PUT
/
api
/
v1
/
calls
/
{id}
curl --request PUT \
  --url https://api.elemente.ai/api/v1/calls/{id} \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '{
  "agentId": "123e4567-e89b-12d3-a456-426614174000",
  "status": "completed",
  "note": "This call need a follow up"
}'
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "in-progress",
  "agentPhone": "+1234567890",
  "agentEmail": "+1234567890",
  "customerPhone": "+1234567890",
  "customerEmail": "+1234567890",
  "agentId": "123e4567-e89b-12d3-a456-426614174000",
  "customerId": "123e4567-e89b-12d3-a456-426614174000",
  "skillId": "123e4567-e89b-12d3-a456-426614174000",
  "customerName": "John Doe",
  "transcription": "Hello, how can I help you?",
  "recordingUrl": "https://example.com/recording.wav",
  "messages": [
    {
      "sid": "SM1234567890abcdef",
      "timestamp": "2025-03-17T14:30:00Z",
      "sender": "agent",
      "content": "Hello, how can I assist you today?",
      "mediaUrl": "https://example.com/image.jpg",
      "status": "delivered"
    }
  ],
  "duration": "7200"
}

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Path Parameters

​
id
string
required

The id of the call

Body

application/json
Input data for update call
​
note
string
required

Call note

Example:

"This call need a follow up"

​
agentId
string

Your agents UUID

Example:

"123e4567-e89b-12d3-a456-426614174000"

​
status
string

The call status

Example:

"completed"

Response

200
application/json
Update call
​
id
string
required

Interaction ID

Example:

"123e4567-e89b-12d3-a456-426614174000"

​
status
string
required

Interaction status

Example:

"in-progress"

​
agentPhone
string
required

Agent phone number

Example:

"+1234567890"

​
agentEmail
string
required

Agent Email

Example:

"+1234567890"

​
customerPhone
string
required

Customer phone number

Example:

"+1234567890"

​
customerEmail
string
required

Customer email

Example:

"+1234567890"

​
agentId
string
required

Agent ID

Example:

"123e4567-e89b-12d3-a456-426614174000"

​
customerId
string
required

Customer ID

Example:

"123e4567-e89b-12d3-a456-426614174000"

​
skillId
string
required

Skill ID

Example:

"123e4567-e89b-12d3-a456-426614174000"

​
customerName
string
required

Customer name

Example:

"John Doe"

​
transcription
string
required

Transcription

Example:

"Hello, how can I help you?"

​
recordingUrl
string
required

Recording URL

Example:

"https://example.com/recording.wav"

​
messages
string[]
required

conversation messages

Example:
[
  {
    "sid": "SM1234567890abcdef",
    "timestamp": "2025-03-17T14:30:00Z",
    "sender": "agent",
    "content": "Hello, how can I assist you today?",
    "mediaUrl": "https://example.com/image.jpg",
    "status": "delivered"
  }
]
​
duration
number
required

Session duration in seconds

Example:

"7200"