Pular para o conteúdo principal
POST
Atualizar segmento

Autorizações

Authorization
string
header
obrigatório

API key criada nas configurações da organização.

Cabeçalhos

Idempotency-Key
string

Chave única da operação. Repetir a mesma chave com o mesmo corpo devolve a resposta original em vez de executar de novo.

Parâmetros de caminho

segment_id
string
obrigatório

ID público do segmento.

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

Corpo

application/json

Envie ao menos um campo. match só vale junto com conditions; sem match, as condições usam all.

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

all: clientes que atendem a todas as condições. any: clientes que atendem a pelo menos uma.

Opções disponíveis:
all,
any
conditions
object[]

A lista completa nova de condições, não só o que mudou. Só para segmentos por filtros.

Required array length: 1 - 30 elements

Uma condição de um segmento por filtros. O mesmo formato entra na criação, na atualização e na prévia e volta em GET /v1/segments/{segment_id}.

operation_id
string

Identificador único opcional desta chamada, como um UUID. Repita o mesmo valor só para tentar de novo a mesma chamada: a nova tentativa devolve o primeiro resultado em vez de criar de novo. O mesmo valor com outro conteúdo é recusado com 409.

Required string length: 8 - 128

Resposta

Segmento atualizado.

object
string
obrigatório
Allowed value: "segment_write"
segment
object
obrigatório
next_step
string
obrigatório