Trigger a routine

Starts an execution of a routine defined in your Dotfile workspace. The agent runs the routine prompt autonomously; the call returns as soon as the execution is enqueued, and the outcome is reported through the autonomy run webhooks.
Only routines configured with the external_api trigger can be fired here — a routine on another trigger or a disabled routine is refused with a 409. Scope the execution to a case with case_id, or leave it out to run across the whole workspace.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Identifier of the routine, generated from its title at creation and stable across renames. Shown in the console on the routine settings.

Body Params
uuid

Case to scope the execution to. When omitted, the routine runs across the whole workspace.

Responses

400

The request is either malformed or contain invalid parameters.

  • Make sure the body payload matches the expected schema
404

No routine can be found.

409

The routine cannot be triggered because it is disabled or configured with a different trigger.

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json