Start a run through the routine's inbound URL

Changed on

No Authorization header: the secret in the path is the credential. The request body, in any format and up to 50,000 characters, is added to the run's first message under the label "Input for this run:"; an empty body starts a run with no input. An Idempotency-Key header makes a repeated delivery return the first run. A paused routine answers 409 and starts nothing, an unknown URL or an archived routine answers 404, and more than 30 runs of one routine in a minute answers 429. The run is a task of the routine's owner (trigger_context {type:"api"}).

post/routines/inbound/{token}

Request

  • Base URL
    https://api.agentsky.dev/v1
  • URL
    https://api.agentsky.dev/v1/routines/inbound/{token}
  • Auth
    none required

Path parameters

tokenstring required

The secret part of the inbound URL (rin_…)

Headers

Idempotency-Keystring

Request body */*

string required

Response

Accepted

Changes