Actions

Operations tagged Actions in the public API.

About Actions

A Call Action is a tool one chatbot may use mid-conversation. The chatbot's model reads the action's description and, turn by turn, decides whether to call it and with which arguments. There are six types: button (shows the visitor a link button), handoff (flags the conversation for a human and emails your team), notify (emails your team a summary), collect_info (saves the visitor's contact details as a customer), http_request (calls your HTTPS endpoint and gives the model its answer) and mcp (calls one tool on an MCP server — only where the platform has MCP switched on; GET /actions/types says which types can be created).

Lifecycle. POST /actions creates an action under a chatbot (action.created), PATCH /actions/{id} changes it (action.updated) and DELETE /actions/{id} removes it (action.deleted). Each time the model calls an enabled action, a run is recorded; when the run ends it emits action.run.succeeded (status: success) or action.run.failed (any other final status). POST /actions/{id}/test is a dry run: it calls nothing and records no run.

Secrets. credentials are write-only: stored encrypted and never returned — has_credentials says whether any are set. config is returned as stored, so keep secrets out of it.

IDs you will meet.

id — the action id, an integer, in every /actions/{id} path.
chatbot_id — the chatbot the action belongs to; GET /actions requires it.
tool_name — the name the model calls the action by: act__ and a slug, unique within the chatbot. No operation takes it.
Run id — one run, the data.object.id of action.run.* events; no operation takes it. A run's action_id is the action id, or null once the action is deleted.

IDs on this page

Chatbot id<CHATBOT_ID>: Integer.
Get it from
GET /v1/chatbots returns it as data[].id
POST /v1/chatbots returns it as id
GET /v1/chatbots/by_handle/{handle} returns it as id
Webhook chatbot.created carries it as data.object.id
In the dashboard, it is the number in a chatbot's address: /dashboard/chatbots/{id}.
Action id<ACTION_ID>: Integer.
Get it from
GET /v1/actions returns it as data[].id
POST /v1/actions returns it as id
GET /v1/chatbots/{id}/action_runs returns it as data[].action_id
Webhook action.created carries it as data.object.id
action.run.* events name the run, not the action: read its action_id from GET /chatbots/{id}/action_runs.

/v1/actions/types

List action types

Returns the six action types and whether this deployment can create each one (supported). The config each type takes is described on POST /actions.

Required scope: actions:read
Idempotency: Read-only
Rate limits

Responses

200
Success.
objectstringRequired
Alwayslist
dataarray of objectRequired
Every action type, in a fixed order.
has_morebooleanRequired
next_cursoranynullableRequired
previous_cursoranynullableRequired
urlstringRequired
Always/v1/actions/types
400
A tenant selector header named a tenant other than the API key's own (ACCOUNT_SELECTOR_NOT_SUPPORTED): an all-digit X-Account-Id other than the key owner's id or, while workspaces.context_enabled is on, an X-Workspace-Id other than the key's workspace (ws_ prefix optional, case-insensitive). A header naming the key's own tenant, or a non-numeric X-Account-Id, is ignored; a key cannot switch tenants, so send neither.
Error codesACCOUNT_SELECTOR_NOT_SUPPORTED
401
Missing or invalid API key.
Error codesUNAUTHENTICATED
403
The API key is missing a required scope.
Error codesACCOUNT_SUSPENDED INSUFFICIENT_SCOPE
429
Rate limited. Honour the Retry-After header before retrying.
Error codesRATE_LIMITED
500
Unexpected server error. Retry with the same Idempotency-Key.
Error codesSERVER_ERROR

Request

curl

curl -X GET 'https://api.agentency.com/v1/actions/types' \
  -H "Authorization: Bearer <YOUR_KEY>" \
  -H "Content-Type: application/json"

Response

Example 200 response

json

{
  "object": "list",
  "data": [
    {
      "object": "action_type",
      "id": "button",
      "supported": true
    },
    {
      "object": "action_type",
      "id": "handoff",
      "supported": true
    },
    {
      "object": "action_type",
      "id": "notify",
      "supported": true
    },
    {
      "object": "action_type",
      "id": "collect_info",
      "supported": true
    },
    {
      "object": "action_type",
      "id": "http_request",
      "supported": true
    },
    {
      "object": "action_type",
      "id": "mcp",
      "supported": false
    },
    {
      "object": "action_type",
      "id": "web_search",
      "supported": false
    },
    {
      "object": "action_type",
      "id": "integration",
      "supported": false
    }
  ],
  "has_more": false,
  "next_cursor": null,
  "previous_cursor": null,
  "url": "/v1/actions/types"
}

/v1/actions

List a chatbot's actions

Returns the actions of the chatbot chatbot_id (required), enabled or not, newest first and cursor-paginated. A chatbot the API key cannot reach is 404 NOT_FOUND.

Required scope: actions:read
Idempotency: Read-only
Rate limits

Before you call

chatbot_id(query)Chatbot id
Integer.
Placeholder in the samples: <CHATBOT_ID>
Get it from
- GET /v1/chatbots returns it as data[].id
- POST /v1/chatbots returns it as id
- GET /v1/chatbots/by_handle/{handle} returns it as id
- Webhook chatbot.created carries it as data.object.id
- In the dashboard, it is the number in a chatbot's address: /dashboard/chatbots/{id}.

Query parameters

chatbot_idintegerRequired
The chatbot whose actions to list. Required: actions belong to one chatbot. A chatbot the API key cannot reach is 404 NOT_FOUND.
Minimum: 1
limitintegerOptional
Page size, clamped to 1–100.
Default: 20Minimum: 1Maximum: 100
starting_afterstringOptional
Cursor from a previous page's next_cursor: returns the page after it. A cursor minted for another list, sort or order is 422 INVALID_CURSOR.
ending_beforestringOptional
Cursor from a previous page's previous_cursor: returns the page before it. Wins when both cursors are sent.
created[gte]stringOptional
Only rows created on or after this instant: YYYY-MM-DD (whole UTC day) or an RFC 3339 timestamp with a zone. Anything else is 422 INVALID_PARAMETER.
created[lte]stringOptional
Only rows created on or before this instant: YYYY-MM-DD (whole UTC day) or an RFC 3339 timestamp with a zone. Anything else is 422 INVALID_PARAMETER.

Responses

200
Success.
objectstringRequired
Alwayslist
dataarray of ActionResourceRequired
has_morebooleanRequired
next_cursorstringnullableRequired
previous_cursorstringnullableRequired
urlstringRequired
Always/v1/actions
400
A tenant selector header named a tenant other than the API key's own (ACCOUNT_SELECTOR_NOT_SUPPORTED): an all-digit X-Account-Id other than the key owner's id or, while workspaces.context_enabled is on, an X-Workspace-Id other than the key's workspace (ws_ prefix optional, case-insensitive). A header naming the key's own tenant, or a non-numeric X-Account-Id, is ignored; a key cannot switch tenants, so send neither.
Error codesACCOUNT_SELECTOR_NOT_SUPPORTED
401
Missing or invalid API key.
Error codesUNAUTHENTICATED
403
The API key is missing a required scope.
Error codesACCOUNT_SUSPENDED INSUFFICIENT_SCOPE
404
The resource does not exist on this account.
Error codesNOT_FOUND
422
Validation failed. See error.details.
Error codesINVALID_CURSOR INVALID_PARAMETER VALIDATION_FAILED
429
Rate limited. Honour the Retry-After header before retrying.
Error codesRATE_LIMITED
500
Unexpected server error. Retry with the same Idempotency-Key.
Error codesSERVER_ERROR

Request

curl

curl -X GET 'https://api.agentency.com/v1/actions?chatbot_id=<CHATBOT_ID>' \
  -H "Authorization: Bearer <YOUR_KEY>" \
  -H "Content-Type: application/json"

Response

Example 200 response

json

{
  "object": "list",
  "data": [
    {
      "object": "action",
      "id": 1,
      "chatbot_id": 1,
      "type": "button",
      "name": "Book a demo",
      "tool_name": "act__book_a_demo",
      "description": "Show this when the visitor wants to book a demo call.",
      "enabled": true,
      "is_high_risk": false,
      "config": {
        "button": {
          "url": "https://shop.example.com/demo",
          "label": "Book a demo",
          "open_in_new_tab": true
        },
        "parameters": []
      },
      "provider": null,
      "operation": null,
      "connection_id": null,
      "channels": null,
      "has_credentials": false,
      "run_count": 1,
      "success_count": 1,
      "success_rate": 100,
      "last_run_at": "2026-01-01T00:00:00+00:00",
      "created_at": "2026-01-01T00:00:00+00:00",
      "updated_at": "2026-01-01T00:00:00+00:00"
    }
  ],
  "has_more": false,
  "next_cursor": null,
  "previous_cursor": null,
  "url": "/v1/actions"
}

/v1/actions

Create an action

Adds a tool to a chatbot. type is fixed for the action's life, and config holds that type's settings, checked for it (422 VALIDATION_FAILED on a config.* field): button: button.label and button.url (required), button.open_in_new_tab (default true). handoff: targets to email and a message_to_visitor. The model passes a reason. notify: targets to email and a subject. The model passes a summary. collect_info: parameters, the details to ask the visitor for (default: name, and a required email). http_request: url (required) and method (GET by default, or POST, PUT, PATCH, DELETE), headers, body_template, auth with its secret in credentials, signing and egress_allowlist. parameters declares what the model passes; a {{name}} placeholder in the URL's path or query, a header value or the body takes its value. mcp: server_url and tool (required), parameters and egress_allowlist. List a server's tools with POST /actions/mcp/discover. The action is enabled unless enabled: false. An enabled action counts against the plan's actions per chatbot (402 AI_ACTION_LIMIT_REACHED) and the platform's ceiling of enabled actions per chatbot (422 ACTION_LIMIT_REACHED). A type this deployment cannot run is 422 ACTION_TYPE_UNAVAILABLE.

Required scope: actions:write
Idempotency: Accepts Idempotency-Key
Webhook events: action.created
Rate limits

Before you call

chatbot_id(body)Chatbot id
Integer.
Placeholder in the samples: <CHATBOT_ID>
Get it from
- GET /v1/chatbots returns it as data[].id
- POST /v1/chatbots returns it as id
- GET /v1/chatbots/by_handle/{handle} returns it as id
- Webhook chatbot.created carries it as data.object.id
- In the dashboard, it is the number in a chatbot's address: /dashboard/chatbots/{id}.

Header parameters

Idempotency-KeystringOptional
Makes a retry safe. The first 2xx answer is stored for 24 h and replayed for the same key with Idempotency-Replayed: true; a retry while the first request runs is 409 IDEMPOTENCY_IN_FLIGHT; the same key with a different payload is 422 IDEMPOTENCY_KEY_REUSED; a malformed key is 400 INVALID_IDEMPOTENCY_KEY.
Min length: 16Max length: 128Pattern: ^[A-Za-z0-9_-]+$

Request body

chatbot_idintegerRequired
The chatbot whose model may call the action. A chatbot the API key cannot reach is 404 NOT_FOUND.
Minimum: 1
typestringRequired
What the action does when called (see the operation description). Fixed for the action's life.
Possible valuesbuttonhandoffnotifycollect_infohttp_requestmcpweb_searchintegration
namestringRequired
Display name, at most 120 characters.
Max length: 120
descriptionstringRequired
When the model should call the action, 8 to 1000 characters. The model reads it to decide, so write it for someone who has never seen your system: "Look up an order's status by its order number" gets used; "Order endpoint" does not.
Min length: 8Max length: 1000
tool_namestringnullableOptional
The tool name to derive from: lowercase letters, digits and _, at most 90 characters. The stored tool_name is act__ and this (or a slug of name when omitted), with a number appended when another action of the chatbot has it.
Max length: 90Pattern: ^[a-z0-9_]+$
enabledbooleanOptional
Whether the chatbot offers the action to its model. Defaults to true.
is_high_riskbooleanOptional
Run a call only after the visitor confirms it in a later turn. Defaults to false. An http_request with POST, PUT, PATCH or DELETE, and an mcp action without config.low_risk, wait for confirmation regardless.
max_iterationsintegernullableOptional
How many times the model may call this action in one turn, 1 to 5. null (the default) uses the platform's limit.
Minimum: 1Maximum: 5
configobjectRequired
The settings of the action's type (see the operation description). Returned on every read, so never put a secret here.
credentialsobjectOptional
Write-only secrets for http_request and mcp: token, username and password, api_key, signing_secret. Stored encrypted and never returned; has_credentials says whether any are set.
providerstringnullableOptional
Integration actions only: the provider key from GET /integrations/catalog.
Pattern: ^[a-z0-9_]{2,48}$
operationstringnullableOptional
Integration actions only: an executable operation key of that provider.
Pattern: ^[a-z0-9_]{1,64}$
connection_idintegernullableOptional
Integration actions only: an active connection of that provider owned by the account.
Minimum: 1
channelsarray of stringnullableOptional
Surfaces the action is offered on: widget, direct_link, dashboard, api or a messaging platform. Null offers it everywhere.
Min items: 1

Responses

201
ActionResource
objectstringRequired
Alwaysaction
idintegerRequired
The action id.
chatbot_idintegerRequired
The chatbot whose model may call the action.
typestringRequired
What the action does when called. Fixed at creation.
Possible valuesbuttonhandoffnotifycollect_infohttp_requestmcpweb_searchintegration
namestringRequired
Display name, shown in the dashboard and run history.
tool_namestringRequired
The name the model calls the tool by: act__ and a slug of the tool_name or name sent at creation, unique within the chatbot (a number is appended on a clash). Fixed at creation.
descriptionstringRequired
When the model should call the action, in your words. The model reads it to decide.
enabledbooleanRequired
Whether the chatbot offers the action to its model.
is_high_riskbooleanRequired
Your high-risk flag: a high-risk call runs only after the visitor confirms it in a later turn. Some calls wait whatever this says: an http_request with POST, PUT, PATCH or DELETE, and an mcp action unless its config.low_risk is true.
configobjectnullableRequired
The type's settings as stored, after validation filled the defaults (see POST /actions). Never holds credentials.
providerstringnullableRequired
Integration actions only: the provider key from GET /integrations/catalog; null for every other type. Fixed at creation.
operationstringnullableRequired
Integration actions only: the provider operation the action runs; null for every other type. Fixed at creation.
connection_idintegernullableRequired
Integration actions only: the account connection the operation runs through; null for every other type.
channelsarray of stringnullableRequired
The surfaces the action is offered on (widget, direct_link, dashboard, api or a messaging platform); null offers it everywhere.
has_credentialsbooleanRequired
Whether any credentials are stored. Their values are never returned.
run_countintegerRequired
Runs that have ended, counted as they end. A skipped confirmation request is not counted.
success_countintegerRequired
Of those, the runs that succeeded.
success_ratenumbernullableRequired
success_count ÷ run_count, in percent with one decimal; null before the first counted run.
last_run_atstringnullableRequired
When the last counted run ended (ISO 8601, UTC); null before the first.
created_atstringnullableRequired
When the action was created (ISO 8601, UTC).
updated_atstringnullableRequired
When the action last changed (ISO 8601, UTC).
400
A tenant selector header named a tenant other than the API key's own (ACCOUNT_SELECTOR_NOT_SUPPORTED): an all-digit X-Account-Id other than the key owner's id or, while workspaces.context_enabled is on, an X-Workspace-Id other than the key's workspace (ws_ prefix optional, case-insensitive). A header naming the key's own tenant, or a non-numeric X-Account-Id, is ignored; a key cannot switch tenants, so send neither. A mutation that honours Idempotency-Key also returns INVALID_IDEMPOTENCY_KEY when that header is not 16–128 [A-Za-z0-9_-] characters.
Error codesACCOUNT_SELECTOR_NOT_SUPPORTED INVALID_IDEMPOTENCY_KEY
401
Missing or invalid API key.
Error codesUNAUTHENTICATED
402
A billing gate refused the request (plan limit, monthly AI budget or message credits). See error.code.
Error codesAI_ACTION_LIMIT_REACHED
403
The API key is missing a required scope.
Error codesACCOUNT_SUSPENDED INSUFFICIENT_SCOPE
404
The resource does not exist on this account.
Error codesNOT_FOUND
409
The request conflicts with the current resource state.
Error codesACTION_TOOL_NAME_CONFLICT IDEMPOTENCY_IN_FLIGHT
422
Validation failed. See error.details.
Error codesACTION_LIMIT_REACHED ACTION_TYPE_UNAVAILABLE IDEMPOTENCY_KEY_REUSED VALIDATION_FAILED
429
Rate limited. Honour the Retry-After header before retrying.
Error codesRATE_LIMITED
500
Unexpected server error. Retry with the same Idempotency-Key.
Error codesSERVER_ERROR

Request

curl

curl -X POST 'https://api.agentency.com/v1/actions' \
  -H "Authorization: Bearer <YOUR_KEY>" \
  -H "Content-Type: application/json"
  -d '{
  "chatbot_id": 1,
  "type": "type",
  "name": "name",
  "description": "description",
  "tool_name": "tool_name",
  "enabled": true,
  "is_high_risk": true,
  "max_iterations": "max_iterations"
}'

