# POST /agent-ops/runs

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

Log a new agent run. If eve_id is provided and already exists, upserts.

## Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `agent_name` | body | string | yes | Agent name |
| `task_type` | body | string | no | Task type (e.g. sales-report, email_response) |
| `status` | body | string | no | started \| completed \| failed \| skipped |
| `model` | body | string | no | Model used (e.g. claude-sonnet-4-6) |
| `duration_ms` | body | number | no | Run duration in milliseconds |
| `output_summary` | body | string | no | Human-readable summary of what the agent did |

## Response example

```json
{ "data": { "id": "run-uuid", "agent_name": "nurture-agent", "status": "started" } }
```

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