Skip to main content
GET
Get an action

Authorizations

Authorization
string
header
required

API key from your account settings

Path Parameters

agentId
string
required

The agent ID

Minimum string length: 1
Example:

"5QHA6VB-DIAbBhxwqxfdi"

actionId
string<uuid>
required

The action ID

Example:

"3f1c2a9e-8b7d-4c1e-9f0a-2d6b7e8c9a10"

Response

The action

id
string
required

Action ID

name
string
required

Action name, unique within the agent

type
enum<string>
required

Action type

Available options:
collect-leads,
collect-data,
custom-button,
custom-action,
shopify-get-cart,
shopify-update-cart,
shopify-place-order,
shopify-exchange,
shopify-show-product,
shopify-show-order,
shopify-update-profile,
shopify-update-address,
shopify-account-access,
shopify-get-metafields,
shopify-tag-order,
shopify-create-return,
magento-show-product,
slack-notify,
stripe-get-subscription-info,
stripe-get-invoices,
stripe-change-billing-address,
stripe-manage-subscription,
stripe-find-payments,
stripe-refund-payment,
chatbase-update-chatbot-settings,
calcom-get-slots,
calendly-get-slots,
tavily-web-search,
sunshine-live-chat,
zendesk-messaging-live-chat,
freshchat-live-chat,
salesforce-live-chat,
chatbase-live-chat,
customize-suggested-messages,
custom-form,
create-ticket,
transfer-to-phone-number,
human-in-the-loop
Example:

"custom-action"

status
enum<string>
required

Whether the agent can use the action. draft means its setup isn't complete, so the agent can't use it.

Available options:
enabled,
disabled,
draft
procedureOnly
boolean
required

Whether the action runs only when a procedure calls it

whenToUse
string | null
required

Tells the agent when to call the action. Null when it is not set.

fields
object[]
required

What the action collects. input fields are the editable list, except on create-ticket actions, where they cannot be changed. form fields are the collect-leads form (description is the label) and widget fields are the linked widget variables; both are shown and cannot be changed. Built-in fields and a shared ticket form are not included.

channels
object[]
required

Channels the action can be switched on or off for, as on the Deploy page. New channels may be added.