Calls

Update call metadata

Update call metadata using partial merge with dot notation paths.

How it works:

  • Accepts flat paths with dot notation: { "call.duration": 45, "tags": ["important"] }
  • Merges with existing metadata (doesn't replace everything)
  • Arrays are replaced, not merged
  • Objects are deeply merged

Examples:

Existing metadata:

{
  "call": { "duration": 30, "status": "completed" },
  "insight": { "score": 8 }
}

Update request:

{
  "metadata": {
    "call.duration": 45,
    "tags": ["important", "follow-up"],
    "insight.property_value": 1500000
  }
}

Result:

{
  "call": { "duration": 45, "status": "completed" },
  "insight": { "score": 8, "property_value": 1500000 },
  "tags": ["important", "follow-up"]
}

Notes:

  • Path must be alphanumeric with dots (e.g., "call.duration", "insight.value")
  • Multi-tenancy is enforced (can only update calls in your org)
patch/api/v1/calls/{id}

Request

  • Base URL: http://localhost:8080
  • URL: http://localhost:8080/api/v1/calls/{id}
  • Auth: bearerAuth (a scheme the document does not define)

Path parameters

idstring uuid required

Resource UUID

Request body

metadataobject required

Response

Updated

successtrue required
messagestring

Changes

No recorded changes to this operation across all 1 revision of this API.