Answer API
Answers are what we return when the conversation API identifies what the user's request are, according to our dialog manager.
Pagination and search
Searches and paginates through expected answers -- those being of type 'TYPE_ANSWER' and 'WELCOME_MESSAGE'.
A valid uuid of an organization
A valid uuid of an environment
The UUID of the bot whose entities you are searching
Term being searched. This expects one optional String matching the name of an answer.
Current page, starting at 1
1
Example: 1
Size of the page
5
Example: 1
Criteria to order result, defaulted to updatedAt date. Possible fields include name, createdAt, updatedAt, createdBy and updatedBy.
updatedAt
Order direction(ASC/DESC), defaulted to DESC
DESC
GET /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/answer?page=1&size=5 HTTP/1.1
Host:
Accept: */*
{
"totalPages": 1,
"totalElements": 1,
"first": true,
"last": true,
"pageable": {
"paged": true,
"unpaged": true,
"pageNumber": 1,
"pageSize": 1,
"sort": {
"unsorted": true,
"sorted": true,
"empty": true
},
"offset": 1
},
"numberOfElements": 1,
"sort": {
"unsorted": true,
"sorted": true,
"empty": true
},
"size": 1,
"content": [
{
"answer": {
"id": "text",
"name": "text",
"description": "text",
"evaluable": 1,
"transactional": 1,
"updatedAt": "2025-06-30T22:27:37.760Z",
"updatedBy": "text",
"tags": [
{
"uuid": "text",
"name": "text"
}
],
"webhook": "text",
"type": "text",
"headers": {},
"answerTemplates": [
{
"id": "text",
"content": {
"content": {},
"description": "text",
"type": "text",
"buttons": [
{}
],
"quickReply": [
{}
],
"name": "text"
},
"type": "text",
"channelTypeId": 1,
"channelId": "text",
"technicalText": "text"
}
],
"executionLimit": 1,
"user": {
"name": "text",
"imageUrl": "text"
}
},
"flows": [
{
"uuid": "text",
"name": "text"
}
]
}
],
"number": 1,
"empty": true
}
Paginates through not expected answers -- those being of type 'FIRST_CELL' and 'TYPE_ANYTHING_ELSE'.
A valid uuid of an organization
A valid uuid of an environment
The UUID of the bot whose entities you are searching
Term being searched. This expects one optional String matching the name of an answer.
Current page, starting at 1
1
Example: 1
Size of the page
5
Example: 1
Criteria to order result, defaulted to updatedAt date. Possible fields include name, createdAt, updatedAt, createdBy and updatedBy.
updatedAt
Order direction(ASC/DESC), defaulted to DESC
DESC
GET /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/answer/not-expected?page=1&size=5 HTTP/1.1
Host:
Accept: */*
{
"totalPages": 1,
"totalElements": 1,
"first": true,
"last": true,
"pageable": {
"paged": true,
"unpaged": true,
"pageNumber": 1,
"pageSize": 1,
"sort": {
"unsorted": true,
"sorted": true,
"empty": true
},
"offset": 1
},
"numberOfElements": 1,
"sort": {
"unsorted": true,
"sorted": true,
"empty": true
},
"size": 1,
"content": [
{
"answer": {
"id": "text",
"name": "text",
"description": "text",
"evaluable": 1,
"transactional": 1,
"updatedAt": "2025-06-30T22:27:37.760Z",
"updatedBy": "text",
"tags": [
{
"uuid": "text",
"name": "text"
}
],
"webhook": "text",
"type": "text",
"headers": {},
"answerTemplates": [
{
"id": "text",
"content": {
"content": {},
"description": "text",
"type": "text",
"buttons": [
{}
],
"quickReply": [
{}
],
"name": "text"
},
"type": "text",
"channelTypeId": 1,
"channelId": "text",
"technicalText": "text"
}
],
"executionLimit": 1,
"user": {
"name": "text",
"imageUrl": "text"
}
},
"flows": [
{
"uuid": "text",
"name": "text"
}
]
}
],
"number": 1,
"empty": true
}
Searches (greedily) for any answer names that exists in a bot, matching types 'TYPE_ANYTHING_ELSE' and 'FIRST_CELL', matching the typed term, left-to-right, and returns a list of Strings, ordered alphabetically.
A valid organization Uuid
A valid environment Uuid
A valid bot uuid to search
Term being searched
How many items will be returned in the list. Defaults to 6.
6
Example: 1
GET /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/answer/not-expected/quicksearch?searchTerm=text HTTP/1.1
Host:
Accept: */*
[
"text"
]
Searches (greedily) for any answer names that exists in a bot, matching types 'TYPE_ANSWER' and 'WELCOME_MESSAGE', matching the typed term, left-to-right, and returns a list of Strings, ordered alphabetically.
A valid organization Uuid
A valid environment Uuid
A valid bot uuid to search
Term being searched
How many items will be returned in the list. Defaults to 6.
6
Example: 1
GET /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/answer/quicksearch?searchTerm=text HTTP/1.1
Host:
Accept: */*
[
"text"
]
CRUD Methods
A valid uuid of an organization
A valid uuid of an environment
The UUID of the bot whose entity you are searching belong to
The answer's uuid
GET /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/answer/{uuid} HTTP/1.1
Host:
Accept: */*
{
"answer": {
"id": "text",
"name": "text",
"description": "text",
"evaluable": 1,
"transactional": 1,
"updatedAt": "2025-06-30T22:27:37.760Z",
"updatedBy": "text",
"tags": [
{
"uuid": "text",
"name": "text"
}
],
"webhook": "text",
"type": "text",
"headers": {},
"answerTemplates": [
{
"id": "text",
"content": {
"content": {},
"description": "text",
"type": "text",
"buttons": [
{}
],
"quickReply": [
{}
],
"name": "text"
},
"type": "text",
"channelTypeId": 1,
"channelId": "text",
"technicalText": "text"
}
],
"executionLimit": 1,
"user": {
"name": "text",
"imageUrl": "text"
}
},
"flows": [
{
"uuid": "text",
"name": "text"
}
]
}
A valid uuid of organization
A valid uuid of environment
A valid uuid of bot
The answer's name.
A freeform description of this answer.
A freeform string to code up a webhook for this answer.
A boolean indicator representing if this answer is a transactional answer.
A boolean indicator representing if this answer is an evaluable answer.
The answer's Headers. This object is a freeform JSON which must be parser as an object when receiving it.
The answer's type.
The number of times an answer can be executed.
POST /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/answer HTTP/1.1
Host:
Content-Type: application/json
Accept: */*
Content-Length: 330
{
"name": "text",
"description": "text",
"tags": [
{
"uuid": "text",
"name": "text",
"objectRef": "text",
"tagTypeId": 1
}
],
"answerTemplates": [
{
"id": "text",
"content": {},
"type": "text",
"channelTypeId": 1,
"channelId": "text",
"technicalText": "text"
}
],
"webhook": "text",
"transactional": true,
"evaluable": true,
"headers": {},
"type": "text",
"executionLimit": 1
}
{
"answer": {
"id": "text",
"name": "text",
"description": "text",
"evaluable": 1,
"transactional": 1,
"updatedAt": "2025-06-30T22:27:37.760Z",
"updatedBy": "text",
"tags": [
{
"uuid": "text",
"name": "text"
}
],
"webhook": "text",
"type": "text",
"headers": {},
"answerTemplates": [
{
"id": "text",
"content": {
"content": {},
"description": "text",
"type": "text",
"buttons": [
{}
],
"quickReply": [
{}
],
"name": "text"
},
"type": "text",
"channelTypeId": 1,
"channelId": "text",
"technicalText": "text"
}
],
"executionLimit": 1,
"user": {
"name": "text",
"imageUrl": "text"
}
},
"flows": [
{
"uuid": "text",
"name": "text"
}
]
}
A valid uuid of an organization
A valid uuid of an environment
The UUID of the bot whose entity you are searching belong to
The answer's uuid
The answer's name.
A freeform description of this answer.
A freeform string to code up a webhook for this answer.
A boolean indicator representing if this answer is a transactional answer.
A boolean indicator representing if this answer is an evaluable answer.
The answer's Headers. This object is a freeform JSON which must be parser as an object when receiving it.
The answer's type.
The number of times an answer can be executed.
PUT /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/answer/{uuid} HTTP/1.1
Host:
Content-Type: application/json
Accept: */*
Content-Length: 330
{
"name": "text",
"description": "text",
"tags": [
{
"uuid": "text",
"name": "text",
"objectRef": "text",
"tagTypeId": 1
}
],
"answerTemplates": [
{
"id": "text",
"content": {},
"type": "text",
"channelTypeId": 1,
"channelId": "text",
"technicalText": "text"
}
],
"webhook": "text",
"transactional": true,
"evaluable": true,
"headers": {},
"type": "text",
"executionLimit": 1
}
{
"answer": {
"id": "text",
"name": "text",
"description": "text",
"evaluable": 1,
"transactional": 1,
"updatedAt": "2025-06-30T22:27:37.760Z",
"updatedBy": "text",
"tags": [
{
"uuid": "text",
"name": "text"
}
],
"webhook": "text",
"type": "text",
"headers": {},
"answerTemplates": [
{
"id": "text",
"content": {
"content": {},
"description": "text",
"type": "text",
"buttons": [
{}
],
"quickReply": [
{}
],
"name": "text"
},
"type": "text",
"channelTypeId": 1,
"channelId": "text",
"technicalText": "text"
}
],
"executionLimit": 1,
"user": {
"name": "text",
"imageUrl": "text"
}
},
"flows": [
{
"uuid": "text",
"name": "text"
}
]
}
Deletes an existing answer. The answer is disabled via the 'removed' parameter being set to true, rather than deleted from the DB.
A valid uuid of organization
A valid uuid of environment
A valid uuid of bot
The answer's uuid
DELETE /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/answer/{uuid} HTTP/1.1
Host:
Accept: */*
No content
Other Listings
A valid uuid of an organization
A valid uuid of an environment
The UUID of the bot whose entities you are searching
GET /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/answer/list-on-flow HTTP/1.1
Host:
Accept: */*
[
{
"id": "text",
"name": "text",
"type": "text",
"executionLimit": 1,
"answerTemplates": [
{
"id": "text",
"content": {
"content": {},
"description": "text",
"type": "text",
"buttons": [
{}
],
"quickReply": [
{}
],
"name": "text"
},
"type": "text",
"channelTypeId": 1,
"channelId": "text",
"technicalText": "text"
}
],
"tags": [
{
"id": "text",
"name": "text"
}
]
}
]
Was this helpful?