Skip to main content
POST
Bulk Assistant Actions

Authorizations

Authorization
string
header
required

Bearer token authentication using your API key

Path Parameters

org_id
string
required

The ID of the org

assistant_id
string
required

The ID of the assistant

Query Parameters

page
number

Page number

take
number

Number of items to take

next
string

Next page token (Only used on special endpoints)

Body

The actions to create and the action IDs to delete.

Schema for creating and deleting assistant actions in bulk

create
object[]

Actions to create

Maximum array length: 64
delete
string[]

IDs of actions to delete

Maximum array length: 64

Response

200 - application/json

All assistant actions after the changes.

id
string
required

The ID of the action

enabled
boolean
required

Whether the action is enabled

name
string | null
required

The name of the action

instructions
string | null
required

The instructions for the action

action_id
string
required

The ID of the action, e.g. "TOOLS:HTTP_REQUEST"

Examples:

"TOOLS:HTTP_REQUEST"

"TOOLS:WEB_SEARCH"

"TOOLS:WEB_SCRAPING"

assistant_id
string
required

The ID of the assistant

Example:

"ast_XXX"

connection_id
string | null
required

The ID of the connection to use for the action if required

Example:

"con_XXX"

config
object
required

The input values with their dynamic field definitions

approval_mode
enum<string>
required

When the assistant must ask before running the action

Available options:
auto,
ask,
never
position
integer
required

The position of the action within its group. Bucketed in multiples of 100, e.g. 100, 101, 102 for the first group, 200, 201, 202 for the second

created_at
string<date-time> | null
required
updated_at
string<date-time> | null
required