Saltar al contenido principal
POST
Crear etiqueta

Autorizaciones

Authorization
string
header
requerido

Clave API creada en la configuración de la organización.

Encabezados

Idempotency-Key
string

Clave única de la operación. Repetir la misma clave con el mismo cuerpo devuelve la respuesta original en lugar de ejecutarla de nuevo.

Cuerpo

application/json
name
string
requerido

Nombre de la etiqueta, único en la tienda.

Required string length: 1 - 256
color
string
predeterminado:9CA3AF

Color en hexadecimal de 6 dígitos, como 9CA3AF.

Pattern: ^#?[0-9A-Fa-f]{6}$
operation_id
string

Identificador único opcional de esta llamada, como un UUID. Repite el mismo valor solo para reintentar la misma llamada: el reintento devuelve el primer resultado en lugar de crear de nuevo. El mismo valor con otro contenido se rechaza con 409.

Required string length: 8 - 128

Respuesta

Etiqueta creada.

object
string
requerido
Allowed value: "tag"
id
string
requerido
Pattern: ^tag_[A-Za-z0-9_-]+$
name
string
requerido
color
string
requerido
created_at
string<date-time>
requerido