Response

Example 201 response

json

{
  "object": "action",
  "id": 1,
  "chatbot_id": 1,
  "type": "http_request",
  "name": "Track a delivery",
  "tool_name": "act__track_a_delivery",
  "description": "Look up where a parcel is when the visitor gives a tracking number.",
  "enabled": true,
  "is_high_risk": false,
  "config": {
    "method": "GET",
    "url": "https://api.example.com/shipments/{{tracking_number}}",
    "headers": [],
    "auth": {
      "type": "bearer",
      "header_name": ""
    },
    "body_template": null,
    "response": {
      "mode": "full"
    },
    "signing": {
      "enabled": false,
      "header": "X-Signature"
    },
    "egress_allowlist": [],
    "parameters": [
      {
        "name": "tracking_number",
        "type": "string",
        "required": true,
        "description": "The parcel tracking number, e.g. 1Z999AA10123456784"
      }
    ]
  },
  "provider": null,
  "operation": null,
  "connection_id": null,
  "channels": null,
  "has_credentials": true,
  "run_count": 0,
  "success_count": 0,
  "success_rate": null,
  "last_run_at": null,
  "created_at": "2026-01-01T00:00:00+00:00",
  "updated_at": "2026-01-01T00:00:00+00:00"
}

/v1/actions/{id}

