List playbooks
curl --request GET \
--url https://realtime-api.voiceflow.com/v1/stable/playbook \
--header 'Authorization: Bearer <token>'{
"playbooks": [
{
"id": "<string>",
"name": "<string>",
"settings": {
"realtime": {
"voice": "<string>",
"eagerness": "<string>"
},
"maxTokens": 123,
"temperature": 123
},
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"description": "<string>",
"instructions": [
"<string>"
],
"pathToolOrder": [
"<string>"
],
"endTool": {
"enabled": true,
"description": "<string>",
"messages": {
"delayMessageID": "<string>",
"failureMessageID": "<string>",
"executionMessageID": "<string>",
"completionMessageID": "<string>",
"delayMessageSeconds": 123,
"generative": {
"execution": {
"enabled": true,
"examples": [
[
"<string>"
]
]
},
"failure": {
"enabled": true,
"examples": [
[
"<string>"
]
]
},
"delay": {
"enabled": true,
"examples": [
[
"<string>"
]
]
},
"completion": {
"enabled": true,
"examples": [
[
"<string>"
]
]
}
}
},
"toolSound": {
"ref": "<string>",
"volume": 0.75
}
},
"cardTool": {
"enabled": true,
"description": "<string>",
"messages": {
"delayMessageID": "<string>",
"failureMessageID": "<string>",
"executionMessageID": "<string>",
"completionMessageID": "<string>",
"delayMessageSeconds": 123,
"generative": {
"execution": {
"enabled": true,
"examples": [
[
"<string>"
]
]
},
"failure": {
"enabled": true,
"examples": [
[
"<string>"
]
]
},
"delay": {
"enabled": true,
"examples": [
[
"<string>"
]
]
},
"completion": {
"enabled": true,
"examples": [
[
"<string>"
]
]
}
}
}
},
"buttonTool": {
"enabled": true,
"description": "<string>",
"messages": {
"delayMessageID": "<string>",
"failureMessageID": "<string>",
"executionMessageID": "<string>",
"completionMessageID": "<string>",
"delayMessageSeconds": 123,
"generative": {
"execution": {
"enabled": true,
"examples": [
[
"<string>"
]
]
},
"failure": {
"enabled": true,
"examples": [
[
"<string>"
]
]
},
"delay": {
"enabled": true,
"examples": [
[
"<string>"
]
]
},
"completion": {
"enabled": true,
"examples": [
[
"<string>"
]
]
}
}
}
},
"carouselTool": {
"enabled": true,
"description": "<string>",
"messages": {
"delayMessageID": "<string>",
"failureMessageID": "<string>",
"executionMessageID": "<string>",
"completionMessageID": "<string>",
"delayMessageSeconds": 123,
"generative": {
"execution": {
"enabled": true,
"examples": [
[
"<string>"
]
]
},
"failure": {
"enabled": true,
"examples": [
[
"<string>"
]
]
},
"delay": {
"enabled": true,
"examples": [
[
"<string>"
]
]
},
"completion": {
"enabled": true,
"examples": [
[
"<string>"
]
]
}
}
}
},
"skipTurnTool": {
"enabled": true,
"description": "<string>"
},
"webSearchTool": {
"enabled": true,
"messages": {
"delayMessageID": "<string>",
"failureMessageID": "<string>",
"executionMessageID": "<string>",
"completionMessageID": "<string>",
"delayMessageSeconds": 123,
"generative": {
"execution": {
"enabled": true,
"examples": [
[
"<string>"
]
]
},
"failure": {
"enabled": true,
"examples": [
[
"<string>"
]
]
},
"delay": {
"enabled": true,
"examples": [
[
"<string>"
]
]
},
"completion": {
"enabled": true,
"examples": [
[
"<string>"
]
]
}
}
},
"toolSound": {
"ref": "<string>",
"volume": 0.75
},
"description": "<string>",
"allowedDomains": [
"<string>"
],
"sourceUrlsCount": 3
},
"callForwardTool": {
"enabled": true,
"address": [
"<string>"
],
"description": "<string>",
"messages": {
"delayMessageID": "<string>",
"failureMessageID": "<string>",
"executionMessageID": "<string>",
"completionMessageID": "<string>",
"delayMessageSeconds": 123,
"generative": {
"execution": {
"enabled": true,
"examples": [
[
"<string>"
]
]
},
"failure": {
"enabled": true,
"examples": [
[
"<string>"
]
]
},
"delay": {
"enabled": true,
"examples": [
[
"<string>"
]
]
},
"completion": {
"enabled": true,
"examples": [
[
"<string>"
]
]
}
}
},
"extension": [
"<string>"
],
"toolSound": {
"ref": "<string>",
"volume": 0.75
},
"callerIDPassthrough": true
},
"knowledgeBaseTool": {
"enabled": true,
"description": "<string>",
"query": [
"<string>"
],
"filters": [
{
"key": "<string>",
"description": null,
"defaultValue": [
"<string>"
]
}
],
"messages": {
"delayMessageID": "<string>",
"failureMessageID": "<string>",
"executionMessageID": "<string>",
"completionMessageID": "<string>",
"delayMessageSeconds": 123,
"generative": {
"execution": {
"enabled": true,
"examples": [
[
"<string>"
]
]
},
"failure": {
"enabled": true,
"examples": [
[
"<string>"
]
]
},
"delay": {
"enabled": true,
"examples": [
[
"<string>"
]
]
},
"completion": {
"enabled": true,
"examples": [
[
"<string>"
]
]
}
}
},
"toolSound": {
"ref": "<string>",
"volume": 0.75
},
"chunkLimit": 123,
"sourceUrlsCount": 3
}
}
]
}Returns every playbook in the environment. A playbook is a set of instructions that drives an agent toward a goal, calling tools as it needs them. The call takes no paging parameters, so one request yields the whole set.
GET
/
v1
/
stable
/
playbook
List playbooks
curl --request GET \
--url https://realtime-api.voiceflow.com/v1/stable/playbook \
--header 'Authorization: Bearer <token>'{
"playbooks": [
{
"id": "<string>",
"name": "<string>",
"settings": {
"realtime": {
"voice": "<string>",
"eagerness": "<string>"
},
"maxTokens": 123,
"temperature": 123
},
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"description": "<string>",
"instructions": [
"<string>"
],
"pathToolOrder": [
"<string>"
],
"endTool": {
"enabled": true,
"description": "<string>",
"messages": {
"delayMessageID": "<string>",
"failureMessageID": "<string>",
"executionMessageID": "<string>",
"completionMessageID": "<string>",
"delayMessageSeconds": 123,
"generative": {
"execution": {
"enabled": true,
"examples": [
[
"<string>"
]
]
},
"failure": {
"enabled": true,
"examples": [
[
"<string>"
]
]
},
"delay": {
"enabled": true,
"examples": [
[
"<string>"
]
]
},
"completion": {
"enabled": true,
"examples": [
[
"<string>"
]
]
}
}
},
"toolSound": {
"ref": "<string>",
"volume": 0.75
}
},
"cardTool": {
"enabled": true,
"description": "<string>",
"messages": {
"delayMessageID": "<string>",
"failureMessageID": "<string>",
"executionMessageID": "<string>",
"completionMessageID": "<string>",
"delayMessageSeconds": 123,
"generative": {
"execution": {
"enabled": true,
"examples": [
[
"<string>"
]
]
},
"failure": {
"enabled": true,
"examples": [
[
"<string>"
]
]
},
"delay": {
"enabled": true,
"examples": [
[
"<string>"
]
]
},
"completion": {
"enabled": true,
"examples": [
[
"<string>"
]
]
}
}
}
},
"buttonTool": {
"enabled": true,
"description": "<string>",
"messages": {
"delayMessageID": "<string>",
"failureMessageID": "<string>",
"executionMessageID": "<string>",
"completionMessageID": "<string>",
"delayMessageSeconds": 123,
"generative": {
"execution": {
"enabled": true,
"examples": [
[
"<string>"
]
]
},
"failure": {
"enabled": true,
"examples": [
[
"<string>"
]
]
},
"delay": {
"enabled": true,
"examples": [
[
"<string>"
]
]
},
"completion": {
"enabled": true,
"examples": [
[
"<string>"
]
]
}
}
}
},
"carouselTool": {
"enabled": true,
"description": "<string>",
"messages": {
"delayMessageID": "<string>",
"failureMessageID": "<string>",
"executionMessageID": "<string>",
"completionMessageID": "<string>",
"delayMessageSeconds": 123,
"generative": {
"execution": {
"enabled": true,
"examples": [
[
"<string>"
]
]
},
"failure": {
"enabled": true,
"examples": [
[
"<string>"
]
]
},
"delay": {
"enabled": true,
"examples": [
[
"<string>"
]
]
},
"completion": {
"enabled": true,
"examples": [
[
"<string>"
]
]
}
}
}
},
"skipTurnTool": {
"enabled": true,
"description": "<string>"
},
"webSearchTool": {
"enabled": true,
"messages": {
"delayMessageID": "<string>",
"failureMessageID": "<string>",
"executionMessageID": "<string>",
"completionMessageID": "<string>",
"delayMessageSeconds": 123,
"generative": {
"execution": {
"enabled": true,
"examples": [
[
"<string>"
]
]
},
"failure": {
"enabled": true,
"examples": [
[
"<string>"
]
]
},
"delay": {
"enabled": true,
"examples": [
[
"<string>"
]
]
},
"completion": {
"enabled": true,
"examples": [
[
"<string>"
]
]
}
}
},
"toolSound": {
"ref": "<string>",
"volume": 0.75
},
"description": "<string>",
"allowedDomains": [
"<string>"
],
"sourceUrlsCount": 3
},
"callForwardTool": {
"enabled": true,
"address": [
"<string>"
],
"description": "<string>",
"messages": {
"delayMessageID": "<string>",
"failureMessageID": "<string>",
"executionMessageID": "<string>",
"completionMessageID": "<string>",
"delayMessageSeconds": 123,
"generative": {
"execution": {
"enabled": true,
"examples": [
[
"<string>"
]
]
},
"failure": {
"enabled": true,
"examples": [
[
"<string>"
]
]
},
"delay": {
"enabled": true,
"examples": [
[
"<string>"
]
]
},
"completion": {
"enabled": true,
"examples": [
[
"<string>"
]
]
}
}
},
"extension": [
"<string>"
],
"toolSound": {
"ref": "<string>",
"volume": 0.75
},
"callerIDPassthrough": true
},
"knowledgeBaseTool": {
"enabled": true,
"description": "<string>",
"query": [
"<string>"
],
"filters": [
{
"key": "<string>",
"description": null,
"defaultValue": [
"<string>"
]
}
],
"messages": {
"delayMessageID": "<string>",
"failureMessageID": "<string>",
"executionMessageID": "<string>",
"completionMessageID": "<string>",
"delayMessageSeconds": 123,
"generative": {
"execution": {
"enabled": true,
"examples": [
[
"<string>"
]
]
},
"failure": {
"enabled": true,
"examples": [
[
"<string>"
]
]
},
"delay": {
"enabled": true,
"examples": [
[
"<string>"
]
]
},
"completion": {
"enabled": true,
"examples": [
[
"<string>"
]
]
}
}
},
"toolSound": {
"ref": "<string>",
"volume": 0.75
},
"chunkLimit": 123,
"sourceUrlsCount": 3
}
}
]
}Authorizations
Voiceflow bearer token
Query Parameters
The ID of the project to operate on.
The alias of the environment to operate on (e.g. main).
Response
200 - application/json
Returns every playbook in the project environment, each with its name, description, instructions, model settings, and its own system tool configuration.
Show child attributes
Show child attributes
Was this page helpful?
⌘I