Request user setup for an application

POST 
https://platform.docana.com/api/v1/applications/:id/setup/

Returns a structured awaiting-user-input handoff for MCP, website, upload, or environment setup. This does not save settings or open a remote browser. Clients render a local form or direct the user to settingsPath. Complete setup through the existing application MCP, allowed-websites, environments, or document upload APIs, then resume the conversation with a non-secret completion message. Never send secret values in reason or variableNames. Requires application write access.

Request

Responses

200

Setup handoff (no credentials)

400

The request body, query, or path failed validation. See validationErrors.

401

The API key or session is missing, expired, or malformed.

403

The caller is authenticated but not allowed to perform this operation.

404

A resource referenced by the path does not exist or is not visible to the caller.

500

Unexpected server error.