Get playbook
curl --request GET \
--url https://realtime-api.voiceflow.com/v1/stable/playbook/{playbookID} \
--header 'Authorization: Bearer <token>'{
"playbook": {
"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 a single playbook by ID, with the fields that define it. A playbook is a set of instructions that drives an agent toward a goal, calling tools as it needs them.
GET
/
v1
/
stable
/
playbook
/
{playbookID}
Get playbook
curl --request GET \
--url https://realtime-api.voiceflow.com/v1/stable/playbook/{playbookID} \
--header 'Authorization: Bearer <token>'{
"playbook": {
"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
Path Parameters
The ID of the playbook to operate on.
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 a single playbook, including its instructions, its tool ordering, and the system tool settings configured on it.
Show child attributes
Show child attributes
Was this page helpful?
⌘I