Add a tag to a call

Adds one of your call tags to a call.

POST https://cotlet.dev/api/v1/ringover/calls/{call_id}/tag

write

Adds the tag to the call, as when you pick Add a tag in the call logs. The tag must exist in list_call_tags, and your Ringover user needs the Tag calls permission; without it the call fails and the agent reports that. It returns the tags the call has now. The tag reaches no one and remove_call_tag undoes it in one call, so it does not wait for your OK.

Parameters

Parameters: add_call_tag
NameTypeDescription
call_id string required string Call ID from list_calls.
tag string required string Tag name from list_call_tags.

Request

cURL
curl -X POST https://cotlet.dev/api/v1/ringover/calls/c_91e04a77/tag \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tag":"Demo booked"}'
Python
result = client.call("ringover", "add_call_tag", {"call_id":"c_91e04a77","tag":"Demo booked"})
Node.js
const result = await cotlet.call('ringover', 'add_call_tag', {"call_id":"c_91e04a77","tag":"Demo booked"});
CLI
cotlet call ringover add_call_tag --data '{"call_id":"c_91e04a77","tag":"Demo booked"}'

Example response

JSON

{
  "call_id": "c_91e04a77",
  "tags": [
    "Demo booked"
  ]
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.