Chat API

Introduction
Endpoints

Botpress API

Introduction
Authentication
Conversations
Conversation participants
Conversation events
Conversation messages
Conversation users
Integrations
Account management
Hub
Bots
Workspaces
Usages
Files
Tables

Human in the Loop API Integration

How to use the Botpress Human in the Loop API Integration
Endpoints to implement
Calling the API

Chat API

Introduction
Endpoints

Botpress API

Introduction
Authentication
Conversations
Conversation participants
Conversation events
Conversation messages
Conversation users
Integrations
Account management
Hub
Bots
Workspaces
Usages
Files
Tables

Human in the Loop API Integration

How to use the Botpress Human in the Loop API Integration
Endpoints to implement
Calling the API

List Integrations

get https://api.botpress.cloud/v1/admin/integrations

List integrations

URL Expired

The URL for this request expired after 30 days.

Query Params

nextToken

string

Provide the meta.nextToken value provided in the last API response to retrieve the next page of results

name

string

Integration Name

version

string

Integration version. Either a semver version or tag "latest"

dev

boolean

If true, only dev integrations are returned. Otherwise, only production integrations are returned.

Headers

x-workspace-id

string

required

Workspace ID

Responses

Response body

object

integrations

array of objects

required

integrations*

object

string

required

length between 28 and 36

ID of the Integration

name

string

required

length ≤ 200

Name of the Integration

version

string

required

length ≤ 200

Version of the Integration

createdAt

date-time

required

Creation date of the Integration in ISO 8601 format

updatedAt

date-time

required

Updating date of the Integration in ISO 8601 format

title

string

required

length between 1 and 64

Title of the integration. This is the name that will be displayed in the UI

description

string

required

length ≤ 256

Description of the integration. This is the description that will be displayed in the UI

iconUrl

string

required

URL of the icon of the integration. This is the icon that will be displayed in the UI

public

boolean

required

Idicates if the integration is public. Public integrations are available to all and cannot be updated without creating a new version.

verificationStatus

string

required

Status of the integration version verification

unapproved pending approved rejected

meta

object

required

nextToken

string

The token to use to retrieve the next page of results, passed as a query string parameter (value should be URL-encoded) to this API endpoint.

Updated 5 months ago

Create Integration

Update Integration

Did this page help you?

Language

Credentials

Bearer

PAT


xxxxxxxxxx
1
curl --request GET \
2
     --url https://api.botpress.cloud/v1/admin/integrations \
3
     --header 'accept: application/json'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

Updated 5 months ago

Create Integration

Update Integration

Did this page help you?

Chat API
Introduction
Endpoints
Create Eventpost
Get Eventget
Delete Userdelete
Update Userput
Get Userget
Create Messagepost
Delete Messagedelete
Get Messageget
Get Participantget
Remove Participantdelete
List Participantsget
Add Participantpost
List Messagesget
Listen Conversationget
Get Or Create Conversationpost
List Conversationsget
Create Conversationpost
Delete Conversationdelete
Get Conversationget
Get Or Create Userpost
Create Userpost

Botpress API
Introduction
Authentication
Conversations
Get Or Create Conversationpost
Delete Conversationdelete
Update Conversationput
Get Conversationget
List Conversationsget
Create Conversationpost
Conversation participants
Remove Participantdelete
Get Participantget
Add Participantpost
List Participantsget
Conversation events
Get Eventget
List Eventsget
Create Eventpost
Conversation messages
Delete Messagedelete
Update Messageput
Get Messageget
Get Or Create Messagepost
List Messagesget
Create Messagepost
Conversation users
Get Or Create Userpost
Delete Userdelete
Update Userput
Get Userget
List Usersget
Create Userpost
Integrations
Request Integration Verificationpost
Get Integration By Nameget
Get Integration Logsget
Delete Integrationdelete
Get Integrationget
Update Integrationput
List Integrationsget
Create Integrationpost
Delete Integration Api Keydelete
Create Integration Api Keypost
List Integration Api Keysget
Configure Integrationpost
Account management
Delete Personal Access Tokendelete
Create Personal Access Tokenpost
List Personal Access Tokensget
Update Accountput
Get Accountget
Hub
Get Public Integrationget
Get Public Integration By Idget
List Public Integrationsget
Bots
Deploy Bot Versionpost
Get Bot Versionget
Create Bot Versionpost
List Bot Versionsget
List Bot Issue Eventsget
List Bot Issuesget
Delete Bot Issuedelete
Get Bot Issueget
Get Bot Analyticsget
Get Bot Logsget
Delete Botdelete
Get Botget
Update Botput
List Botsget
Create Botpost
Workspaces
Update Workspace Memberput
Delete Workspace Memberdelete
Get Workspace Memberget
Create Workspace Memberpost
List Workspace Membersget
Get Audit Recordsget
List Public Workspacesget
List Workspace Quotasget
Get Workspace Quotaget
Break Down Workspace Usage By Botget
List Workspace Usagesget
Delete Workspacedelete
Update Workspaceput
Get Workspaceget
Get Public Workspaceget
List Workspacesget
Create Workspacepost
Usages
List Usage Activityget
List Usage Historyget
Get Usageget
Files
List File Passagesget
Search Filesget
Update File Metadataput
Get Fileget
Delete Filedelete
List Filesget
Upsert Fileput
What is the Files API?
Tables
Upsert Table Rowspost
Delete Table Rowspost
Update Table Rowsput
Create Table Rowspost
Find Table Rowspost
Get Table Rowget
Rename Table Columnput
Duplicate Tablepost
Delete Tabledelete
Update Tableput
Get Or Create Tablepost
Get Tableget
Create Tablepost
List Tablesget

