Pular para o conteúdo principal
PATCH
cURL
Use PATCH para atualizações parciais. Para renomear um fluxo de verificação (workflow), envie apenas workflow_label.
Para alterar as verificações do fluxo, envie o array features completo que você deseja. Ele substitui a ordem e a configuração anteriores dos recursos.
A API v3 mantém os fluxos simples: um caminho linear e uma etapa final de status. Ramificações, nós de ação e nós de webhook não são aceitos aqui.

Referência de configuração de recursos

Quando você envia features em um PATCH, o array substitui a ordem e a configuração anteriores dos recursos. Inclua novamente todas as configurações obrigatórias. O objeto config específico depende do recurso. Consulte a lista completa de campos, os valores padrão, as configurações obrigatórias, os intervalos de valores e os exemplos em Configurações de recursos do fluxo. Para OCR, omita config.documents_allowed, envie null ou envie {} para permitir todos os tipos de documento compatíveis. Inclua esse campo apenas quando quiser restringir o fluxo a países ou tipos de documento específicos. Para QUESTIONNAIRE, config.questionnaire_uuid é obrigatório.

Atualizando as configurações do fluxo

Você pode atualizar parcialmente as configurações das sessões sem alterar a lista de recursos. Envie apenas os campos que deseja alterar.
Use o uuid do fluxo retornado pelo endpoint de listagem, criação ou consulta como settings_uuid nesta URL.

Autorizações

x-api-key
string
header
obrigatório

Chave de API da sua aplicação, em Developers -> API keys no Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter escopo restrito: nenhum acesso, leitura ou escrita por recurso, limitada a alguns fluxos ou a sessões aprovadas, a uma lista de endereços IP e a uma data de validade. 401 significa que a chave está errada, revogada ou expirada; 403 significa que nenhuma chave foi enviada, que a chave não tem acesso a este recurso ou ação, ou que a requisição veio de um endereço fora da sua lista de IPs; 404 em uma rota de sessão significa que a sessão está fora dos fluxos ou status da chave. Uma chave sem acesso a mídia recebe URLs de imagem, vídeo e PDF como null, e uma chave sem permissão de escrita em sessões recebe links e tokens de sessão como null. Consulte https://docs.didit.me/console/api-keys.

Parâmetros de caminho

settings_uuid
string<uuid>
obrigatório

UUID da versão do fluxo a ser atualizada.

Corpo

application/json

Atualize os metadados do fluxo de verificação ou substitua a lista linear completa de recursos. Lista de campos permitidos ESTRITA: qualquer chave não listada aqui é rejeitada com 400.

workflow_label
string

Nome de exibição do fluxo de verificação (workflow) (máximo de 50 caracteres).

Maximum string length: 50
is_default
boolean

Define este fluxo como padrão para novas sessões.

status
enum<string>

Controla o versionamento. Omita para atualizar a versão atual no próprio lugar (rascunhos são publicados automaticamente). published em uma versão já publicada cria e retorna uma NOVA versão. draft só é válido enquanto a versão ainda é um rascunho.

Opções disponíveis:
draft,
published
features
object[]

Se informado, substitui toda a ordem e a configuração dos recursos.

Minimum array length: 1
is_white_label_enabled
boolean

Ativa a personalização de marca própria para as sessões criadas com este fluxo.

is_desktop_allowed
boolean

Permite que o fluxo de verificação seja executado em navegadores desktop.

max_retry_attempts
integer

Número máximo de novas tentativas permitidas após uma verificação recusada. 0 bloqueia o usuário após a primeira recusa.

Intervalo obrigatório: 0 <= x <= 10
retry_window_days
integer | null

Janela móvel em dias usada para contar as novas tentativas. null aplica um limite para todo o histórico.

Intervalo obrigatório: 1 <= x <= 365
face_liveness_max_attempts
integer

Número máximo de envios de prova de vida por sessão. Esse valor também é copiado para os nós de prova de vida e de estimativa de idade gerados no fluxo de verificação (workflow), a menos que a configuração no nível do recurso o substitua.

Intervalo obrigatório: 1 <= x <= 3
face_match_max_attempts
integer

Número máximo de envios de correspondência facial por sessão. Esse valor também é copiado para os nós de correspondência facial gerados no fluxo de verificação (workflow), a menos que a configuração no nível do recurso o substitua.

Intervalo obrigatório: 1 <= x <= 3
session_expiration_time
integer

Segundos até a expiração de uma sessão não concluída. Mínimo de 1 hora (3600), máximo de 4 semanas (2419200).

Intervalo obrigatório: 3600 <= x <= 2419200

Resposta

