Skip to main content
POST
/
agents
Create agent
curl --request POST \
  --url https://app2.freyavoice.ai/api/v2/agents \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "workspaceId": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Customer Support Agent",
  "source": "firebase",
  "config": {
    "llmConfig": {
      "provider": "openai",
      "model": "gpt-4o",
      "systemPrompt": "You are a helpful customer support agent...",
      "firstMessage": "Hello! How can I help you today?",
      "firstMessageMode": "assistant-speaks-first",
      "maxTokens": 1000,
      "temperature": 0.7
    },
    "ttsConfig": {
      "provider": "elevenlabs",
      "model": "eleven_multilingual_v2",
      "voiceId": "21m00Tcm4TlvDq8ikWAM",
      "language": "en",
      "speed": 1,
      "stability": 0.5,
      "similarityBoost": 0.75,
      "additionalSettings": {}
    },
    "sstConfig": {
      "provider": "deepgram",
      "model": "nova-2",
      "language": "en",
      "temperature": null,
      "punctuate": true,
      "diarize": false,
      "additionalSettings": {}
    },
    "complianceConfig": {
      "pciDss": false,
      "mifidIi": false,
      "euAiAct": false,
      "soc2": false
    }
  }
}
'
{
  "success": true,
  "data": {
    "message": "<string>",
    "result": {
      "agent": {
        "id": "<string>",
        "workspaceId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "userId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>",
        "source": "firebase",
        "config": {
          "llmConfig": {
            "provider": "<string>",
            "model": "<string>",
            "systemPrompt": "<string>",
            "firstMessage": "<string>",
            "firstMessageMode": "assistant-waits-for-user",
            "disableInterruptionsDuringFirstMessage": false,
            "maxTokens": 1000,
            "temperature": 0.7,
            "thinkingBudgetEnabled": false,
            "thinkingBudget": 10000,
            "tools": [],
            "additionalSettings": {}
          },
          "ttsConfig": {
            "provider": "<string>",
            "model": "<string>",
            "voiceId": "<string>",
            "stability": 0.5,
            "similarityBoost": 0.5,
            "language": "multi",
            "speed": 1,
            "additionalSettings": {},
            "startSpeakingPlan": {
              "waitSeconds": 0.4
            },
            "stopSpeakingPlan": {
              "numberOfWords": 1,
              "voiceSeconds": 0.4,
              "backOffSeconds": 0.4
            }
          },
          "sstConfig": {
            "provider": "<string>",
            "model": "<string>",
            "temperature": 0.5,
            "language": "multi",
            "punctuate": true,
            "diarize": false,
            "additionalSettings": {}
          },
          "complianceConfig": {
            "pciDss": false,
            "mifidIi": false,
            "euAiAct": false,
            "soc2": false
          },
          "callTimeoutSettings": {
            "silenceTimeout": 0,
            "maximumDuration": 600
          },
          "voicemailDetection": {
            "enabled": false,
            "messageMode": "none",
            "staticMessage": null,
            "voicemailResponseDelay": 2
          },
          "postConversationAnalysis": {
            "generateSummary": false,
            "summaryPrompt": null,
            "generateStructuredData": false,
            "structuredDataPrompt": null,
            "autoDetectProblems": false,
            "structuredDataSchema": []
          },
          "privacyConfig": {
            "enableRecording": false,
            "getRecordingConsent": false,
            "recordingConsentText": null,
            "stopSecs": 1,
            "preSpeechMs": 1,
            "maxDurationSecs": 1
          },
          "turnAnalyzerConfig": {
            "provider": "local",
            "url": "<string>",
            "modelPath": "<string>"
          }
        },
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z",
        "files": []
      }
    }
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
workspaceId
string<uuid>
required
name
string
required
Required string length: 1 - 100
config
object
required
source
enum<string>
default:firebase
Available options:
firebase,
vapi
files
object[]

Response

Agent created

success
enum<boolean>
required
Available options:
true,
false
data
object
required