Update an agent

The new name for the agent

Replacement description. Omit or pass null to leave unchanged, or use an empty value to clear.

Replacement prompt. Omit or pass null to leave unchanged, or use an empty value to clear.

Replacement default cloud environment ID. Omit or pass null to leave unchanged, or pass an empty string to clear.

Replacement default runner UID. Omit or pass null to leave unchanged, or pass an empty string to clear. A non-empty value must reference a runner the editor can View.

Replacement base model. Omit or pass null to leave unchanged, or pass an empty string to clear.

Replacement default harness; omit or pass null to leave unchanged, or pass an empty string to clear. Deprecated - use harness instead, kept only for backward compatibility: when both are sent, harness is authoritative and a conflicting type is rejected with invalid_request.

Default credential strategy for runs executed by a named agent; an agent may leave this unset (see AgentResponse.credential_strategy for the full resolution order).

• EXECUTOR: runs authenticate with the named agent's own credentials (e.g. a GitHub App installation token for the agent's team).
• CREATOR: runs authenticate with the credentials of the principal that created the run.

Whether runs created with this agent's API key may use the on_behalf_of field to attribute runs to another team member. Omit or pass null to leave unchanged. Only team admins may set this field.

Replacement default worker host. Omit or pass null to leave unchanged, or pass an empty string to clear (the workspace default then applies). A non-empty value is trimmed and replaces the stored default; use "warp" to force Warp-hosted execution over a self-hosted workspace default.

Unique identifier for the agent

Name of the agent

Optional description of the agent

Optional base prompt for this agent

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

Default runner UID for runs executed by this agent; when set, it overrides the selected environment's default runner for runs that do not specify their own runner_id. The precedence order for runner resolution is:

1. The runner specified on the run itself
2. The agent's default runner
3. The selected environment's default runner
4. The environment's legacy inline compute fields
5. System defaults

Whether the agent is currently enabled. Defaults to true.

When the agent was created (RFC3339)

When the agent was last updated (RFC3339)

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

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. Warp Deprecated: use harness instead, which carries the full {type, model_id, reasoning_level} default.

Default credential strategy for runs executed by a named agent; an agent may leave this unset (see AgentResponse.credential_strategy for the full resolution order).

• EXECUTOR: runs authenticate with the named agent's own credentials (e.g. a GitHub App installation token for the agent's team).
• CREATOR: runs authenticate with the credentials of the principal that created the run.

Whether runs created with this agent's API key may use the on_behalf_of field to attribute runs to another team member.

Default worker host for runs executed by this agent, or empty when unset; the precedence order for worker host resolution is:

1. The host specified on the run itself
2. The agent's default host
3. The workspace default host