Retrieve an action

Returns one action: its type and config, whether it is enabled, and its run counters. credentials are never returned; has_credentials says whether any are stored.

Required scope: actions:read
Idempotency: Read-only
Rate limits

Before you call

id(path)Action id
Integer.
Placeholder in the samples: <ACTION_ID>
Get it from
- GET /v1/actions returns it as data[].id
- POST /v1/actions returns it as id
- GET /v1/chatbots/{id}/action_runs returns it as data[].action_id
- Webhook action.created carries it as data.object.id
- action.run.* events name the run, not the action: read its action_id from GET /chatbots/{id}/action_runs.

Path parameters

idintegerRequired
The action id.

Responses

200
ActionResource
objectstringRequired
Alwaysaction
idintegerRequired
The action id.
chatbot_idintegerRequired
The chatbot whose model may call the action.
typestringRequired
What the action does when called. Fixed at creation.
Possible valuesbuttonhandoffnotifycollect_infohttp_requestmcpweb_searchintegration
namestringRequired
Display name, shown in the dashboard and run history.
tool_namestringRequired
The name the model calls the tool by: act__ and a slug of the tool_name or name sent at creation, unique within the chatbot (a number is appended on a clash). Fixed at creation.
descriptionstringRequired
When the model should call the action, in your words. The model reads it to decide.
enabledbooleanRequired
Whether the chatbot offers the action to its model.
is_high_riskbooleanRequired
Your high-risk flag: a high-risk call runs only after the visitor confirms it in a later turn. Some calls wait whatever this says: an http_request with POST, PUT, PATCH or DELETE, and an mcp action unless its config.low_risk is true.
configobjectnullableRequired
The type's settings as stored, after validation filled the defaults (see POST /actions). Never holds credentials.
providerstringnullableRequired
Integration actions only: the provider key from GET /integrations/catalog; null for every other type. Fixed at creation.
operationstringnullableRequired
Integration actions only: the provider operation the action runs; null for every other type. Fixed at creation.
connection_idintegernullableRequired
Integration actions only: the account connection the operation runs through; null for every other type.
channelsarray of stringnullableRequired
The surfaces the action is offered on (widget, direct_link, dashboard, api or a messaging platform); null offers it everywhere.
has_credentialsbooleanRequired
Whether any credentials are stored. Their values are never returned.
run_countintegerRequired
Runs that have ended, counted as they end. A skipped confirmation request is not counted.
success_countintegerRequired
Of those, the runs that succeeded.
success_ratenumbernullableRequired
success_count ÷ run_count, in percent with one decimal; null before the first counted run.
last_run_atstringnullableRequired
When the last counted run ended (ISO 8601, UTC); null before the first.
created_atstringnullableRequired
When the action was created (ISO 8601, UTC).
updated_atstringnullableRequired
When the action last changed (ISO 8601, UTC).
400
A tenant selector header named a tenant other than the API key's own (ACCOUNT_SELECTOR_NOT_SUPPORTED): an all-digit X-Account-Id other than the key owner's id or, while workspaces.context_enabled is on, an X-Workspace-Id other than the key's workspace (ws_ prefix optional, case-insensitive). A header naming the key's own tenant, or a non-numeric X-Account-Id, is ignored; a key cannot switch tenants, so send neither.
Error codesACCOUNT_SELECTOR_NOT_SUPPORTED
401
Missing or invalid API key.
Error codesUNAUTHENTICATED
403
The API key is missing a required scope.
Error codesACCOUNT_SUSPENDED INSUFFICIENT_SCOPE
404
The resource does not exist on this account.
Error codesNOT_FOUND
429
Rate limited. Honour the Retry-After header before retrying.
Error codesRATE_LIMITED
500
Unexpected server error. Retry with the same Idempotency-Key.
Error codesSERVER_ERROR

