Skip to main content
GET
/
api
/
v1
/
assistants
List Assistants
curl --request GET \
  --url https://api.voicebot.studio/api/v1/assistants \
  --header 'X-API-Key: <api-key>'
[
  {
    "id": "<string>",
    "name": "<string>",
    "model": {
      "messages": [
        {
          "content": "<string>",
          "role": "<string>"
        }
      ],
      "provider": "standard",
      "model": "standard",
      "tools": [
        {
          "async": false,
          "messages": [
            {}
          ],
          "type": "dtmf",
          "function": {
            "strict": true,
            "name": "<string>",
            "description": "<string>",
            "parameters": {}
          },
          "server": {
            "timeoutSeconds": 20,
            "url": "<string>",
            "secret": "<string>",
            "headers": {}
          }
        }
      ],
      "toolIds": [
        "<string>"
      ],
      "temperature": 123,
      "maxTokens": 123,
      "numFastTurns": 123,
      "knowledgeBase": {
        "provider": "canonical",
        "topK": 123,
        "fileIds": [
          "<string>"
        ]
      },
      "fallbackModels": [
        "standard"
      ],
      "semanticCachingEnabled": true,
      "emotionRecognitionEnabled": true
    },
    "voice": {
      "fillerInjectionEnabled": true,
      "model": "standard",
      "style": 123,
      "voiceId": "Robert",
      "language": "<string>",
      "provider": "standard",
      "stability": 123,
      "similarityBoost": 123,
      "useSpeakerBoost": true,
      "enableSsmlParsing": true,
      "optimizeStreamingLatency": 123,
      "chunkPlan": {
        "enabled": true,
        "minCharacters": 40.5,
        "punctuationBoundaries": [
          "<string>"
        ],
        "formatPlan": {
          "enabled": true,
          "numberToDigitsCutoff": 1,
          "replacements": [
            {}
          ]
        }
      }
    },
    "transcriber": {
      "provider": "standard",
      "model": "standard",
      "language": "<string>",
      "smartFormat": true,
      "languageDetectionEnabled": true,
      "keywords": [
        "<string>"
      ],
      "endpointing": 123
    },
    "analysisPlan": {
      "successEvaluationRubric": "NumericScale",
      "successEvaluationRequestTimeoutSeconds": 123,
      "successEvaluationPrompt": "<string>",
      "structuredDataSchema": {
        "type": "string",
        "items": {},
        "properties": {},
        "description": "<string>",
        "required": [
          "<string>"
        ]
      },
      "structuredDataRequestTimeoutSeconds": 123,
      "structuredDataPrompt": "<string>",
      "summaryPrompt": "<string>",
      "summaryRequestTimeoutSeconds": 123
    },
    "serverUrl": "<string>",
    "serverUrlSecret": "<string>",
    "artifactPlan": {
      "transcriptPlan": {
        "enabled": true,
        "userName": "<string>",
        "assistantName": "<string>"
      },
      "recordingEnabled": true,
      "videoRecordingEnabled": true,
      "recordingPath": "<string>"
    },
    "messagePlan": {
      "idleMessages": [
        "<string>"
      ],
      "idleMessageMaxSpokenCount": 123,
      "idleTimeoutSeconds": 123
    },
    "startSpeakingPlan": {
      "waitSeconds": 123,
      "smartEndpointingEnabled": true,
      "transcriptionEndpointingPlan": {
        "onPunctuationSeconds": 123,
        "onNoPunctuationSeconds": 123,
        "onNumberSeconds": 123
      }
    },
    "stopSpeakingPlan": {
      "numWords": 123,
      "voiceSeconds": 123,
      "backoffSeconds": 123
    },
    "monitorPlan": {
      "listenEnabled": true,
      "controlEnabled": true
    },
    "clientMessages": [
      "<string>"
    ],
    "dialKeypadFunctionEnabled": true,
    "endCallFunctionEnabled": true,
    "forwardingPhoneNumber": "<string>",
    "organizationId": "<string>",
    "createdBy": "<string>",
    "createdAt": "<string>",
    "updatedAt": "<string>"
  }
]

Authorizations

X-API-Key
string
header
required

Response

200 - application/json

Successful Response

id
string
required
name
string
required
organizationId
string
required
createdBy
string
required
createdAt
string
required
updatedAt
string
required
model
object | null
voice
object | null
transcriber
object | null
analysisPlan
object | null

This is the analysis plan for the assistant.

serverUrl
string | null

Server URL must match either workflow.amira.bot or workflow.voicebot.studio

serverUrlSecret
string | null
artifactPlan
object | null
messagePlan
object | null
startSpeakingPlan
object | null
stopSpeakingPlan
object | null
monitorPlan
object | null
clientMessages
string[] | null
dialKeypadFunctionEnabled
boolean | null
endCallFunctionEnabled
boolean | null
forwardingPhoneNumber
string | null