Tag a conversation

POST

/v2/conversations/service-account/conversationId/tags

Sets the full list of tags on a conversation. This is a full replace, not incremental — any tag currently attached but not included in TagIds is removed, and any new tag ID is attached.

Intent	What to send
Set tags	Array of all desired tag IDs
Add a tag	Fetch current tags, append the new ID, resend the full list
Remove one tag	Fetch current tags, drop that ID, resend the remaining list
Clear all tags	Empty array `[]`

Use GET /v1/tags/service-account to list all available tags and their IDs.

Response: 200 OK with an empty body. To verify the updated state, call GET /v2/conversations/service-account/{conversationId} afterward.

Request

Path Params

Body Params application/json

Examples

Responses

🟢200OK

application/json

Tags updated successfully. Empty body — call GET /v2/conversations/service-account/{conversationId} to verify the updated state.

Bodyapplication/json

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

cURL

Set two tagsClear all tags

curl --location 'https://api.voxa.sa/v2/conversations/service-account/conversationId/tags' \
--header 'Content-Type: application/json' \
--data '{
    "TagIds": [
        "3a1d7c...............",
        "3a1acd..............."
    ]
}'

Response Example

200 - Example 1

{}

Modified at 2026-07-27 12:05:18

Create Outbound IVR

Create Tag