Update an application
PATCHhttps://platform.docana.com/api/v1/applications/:id/
Updates one or more of the application name, description, group and settings. settings takes every application-level setting: capability toggles (codeExecutionEnabled, skillsEnabled, ...), model pins (agentDefaultModel, assistantModel, ...), attachment, document template and retrieval knobs, the concurrent-execution limit (maxConcurrentExecutions), whether the assistant answers only from the application knowledge (assistantKnowledgeOnly), and the persona and tone of voice (persona: a preset, six voice trait levels, and free-text voice notes; null or the neutral preset clears it). On the other settings null removes the application value so the company value applies again. Omitted fields are preserved. Settings read back from metadata.settings. Requires write access. maxConcurrentExecutions and the model pins (agentDefaultModel, agentLiteModel, agentProModel, assistantModel, documentTemplateModelName, evaluationModel, smartAssertionModel, retrievalRerankModel) are super admin only: from anyone else a body that sets or clears one is rejected whole with 403 settings/super-admin-only, details.keys naming them, and nothing is written.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 500
The updated application
The request body, query, or path failed validation. See validationErrors.
The API key or session is missing, expired, or malformed.
No write access to the application, or a super-admin-only setting from another caller (code: settings/super-admin-only, details.keys)
A resource referenced by the path does not exist or is not visible to the caller.
Unexpected server error.