Voiceflow bearer token
Get many prompts
curl --request POST \
--url https://realtime-api.voiceflow.com/v1/stable/prompt/get-many \
--header 'Authorization: Bearer <token>'
--header 'Content-Type: application/json' \
--data '{
"ids": [
"<string>"
]
}'const response = await fetch('https://realtime-api.voiceflow.com/v1/stable/prompt/get-many?projectID=<projectID>&environmentAlias=<environmentAlias>', {
method: 'POST',
headers: {
Authorization: 'Bearer <token>',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"ids": [
"<string>"
]
}),
});
const data = await response.json();import requests
response = requests.post(
'https://realtime-api.voiceflow.com/v1/stable/prompt/get-many?projectID=<projectID>&environmentAlias=<environmentAlias>',
headers={'Authorization': 'Bearer <token>'},
json={
"ids": [
"<string>"
]
},
)
data = response.json()vf prompt get-many --project-id <projectID> --environment-alias <environmentAlias> \
< body.json{
"prompts": [
{
"id": "<string>",
"name": "<string>",
"system": "<string>",
"settings": {
"model": "<AIModel>",
"maxTokens": 0,
"temperature": 0,
"responseFormat": "<string>",
"reasoningEffort": "<AIReasoningEffort>",
"serviceTier": "<AIParamsServiceTier>",
"useStructuredOutput": true
},
"createdAt": "2026-09-10T00:00:00.000Z",
"updatedAt": "2026-09-10T00:00:00.000Z",
"createdByID": 0,
"updatedByID": 0
}
],
"missing": [
"<string>"
]
}Reads several prompts by ID in one call. An ID that matches no prompt in the environment is reported instead of failing the request.
POST
/v1/stable/prompt/get-many
Get many prompts
curl --request POST \
--url https://realtime-api.voiceflow.com/v1/stable/prompt/get-many \
--header 'Authorization: Bearer <token>'
--header 'Content-Type: application/json' \
--data '{
"ids": [
"<string>"
]
}'const response = await fetch('https://realtime-api.voiceflow.com/v1/stable/prompt/get-many?projectID=<projectID>&environmentAlias=<environmentAlias>', {
method: 'POST',
headers: {
Authorization: 'Bearer <token>',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"ids": [
"<string>"
]
}),
});
const data = await response.json();import requests
response = requests.post(
'https://realtime-api.voiceflow.com/v1/stable/prompt/get-many?projectID=<projectID>&environmentAlias=<environmentAlias>',
headers={'Authorization': 'Bearer <token>'},
json={
"ids": [
"<string>"
]
},
)
data = response.json()vf prompt get-many --project-id <projectID> --environment-alias <environmentAlias> \
< body.json{
"prompts": [
{
"id": "<string>",
"name": "<string>",
"system": "<string>",
"settings": {
"model": "<AIModel>",
"maxTokens": 0,
"temperature": 0,
"responseFormat": "<string>",
"reasoningEffort": "<AIReasoningEffort>",
"serviceTier": "<AIParamsServiceTier>",
"useStructuredOutput": true
},
"createdAt": "2026-09-10T00:00:00.000Z",
"updatedAt": "2026-09-10T00:00:00.000Z",
"createdByID": 0,
"updatedByID": 0
}
],
"missing": [
"<string>"
]
}Authorizations
Query Parameters
Response
200 - application/jsonReturns the prompts found, in request order, and missing, the requested IDs that match no prompt in this environment.
The prompts found, in request order.
Show child attributes
Plain text; markdown is not interpreted. {variable_name} inserts a variable or entity, {variable_name.path} a field of a variable. Escape a literal { or \ with a backslash. A name matching neither is stored as literal text and reported in unresolvedReferences; secrets are not available here.
Show child attributes
Was this page helpful?
Thanks for your feedback.