VoiceGateway

Save call tags and archive state if the read revision is still current

PUT
/api/v1/org/{orgId}/project/{projectId}/calls/{callId}/metadata

Authorization

consoleSession
cookievg_session<token>

The console's session cookie, set when you sign in. Every operation accepts it, at the role the operation names.

Path Parameters

orgId*string

Authorised orgId; the server must verify organisation/project ownership before any read.

Length1 <= length
projectId*string

Authorised projectId; the server must verify organisation/project ownership before any read.

Length1 <= length
callId*string

Immutable call UUID within the named project.

Formatuuid

Request Body

application/json
  1. body

Replace tags and archive state only when revision matches. Clear tags with an empty array. A stale revision returns 409 without changing persisted data.

tags*array<>

Normalized lowercase tags belonging to this immutable call ID.

Itemsitems <= 32
archived*boolean

Reversible archive state. Does not delete evidence or resolve findings.

revision*integer
Range0 <= value <= 9007199254740991

Response Body

Persisted call metadata with the new revision.

application/json
  1. response
tags*array<>

Normalized lowercase tags belonging to this immutable call ID.

Itemsitems <= 32
archived*boolean

Reversible archive state. Does not delete evidence or resolve findings.

revision*integer
Range0 <= value <= 9007199254740991
Example Request
curl -X PUT 'https://example.com/api/v1/org/string/project/string/calls/497f6eca-6276-4993-bfeb-53cbbbba6f08/metadata' \  -H 'Content-Type: application/json' \  -d '{  "tags": [    "string"  ],  "archived": true,  "revision": 0}'
Example Response
{  "tags": [    "string"  ],  "archived": true,  "revision": 0}

Was this page helpful?