Skip to main content
POST
Create Agent

Authorizations

Authorization
string
header
required

API key authentication. Get your API key from the Duvo dashboard.

Path Parameters

teamId
string
required

Body

application/json
name
string
required

Human-readable agent name

Minimum string length: 1
type
enum<string>
default:agent

Flavour of the step to create. Fixed at creation — it selects the config family every build of this step must use, and the two cannot be mixed.

Available options:
agent,
code
thread_id
string<uuid> | null

Existing thread ID to associate with the agent

source_build_id
string<uuid> | null

Build ID whose case-queue-consumer setup should be copied to the new agent

automation_id
string<uuid> | null

Automation this agent belongs to. If omitted on a team using the automations model, a new automation named after the agent is created automatically.

build
object

Optional inline build. When present, a first build is created alongside the agent. Only valid for an agent step.

Response

Default Response

agent
object
required
build
object