Request

curl

curl -X GET 'https://api.agentency.com/v1/actions/<ACTION_ID>' \
  -H "Authorization: Bearer <YOUR_KEY>" \
  -H "Content-Type: application/json"

Response

Example 200 response

json

{
  "object": "action",
  "id": 1,
  "chatbot_id": 1,
  "type": "button",
  "name": "Book a demo",
  "tool_name": "act__book_a_demo",
  "description": "Show this when the visitor wants to book a demo call.",
  "enabled": true,
  "is_high_risk": false,
  "config": {
    "button": {
      "url": "https://shop.example.com/demo",
      "label": "Book a demo",
      "open_in_new_tab": true
    },
    "parameters": []
  },
  "provider": null,
  "operation": null,
  "connection_id": null,
  "channels": null,
  "has_credentials": false,
  "run_count": 1,
  "success_count": 1,
  "success_rate": 100,
  "last_run_at": "2026-01-01T00:00:00+00:00",
  "created_at": "2026-01-01T00:00:00+00:00",
  "updated_at": "2026-01-01T00:00:00+00:00"
}

/v1/actions/{id}

Update an action

Changes the fields you send and keeps the rest. config is merged key by key over the stored config, then checked for the action's type; credentials are merged the same way, and an empty value removes that key. type and tool_name cannot change. Switching a disabled action on (enabled: true) passes the same plan limit and ceiling as a create. Every successful call emits action.updated, even one that changes nothing.

Required scope: actions:write
Idempotency: Accepts Idempotency-Key
Webhook events: action.updated
Rate limits

Before you call

id(path)Action id
Integer.
Placeholder in the samples: <ACTION_ID>
Get it from
- GET /v1/actions returns it as data[].id
- POST /v1/actions returns it as id
- GET /v1/chatbots/{id}/action_runs returns it as data[].action_id
- Webhook action.created carries it as data.object.id
- action.run.* events name the run, not the action: read its action_id from GET /chatbots/{id}/action_runs.

Path parameters

idintegerRequired
The action id.

Header parameters

Idempotency-KeystringOptional
Makes a retry safe. The first 2xx answer is stored for 24 h and replayed for the same key with Idempotency-Replayed: true; a retry while the first request runs is 409 IDEMPOTENCY_IN_FLIGHT; the same key with a different payload is 422 IDEMPOTENCY_KEY_REUSED; a malformed key is 400 INVALID_IDEMPOTENCY_KEY.
Min length: 16Max length: 128Pattern: ^[A-Za-z0-9_-]+$

Request body

namestringOptional
Display name, at most 120 characters.
Max length: 120
descriptionstringOptional
When the model should call the action, 8 to 1000 characters.
Min length: 8Max length: 1000
enabledbooleanOptional
Whether the chatbot offers the action to its model. Switching it on passes the plan limit and the per-chatbot ceiling.
is_high_riskbooleanOptional
Run a call only after the visitor confirms it in a later turn.
max_iterationsintegernullableOptional
How many times the model may call this action in one turn, 1 to 5; null uses the platform's limit.
Minimum: 1Maximum: 5
configobjectRequired
Keys to change in the type's settings, merged over the stored ones; the result is checked as on create. Send a whole list (parameters, headers, targets) to change it.
credentialsobjectOptional
Secrets to set, merged over the stored ones; an empty string or null removes that key. Write-only.
providerstringnullableOptional
Integration actions only. Fixed at create: a different value is 422.
Pattern: ^[a-z0-9_]{2,48}$
operationstringnullableOptional
Integration actions only. Fixed at create: a different value is 422.
Pattern: ^[a-z0-9_]{1,64}$
connection_idintegernullableOptional
Integration actions only. Another active connection of the same provider owned by the account.
Minimum: 1
channelsarray of stringnullableOptional
Surfaces the action is offered on: widget, direct_link, dashboard, api or a messaging platform. Null offers it everywhere.
Min items: 1

