---
title: "Add tags to specific call"
method: POST
path: "/call/tag"
tags: ["call"]
---

# Add tags to specific call

`POST /call/tag`

Assigns one or more tags to a specific call record for categorization and organization. Tags enable easier filtering and grouping of calls based on custom criteria.

## Request body

- CallTagPost
  - `tag_name` string[], required — Client-defined tag label. String. Note: some production tags have leading/trailing whitespace.
  - `call_id` integer, required — Unique identifier for the call record. Integer. Use as the primary key when cross-referencing other endpoints (e.g., /call/transcription, /call/tag).

## Response `200`

Confirmation of tag assignment with result status

- PostResponse
  - `result` string, required — Outcome of the request. String, typically 'success' or 'error'.
  - `err` string, required — Error message when result='error'. String. Empty/null on success.
  - `data` string — Response payload. Shape varies by endpoint.

## Other responses

- `default` — Unexpected error

---

[API](https://skmtc.dev/convirza/apis/convirza-apis.md) · [All operations](https://skmtc.dev/convirza/apis/convirza-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/convirza/convirza-apis/revisions/ccf9bbe34f5a/schema)