> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ariacompute.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update an Aria Agent Cloud Agent Definition

> Update an Aria Agent Cloud agent's name, model, instructions, tools, or metadata. Partial updates supported using OpenAI beta shape.

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

```http theme={null}
POST /v1/agents/{agent_id}
```

## Authentication

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

## Path parameters

<ParamField path="agent_id" type="string" required>
  Agent identifier.
</ParamField>

## Request body

<ParamField body="name" type="string">
  Display name.
</ParamField>

<ParamField body="model" type="string">
  Backing model identifier.
</ParamField>

<ParamField body="instructions" type="string">
  System instructions.
</ParamField>

<ParamField body="tools" type="array">
  Full replacement of the tool list.
</ParamField>

<ParamField body="metadata" type="object">
  Full replacement of metadata.
</ParamField>

## Response

Returns the full updated agent object; same shape as [Get Agent](/api-reference/agent/agents/get).

## Example

```bash theme={null}
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."}'
```


## Related topics

- [Delete an Aria Agent Cloud Agent Definition](/api-reference/agent/agents/delete.md)
- [Update an Aria Agent Cloud Session](/api-reference/agent/sessions/update.md)
- [Delete an Aria Agent Cloud Session by ID](/api-reference/agent/sessions/delete.md)
- [Retrieve an Aria Agent Cloud Agent by ID](/api-reference/agent/agents/get.md)
- [Create Aria Agent Cloud Session for an Agent](/api-reference/agent/sessions/create.md)