# Approve or decline (/docs/api-reference/decide_room_approval)

`POST /v1/rooms/{room_id}/approvals/{approval_id}/decision` · operation `decide_room_approval`

The owner approves or declines an approval asked of them. Approving runs it once, exactly as asked.

**Sign-in:** a signed-in person's access token (`Authorization: Bearer …`), which AI apps get through MCP sign-in.

### Path parameters

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `room_id` | string | yes |  |
| `approval_id` | string (uuid) | yes |  |

### Headers

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `SMB-Workspace-Id` | string (uuid) | yes | Workspace where this operation runs. Required for user tokens and Workspace API keys. |
| `Idempotency-Key` | string | yes |  |

### Request body (JSON)

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `decision` | one of `approve`, `decline` | yes |  |

### Response

**200** Successful authorized response.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `data` | object | yes |  |
| `data.approval_id` | string (uuid) | yes |  |
| `data.kind` | one of `app_action` | yes |  |
| `data.room_id` | string or null | yes |  |
| `data.connection_id` | string (uuid) | yes |  |
| `data.plugin` | string or null | yes |  |
| `data.tool` | string | yes |  |
| `data.arguments` | object | yes |  |
| `data.summary` | string | yes |  |
| `data.status` | one of `pending`, `running`, `done`, `failed`, `unconfirmed`, `declined`, `expired`, `canceled` | yes |  |
| `data.requested_by` | object | yes |  |
| `data.approver` | object | yes |  |
| `data.task_id` | string or null | yes |  |
| `data.created_at` | string | yes |  |
| `data.expires_at` | string | yes |  |
| `data.decided_at` | string or null | yes |  |
| `data.finished_at` | string or null | yes |  |
| `data.result` | any or null | yes |  |
| `data.error` | string or null | yes |  |
| `request_id` | string | yes |  |

### Errors

- `400` The request is invalid.
- `401` Authentication is required.
- `403` The caller is not authorized.
- `404` The resource was not found.
- `409` The resource revision or idempotency input conflicts.
- `413` The request body is too large.
- `415` The request must be JSON.
- `422` Required evidence is missing.
- `429` Rate limit reached; honor Retry-After.
- `500` The request could not be completed.
- `502` A dependency returned an invalid response.
- `503` The service is temporarily unavailable.

### Example

```bash
curl --request POST "https://api.smb.co/v1/rooms/$ROOM_ID/approvals/$APPROVAL_ID/decision" \
  --header "Authorization: Bearer $ACCESS_TOKEN" \
  --header "SMB-Workspace-Id: $WORKSPACE_ID" \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  --header "Content-Type: application/json" \
  --data '{"decision":"approve"}'
```