Responses

200
ActionResource
objectstringRequired
Alwaysaction
idintegerRequired
The action id.
chatbot_idintegerRequired
The chatbot whose model may call the action.
typestringRequired
What the action does when called. Fixed at creation.
Possible valuesbuttonhandoffnotifycollect_infohttp_requestmcpweb_searchintegration
namestringRequired
Display name, shown in the dashboard and run history.
tool_namestringRequired
The name the model calls the tool by: act__ and a slug of the tool_name or name sent at creation, unique within the chatbot (a number is appended on a clash). Fixed at creation.
descriptionstringRequired
When the model should call the action, in your words. The model reads it to decide.
enabledbooleanRequired
Whether the chatbot offers the action to its model.
is_high_riskbooleanRequired
Your high-risk flag: a high-risk call runs only after the visitor confirms it in a later turn. Some calls wait whatever this says: an http_request with POST, PUT, PATCH or DELETE, and an mcp action unless its config.low_risk is true.
configobjectnullableRequired
The type's settings as stored, after validation filled the defaults (see POST /actions). Never holds credentials.
providerstringnullableRequired
Integration actions only: the provider key from GET /integrations/catalog; null for every other type. Fixed at creation.
operationstringnullableRequired
Integration actions only: the provider operation the action runs; null for every other type. Fixed at creation.
connection_idintegernullableRequired
Integration actions only: the account connection the operation runs through; null for every other type.
channelsarray of stringnullableRequired
The surfaces the action is offered on (widget, direct_link, dashboard, api or a messaging platform); null offers it everywhere.
has_credentialsbooleanRequired
Whether any credentials are stored. Their values are never returned.
run_countintegerRequired
Runs that have ended, counted as they end. A skipped confirmation request is not counted.
success_countintegerRequired
Of those, the runs that succeeded.
success_ratenumbernullableRequired
success_count ÷ run_count, in percent with one decimal; null before the first counted run.
last_run_atstringnullableRequired
When the last counted run ended (ISO 8601, UTC); null before the first.
created_atstringnullableRequired
When the action was created (ISO 8601, UTC).
updated_atstringnullableRequired
When the action last changed (ISO 8601, UTC).
400
A tenant selector header named a tenant other than the API key's own (ACCOUNT_SELECTOR_NOT_SUPPORTED): an all-digit X-Account-Id other than the key owner's id or, while workspaces.context_enabled is on, an X-Workspace-Id other than the key's workspace (ws_ prefix optional, case-insensitive). A header naming the key's own tenant, or a non-numeric X-Account-Id, is ignored; a key cannot switch tenants, so send neither. A mutation that honours Idempotency-Key also returns INVALID_IDEMPOTENCY_KEY when that header is not 16–128 [A-Za-z0-9_-] characters.
Error codesACCOUNT_SELECTOR_NOT_SUPPORTED INVALID_IDEMPOTENCY_KEY
401
Missing or invalid API key.
Error codesUNAUTHENTICATED
403
The API key is missing a required scope.
Error codesACCOUNT_SUSPENDED INSUFFICIENT_SCOPE
404
The resource does not exist on this account.
Error codesNOT_FOUND
409
The request conflicts with the current resource state.
Error codesIDEMPOTENCY_IN_FLIGHT
422
Validation failed. See error.details.
Error codesACTION_LIMIT_REACHED IDEMPOTENCY_KEY_REUSED VALIDATION_FAILED
429
Rate limited. Honour the Retry-After header before retrying.
Error codesRATE_LIMITED
500
Unexpected server error. Retry with the same Idempotency-Key.
Error codesSERVER_ERROR

Request

curl

curl -X PATCH 'https://api.agentency.com/v1/actions/<ACTION_ID>' \
  -H "Authorization: Bearer <YOUR_KEY>" \
  -H "Content-Type: application/json"
  -d '{
  "name": "name",
  "description": "description",
  "enabled": true,
  "is_high_risk": true,
  "max_iterations": "max_iterations",
  "config": "config",
  "credentials": "credentials",
  "provider": "provider"
}'

Response

Example 200 response

json

{
  "object": "action",
  "id": 1,
  "chatbot_id": 1,
  "type": "http_request",
  "name": "Track a delivery",
  "tool_name": "act__track_a_delivery",
  "description": "Look up where a parcel is when the visitor gives a tracking number.",
  "enabled": true,
  "is_high_risk": false,
  "config": {
    "url": "https://api.example.com/shipments/{{tracking_number}}",
    "auth": {
      "type": "bearer",
      "header_name": ""
    },
    "method": "GET",
    "headers": [],
    "signing": {
      "header": "X-Signature",
      "enabled": false
    },
    "response": {
      "mode": "full"
    },
    "parameters": [
      {
        "name": "tracking_number",
        "type": "string",
        "required": true,
        "description": "The parcel tracking number, e.g. 1Z999AA10123456784"
      }
    ],
    "body_template": null,
    "egress_allowlist": []
  },
  "provider": null,
  "operation": null,
  "connection_id": null,
  "channels": null,
  "has_credentials": true,
  "run_count": 0,
  "success_count": 0,
  "success_rate": null,
  "last_run_at": null,
  "created_at": "2026-01-01T00:00:00+00:00",
  "updated_at": "2026-01-01T00:00:00+00:00"
}

/v1/actions/{id}

Delete an action

Removes the action for good: the chatbot no longer offers it to the model. Its runs stay, listed by GET /chatbots/{id}/action_runs with action_id: null.

Required scope: actions:write
Idempotency: Accepts Idempotency-Key
Webhook events: action.deleted
Rate limits

Before you call

id(path)Action id
Integer.
Placeholder in the samples: <ACTION_ID>
Get it from
- GET /v1/actions returns it as data[].id
- POST /v1/actions returns it as id
- GET /v1/chatbots/{id}/action_runs returns it as data[].action_id
- Webhook action.created carries it as data.object.id
- action.run.* events name the run, not the action: read its action_id from GET /chatbots/{id}/action_runs.

