Create phone session

POST /v1/sessions/phone — place an outbound PSTN call backed by a Speko voice session.

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

to*E164

Match^\+[1-9]\d{6,14}$

from?E164

Match^\+[1-9]\d{6,14}$

agentId?string

Persisted agent to run. Required unless intent is supplied.

intent?

constraints?

voice?string

systemPrompt?string

firstMessage?string

llm?

ttsOptions?

sttOptions?

telephony?

metadata?

Response Body

`application/json`

{
  "sessionId": "string",
  "callControlId": "string",
  "roomName": "string",
  "status": "dialing",
  "to": "+12015551234",
  "from": "+12015551234"
}

{
  "error": "Invalid request body",
  "code": "VALIDATION_ERROR"
}

{
  "error": "Unauthorized",
  "code": "UNAUTHORIZED"
}

{
  "error": "not found",
  "code": "NOT_FOUND"
}

Create phone session

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

404application/json

`application/json`

`application/json`

`application/json`

`application/json`