Place a tag
| Method | tag.call |
|---|---|
| API version | v4.0 |
| Description | Tagging an active call |
| Return to list of methods | |
The tag can only be assigned to an active call. A completed call can be tagged using the DATA API method - Setting a call tag
Request parameters
| Title | Type | Required | Description |
|---|---|---|---|
| access_token | string | yes | Authentication session key |
| call_session_id | number | yes | A unique call session identifier that can be received in a response message when calling the start.informer_call, start.vnumber_call, start.scenario_call, start.employee_call methods using the notification server or DATA API. |
| tag_id | number | yes | A unique tag identifier that can be obtained using the DATA API method - Getting a list of tags |
Example request```json
{ "jsonrpc": "2.0", "method": "tag.call", "id": "req1", "params": { "access_token": "2fRN4g217ca0b4224a67988aff3e584f91964a692045415f36fa66146f5a3c1ae1f6093d", "call_session_id": 2846590, "tag_id": 36 } }
#### Sample answer```json
{
"jsonrpc": "2.0",
"id": "req1",
"result": {
"data": {
"success": "true"
}
}
}
List of returned errors
| Error text | Error code | Error mnemonics | Description |
|---|---|---|---|
Tag with {tag_id} not found |
-32602 | tag_not_found |
|
| Duplicate tag | -32602 | duplicate_tag |
See also section "List of errors common to all methods"