Path parameters

idintegerRequired
The action id.

Header parameters

Idempotency-KeystringOptional
Makes a retry safe. The first 2xx answer is stored for 24 h and replayed for the same key with Idempotency-Replayed: true; a retry while the first request runs is 409 IDEMPOTENCY_IN_FLIGHT; the same key with a different payload is 422 IDEMPOTENCY_KEY_REUSED; a malformed key is 400 INVALID_IDEMPOTENCY_KEY.
Min length: 16Max length: 128Pattern: ^[A-Za-z0-9_-]+$

Responses

200
Success.
objectstringRequired
Alwaysaction
idintegerRequired
The deleted action's id.
deletedbooleanRequired
Always true.
400
A tenant selector header named a tenant other than the API key's own (ACCOUNT_SELECTOR_NOT_SUPPORTED): an all-digit X-Account-Id other than the key owner's id or, while workspaces.context_enabled is on, an X-Workspace-Id other than the key's workspace (ws_ prefix optional, case-insensitive). A header naming the key's own tenant, or a non-numeric X-Account-Id, is ignored; a key cannot switch tenants, so send neither. A mutation that honours Idempotency-Key also returns INVALID_IDEMPOTENCY_KEY when that header is not 16–128 [A-Za-z0-9_-] characters.
Error codesACCOUNT_SELECTOR_NOT_SUPPORTED INVALID_IDEMPOTENCY_KEY
401
Missing or invalid API key.
Error codesUNAUTHENTICATED
403
The API key is missing a required scope.
Error codesACCOUNT_SUSPENDED INSUFFICIENT_SCOPE
404
The resource does not exist on this account.
Error codesNOT_FOUND
409
The request conflicts with the current resource state.
Error codesIDEMPOTENCY_IN_FLIGHT
422
Validation failed. See error.details.
Error codesIDEMPOTENCY_KEY_REUSED
429
Rate limited. Honour the Retry-After header before retrying.
Error codesRATE_LIMITED
500
Unexpected server error. Retry with the same Idempotency-Key.
Error codesSERVER_ERROR

Request

curl

curl -X DELETE 'https://api.agentency.com/v1/actions/<ACTION_ID>' \
  -H "Authorization: Bearer <YOUR_KEY>" \
  -H "Content-Type: application/json"

Response

Example 200 response

json

{
  "object": "action",
  "id": 1,
  "deleted": true
}

/v1/actions/{id}/runs

List an action's runs

Returns every call the model made to this action in a conversation, newest first and cursor-paginated: each run's id, status and start time. A dry run from POST /actions/{id}/test is not a run. To be told as runs end, subscribe to action.run.succeeded and action.run.failed.

Required scope: actions:read
Idempotency: Read-only
Rate limits

Before you call

id(path)Action id
Integer.
Placeholder in the samples: <ACTION_ID>
Get it from
- GET /v1/actions returns it as data[].id
- POST /v1/actions returns it as id
- GET /v1/chatbots/{id}/action_runs returns it as data[].action_id
- Webhook action.created carries it as data.object.id
- action.run.* events name the run, not the action: read its action_id from GET /chatbots/{id}/action_runs.

Path parameters

idintegerRequired
The action id.

Query parameters

limitintegerOptional
Page size, clamped to 1–100.
Default: 20Minimum: 1Maximum: 100
starting_afterstringOptional
Cursor from a previous page's next_cursor: returns the page after it. A cursor minted for another list, sort or order is 422 INVALID_CURSOR.
ending_beforestringOptional
Cursor from a previous page's previous_cursor: returns the page before it. Wins when both cursors are sent.
created[gte]stringOptional
Only rows created on or after this instant: YYYY-MM-DD (whole UTC day) or an RFC 3339 timestamp with a zone. Anything else is 422 INVALID_PARAMETER.
created[lte]stringOptional
Only rows created on or before this instant: YYYY-MM-DD (whole UTC day) or an RFC 3339 timestamp with a zone. Anything else is 422 INVALID_PARAMETER.

Responses

200
Success.
objectstringRequired
Alwayslist
dataarray of ActionRunResourceRequired
has_morebooleanRequired
next_cursorstringnullableRequired
previous_cursorstringnullableRequired
urlstringRequired
400
A tenant selector header named a tenant other than the API key's own (ACCOUNT_SELECTOR_NOT_SUPPORTED): an all-digit X-Account-Id other than the key owner's id or, while workspaces.context_enabled is on, an X-Workspace-Id other than the key's workspace (ws_ prefix optional, case-insensitive). A header naming the key's own tenant, or a non-numeric X-Account-Id, is ignored; a key cannot switch tenants, so send neither.
Error codesACCOUNT_SELECTOR_NOT_SUPPORTED
401
Missing or invalid API key.
Error codesUNAUTHENTICATED
403
The API key is missing a required scope.
Error codesACCOUNT_SUSPENDED INSUFFICIENT_SCOPE
404
The resource does not exist on this account.
Error codesNOT_FOUND
422
Validation failed. See error.details.
Error codesINVALID_CURSOR INVALID_PARAMETER
429
Rate limited. Honour the Retry-After header before retrying.
Error codesRATE_LIMITED
500
Unexpected server error. Retry with the same Idempotency-Key.
Error codesSERVER_ERROR

Request

curl

curl -X GET 'https://api.agentency.com/v1/actions/<ACTION_ID>/runs' \
  -H "Authorization: Bearer <YOUR_KEY>" \
  -H "Content-Type: application/json"

Response

Example 200 response

json

{
  "object": "list",
  "data": [
    {
      "object": "action_run",
      "id": 1,
      "action_id": 1,
      "status": "success",
      "created_at": "2026-01-01T00:00:00+00:00"
    }
  ],
  "has_more": false,
  "next_cursor": null,
  "previous_cursor": null,
  "url": "/v1/actions/1/runs"
}

/v1/chatbots/{id}/action_runs

List a chatbot's action runs

Returns the runs of every action of one chatbot, newest first and cursor-paginated — including the runs of actions since deleted, whose action_id is null.

Required scope: actions:read
Idempotency: Read-only
Rate limits

Before you call

