> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # API para atualizar usuário: entidade User do fornecedor > Atualize campos editáveis do User do fornecedor na Didit: nome de exibição, metadados e tags. Identidade verificada é imutável. Pague por chamada. Prompt para atualizar usuário Copiar o prompt para a área de transferência \

\`Goal: Partial-update a Didit User entity by vendor_data.

Endpoint: PATCH https://verification.didit.me/v3/users/{vendor_data}/
Auth header: x-api-key: 
Content-Type: application/json

Path param:
\- vendor_data (string, REQUIRED) — free-form string, NOT a UUID. URL-encode.

Request body (PARTIAL — only included fields are touched; auto-derived counters and session history are left alone):
\- full_name (string, max 512, nullable)
\- display_name (string, nullable)
\- date_of_birth (string YYYY-MM-DD, nullable)
\- status (enum) — "ACTIVE" | "FLAGGED" | "BLOCKED" (VendorUserStatusChoices). Setting "BLOCKED" auto-adds vendor_data to the system blocklist; flipping away removes it.
\- metadata (object, nullable) — REPLACES existing metadata wholesale; merge client-side if you only want to add keys.
\- approved_emails (object)
\- approved_phones (object)
\- issuing_states (object)
\- reason (string, optional, max 1000): why the status changed. Recorded as the comment of the STATUS_CHANGED entry in the user's activity (comments[].comment), only when this update actually changes status. Webhooks do not carry it.

curl:
curl -X PATCH 'https://verification.didit.me/v3/users/user-abc-123/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"display_name": "Jane S.", "status": "FLAGGED", "reason": "Address does not match the billing country"}'

Response 200: full updated UserDetailItem (same shape as GET). See /reference/data-models.

Side effects:
\- Writes to the user's comments activity log (actor derived from the API key): a STATUS_CHANGED entry with reason when status changes, and a PROFILE_UPDATED entry when display_name, full_name, date_of_birth or metadata change.
\- last_activity_at bumped to now().
\- Concurrent updates: last-write-wins per field.
\- Re-sending an unchanged body is safe (no extra audit row).

Failure modes:
\- 400 — validation. Examples:
\{ "status": ["Invalid status. Valid options are: ACTIVE, FLAGGED, BLOCKED"] }
\{ "metadata": ["Metadata must be a JSON object."] }
date_of_birth must be YYYY-MM-DD.
\{ "reason": ["Ensure this field has no more than 1000 characters."] }
\- 401 — missing/invalid x-api-key. { "detail": "Authentication credentials were not provided." }
\- 403 — the API key is revoked or is not valid for this application. { "detail": "You do not have permission to perform this action." }
\- 403: a scoped API key without users write. { "detail": "This API key has no write access to people." }
\- 404 — vendor_data not found. { "detail": "Not found." }
\- 429 — rate-limited.

Notes:
\- vendor_data in the URL itself cannot be changed via this endpoint — create new + delete old to rekey.
\- For status-only flips, prefer the dedicated PATCH /v3/users/{vendor_data}/update-status/.
\- Overriding fields populated by a verified session is allowed but flagged in the audit log.

For end-to-end Didit integration, paste in the full prompt at /integration/integration-prompt.`

