Beta

Ask for approval

Last updated Nov 19, 2026View as MarkdownAgent setup / MCP
POST
/v1/rooms/{room_id}/connections/{connection_id}/approvals

Asks the app's owner to approve one action. Nothing runs until they approve; then it runs once, exactly as asked.

Authorization

headerAuthorizationBearer <token>

A signed-in SMB user's access token. Workspace-scoped operations also require SMB-Workspace-Id.

Path Parameters

room_id*string
Match^rom_[0-7][0-9A-HJKMNP-TV-Z]{25}$
connection_id*string
Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid

Header Parameters

SMB-Workspace-Id*string

Workspace where this operation runs. Required for user tokens and Workspace API keys.

Formatuuid
Idempotency-Key*string
Length8 <= length <= 200

Request Body

application/json
  1. body
tool*string

Tool slug from find_room_connection_tools.

Match^[A-Z][A-Z0-9_]{1,127}$
arguments?

Inputs per the tool's input_schema.

Default{}
summary*string

What will happen, in plain words.

Length1 <= length <= 300

Response Body

Successful authorized response.

application/json
  1. response
data*
request_id*string
curl -X POST 'https://example.com/v1/rooms/string/connections/497f6eca-6276-4993-bfeb-53cbbbba6f08/approvals' \  -H 'SMB-Workspace-Id: 497f6eca-6276-4993-bfeb-53cbbbba6f08' \  -H 'Idempotency-Key: stringst' \  -H 'Content-Type: application/json' \  -d '{  "tool": "string",  "summary": "string"}'
{  "data": {    "approval_id": "15af2260-72db-4fc4-b587-6b841d6a3d55",    "kind": "app_action",    "room_id": "string",    "connection_id": "d3547de1-d1f2-4344-b4c2-17169b7526f9",    "plugin": "string",    "tool": "string",    "arguments": {      "property1": null,      "property2": null    },    "summary": "string",    "status": "pending",    "requested_by": {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "name": "string"    },    "approver": {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "name": "string"    },    "task_id": "string",    "created_at": "string",    "expires_at": "string",    "decided_at": "string",    "finished_at": "string",    "result": null,    "error": "string"  },  "request_id": "string"}