Fluxo atualizado. O corpo é a configuração COMPLETA da versão resultante (mesmo formato bruto de VerificationSettings que GET /v3/workflows/{settings_uuid}/). Quando a atualização cria uma nova versão (status: "published" enviado em um registro publicado), o uuid e a version retornados diferem dos que você alterou; use o uuid retornado nas chamadas seguintes.

Os campos abaixo são tipados; o objeto também traz todas as outras colunas da configuração do fluxo de verificação (ativação de recursos, limiares, ações de aviso, documentos permitidos, callbacks) como propriedades adicionais. Os campos que não se aplicam ao workflow_type são null.

uuid
string<uuid>

Identificador da versão (settings_uuid). Cada versão de um fluxo tem o seu próprio.

workflow_id
string<uuid>

Identificador estável compartilhado por todas as versões do fluxo. As sessões criadas com ele usam a versão publicada mais recente.

workflow_label
string

Nome de exibição do fluxo.

workflow_type
enum<string> | null

Modelo do fluxo. null para fluxos em grafo criados sem modelo.

Opções disponíveis:
kyc,
kyb,
adaptive_age_verification,
biometric_authentication,
address_verification,
questionnaire_verification,
email_verification,
phone_verification,
null
is_default
boolean

Se este é o fluxo de verificação (workflow) padrão da aplicação.

is_archived
boolean

Fluxos arquivados não podem iniciar novas sessões.

version
integer

Número da versão dentro do fluxo.

status
enum<string>

As versões de rascunho são editáveis; as versões publicadas são imutáveis e usadas para novas sessões.

Opções disponíveis:
draft,
published
published_at
string<date-time> | null

Quando esta versão foi publicada. null para rascunhos.

is_simple_workflow
boolean

true quando o fluxo não tem um workflow_graph personalizado.

is_editable
boolean

true apenas para versões draft.

workflow_url
string<uri>

URL pública que inicia uma sessão com este fluxo.

workflow_graph
object | null

Estrutura de grafo do fluxo (nós e arestas). null para fluxos simples.

features
string

Recursos ativados unidos por " + ", por exemplo "OCR + LIVENESS".

total_price
number | null

Preço por sessão; para fluxos em grafo, o caminho mais caro.

min_price
number | null

Preço do caminho mais barato do fluxo.

max_price
number | null

Preço do caminho mais caro do fluxo.

special_add_on_prices
object | null

Preços de complementos específicos da organização, ou null quando nenhum está definido.

max_retry_attempts
integer

Novas tentativas permitidas após uma verificação recusada.

retry_window_days
integer | null

Dias durante os quais as novas tentativas são permitidas.

session_expiration_time
integer

Segundos até a expiração de uma sessão não concluída.

questionnaire
object | null

O questionário vinculado ao fluxo, ou null.

kyb_role_settings
object[]

Configurações de verificação por função para as pessoas-chave do KYB.

created_at
string<date-time>
updated_at
string<date-time>
signature_availability
object

Quais níveis de Assinatura eletrônica podem assinar neste momento. Verifique antes de definir signature_level. Retornado em fluxos kyc, kyb e de grafo.

is_bank_verification_enabled
boolean

Indica se um fluxo simples de KYC ou KYB executa a Verificação bancária. Ela é executada após as etapas de contato (e a Verificação de localização) e antes da validação de banco de dados, da AML e da análise de IP. A Verificação bancária ainda não está disponível para todos: ativá-la é recusado onde quer que ela não esteja habilitada.

bank_verification_config
object

Configurações de verificação bancária de um fluxo simples, com as mesmas chaves aceitas por um nó BANK_VERIFICATION (por exemplo, bank_countries e bank_method_order). Chaves desconhecidas são descartadas. Todas as chaves são opcionais e uma chave ausente mantém seu valor padrão, então {} significa todos os valores padrão. Consulte Configurações de verificação bancária.

Exemplo:
is_geolocation_enabled
boolean

Indica se um fluxo simples de KYC executa a Verificação de localização. Ela é executada após as etapas de contato e antes da Verificação bancária e da validação de banco de dados. Fluxos de empresas (KYB) não podem executá-la.

geolocation_config
object

Configurações de verificação de localização de um fluxo de verificação (workflow) simples, com as mesmas chaves que um nó GEOLOCATION aceita (por exemplo, is_geolocation_geofencing_enabled e geolocation_max_attempts). Chaves desconhecidas são descartadas. Todas as chaves são opcionais e uma chave ausente mantém seu valor padrão, então {} significa todos os valores padrão.

Exemplo:
Última modificação em 1 de novembro de 2026