Upsert participante por CPF

PUT 
/api/integrations/v1/participants/by-cpf/:cpf

Cria o participante se o CPF ainda não existir na organização; caso contrário, atualiza o existente. Ideal para sincronização contínua a partir de um RH/folha onde o CPF é a chave natural. O CPF do path sobrepõe qualquer cpf no corpo.

Retorna 201 quando cria e 200 quando atualiza.

Request

Responses

200

Participante existente atualizado.

201

Participante criado (CPF ainda não existia).

400

Requisição inválida (validação ou conflito de idempotência com payload diferente).

401

Credencial ausente, inválida, revogada ou expirada.

Response Headers

WWW-Authenticate

403

IP fora da allowlist ou escopo insuficiente (insufficient_scope).

429

Limite de taxa por chave excedido.