# POST /agent-ops/registry/:id/test-run

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

Trigger a manual test run for a managed agent. Verifies company ownership, confirms the agent is active and managed_agents runtime, then proxies to the dispatcher. Returns a run_id and session_id. Requires agent-ops:write scope.

## Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `id` | path | string | yes | Agent registry UUID |
| `trigger_context` | body | object | no | Optional context injected into the kickoff (default: { source: "api-test-run" }) |

## Request example

```bash
{
  "trigger_context": { "source": "api-test-run", "note": "Manual verification run" }
}
```

## Response example

```json
{
  "data": {
    "run_id": "d08d9fc0-fd6e-47e0-9401-4850f091b40f",
    "session_id": "sesn_01K4eijGkTcn88XfHVBNA3VE",
    "trigger_kind": "manual",
    "kickoff_chars": 285,
    "vault_ids_attached": 0
  }
}
```

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