PATCH
/
v1
/
calls
/
{call_id}
Update call
curl --request PATCH \
  --url https://api.callrounded.com/v1/calls/{call_id} \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '{
  "metadata": {
    "source": "marketing_campaign",
    "utm_medium": "email"
  },
  "override": true
}'
{
  "message": "Call retrieved successfully",
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "organization_id": "123e4567-e89b-12d3-a456-426614174001",
    "type": "phone_call",
    "agent_id": "123e4567-e89b-12d3-a456-426614174002",
    "status": "created",
    "metadata": {
      "source": "marketing_campaign",
      "utm_medium": "email"
    },
    "start_time": "2023-06-15T14:30:00Z",
    "end_time": "2023-06-15T14:35:00Z",
    "duration_seconds": 300,
    "redirect_duration_seconds": 5,
    "cost": 0.15,
    "transcript_string": "Agent: Hello, how can I help you today?\nUser: I'd like to check on my order status.",
    "transcript": [
      {
        "role": "user",
        "start_time": "2023-06-15T14:31:23Z",
        "content": "Hello, how can I help you today?"
      }
    ],
    "variable_values": [
      {
        "name": "customer_name",
        "type": "string",
        "value": "John Doe",
        "timestamp": "2023-06-15T14:33:12Z"
      }
    ],
    "answer_type": "human",
    "from_number": "+33912345678",
    "to_number": "+33612345678",
    "direction": "inbound",
    "recording_url": "https://rounded-twilio.s3.amazonaws.com/calls/test?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=TEST%2F20250401%2Feu-west-3%2Fs3%2Faws4_request&X-Amz-Date=20250401T163838Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=046d4f7da8a7f2343875872593cbaa94a7836c42e1fd669e91fc2af9cf2b43be",
    "secure_recording_url": true
  },
  "error": {
    "details": [
      {
        "field": "email",
        "message": "Invalid email format"
      }
    ],
    "message": "An error occurred while processing your request",
    "status": 400,
    "type": "generic_error"
  },
  "status": 200
}

Authorizations

​
X-Api-Key
string
header
required

The API Key created in Rounded Studio.

Path Parameters

​
call_id
string<uuid>
required

Body

application/json

Schema for updating a call with metadata.

​
metadata
object | null

Additional metadata to associate with the call.

Examples:
{
  "source": "marketing_campaign",
  "utm_medium": "email"
}
​
override
boolean | null
default:false

If True, existing metadata will be completely replaced with new metadata. If False, existing metadata will be merged with new metadata.

Response

Successfully updated call information

​
data
object
required

The call data retrieved.

​
message
string
default:Call retrieved successfully

Response message indicating the result of the operation.

​
error
object | null
Example:
{
  "details": [
    {
      "field": "email",
      "message": "Invalid email format"
    }
  ],
  "message": "An error occurred while processing your request",
  "status": 400,
  "type": "generic_error"
}
​
status
integer
default:200

HTTP status code of the response.