curl --request PUT \
--url https://api.botpress.cloud/v1/admin/bots/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'x-workspace-id: <x-workspace-id>' \
--data '
{
"url": "<string>",
"authentication": "iam",
"configuration": {
"data": {},
"schema": {}
},
"tags": {},
"blocked": true,
"maxExecutionTime": 123,
"alwaysAlive": true,
"user": {
"tags": {}
},
"message": {
"tags": {}
},
"conversation": {
"tags": {}
},
"events": {},
"actions": {},
"states": {},
"recurringEvents": {},
"integrations": {},
"plugins": {},
"subscriptions": {
"events": {}
},
"code": "<string>",
"name": "<string>",
"medias": [
{
"url": "<string>",
"name": "<string>"
}
],
"layers": [
"<string>"
],
"shouldMergePlugins": true
}
'{
"bot": {
"id": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"signingSecret": "<string>",
"integrations": {},
"plugins": {},
"user": {
"tags": {}
},
"conversation": {
"tags": {}
},
"message": {
"tags": {}
},
"states": {},
"configuration": {
"data": {},
"schema": {}
},
"events": {},
"recurringEvents": {},
"subscriptions": {
"events": {}
},
"actions": {},
"tags": {},
"name": "<string>",
"dev": true,
"alwaysAlive": true,
"status": "active",
"medias": [
{
"url": "<string>",
"name": "<string>"
}
],
"maxExecutionTime": 123,
"deployedAt": "2023-11-07T05:31:56Z",
"createdBy": "<string>"
}
}Update bot
curl --request PUT \
--url https://api.botpress.cloud/v1/admin/bots/{id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'x-workspace-id: <x-workspace-id>' \
--data '
{
"url": "<string>",
"authentication": "iam",
"configuration": {
"data": {},
"schema": {}
},
"tags": {},
"blocked": true,
"maxExecutionTime": 123,
"alwaysAlive": true,
"user": {
"tags": {}
},
"message": {
"tags": {}
},
"conversation": {
"tags": {}
},
"events": {},
"actions": {},
"states": {},
"recurringEvents": {},
"integrations": {},
"plugins": {},
"subscriptions": {
"events": {}
},
"code": "<string>",
"name": "<string>",
"medias": [
{
"url": "<string>",
"name": "<string>"
}
],
"layers": [
"<string>"
],
"shouldMergePlugins": true
}
'{
"bot": {
"id": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"signingSecret": "<string>",
"integrations": {},
"plugins": {},
"user": {
"tags": {}
},
"conversation": {
"tags": {}
},
"message": {
"tags": {}
},
"states": {},
"configuration": {
"data": {},
"schema": {}
},
"events": {},
"recurringEvents": {},
"subscriptions": {
"events": {}
},
"actions": {},
"tags": {},
"name": "<string>",
"dev": true,
"alwaysAlive": true,
"status": "active",
"medias": [
{
"url": "<string>",
"name": "<string>"
}
],
"maxExecutionTime": 123,
"deployedAt": "2023-11-07T05:31:56Z",
"createdBy": "<string>"
}
}Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Workspace ID
Whether the client supports bots with multiple instances of the same integration. Set to "true" to receive integration instances keyed by their alias instead of their id. This header will be removed in the future, and the API will always return multiple instances keyed by alias.
Bot ID
Bot metadata
Show child attributes
Maximum execution time (in seconds).
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
A mapping of plugin aliases to their configuration
Show child attributes
Show child attributes
JavaScript code of the bot
Optional name for the bot, if not provided will be auto-generated
1UNUSED. Please ignore this field. It will be removed in the near future.
Success
Show child attributes
Was this page helpful?