id(path)Chatbot id
Integer.
Placeholder in the samples: <CHATBOT_ID>
Get it from
- GET /v1/chatbots returns it as data[].id
- POST /v1/chatbots returns it as id
- GET /v1/chatbots/by_handle/{handle} returns it as id
- Webhook chatbot.created carries it as data.object.id
- In the dashboard, it is the number in a chatbot's address: /dashboard/chatbots/{id}.

Path parameters

idintegerRequired
The chatbot id.

Query parameters

limitintegerOptional
Page size, clamped to 1–100.
Default: 20Minimum: 1Maximum: 100
starting_afterstringOptional
Cursor from a previous page's next_cursor: returns the page after it. A cursor minted for another list, sort or order is 422 INVALID_CURSOR.
ending_beforestringOptional
Cursor from a previous page's previous_cursor: returns the page before it. Wins when both cursors are sent.
created[gte]stringOptional
Only rows created on or after this instant: YYYY-MM-DD (whole UTC day) or an RFC 3339 timestamp with a zone. Anything else is 422 INVALID_PARAMETER.
created[lte]stringOptional
Only rows created on or before this instant: YYYY-MM-DD (whole UTC day) or an RFC 3339 timestamp with a zone. Anything else is 422 INVALID_PARAMETER.

Responses

200
Success.
objectstringRequired
Alwayslist
dataarray of ActionRunResourceRequired
has_morebooleanRequired
next_cursorstringnullableRequired
previous_cursorstringnullableRequired
urlstringRequired
400
A tenant selector header named a tenant other than the API key's own (ACCOUNT_SELECTOR_NOT_SUPPORTED): an all-digit X-Account-Id other than the key owner's id or, while workspaces.context_enabled is on, an X-Workspace-Id other than the key's workspace (ws_ prefix optional, case-insensitive). A header naming the key's own tenant, or a non-numeric X-Account-Id, is ignored; a key cannot switch tenants, so send neither.
Error codesACCOUNT_SELECTOR_NOT_SUPPORTED
401
Missing or invalid API key.
Error codesUNAUTHENTICATED
403
The API key is missing a required scope.
Error codesACCOUNT_SUSPENDED INSUFFICIENT_SCOPE
404
The resource does not exist on this account.
Error codesNOT_FOUND
422
Validation failed. See error.details.
Error codesINVALID_CURSOR INVALID_PARAMETER
429
Rate limited. Honour the Retry-After header before retrying.
Error codesRATE_LIMITED
500
Unexpected server error. Retry with the same Idempotency-Key.
Error codesSERVER_ERROR

Request

curl

curl -X GET 'https://api.agentency.com/v1/chatbots/<CHATBOT_ID>/action_runs' \
  -H "Authorization: Bearer <YOUR_KEY>" \
  -H "Content-Type: application/json"

Response

Example 200 response

json

{
  "object": "list",
  "data": [
    {
      "object": "action_run",
      "id": 1,
      "action_id": 1,
      "status": "success",
      "created_at": "2026-01-01T00:00:00+00:00"
    }
  ],
  "has_more": false,
  "next_cursor": null,
  "previous_cursor": null,
  "url": "/v1/chatbots/1/action_runs"
}

/v1/actions/{id}/test

Dry-run an action

Shows what the action would do, without doing it. Two ways: With message: asks the chatbot's model — with this action as its only tool and the knowledge a live turn would retrieve — whether it would call the action for that visitor message (invoked) and with which arguments, then dry-runs the action with them. With arguments only: skips the model and dry-runs the action with your arguments, to check its config and templating. A dry run makes no outbound call — no request to your URL or MCP server, no email — records no run and emits no event; request_summary shows the call a live run would make. When the chatbot's model cannot call tools, message is ignored and invoked is null. A message probe is a real model completion, and this endpoint does NOT accept Idempotency-Key: every call with a message — including an automatic client retry after a timeout — runs and pays for another completion. Retry only when you would accept a second cost. The completion counts against the chatbot's monthly AI budget (402 CHATBOT_BUDGET_EXCEEDED / USER_BUDGET_EXCEEDED once it is spent) and needs message credits left (402 MESSAGE_CREDITS_EXCEEDED), though it uses none. An arguments-only dry run is never billing-gated. 404 ACTIONS_DISABLED while Call Actions are switched off platform-wide.

Required scope: actions:write
Webhook events: None
Rate limits

Before you call

id(path)Action id
Integer.
Placeholder in the samples: <ACTION_ID>
Get it from
- GET /v1/actions returns it as data[].id
- POST /v1/actions returns it as id
- GET /v1/chatbots/{id}/action_runs returns it as data[].action_id
- Webhook action.created carries it as data.object.id
- action.run.* events name the run, not the action: read its action_id from GET /chatbots/{id}/action_runs.

Path parameters

idintegerRequired
The action id.

Request body

messagestringnullableOptional
A visitor message, at most 4000 characters: the model decides whether it would call the action for it. A real, paid model completion (see the operation description).
Max length: 4000
argumentsobjectOptional
Arguments for the action, keyed by config.parameters name: dry-run with these and skip the model. Also the fallback when the model, given message, does not call the action. At most 50 top-level keys, 5 levels of nesting and 16 KB as JSON; larger is 422 VALIDATION_FAILED.

Responses

