Saltar al contenido principal
POST
Actualizar segmento

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.

Parámetros de ruta

segment_id
string
requerido

ID público del segmento.

Pattern: ^seg_[A-Za-z0-9_-]+$

Cuerpo

application/json

Envía al menos un campo. match solo vale junto con conditions; sin match, las condiciones usan all.

name
string
Required string length: 1 - 200
description
string
Maximum string length: 1000
match
enum<string>

all: clientes que cumplen todas las condiciones. any: clientes que cumplen al menos una.

Opciones disponibles:
all,
any
conditions
object[]

La lista completa nueva de condiciones, no solo lo que cambió. Solo para segmentos por filtros.

Required array length: 1 - 30 elements

Una condición de un segmento por filtros. El mismo formato entra en la creación, la actualización y la vista previa y vuelve en GET /v1/segments/{segment_id}.

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

Segmento actualizado.

object
string
requerido
Allowed value: "segment_write"
segment
object
requerido
next_step
string
requerido