Read from a shared app
POST
Runs one read-only tool on an app shared into a Room. Never changes anything. Each read is recorded in the Room's activity: everyone in the Room sees which app and what kind of read; the question is shown only to the person who asked it.
header
AuthorizationBearer <token>A signed-in SMB user's access token. Workspace-scoped operations also require SMB-Workspace-Id.
room_id*stringMatch
^rom_[0-7][0-9A-HJKMNP-TV-Z]{25}$connection_id*stringMatch
^([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)$Format
uuidSMB-Workspace-Id*stringWorkspace where this operation runs. Required for user tokens and Workspace API keys.
Format
uuidapplication/json- body
tool*stringTool slug from find_room_connection_tools.
Match
^[A-Z][A-Z0-9_]{1,127}$arguments?Inputs per the tool's input_schema.
Default
{}question?stringThe person's question, in their words. Shown in the Room's activity only to the person who asked it.
Length
1 <= length <= 2000Successful authorized response.
application/json- response
data*request_id*stringcurl -X POST 'https://example.com/v1/rooms/string/connections/497f6eca-6276-4993-bfeb-53cbbbba6f08/read' \ -H 'SMB-Workspace-Id: 497f6eca-6276-4993-bfeb-53cbbbba6f08' \ -H 'Content-Type: application/json' \ -d '{ "tool": "string"}'{ "data": { "tool": "string", "result": null }, "request_id": "string"}