Assistants

Create and delete assistant actions in bulk

Create and delete multiple assistant actions in a single request.

post/orgs/assistants/{assistant_id}/actions/bulk

Request

Base URL: https://api.useinvent.com
URL: https://api.useinvent.com/orgs/assistants/{assistant_id}/actions/bulk
Auth: HTTP bearer

Path parameters

assistant_idstring required

The ID of the assistant

Query parameters

pagenumber

Page number

takenumber

Number of items to take

nextstring

Next page token (Only used on special endpoints)

progressiveboolean

Skip the total count: pagination-count is exact on the last page, and one more than the items so far while more pages exist (Only used on special endpoints)

Request body

deletestring[]

IDs of actions to delete

Example request

{
  "create": [
    {
      "connection_id": "con_XXX"
    }
  ]
}

Response

All assistant actions after the changes.

idstring required

The ID of the action

enabledboolean required

Whether the action is enabled

namestring nullable required

The name of the action

instructionsstring nullable required

The instructions for the action

action_idstring required

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

assistant_idstring required

The ID of the assistant

connection_idstring nullable required

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

approval_mode'auto' | 'ask' | 'never' required

When the assistant must ask before running the action

positioninteger 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_atstring date-time nullable required

updated_atstring date-time nullable required

Example response

[
  {
    "action_id": "TOOLS:HTTP_REQUEST",
    "assistant_id": "ast_XXX",
    "connection_id": "con_XXX"
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.