Skip to main content
POST
/
v1
/
assistant-deployment
/
create-phone-deployment
create-phone-deployment
curl --request POST \
  --url https://assistant-01.in.rapida.ai/v1/assistant-deployment/create-phone-deployment \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "assistantId": "2227823180112723968",
  "phoneProviderName": "twilio"
}
'
{
  "code": 200,
  "success": true,
  "data": {
    "id": "2230142097179373568",
    "assistantId": "2227823180112723968",
    "greeting": "Hi, how can I help you today?",
    "mistake": "Sorry, I did not understand that.",
    "idealTimeout": 30,
    "idealTimeoutBackoff": 2,
    "idealTimeoutMessage": "Are you still there?",
    "maxSessionDuration": 300,
    "phoneProviderName": "twilio",
    "phoneOptions": [
      {
        "key": "phoneNumber",
        "value": "+14155550100"
      }
    ],
    "status": "active",
    "inputAudio": {
      "audioProvider": "deepgram",
      "audioType": "stt",
      "status": "active"
    },
    "outputAudio": {
      "audioProvider": "elevenlabs",
      "audioType": "tts",
      "status": "active"
    }
  }
}

Authorizations

​
x-api-key
string
header
required

API key from Rapida credentials.

Headers

​
x-client-source
enum<string>
default:sdk

Client source identifier. SDK clients send this automatically.

Available options:
sdk
​
x-auth-id
string

Optional user identifier to propagate with the request.

Body

application/json
​
assistantId
string
required

Assistant ID for the phone deployment.

Pattern: ^[0-9]+$
Example:

"2227823180112723968"

​
phoneProviderName
string
required

Telephony provider name.

Example:

"twilio"

​
greeting
string

First message the assistant sends when the phone session starts.

Example:

"Hi, how can I help you today?"

​
mistake
string

Message to use when the assistant cannot understand or handle the input.

Example:

"Sorry, I did not understand that."

​
idealTimeout
integer<uint64>

Idle timeout in seconds before the assistant sends the timeout message.

Required range: 15 <= x <= 120
Example:

30

​
idealTimeoutBackoff
integer<uint64>

Number of idle-timeout retries before the session can end.

Required range: 0 <= x <= 5
Example:

2

​
idealTimeoutMessage
string

Message sent when the phone session reaches the idle timeout.

Example:

"Are you still there?"

​
maxSessionDuration
integer<uint64>

Maximum phone session duration in seconds.

Required range: 180 <= x <= 600
Example:

300

​
phoneOptions
object[]

Provider-specific phone options.

​
inputAudio
object
​
outputAudio
object

Response

Assistant phone deployment created.

​
code
integer<int32>
Example:

200

​
success
boolean
Example:

true

​
data
object
​
error
object

Platform error response details. errorCode is a stable platform error code. See PlatformErrorCode for documented code/message mappings.