# POST /agent-proposals/:id/reject

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

Reject a pending proposal. The proposed action is NOT executed. The rejection reason is stored and visible to the agent.

## Parameters

| Name | In | Type | Required | Description |
|------|----|------|----------|-------------|
| `id` | path | string | yes | Proposal UUID |
| `reason` | body | string | no | Reason for rejection (shown to the agent for learning) |

## Request example

```bash
{ "reason": "Automation is intentionally paused during Q2 migration." }
```

## Response example

```json
{ "data": { "proposal_id": "f1a2b3c4-...", "status": "rejected" } }
```

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