Update an Aria Agent Cloud Agent Definition

Update an existing agent. The request body is a partial patch: any field you include is replaced, any field you omit is left unchanged. Following the OpenAI beta convention, updates use POST on the resource path.

Endpoint

POST /v1/agents/{agent_id}

Authentication

Authorization: Bearer <api_key> or Authorization: ApiKey <api_key>.

Path parameters

string

required

Agent identifier.

Request body

string

Display name.

string

Backing model identifier.

string

System instructions.

array

Full replacement of the tool list.

object

Full replacement of metadata.

Response

Returns the full updated agent object; same shape as Get Agent.

Example

curl -X POST https://agent.example.com/v1/agents/ag_0198a... \
  -H "Authorization: Bearer $ARIA_AGENT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"instructions": "You are a triage agent. Prefer concise answers."}'

PIN API

ROUTER API

AGENT API

Update an Aria Agent Cloud Agent Definition

Endpoint

Authentication

Path parameters

Request body

Response

Example

​Endpoint

​Authentication

​Path parameters

​Request body

​Response

​Example

Endpoint

Authentication

Path parameters

Request body

Response

Example