200
Success.
objectstringRequired
Alwaysaction_test
idintegerRequired
The action id.
invokedbooleannullableRequired
Whether the model called the action for message — false also when the model could not be reached. null when no model was asked (no message, or a model that cannot call tools).
argumentsobjectnullableRequired
The arguments the dry run used: the model's when it called the action, otherwise the ones you sent. null when there were none.
assistant_messagestringnullableRequired
The text the model answered with — when it did not call the action, its reply to the visitor, which usually shows why. null when it wrote none or no model was asked.
statusstringRequired
How the dry run ended: success; pending for handoff and notify, whose email a live run would queue; or failed, with error_code. A dry run skips the confirmation and rate gates of a live run.
Possible valuessuccessfailedskippedconfirmation_pendingpendingtimed_out
model_contentstringRequired
The tool result the model would read back.
metadataobjectRequired
What the chat would act on: for button its label, url and open_in_new_tab; for handoff handoff_requested, handoff_reason and message_to_visitor.
error_codestringnullableRequired
Why the dry run failed — invalid_arguments (the arguments do not fit config.parameters) or invalid_config; null otherwise.
request_summaryobjectnullableRequired
The call a live run would make, without secrets: method and host for http_request, host and tool for mcp, each with dry_run: true. null for the types that call nothing.
response_summaryobjectnullableRequired
What the action reports without calling anything — the label of a button, the fields a collect_info would save. null for http_request and mcp: a dry run sends no request, so there is no response.
probe_contextstringnullableRequired
Which prompt the model was asked with: knowledge when retrieval found something for message, no_knowledge when it did not. null when no model was asked.
Possible valuesknowledgeno_knowledgenull
knowledge_chunksintegerRequired
How many knowledge chunks the message probe retrieved; 0 when no model was asked.
400
A tenant selector header named a tenant other than the API key's own (ACCOUNT_SELECTOR_NOT_SUPPORTED): an all-digit X-Account-Id other than the key owner's id or, while workspaces.context_enabled is on, an X-Workspace-Id other than the key's workspace (ws_ prefix optional, case-insensitive). A header naming the key's own tenant, or a non-numeric X-Account-Id, is ignored; a key cannot switch tenants, so send neither.
Error codesACCOUNT_SELECTOR_NOT_SUPPORTED
401
Missing or invalid API key.
Error codesUNAUTHENTICATED
402
A billing gate refused the request (plan limit, monthly AI budget or message credits). See error.code.
Error codesCHATBOT_BUDGET_EXCEEDED MESSAGE_CREDITS_EXCEEDED USER_BUDGET_EXCEEDED
403
The API key is missing a required scope.
Error codesACCOUNT_SUSPENDED INSUFFICIENT_SCOPE
404
The resource does not exist on this account.
Error codesACTIONS_DISABLED NOT_FOUND
422
Validation failed. See error.details.
Error codesVALIDATION_FAILED
429
Rate limited. Honour the Retry-After header before retrying.
Error codesRATE_LIMITED
500
Unexpected server error. Retry with the same Idempotency-Key.
Error codesSERVER_ERROR

Request

curl

curl -X POST 'https://api.agentency.com/v1/actions/<ACTION_ID>/test' \
  -H "Authorization: Bearer <YOUR_KEY>" \
  -H "Content-Type: application/json"
  -d '{
  "message": "message",
  "arguments": "arguments"
}'

Response

Example 200 response

json

{
  "object": "action_test",
  "id": 1,
  "invoked": null,
  "arguments": {
    "tracking_number": "1Z999AA10123456784"
  },
  "assistant_message": null,
  "status": "success",
  "model_content": "(dry run) The request was not sent.",
  "metadata": [],
  "error_code": null,
  "request_summary": {
    "method": "GET",
    "host": "api.example.com",
    "dry_run": true
  },
  "response_summary": null,
  "probe_context": null,
  "knowledge_chunks": 0
}

/v1/actions/mcp/discover

List an MCP server's tools

Asks the MCP server at server_url for its tools (tools/list) and returns them, so you can create one mcp action per tool. token, when sent, goes to the server as a bearer token and is not stored: put it in the action's credentials.token. The server URL passes the same address checks as any outbound call. 404 MCP_NOT_ENABLED while MCP actions are switched off platform-wide; 422 MCP_DISCOVERY_FAILED when the server cannot be listed. Not idempotency-gated: every call contacts the server.

Required scope: actions:write
Webhook events: None
Rate limits

Request body

server_urlstringRequired
The MCP server's http(s) URL, at most 2048 characters. A private or internal address is refused.
Format: uriMax length: 2048Pattern: ^https?:\/\/
tokenstringnullableOptional
A bearer token the server needs, at most 2048 characters. Sent with this request only, never stored.
Max length: 2048

Responses

200
Success.
objectstringRequired
Alwayslist
dataarray of objectRequired
The server's tools, each exactly as its tools/list answer gives it: name, and usually description and inputSchema. Create one action per tool you want, with type: mcp, config.tool set to its name and config.parameters from its inputSchema.
has_morebooleanRequired
next_cursoranynullableRequired
previous_cursoranynullableRequired
urlstringRequired
Always/v1/actions/mcp/discover
400
A tenant selector header named a tenant other than the API key's own (ACCOUNT_SELECTOR_NOT_SUPPORTED): an all-digit X-Account-Id other than the key owner's id or, while workspaces.context_enabled is on, an X-Workspace-Id other than the key's workspace (ws_ prefix optional, case-insensitive). A header naming the key's own tenant, or a non-numeric X-Account-Id, is ignored; a key cannot switch tenants, so send neither.
Error codesACCOUNT_SELECTOR_NOT_SUPPORTED
401
Missing or invalid API key.
Error codesUNAUTHENTICATED
403
The API key is missing a required scope.
Error codesACCOUNT_SUSPENDED INSUFFICIENT_SCOPE
404
The resource does not exist on this account.
Error codesMCP_NOT_ENABLED
422
Validation failed. See error.details.
Error codesMCP_DISCOVERY_FAILED VALIDATION_FAILED
429
Rate limited. Honour the Retry-After header before retrying.
Error codesRATE_LIMITED
500
Unexpected server error. Retry with the same Idempotency-Key.
Error codesSERVER_ERROR

Request

curl

curl -X POST 'https://api.agentency.com/v1/actions/mcp/discover' \
  -H "Authorization: Bearer <YOUR_KEY>" \
  -H "Content-Type: application/json"
  -d '{
  "server_url": "server_url",
  "token": "token"
}'

Response

Example 200 response

json

{
  "object": "list",
  "data": [
    {
      "name": "search_orders",
      "description": "Find orders by customer email.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "email": {
            "type": "string"
          }
        },
        "required": [
          "email"
        ]
      },
      "annotations": [],
      "param_headers": []
    }
  ],
  "has_more": false,
  "next_cursor": null,
  "previous_cursor": null,
  "url": "/v1/actions/mcp/discover"
}

About Actions

IDs on this page

/v1/actions/types

Responses

See also

Request

Response

/v1/actions

Query parameters

Responses

See also

Request

Response

/v1/actions

Header parameters

Request body

Responses

See also

Request

Response

/v1/actions/{id}

Path parameters

Responses

See also

Request

Response

/v1/actions/{id}

Path parameters

Header parameters

Request body

Responses

See also

Request

Response

/v1/actions/{id}

Path parameters

Header parameters

Responses

See also

Request

Response

/v1/actions/{id}/runs

Path parameters

Query parameters

Responses

See also

Request

Response

/v1/chatbots/{id}/action_runs

Path parameters

Query parameters

Responses

See also

Request

Response

/v1/actions/{id}/test

Path parameters

Request body

Responses

See also

Request

Response

/v1/actions/mcp/discover

Request body

Responses

See also

Request

Response