Create Custom Agent V1
Create a custom agent. Configurations stick until deleted. Use PATCH to flip is_active rather than re-creating to preserve audit history.
POST
Create a custom agent.
Configurations stick until deleted. Use
PATCH to flip is_active
rather than re-creating to preserve audit history.
Request body
CustomAgentRequest
string
required
Human-readable agent name (≤128 chars).
string,null
Free-form description (≤4 KB). Surfaces in the dashboard list view.
string,null
Text appended to the platform’s default system prompt for this agent’s runs (≤16 KB). Use to give the agent persistent persona or domain-specific instructions.
string
Tag for this agent’s runs; default ‘custom’. Free-form.
string[]
Skill IDs or names to register on each run (≤100 entries).
string[]
Allow-list of tool names this agent may use; empty = full default tool set. Useful for sandboxing untrusted prompts.
object
Params merged into every
/trigger call invoking this agent.object
Optional trigger metadata — e.g.
{type: 'scheduled', cron: '0 9 * * *'}. Free-form; the worker reads documented keys.Response
CustomAgentSummary
string
required
string
required
string,null
required
string,null
required
string
required
string[]
required
string[]
required
object
required
object
required
boolean
required
boolean
required
string
required
string
required