\
Colar em ## Visão geralAtualiza os campos mutáveis de uma [entidade de usuário](https://docs.didit.me/pt-br/entities/users/overview.md). Os campos propagados de sessões verificadas de Verificação de Usuário (KYC) (`full_name`, `date_of_birth`, `portrait_image`, contadores agregados, `features`) são somente para leitura.## Quando usar- **Atualizar seus próprios metadados**: mover um usuário entre níveis, alterar tags, registrar uma nota interna. - **Renomear**: definir um `display_name` melhor para as visualizações internas do console. - **Substituir dados verificados** (com cautela): substituições manuais são permitidas, mas ficam registradas na trilha de auditoria.## Observações- O `vendor_data` na URL não pode ser alterado por este endpoint. Crie um novo usuário e exclua o antigo se precisar trocar a chave. - Emite um webhook `user.data.updated` com um array `changed_fields` para que os consumidores possam sincronizar com eficiência. - Uma alteração de `status` aqui funciona como [Atualizar status do usuário](https://docs.didit.me/pt-br/management-api/users/update-status.md). Ela fica registrada na atividade da pessoa, com o `reason` opcional (até 1000 caracteres) como comentário, e `BLOCKED` adiciona o `vendor_data` à lista de bloqueio do sistema. O webhook `user.status.updated` não inclui o `reason`. - Se você fizer um PATCH em um campo que está sendo gerenciado por uma sessão verificada, a substituição será aceita, mas sinalizada no [registro de auditoria](https://docs.didit.me/pt-br/console/audit-logs.md).## PermissõesO segredo principal e as [chaves de API](https://docs.didit.me/pt-br/console/api-keys.md) com acesso total sempre podem chamar este endpoint. Uma chave com acesso personalizado precisa de permissão de escrita em **Pessoas** (`users`). Uma chave limitada a alguns fluxos ou a sessões aprovadas não consegue acessar este endpoint.As [funções e permissões](https://docs.didit.me/pt-br/console/roles-permissions.md) do Console determinam o que um membro da equipe pode fazer no Console. Elas não são avaliadas em requisições feitas com chave de API.## Relacionados- [Operações de usuário](https://docs.didit.me/pt-br/entities/users/operations.md) - [Modelo de dados](https://docs.didit.me/pt-br/entities/users/data-model.md) - [Atualizar status](https://docs.didit.me/pt-br/management-api/users/update-status.md) ## OpenAPI ````yaml pt-br/openapi-25.json PATCH /v3/users/{vendor_data}/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API de verificação de identidade. Autentique-se com o cabeçalho x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/users/{vendor_data}/: patch: tags: - Users summary: Atualizar usuário description: >- Atualização parcial de um usuário: `display_name`, `full_name`, `date_of_birth`, `status`, `metadata`, `approved_emails`/`approved_phones`/`issuing_states`. `metadata` é substituído por completo. Alterar `status` aqui funciona como em [Update User Status](#patch-/v3/users/-vendor_data-/update-status/): registra uma atividade `STATUS_CHANGED` com o `reason` opcional, e `BLOCKED` adiciona o `vendor_data` à lista de bloqueio do sistema (sair de `BLOCKED` remove essa entrada). Alterações em `display_name`, `full_name`, `date_of_birth` ou `metadata` são registradas como uma atividade `PROFILE_UPDATED`. operationId: update_user parameters: - name: vendor_data in: path required: true schema: type: string description: Seu identificador exclusivo do usuário (string livre, NÃO um UUID). example: user-abc-123 requestBody: content: application/json: schema: type: object properties: full_name: type: string nullable: true maxLength: 512 description: Nome completo do usuário display_name: type: string nullable: true description: Nome de exibição personalizado para este usuário date_of_birth: type: string format: date nullable: true description: Data de nascimento no formato YYYY-MM-DD status: type: string enum: - ACTIVE - FLAGGED - BLOCKED description: >- Status do ciclo de vida do usuário. Uma alteração é registrada como uma atividade `STATUS_CHANGED`, e `BLOCKED` adiciona o `vendor_data` à lista de bloqueio do sistema (sair de `BLOCKED` remove essa entrada). metadata: type: object nullable: true description: >- Objeto JSON arbitrário que você anexa ao usuário. **Substitui totalmente** os metadados existentes na atualização — faça a mesclagem no lado do cliente se quiser apenas adicionar chaves. approved_emails: type: array items: type: string description: >- Endereços de e-mail verificados deste usuário, por exemplo, `["john@example.com"]`. Substitui completamente a lista armazenada. approved_phones: type: array items: type: string description: >- Números de telefone verificados deste usuário. Substitui completamente a lista armazenada. issuing_states: type: array items: type: string description: >- Países emissores (ISO 3166-1 alpha-3), por exemplo `["USA"]`. Substitui integralmente a lista armazenada. reason: type: string nullable: true maxLength: 1000 description: >- Por que o status mudou. Registrado na entrada de mudança de status na atividade do usuário (`comments[].comment` e **Activity** no Business Console), apenas quando o status realmente muda. Os webhooks não o incluem. examples: Rename: summary: Definir nome de exibição value: display_name: Jane S. Override status: summary: Sinalizar o usuário para revisão value: status: FLAGGED Add metadata: summary: Substituir o JSON de metadados value: metadata: tier: premium risk_level: low Fix extracted DOB: summary: Corrigir campos de perfil extraídos value: full_name: Jane Elizabeth Smith date_of_birth: '1985-11-22' Flag with reason: summary: Sinalizar o usuário e registrar o motivo value: status: FLAGGED reason: Address does not match the billing country responses: '200': description: >- Usuário atualizado. Retorna o registro completo e atualizado do usuário (mesmo formato de Get User). content: application/json: schema: $ref: '#/components/schemas/UserDetailItem' examples: Updated: value: didit_internal_id: f4e5e1f2-94a9-4f86-8c16-2b7d9b4db418 vendor_data: user-abc-123 display_name: Jane S. full_name: Jane Elizabeth Smith date_of_birth: '1985-11-22' effective_name: Jane S. status: FLAGGED metadata: tier: premium portrait_image_url: https:///... session_count: 3 approved_count: 2 declined_count: 0 in_review_count: 1 issuing_states: - USA approved_emails: - john@example.com approved_phones: - '+14155551234' features: ID_VERIFICATION: Approved LIVENESS: Approved FACE_MATCH: Approved AML: Approved features_list: - feature: ID_VERIFICATION status: Approved - feature: LIVENESS status: Approved - feature: FACE_MATCH status: Approved - feature: AML status: Approved last_session_at: '2025-06-15T10:30:00Z' last_activity_at: '2025-06-15T10:30:00Z' first_session_at: '2025-06-01T08:00:00Z' tags: - uuid: 9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d tag: uuid: e1f2a3b4-c5d6-4e7f-8a9b-0c1d2e3f4a5b name: VIP color: '#2567FF' description: null source: custom created_at: '2025-05-01T09:00:00Z' updated_at: '2025-05-01T09:00:00Z' added_by_email: analyst@acme.com added_by_name: Jane Analyst created_at: '2025-06-02T11:00:00Z' comments: [] created_at: '2025-06-01T08:00:00Z' updated_at: '2025-06-15T10:30:00Z' '400': description: >- Corpo inválido: normalmente um `status` desconhecido ou uma `date_of_birth` fora do formato `YYYY-MM-DD`. content: application/json: examples: Bad status: value: status: - '"INVALID" is not a valid choice.' Bad date_of_birth: value: date_of_birth: - >- Date has wrong format. Use one of these formats instead: YYYY-MM-DD. Reason too long: value: reason: - Ensure this field has no more than 1000 characters. '401': description: >- Nenhuma credencial fornecida. Requisições para caminhos `/v3/users/*` sem um cabeçalho `x-api-key` (ou token `Authorization: Bearer`) são rejeitadas pelo middleware de autenticação antes de chegarem à API. content: application/json: examples: Missing credentials: value: detail: >- You must be authenticated with a valid access token to access this endpoint. '403': description: >- A chave não pode atualizar usuários desta aplicação. Uma chave ausente retorna `403`; uma chave incorreta, revogada ou expirada retorna `401`. content: application/json: examples: Forbidden: value: detail: You do not have permission to perform this action. '404': description: >- Não existe nenhum usuário com o `vendor_data` informado nesta aplicação. content: application/json: examples: Not found: value: detail: Not found. '429': description: >- Limite de requisições excedido; aguarde e tente novamente após o intervalo indicado em `Retry-After`. content: application/json: examples: Rate limited: value: detail: Request was throttled. Expected available in 30 seconds. security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -X PATCH 'https://verification.didit.me/v3/users/user-abc-123/' \ -H 'x-api-key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"display_name": "Jane S.", "status": "FLAGGED"}' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.users.update( "user-abc-123", display_name="Jane S.", ) print(result) - lang: javascript label: Node.js source: |- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const result = await didit.users.update("user-abc-123", { display_name: "Jane S.", }); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Users.Update(ctx, \"user-abc-123\", didit.UsersUpdateParams{\n\tDisplayName: didit.String(\"Jane S.\"),\n})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: >- import me.didit.Didit; import me.didit.types.UsersUpdateParams; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.users().update("user-abc-123", UsersUpdateParams.builder() .displayName("Jane S.") .build()); System.out.println(result); - lang: php label: PHP source: |- users->update('user-abc-123', [ 'display_name' => 'Jane S.', ]); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.users.update( "user-abc-123", display_name: "Jane S." ) puts result.to_h - lang: csharp label: .NET source: >- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.Users.UpdateAsync("user-abc-123", new UsersUpdateParams { DisplayName = "Jane S.", }); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: UserDetailItem: type: object description: >- Detalhes completos do usuário. Estende UserListItem com metadados, comentários e updated_at. allOf: - $ref: '#/components/schemas/UserListItem' - type: object properties: metadata: type: object description: >- JSON de metadados personalizados que você anexou a este usuário. O padrão é `{}`. tags: type: array description: >- Atribuições de tags. OBSERVAÇÃO: nas respostas de detalhe, cada entrada é um objeto de *vínculo* de tag (`{uuid, tag: {...}, added_by_email, added_by_name, created_at}`), diferente do formato plano `{uuid, name, color}` usado nas respostas de lista. items: type: object properties: uuid: type: string format: uuid description: UUID da atribuição da tag (não da tag em si). tag: type: object properties: uuid: type: string format: uuid name: type: string color: type: string description: type: string nullable: true source: type: string enum: - didit - custom created_at: type: string format: date-time updated_at: type: string format: date-time added_by_email: type: string nullable: true added_by_name: type: string nullable: true created_at: type: string format: date-time comments: type: array items: type: object properties: uuid: type: string format: uuid comment_type: type: string enum: - COMMENT - STATUS_CHANGED - METADATA_UPDATED - TAG_ADDED - TAG_REMOVED - PROFILE_UPDATED comment: type: string nullable: true actor_email: type: string nullable: true actor_name: type: string nullable: true previous_status: type: string nullable: true enum: - ACTIVE - FLAGGED - BLOCKED - null new_status: type: string nullable: true enum: - ACTIVE - FLAGGED - BLOCKED - null previous_value: type: object nullable: true description: >- Valores anteriores dos campos para entradas PROFILE_UPDATED. new_value: type: object nullable: true description: Novos valores de campo para entradas PROFILE_UPDATED. changed_fields: type: array items: type: string description: >- Nomes dos campos alterados por uma entrada PROFILE_UPDATED. metadata: type: object nullable: true mentioned_emails: type: array items: type: string created_at: type: string format: date-time description: >- Registro de atividades e comentários deste usuário (alterações de status, edições de perfil, notas manuais). updated_at: type: string format: date-time UserListItem: type: object description: Um usuário verificado. properties: didit_internal_id: type: string format: uuid description: UUID interno estável da Didit para este usuário. vendor_data: type: string nullable: true description: >- Seu identificador exclusivo deste usuário (passado ao criar sessões). Pode ser nulo quando nenhum identificador do fornecedor foi informado. display_name: type: string nullable: true description: Nome de exibição personalizado definido por você full_name: type: string nullable: true description: Nome completo extraído dos documentos verificados date_of_birth: type: string format: date nullable: true effective_name: type: string nullable: true description: >- Melhor nome disponível: display_name, se definido; caso contrário, full_name status: type: string enum: - ACTIVE - FLAGGED - BLOCKED description: >- Status do ciclo de vida do registro do usuário (NÃO é um status de sessão). `ACTIVE` é o padrão, `FLAGGED` marca o usuário para atenção manual e `BLOCKED` impede novas sessões para este `vendor_data`. portrait_image_url: type: string nullable: true description: >- URL pré-assinada da foto de retrato do usuário (expira após algumas horas) session_count: type: integer description: Número total de sessões de verificação deste usuário approved_count: type: integer description: Número de sessões aprovadas declined_count: type: integer description: Número de sessões recusadas in_review_count: type: integer description: Número de sessões em revisão issuing_states: type: array items: type: string description: >- Códigos ISO 3166-1 alpha-3 dos países emissores encontrados nos documentos de identidade aprovados deste usuário, por exemplo, `["USA", "ESP"]`. Array vazio quando não houver nenhum. approved_emails: type: array items: type: string description: >- Endereços de e-mail verificados coletados das sessões aprovadas deste usuário, por exemplo, `["john@example.com"]`. approved_phones: type: array items: type: string description: >- Números de telefone verificados coletados das sessões aprovadas deste usuário, por exemplo, `["+14155551234"]`. features: type: object description: >- Status agregado por recurso em todas as sessões deste usuário. Chaves possíveis: `ID_VERIFICATION`, `NFC`, `LIVENESS`, `FACE_MATCH`, `POA`, `QUESTIONNAIRE`, `EMAIL_VERIFICATION`, `PHONE`, `AML`, `IP_ANALYSIS`, `AGE_ESTIMATION`, `DATABASE_VALIDATION`. Valores possíveis: `Approved`, `Declined`, `In Review`, `Not Finished`, `Resub Requested`. features_list: type: array items: type: object properties: feature: type: string status: type: string description: >- Os mesmos dados de `features`, como um array ordenado de objetos `{feature, status}`. last_session_at: type: string format: date-time nullable: true description: Data e hora da sessão mais recente first_session_at: type: string format: date-time nullable: true description: Data e hora da primeira sessão last_activity_at: type: string format: date-time nullable: true description: >- Data e hora da atividade mais recente deste usuário (sessão, transação, mudança de status, edição de dados etc.). tags: type: array items: type: object properties: uuid: type: string format: uuid name: type: string color: type: string description: Tags atribuídas a este usuário created_at: type: string format: date-time securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- 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. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.