Skip to main content
POST
cURL

Quando usar

Modo de resposta com revisão: a IA avaliou e a decisão é sua.

As três saídas

A resposta é a solicitação inteira, já com o item no status novo. Item que não está aguardando decisão responde 409, e cada item aceita até 3 pedidos de reenvio: depois disso, aprove ou dispense.
Em RESEND_REQUESTED, o comment é o texto que o cliente lê. Escreva o que precisa ser corrigido, não o código da verificação.
Contexto e vocabulário em Solicitações de coleta. Autenticação, versionamento e capacidades em Visão geral da API.

Authorizations

Authorization
string
header
required

Enter JWT token

Path Parameters

id
string
required

Id da solicitacao.

itemId
string
required

Id do item.

Body

application/json
decision
enum<string>
required
Available options:
APPROVED,
RESEND_REQUESTED,
WAIVED
comment
string

Obrigatorio em RESEND_REQUESTED: e o texto que o destinatario le. Opcional nas outras decisoes.

Maximum string length: 500

Response

O detalhe da solicitacao inteira, ja com o item no status resultante (mesmo corpo de GET /v1/collections/{id}). APPROVED leva o item a VALIDATED, WAIVED a WAIVED e RESEND_REQUESTED de volta a PENDING, com o comentario em rejectionReason.

Uma solicitacao de coleta com itens, destinatarios e trilha.

id
string
registryId
string
templateId
string | null
templateSlug
string | null
templateName
string | null
templateVersion
integer | null
status
enum<string>
Available options:
DRAFT,
SENT,
IN_PROGRESS,
COMPLETED,
EXPIRED,
CANCELED
responseMode
enum<string>
Available options:
AUTOMATIC,
REVIEW
channel
enum<string>

NONE: a plataforma nao avisou ninguem e quem entrega o link e voce.

Available options:
WHATSAPP,
EMAIL,
BOTH,
NONE
reminders
integer[]

Dias apos o envio.

behavior
object

O comportamento herdado do modelo.

message
string | null

Recado do operador ao destinatario.

dueAt
string<date-time> | null
sentAt
string<date-time> | null
completedAt
string<date-time> | null
canceledAt
string<date-time> | null
subjectName
string | null

Resumo do cadastro alvo, para evitar uma segunda chamada.

subjectDocument
string | null
items
object[]
recipients
object[]
events
object[]

A trilha, append-only. O detalhe traz os 100 eventos mais recentes.

registry
object | null

O cadastro alvo: id, document, name e entityType.

itemsTotal
integer
itemsResolved
integer
itemsAwaitingOperator
integer

Itens esperando decisao humana (AWAITING_OPERATOR ou MANUAL_REVIEW).

progress
object

Contagem de itens (total, resolved, validated, awaitingOperator, rejected, pending) e de destinatarios (recipientsTotal, recipientsExpected, recipientsCompleted, recipientsWithoutItems).

createdAt
string<date-time>
updatedAt
string<date-time>