botruntime
API ReferenceChat API

Call Action

Call an action

POST
/v1/chat/actions

Header Parameters

x-bot-id*string

Bot id

x-integration-id?string

Integration id

x-integration-alias?string

Integration alias

Request Body

application/json

Action payload

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

curl -X POST "https://example.com/v1/chat/actions" \  -H "x-bot-id: string" \  -H "Content-Type: application/json" \  -d '{    "type": "string",    "input": {}  }'
{  "output": {},  "meta": {    "cached": true  }}
{  "output": {},  "meta": {    "cached": true  }}

Add Participant POST

Add a [Participant](#schema_participant) to a [Conversation](#schema_conversation).

Cancel Integration Operation POST

Requests best-effort cancellation. A queued operation is cancelled immediately. A running local attempt receives a cancellation signal, but the generic fallback has no provider Cancel adapter and cannot confirm that remote work stopped.