Sign in

v1

latestOpenAPI 3.0.0Proprietary2026-07-132885152.8 KB
agent

Create an agent

Create a new agent for the caller's team. Agents can be used as the execution principal for team-owned runs.

post/agent/identities

Request body

namestring required

A name for the agent

descriptionstring nullable

Optional description of the agent

promptstring nullable

Optional base prompt for this agent

environment_idstring nullable

Optional default cloud environment ID for runs executed by this agent. The environment must be owned by the same team as the agent.

skillsstring[]

Optional list of skill specs to associate with the agent. Format: "{owner}/{repo}:{skill_path}" (e.g., "warpdotdev/warp-server:.claude/skills/deploy/SKILL.md"). Each spec is validated and normalized at attach time using the team's GitHub credentials; inaccessible or malformed specs are rejected.

base_modelstring nullable

Optional base model for runs executed by this agent.

base_harnessstring nullable

Optional default harness for runs executed by this agent.

Response

Agent created successfully

uidstring required

Unique identifier for the agent

namestring required

Name of the agent

descriptionstring nullable

Optional description of the agent

promptstring nullable

Optional base prompt for this agent

environment_idstring

Default cloud environment ID for runs executed by this agent. The precedence order for environment resolution is:

  1. The environment specified on the run itself
  2. The agent's default environment
  3. An empty environment
availableboolean required

Whether this agent is within the team's plan limit and can be used for runs

created_atstring date-time required

When the agent was created (RFC3339)

updated_atstring date-time required

When the agent was last updated (RFC3339)

skillsstring[] required

Ordered list of normalized skill specs associated with this agent. Always present; empty when no skills are attached.

base_modelstring

Base model for runs executed by this agent. The precedence order for model resolution is:

  1. The model specified on the run itself
  2. The agent's base model
  3. The team's default model
base_harnessstring

Default harness for runs executed by this agent. The precedence order for harness resolution is:

  1. The harness specified on the run itself
  2. The agent's base harness
  3. Oz