Queue an on-demand run of a routine

POST 
https://platform.docana.com/api/v1/agents/:agentId/routines/:routineId/run/

Requires Authorization: ApiKey <key> with the FULL or ROUTINE scope; session cookies are rejected. The routine must be enabled and have an enabled API trigger. Accepts an optional JSON body { text?: string } (max 10k chars) that is passed to the routine as a prefix to the saved prompt. Answers 202 once the run is queued; the spawned thread and execution ids appear on the run row once the worker finishes.

Request

Responses

202

The run was queued

400

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

401

Missing, invalid or expired API key

403

Wrong API key scope or no access to the application

404

Routine not found for this agent

409

Routine disabled or without an enabled API trigger

500

Unexpected server error.