> ## 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 Agent - PUT /v1/workspaces/:workspace_id/agents/:agent_id

> Update an Agent Loadout's name, description, prompt, and tools via PUT /v1/workspaces/:workspace_id/agents/:agent_id. Minimum role contributor.

Update an Agent Loadout's name, description, prompt, and tools.

## Endpoint

```http theme={null}
PUT /v1/workspaces/:workspace_id/agents/:agent_id
```

## Authentication

`Authorization: Bearer <jwt>` or `X-API-Key <sk_...>`. Minimum role: **contributor**.

## Path parameters

**workspace\_id** `string` *required*

Workspace id.

**agent\_id** `string` *required*

Agent id.

## Request body

**name** `string`

Name.

**description** `string`

Description.

**prompt** `string`

System prompt.

**tools** `string[]`

Tools.

## Response

**updated** `boolean`

Always true (updated).

## Example

```bash cURL theme={null}
curl -X PUT https://memo.ariacompute.com/v1/workspaces/ws_01a2b3c4d5e6/agents/agent_01a2b3c4d5e6 \
  -H "Authorization: Bearer <jwt>" \
  -H "Content-Type: application/json" \
  -d '{"name":"Doc Assistant v2","prompt":"You are a rigorous doc assistant.","tools":["rag","search"]}'
```

```json 200 theme={null}
{
  "updated": true
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.