Human in the Loop API Integration
How to use the Botpress Human in the Loop API Integration
Endpoints to implement
Send a message to the agentpost
Create a userpost
Close a ticketpost
Create a conversation in your servicepost
Ping your servicepost
Calling the API
Stop the human-in-the-loop (HITL) session and close the ticket.post
Notify that an agent was assigned to a conversation.post
Send a message from the agent to the bot.post

Chat API
Introduction
Endpoints
Create Eventpost
Get Eventget
Delete Userdelete
Update Userput
Get Userget
Create Messagepost
Delete Messagedelete
Get Messageget
Get Participantget
Remove Participantdelete
List Participantsget
Add Participantpost
List Messagesget
Listen Conversationget
Get Or Create Conversationpost
List Conversationsget
Create Conversationpost
Delete Conversationdelete
Get Conversationget
Get Or Create Userpost
Create Userpost

Botpress API
Introduction
Authentication
Conversations
Get Or Create Conversationpost
Delete Conversationdelete
Update Conversationput
Get Conversationget
List Conversationsget
Create Conversationpost
Conversation participants
Remove Participantdelete
Get Participantget
Add Participantpost
List Participantsget
Conversation events
Get Eventget
List Eventsget
Create Eventpost
Conversation messages
Delete Messagedelete
Update Messageput
Get Messageget
Get Or Create Messagepost
List Messagesget
Create Messagepost
Conversation users
Get Or Create Userpost
Delete Userdelete
Update Userput
Get Userget
List Usersget
Create Userpost
Integrations
Request Integration Verificationpost
Get Integration By Nameget
Get Integration Logsget
Delete Integrationdelete
Get Integrationget
Update Integrationput
List Integrationsget
Create Integrationpost
Delete Integration Api Keydelete
Create Integration Api Keypost
List Integration Api Keysget
Configure Integrationpost
Account management
Delete Personal Access Tokendelete
Create Personal Access Tokenpost
List Personal Access Tokensget
Update Accountput
Get Accountget
Hub
Get Public Integrationget
Get Public Integration By Idget
List Public Integrationsget
Bots
Deploy Bot Versionpost
Get Bot Versionget
Create Bot Versionpost
List Bot Versionsget
List Bot Issue Eventsget
List Bot Issuesget
Delete Bot Issuedelete
Get Bot Issueget
Get Bot Analyticsget
Get Bot Logsget
Delete Botdelete
Get Botget
Update Botput
List Botsget
Create Botpost
Workspaces
Update Workspace Memberput
Delete Workspace Memberdelete
Get Workspace Memberget
Create Workspace Memberpost
List Workspace Membersget
Get Audit Recordsget
List Public Workspacesget
List Workspace Quotasget
Get Workspace Quotaget
Break Down Workspace Usage By Botget
List Workspace Usagesget
Delete Workspacedelete
Update Workspaceput
Get Workspaceget
Get Public Workspaceget
List Workspacesget
Create Workspacepost
Usages
List Usage Activityget
List Usage Historyget
Get Usageget
Files
List File Passagesget
Search Filesget
Update File Metadataput
Get Fileget
Delete Filedelete
List Filesget
Upsert Fileput
What is the Files API?
Tables
Upsert Table Rowspost
Delete Table Rowspost
Update Table Rowsput
Create Table Rowspost
Find Table Rowspost
Get Table Rowget
Rename Table Columnput
Duplicate Tablepost
Delete Tabledelete
Update Tableput
Get Or Create Tablepost
Get Tableget
Create Tablepost
List Tablesget

Human in the Loop API Integration
How to use the Botpress Human in the Loop API Integration
Endpoints to implement
Send a message to the agentpost
Create a userpost
Close a ticketpost
Create a conversation in your servicepost
Ping your servicepost
Calling the API
Stop the human-in-the-loop (HITL) session and close the ticket.post
Notify that an agent was assigned to a conversation.post
Send a message from the agent to the bot.post

200Success

defaultSuccess