PATCH
/
v1
/
calls
/
{call_id}
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": "completed",
    "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"
      }
    ],
    "from_number": "+33912345678",
    "to_number": "+33612345678",
    "direction": "inbound",
    "recording_url": "<string>"
  },
  "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
required

Body

application/json

Schema for updating a call with metadata.

Response

200
application/json

Successfully updated call information

The response is of type object.