# POST /agent-ops/registry/:id/definition

**Resource:** [Agent Ops](./agent-ops.md)  
**Scopes:** `agent-ops:write`  
**Write operation:** yes

Update the managed agent definition (bumps the version on the underlying AI platform). Verifies company ownership of both the registry row and the linked definition before proxying. Body must contain an "agent" key with the update payload. Requires agent-ops:write scope.

## Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `id` | path | string | yes | Agent registry UUID |
| `agent` | body | object | yes | Definition update payload (e.g. { name, system_prompt, model }) |

## Request example

```bash
{
  "agent": {
    "name": "My Updated Agent",
    "system_prompt": "You are a helpful CRM assistant..."
  }
}
```

## Response example

```json
{
  "data": {
    "id": "def-uuid",
    "name": "My Updated Agent",
    "current_version": 4,
    "updated_at": "2026-05-19T08:00:00Z"
  }
}
```

---
Base URL: `https://api.trustpager.com/functions/v1/api/v1` — Auth: `Authorization: Bearer YOUR_API_KEY`