Skip to main content
PATCH
Update a contact tag
Rename the tag identified by tagId. levios also updates that tag name on its current contact assignments. Your API key needs the contacts:write scope. The tag and account_id must belong to an Instagram account that the key can access.

Request body

Send exactly these fields:
  • account_id: the UUID of the Instagram account.
  • name: the new tag name.
levios trims name and collapses consecutive whitespace to one space. The normalized name must contain 1 through 50 characters. The raw input can contain at most 200 characters, and the normalized result cannot contain control characters.

Rename restrictions

The API returns api_contact_tag_conflict when another tag already uses the normalized name. It returns api_contact_tag_in_use when an automation configuration references the current name. Update those automation configurations before renaming the tag. Sending the tag’s current normalized name leaves it unchanged and returns the current tag. The operation is idempotent.
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. Read the current tag catalog before deciding whether to send another request.

Authorizations

Authorization
string
header
required

Levios API key sent as a Bearer token.

Path Parameters

tagId
string<uuid>
required

Body

application/json
account_id
string<uuid>
required
name
any
required

Response

Successful response.