Skip to main content
POST
Trigger a managed-agent run

Authorizations

Authorization
string
header
required

API key with dtk_live_ prefix. Obtain it from API Keys in the account sidebar. New keys start with all supported scopes selected for the chosen project, and you can narrow them to specific read/write scopes as needed.

Path Parameters

projectId
string<uuid>
required

The project the credential is bound to. Read it from GET /connection.

agentKey
string
required

Roster or custom agent key.

Body

application/json
requestIdempotencyKey
string<uuid>
required
instructions
string
Required string length: 1 - 4000
modelId
string
Required string length: 1 - 120
targetPage
string

Page the run works on, for agents that brief one page: an absolute URL, or a path such as /pricing on a tracked domain.

Required string length: 1 - 2048

Response

Queued or reused managed-agent run

data
object
required
meta
object
required

Sent beside data on every successful response that returns data.