Skip to main content
POST
Create a custom agent

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

Body

application/json
displayName
string
required
Required string length: 1 - 80
description
string
required

One sentence saying what the agent does.

Required string length: 1 - 240
instructions
string
required

What the agent does on every run.

Required string length: 1 - 12000
modelId
string
required

A model available now; others are refused with 400.

Required string length: 1 - 120
quickActions
string[]
required

Suggested requests shown with the agent.

Required array length: 1 - 6 elements
Required string length: 1 - 160
toolAllowlist
string[]
required

Tools the agent may use, including exactly one draft output: create_draft_action, create_draft_brief or create_report_artifact.

Minimum array length: 1

Response

The custom agent

data
object
required
meta
object
required