DOdotfile
Routines

Trigger a routine

Changed on

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 carrying an external_api trigger can be fired here — a routine without one 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.

post/v1/routines/{slug}/trigger

Request

  • Base URL
    https://api.dotfile.com
  • Auth
    API key in header X-DOTFILE-API-KEY

Path parameters

slugstring required

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

Request body

case_idstring uuid

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

Response

The execution started

ℹ️ Click to see full payload

thread_idstring uuid required

Identifier of the execution. Carried by the autonomy run webhooks reporting the outcome.

Changes