Skip to main content
DELETE
Delete a contact tag
Delete the tag identified by tagId. The operation also removes the tag from every contact in the selected Instagram account. Your API key needs the contacts:write scope. Pass the account UUID as the required account_id query parameter. The account and tag must be accessible to the key.
A successful request returns 204 with no response body.

Delete restrictions

The API returns api_contact_tag_in_use when an automation configuration references the tag. Remove or replace those references before deleting it. The resulting state is idempotent. After the tag is deleted, another request for the same tagId can return api_contact_tag_not_found.
If the API returns api_contact_tag_response_unavailable with committed: true and retryable: false, the tag changed but the response could not be verified. Do not retry automatically. List the current tag catalog first.

Authorizations

Authorization
string
header
required

Levios API key sent as a Bearer token.

Path Parameters

tagId
string<uuid>
required

Query Parameters

account_id
string<uuid>
required

Response

Successful response.