Error
A valid request URL is required to generate request examples{
"success": true,
"data": {
"id": "agt_4f9c2b7e10a24d51",
"organizationId": "org_2a1b9c",
"name": "Peak Comfort HVAC — Front Desk",
"version": 8,
"status": "draft",
"persona": "A warm, efficient front-desk agent for an HVAC company.",
"primaryLanguage": "en",
"languages": [
"en",
"es"
],
"sku": "code_switch",
"enabledChannels": [
"voice",
"chat"
],
"defaultVoiceId": "voice_9c1f",
"voiceMap": {
"en": "voice_9c1f"
},
"createdAt": "2026-07-01T14:32:00.000Z",
"updatedAt": "2026-07-13T10:07:00.000Z"
}
}{
"type": "about:blank",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"code": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}{
"type": "about:blank",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"code": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}{
"type": "about:blank",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"code": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}Agents
Set the agent's voice
Assigns a voice to the agent for a given language, defaulting to the agent’s primary language. This is a shortcut for changing the voice without sending a full agent update. Look up a voice ID with the voice catalog or voice search endpoints first.
PUT
/
agents
/
{id}
/
voice
Error
A valid request URL is required to generate request examples{
"success": true,
"data": {
"id": "agt_4f9c2b7e10a24d51",
"organizationId": "org_2a1b9c",
"name": "Peak Comfort HVAC — Front Desk",
"version": 8,
"status": "draft",
"persona": "A warm, efficient front-desk agent for an HVAC company.",
"primaryLanguage": "en",
"languages": [
"en",
"es"
],
"sku": "code_switch",
"enabledChannels": [
"voice",
"chat"
],
"defaultVoiceId": "voice_9c1f",
"voiceMap": {
"en": "voice_9c1f"
},
"createdAt": "2026-07-01T14:32:00.000Z",
"updatedAt": "2026-07-13T10:07:00.000Z"
}
}{
"type": "about:blank",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"code": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}{
"type": "about:blank",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"code": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}{
"type": "about:blank",
"title": "<string>",
"status": 123,
"detail": "<string>",
"instance": "<string>",
"code": "<string>",
"errors": [
{
"field": "<string>",
"message": "<string>"
}
]
}Authorizations
Flowyte secret API key (Authorization: Bearer flowyte_sk_live_…). Scope-gated; is scoped to your organization — a key can never reach another tenant. The listed scopes in each operation's apiKey requirement are the scopes that key must hold. The tokenUrl is nominal: keys are minted in the dashboard.
FlowClient Credentials
- Token URL
- /api/v1/api-keys
Scopes1
agents:write
Create/update/delete agents, publish, rollback.
Path Parameters
The agent's unique ID (the UUID returned by createAgent / listAgents).
Body
application/json