Create agent | Atlas | Documentation

curl -X POST https://api.youratlas.com/v1/api/agent/campaignId \
     -H "api-key: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "Name": "Customer Support Agent",
  "Language": "en-US",
  "VoiceId": "joanna"
}'

{
  "Name": "Customer Support Agent",
  "Language": "en-US",
  "VoiceId": "joanna",
  "AgentTypeName": "Virtual Assistant",
  "PreScript": "Hello, how can I assist you today?",
  "PostScript": "Thank you for contacting us. Have a great day!",
  "AtlasVoiceId": "atlas-voice-1234",
  "Model": "neural-v1",
  "Provider": "11labs",
  "Stability": 0.85,
  "SimilarityBoost": 0.9,
  "BackgroundSound": "office-ambience",
  "Pitch": 1,
  "Speed": 1,
  "Region": "us-east-1",
  "Volume": 0.8,
  "LanguageBoost": "en",
  "FillerInjectionEnabled": true,
  "TextNormalizationEnabled": true,
  "PartitionKey": "campaign-7890",
  "RowKey": "agent-4567",
  "Timestamp": "2024-01-15T09:30:00Z"
}

Authentication

api-keystring

Your Atlas API key. Get it from the Atlas Portal under Settings > API Keys.

Path parameters

campaignIdstringRequired

Request

This endpoint expects an object.

NamestringRequired

LanguagestringRequired

VoiceIdstringRequired

AgentTypeNamestringOptional

PreScriptstringOptional

PostScriptstringOptional

AtlasVoiceIdstringOptional

ModelstringOptional

ProviderenumOptional

Allowed values:

StabilitydoubleOptional

SimilarityBoostdoubleOptional

BackgroundSoundstringOptional

PitchdoubleOptional

SpeeddoubleOptional

RegionstringOptional

VolumedoubleOptional

LanguageBooststringOptional

FillerInjectionEnabledbooleanOptional

TextNormalizationEnabledbooleanOptional

Response

Agent created

Namestring

Languagestring

VoiceIdstring

AgentTypeNamestring

PreScriptstring

PostScriptstring

AtlasVoiceIdstring

Modelstring

Providerenum

Allowed values:

Stabilitydouble

SimilarityBoostdouble

BackgroundSoundstring

Pitchdouble

Speeddouble

Regionstring

Volumedouble

LanguageBooststring

FillerInjectionEnabledboolean

TextNormalizationEnabledboolean

PartitionKeystring

RowKeystring

Timestampdatetime

Errors

400

Bad Request Error

500

Internal Server Error