Skip to main content
Custom actions let the AI agent call external APIs during a conversation. When a user asks “Where is my order?” the agent can call your order-lookup API and return the real answer.

Action types

Import an OpenAPI (Swagger) specification to automatically create actions for each endpoint.
1

Go to Actions

Navigate to Actions in the dashboard sidebar.
2

Import OpenAPI spec

Click Import OpenAPI and paste your spec URL or upload the JSON/YAML file (max 2 MB, spec body max 500K characters).
3

Select endpoints

Choose which endpoints to expose to the agent. Each becomes a callable tool.
The agent sees each endpoint as a tool with the operation’s summary as the description and the request schema as parameters.

User tokens

If your API requires user-specific authentication, the widget can forward custom headers to action endpoints via userTokens:
User tokens are forwarded to action endpoints as-is. Only configure tokens for APIs you trust. Max 10 token keys, each value up to 4096 characters.

Limits