> ## 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 resolver casos > Resolva casos como falso positivo ou ameaça válida na Didit. Veja o bloqueio por lista de verificação, a exigência de notas e a aprovação 4-eyes. Prompt da API para resolver casos Copiar o prompt para a área de transferência \

\`Resolve a case through the Management API.

Endpoint:
POST https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/cases/{case_uuid}/resolve/

Authentication:
Use the x-api-key header with my Didit API key.

Request body:
\{"resolution": "FALSE_POSITIVE", "note": "Confirmed legitimate activity after reviewing documents."}
\- resolution is required: FALSE_POSITIVE (no concern found) | VALID_THREAT (concern confirmed) | INCONCLUSIVE | REQUIREMENTS_NOT_MET | REQUIREMENTS_SATISFIED.
\- note is required only when the case's blueprint has require_resolution_note enabled.
\- checker is optional and only for a blueprint with a four-eyes checker step: the user uuid of the member who must approve the resolution (the same id as assigned_to.uuid on a case, or members[].user_id on a review team). Omit it or send null to leave the resolution to the checker queue.

Behavior:
\- Blocked with 400 if the blueprint's checklist is not optional and any item is incomplete - response lists the incomplete item labels.
\- Blocked with 400 if the blueprint requires a note and none was given.
\- If the blueprint has a four_eyes_checker_blueprint configured, the resolution is staged (case.pending_resolution) and the case moves to that checker blueprint's queue instead of closing - status stays OPEN. A different user must then call approve or reject-approval.
\- Submit a four-eyes resolution as a console member. A resolution an API key submits has no recorded maker (pending_resolution.maker_email is null), so approve and reject-approval return 403 {"detail": "Case has no recorded maker for this pending resolution; approve is not permitted."} for every caller.
\- Otherwise the case closes immediately: status becomes RESOLVED, resolved_at and resolved_by_email are set.
\- On a four-eyes blueprint with checker, only that member can approve or reject the staged resolution, and the response's checker {member_uuid, name, email} names them. Any other caller, including an API key, gets 403 on approve and reject-approval. Without checker, the response's checker is null and the checker blueprint's queue decides.

Example call:
curl -X POST "https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/cases/{case_uuid}/resolve/" \
-H "x-api-key: YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{"resolution": "FALSE_POSITIVE", "note": "Confirmed legitimate activity."}'

Response 200: CaseDetail. Check pending_resolution to tell staged-for-approval apart from a completed resolution.

Failure modes:
\- 400 - incomplete checklist, or missing required note (a list of strings).
\- 400 - when checker is sent, in the order they fire:
\- ["Reviewer access could not be verified. Try again."] or ["Choose an active reviewer with case access to this application."] - the member could not be checked, or is not an active reviewer with case access.
\- {"checker": ["The officer who submitted the resolution cannot be its checker."]} - you named the officer who is resolving.
\- {"checker": ["This review policy has no checker step, so the case resolves directly."]} - the case's blueprint has no four-eyes checker step.
\- 401/403 - auth/permission errors. A key with restricted access gets 403 {"detail": "This API key has no access to this endpoint."} (cases need a full-access key). A console member token needs write:cases.
\- 404 - case not found.

For the full integration shape, see /integration/integration-prompt.`

\
Colar em Resolva um caso. Se o seu modelo estiver emparelhado com um modelo de verificador para a [revisão a quatro olhos](https://docs.didit.me/pt/console/case-management/four-eyes.md), isto coloca a resolução em espera em vez de fechar o caso. Verifique o campo `pending_resolution` da resposta para distinguir os dois resultados.## Indicar o verificadorNum modelo com um passo de verificador a quatro olhos, envie `checker` com o UUID de utilizador do membro que tem de aprovar a resolução. Só esse membro pode então aprovar ou rejeitar a resolução; qualquer outra pessoa, incluindo uma chave de API, recebe `403`. O campo `checker` do caso indica esse membro até a resolução ser aprovada, rejeitada ou devolvida para nova revisão porque as provas mudaram. Sem `checker`, a resolução fica à espera na fila do modelo de verificador. O membro tem de ter acesso aos casos desta aplicação e não pode ser o responsável que submete a resolução. Num modelo sem passo de verificador, `checker` devolve `400`.## As resoluções a quatro olhos exigem um membro da consolaSubmeta uma resolução que segue para revisão a quatro olhos como membro da consola, e não com uma chave de API. Uma resolução submetida por uma chave de API não tem criador registado, por isso as ações de aprovação e rejeição devolvem `403` a todos os chamadores, incluindo o verificador indicado.## AcessoOs endpoints de casos exigem uma [chave de API](https://docs.didit.me/pt/console/api-keys.md) com acesso total. Uma chave com acesso restrito recebe `403`.## Relacionados- [Revisão a quatro olhos (Consola)](https://docs.didit.me/pt/console/case-management/four-eyes.md) - [Obter caso](https://docs.didit.me/pt/management-api/cases/get.md) - [Lista de verificação (Consola)](https://docs.didit.me/pt/console/case-management/checklist.md) - [Atualizar estado em massa](https://docs.didit.me/pt/management-api/cases/bulk-status.md) ## OpenAPI ````yaml pt/openapi-25.json POST /v3/organization/{organization_id}/application/{application_id}/cases/{case_uuid}/resolve/ 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/organization/{organization_id}/application/{application_id}/cases/{case_uuid}/resolve/: post: tags: - Cases summary: Resolver caso description: >- Resolva o caso com uma de cinco resoluções: FALSE_POSITIVE (nenhuma preocupação encontrada), VALID_THREAT (preocupação confirmada), INCONCLUSIVE, REQUIREMENTS_NOT_MET ou REQUIREMENTS_SATISFIED. Bloqueado com 400 se a lista de verificação do blueprint não for opcional e restarem itens incompletos, ou se o blueprint exigir uma nota de resolução e nenhuma for fornecida. Quando o blueprint do caso tem um passo de verificação a quatro olhos (four_eyes_checker_blueprint), a resolução fica pendente (case.pending_resolution) e o caso avança para o blueprint do verificador em vez de ser resolvido de imediato; um responsável diferente deve chamar approve ou reject-approval. Envie uma resolução a quatro olhos como membro da consola: uma resolução enviada por uma chave de API não tem um autor registado, pelo que approve e reject-approval devolvem 403 a qualquer chamador. Num blueprint a quatro olhos pode indicar o membro que deve aprovar através de `checker`: apenas esse membro poderá aprovar ou rejeitar a resolução, e o campo `checker` da resposta identifica-o. Sem `checker`, a resolução aguarda na fila do blueprint do verificador. Enviar `checker` para um blueprint sem passo de verificação devolve 400. operationId: resolve_case parameters: - name: organization_id in: path required: true schema: type: string format: uuid description: UUID da organização. - name: application_id in: path required: true schema: type: string format: uuid description: UUID da aplicação. - name: case_uuid in: path required: true schema: type: string format: uuid example: c1a5e000-0000-4000-8000-000000000001 description: UUID do caso. requestBody: required: true content: application/json: schema: type: object required: - resolution properties: resolution: type: string enum: - FALSE_POSITIVE - VALID_THREAT - INCONCLUSIVE - REQUIREMENTS_NOT_MET - REQUIREMENTS_SATISFIED note: type: string nullable: true description: >- Obrigatório quando o blueprint define require_resolution_note. checker: type: string format: uuid nullable: true description: >- Apenas modelos de quatro olhos. O UUID de utilizador do membro que tem de aprovar esta resolução (o mesmo ID de `assigned_to.uuid` num caso, ou `members[].user_id` numa equipa de revisão). O membro tem de ter acesso a casos nesta aplicação e não pode ser o responsável que submete a resolução. Omita-o ou envie null para deixar a resolução para a fila de verificadores. examples: Resolve: value: resolution: FALSE_POSITIVE note: Confirmed legitimate activity after reviewing documents. Four-eyes blueprint with a named checker: value: resolution: VALID_THREAT note: Document tampering confirmed. checker: 3fa85f64-5717-4562-b3fc-2c963f66afa6 responses: '200': description: Resolvido, ou colocado em espera para aprovação a quatro olhos. content: application/json: schema: $ref: '#/components/schemas/CaseDetail' '400': description: >- A resolução foi recusada. Os erros não associados a campos são apresentados como uma lista de cadeias de carateres: uma checklist incompleta, uma nota obrigatória em falta ou um `checker` que não pôde ser verificado ou não é um revisor ativo com acesso a casos nesta aplicação. Os erros de `checker` surgem indexados pelo campo: o membro indicado é o responsável a submeter a resolução ou o modelo do caso não tem nenhum passo de verificação. content: application/json: schema: oneOf: - type: array items: type: string - type: object additionalProperties: type: array items: type: string examples: Incomplete checklist: value: - >- Case has incomplete checklist items: Verify source of funds Resolution note required: value: - A resolution note is required to resolve this case. Reviewer access could not be verified: value: - Reviewer access could not be verified. Try again. Checker is not an active reviewer: value: - >- Choose an active reviewer with case access to this application. Checker is the submitting officer: value: checker: - >- The officer who submitted the resolution cannot be its checker. Policy has no checker step: value: checker: - >- This review policy has no checker step, so the case resolves directly. security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -X POST 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/cases/c1a5e000-0000-4000-8000-000000000001/resolve/' \ -H 'x-api-key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"resolution": "FALSE_POSITIVE", "note": "Confirmed legitimate activity after reviewing documents."}' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID # and DIDIT_APPLICATION_ID. client = Didit() result = client.cases.resolve( "c1a5e000-0000-4000-8000-000000000001", resolution="FALSE_POSITIVE", note="Confirmed legitimate activity after reviewing documents.", ) print(result) - lang: javascript label: Node.js source: >- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. const didit = new Didit(); const result = await didit.cases.resolve("c1a5e000-0000-4000-8000-000000000001", { resolution: "FALSE_POSITIVE", note: "Confirmed legitimate activity after reviewing documents.", }); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID\n// and DIDIT_APPLICATION_ID.\nclient := didit.NewClient()\n\nresult, err := client.Cases.Resolve(ctx, \"c1a5e000-0000-4000-8000-000000000001\", didit.CasesResolveParams{\n\tResolution: \"FALSE_POSITIVE\",\n\tNote: didit.String(\"Confirmed legitimate activity after reviewing documents.\"),\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.CasesResolveParams; // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. Didit client = new Didit(); var result = client.cases().resolve("c1a5e000-0000-4000-8000-000000000001", CasesResolveParams.builder() .resolution(CasesResolveParams.Resolution.of("FALSE_POSITIVE")) .note("Confirmed legitimate activity after reviewing documents.") .build()); System.out.println(result); - lang: php label: PHP source: >- cases->resolve('c1a5e000-0000-4000-8000-000000000001', [ 'resolution' => 'FALSE_POSITIVE', 'note' => 'Confirmed legitimate activity after reviewing documents.', ]); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID # and DIDIT_APPLICATION_ID. didit = Didit::Client.new result = didit.cases.resolve( "c1a5e000-0000-4000-8000-000000000001", resolution: "FALSE_POSITIVE", note: "Confirmed legitimate activity after reviewing documents." ) puts result.to_h - lang: csharp label: .NET source: >- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. using var client = new DiditClient(); var result = await client.Cases.ResolveAsync("c1a5e000-0000-4000-8000-000000000001", new CasesResolveParams { Resolution = "FALSE_POSITIVE", Note = "Confirmed legitimate activity after reviewing documents.", }); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: CaseDetail: type: object properties: uuid: type: string format: uuid case_number: type: string nullable: true title: type: string status: type: string enum: - OPEN - AWAITING_USER - RESOLVED resolution: type: string enum: - FALSE_POSITIVE - VALID_THREAT - INCONCLUSIVE - REQUIREMENTS_NOT_MET - REQUIREMENTS_SATISFIED nullable: true resolution_notes: type: string nullable: true priority: type: string enum: - LOW - MEDIUM - HIGH source: type: string enum: - MANUAL - AML_SCREENING - TRANSACTION_RULE - WORKFLOW_BUILDER tags: type: array items: type: string subject: $ref: '#/components/schemas/CaseSubject' assigned_to: $ref: '#/components/schemas/CaseAssignee' assigned_at: type: string format: date-time nullable: true team: $ref: '#/components/schemas/CaseTeamSummary' due_at: type: string format: date-time nullable: true resolved_at: type: string format: date-time nullable: true resolved_by_email: type: string nullable: true pending_resolution: type: object nullable: true description: >- Definido apenas enquanto uma resolução 4-eyes estiver preparada no blueprint do verificador, a aguardar aprovação ou rejeição. properties: resolution: type: string enum: - FALSE_POSITIVE - VALID_THREAT - INCONCLUSIVE - REQUIREMENTS_NOT_MET - REQUIREMENTS_SATISFIED resolution_notes: type: string nullable: true maker_email: type: string format: email nullable: true description: >- E-mail do responsável que submeteu a resolução. Null quando submetida por uma chave de API: essa resolução não tem criador registado, pelo que aprovar e rejeitar aprovação devolvem 403 para qualquer chamador. maker_name: type: string nullable: true maker_user_id: type: string format: uuid nullable: true description: >- UUID de utilizador do membro que submeteu a resolução. Null quando foi submetido por uma chave de API. Esse membro não pode ser indicado como `checker`. maker_blueprint_id: type: string format: uuid staged_at: type: string format: date-time checker: $ref: '#/components/schemas/CaseChecker' metadata: type: object blueprint: $ref: '#/components/schemas/CaseBlueprintDetail' notes: type: array items: $ref: '#/components/schemas/CaseNote' description: As 50 notas mais recentes. events: type: array items: $ref: '#/components/schemas/CaseEvent' description: Os 100 eventos mais recentes. links: type: array items: $ref: '#/components/schemas/CaseLink' links_count: type: integer notes_count: type: integer checklist_items: type: array items: $ref: '#/components/schemas/CaseChecklistItem' created_at: type: string format: date-time updated_at: type: string format: date-time CaseSubject: type: object nullable: true description: O único utilizador ou a única empresa a que o caso está associado. properties: type: type: string enum: - user - business uuid: type: string format: uuid name: type: string external_id: type: string nullable: true description: O vendor_data do sujeito. country: type: string nullable: true description: >- Código de país de três letras do sujeito (ISO 3166-1 alfa-3), ou null quando não for conhecido. Para uma empresa, o respetivo país de constituição. Para uma pessoa, o país emissor de um documento de identificação das suas verificações; uma pessoa com documentos de vários países apresenta um deles, e podem surgir códigos de documentos da ICAO como `XXA`. example: ESP portrait: type: string format: uri nullable: true description: >- URL assinado de curta duração da imagem de retrato da pessoa. Sempre nulo para uma empresa, e nulo para uma pessoa sem retrato. O URL expira, pelo que deve descarregar a imagem ao consultar o caso em vez de guardar o URL. CaseAssignee: type: object nullable: true properties: uuid: type: string format: uuid full_name: type: string email: type: string format: email CaseTeamSummary: type: object nullable: true description: >- A equipa de revisão responsável pelo caso, ou null quando nenhuma equipa for responsável. O encaminhamento define-a quando uma regra de encaminhamento atribui o caso a uma das suas equipas. Altere ou limpe este valor com `PATCH .../cases/{case_uuid}/` (`team`). properties: uuid: type: string format: uuid name: type: string CaseChecker: type: object nullable: true description: >- O membro designado para aprovar ou rejeitar a resolução pendente. Definido apenas enquanto uma resolução de quatro olhos aguarda por um revisor designado. Nulo quando nada estiver pendente, enquanto a resolução pendente aguarda na fila de revisores e assim que a resolução for aprovada, rejeitada ou devolvida para uma nova revisão porque as provas foram alteradas. properties: member_uuid: type: string format: uuid description: >- O uuid de utilizador do membro: o valor que passa como `checker` ao resolver o caso. name: type: string nullable: true description: O nome completo do membro, ou nulo quando não for conhecido. email: type: string format: email CaseBlueprintDetail: type: object properties: uuid: type: string format: uuid name: type: string maxLength: 24 description: type: string nullable: true assignment_method: type: string enum: - MANUAL - AUTOMATIC assignee_pool: type: array items: type: string format: uuid max_active_cases: type: integer nullable: true escalation_enabled: type: boolean transfer_enabled: type: boolean require_resolution_note: type: boolean is_active: type: boolean preset_key: type: string nullable: true created_at: type: string format: date-time escalation_blueprint: type: string format: uuid nullable: true escalation_blueprint_name: type: string nullable: true four_eyes_checker_blueprint: type: string format: uuid nullable: true four_eyes_checker_blueprint_name: type: string nullable: true content_config: type: object description: >- As seis secções alternáveis que determinam quais os separadores e campos apresentados na página do caso. Secções ou chaves desconhecidas são rejeitadas. properties: checklist: type: object properties: enabled: type: boolean optional: type: boolean description: >- Quando for true, um caso pode ser resolvido com itens da lista de verificação incompletos. items: type: array items: type: object properties: label: type: string maxLength: 255 order: type: integer aml_control: type: object properties: enabled: type: boolean financial: type: boolean identity: type: boolean identity: type: object properties: enabled: type: boolean personal_information: type: boolean applicant_tags: type: boolean contact_information: type: boolean risk_overview: type: boolean poi_documents: type: boolean poa_documents: type: boolean verifications: type: object properties: enabled: type: boolean summary: type: boolean reporting: type: object properties: enabled: type: boolean fiu_reports: type: boolean financial: type: object properties: enabled: type: boolean payment_methods: type: boolean transactions: type: boolean creation_sources: type: array description: Conetores que atualmente encaminham novos casos para este modelo. items: type: object properties: kind: type: string enum: - aml - rule - workflow id: type: string name: type: string receives_escalation_from: type: array description: Outros esquemas cujo destino de escalamento aponta para este. items: type: object properties: id: type: string name: type: string updated_at: type: string format: date-time version: type: integer readOnly: true default_deadline_hours: type: integer nullable: true minimum: 1 maximum: 8760 CaseNote: type: object properties: uuid: type: string format: uuid comment: type: string actor_email: type: string format: email nullable: true actor_name: type: string nullable: true mentioned_emails: type: array items: type: string format: email is_internal: type: boolean attachments: type: array items: type: object properties: s3_key: type: string filename: type: string file_size: type: integer url: type: string format: uri tags: type: array items: type: string created_at: type: string format: date-time CaseEvent: type: object properties: uuid: type: string format: uuid event_type: type: string enum: - CREATED - STATUS_CHANGED - ASSIGNED - UNASSIGNED - RESOLVED - REOPENED - LINK_ADDED - LINK_REMOVED - NOTE_ADDED - NOTE_PINNED - NOTE_UNPINNED - PRIORITY_CHANGED - DUE_DATE_CHANGED - TAG_ADDED - TAG_REMOVED - ESCALATED - TRANSFERRED - CHECKLIST_COMPLETED - REPORT_CREATED - REPORT_FINALIZED - SUBMITTED_FOR_APPROVAL - APPROVAL_GRANTED - APPROVAL_REJECTED - ENTITY_ACTION - APPROVAL_INVALIDATED - CUSTOMER_REQUEST - STAGE_CHANGED - TEAM_CHANGED - CHECKER_ASSIGNED - CHECKER_UNASSIGNED actor_email: type: string format: email nullable: true actor_name: type: string nullable: true previous_status: type: string enum: - OPEN - AWAITING_USER - RESOLVED nullable: true new_status: type: string enum: - OPEN - AWAITING_USER - RESOLVED nullable: true metadata: type: object created_at: type: string format: date-time CaseLink: type: object properties: uuid: type: string format: uuid linked_entity_type: type: string enum: - session - business_session - transaction nullable: true linked_entity_uuid: type: string format: uuid nullable: true linked_entity_summary: type: object nullable: true description: >- session_id/session_number/status para ligações de sessão e business_session; uuid/txn_id/status para ligações de transação. created_at: type: string format: date-time CaseChecklistItem: type: object properties: uuid: type: string format: uuid label: type: string maxLength: 255 is_completed: type: boolean completed_by: type: string format: email nullable: true completed_at: type: string format: date-time nullable: true order: type: integer securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- A chave de API da sua aplicação, a partir de Programadores -> Chaves de API na Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter o âmbito definido: nenhum, 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á incorreta, 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 o pedido veio de um endereço fora da sua lista de IP; 404 numa rota de sessão significa que a sessão está fora dos fluxos ou estados da chave. Uma chave sem acesso a multimédia recebe URLs de imagens, vídeos e PDFs como nulos, e uma chave sem permissão de escrita em sessões recebe ligações de sessão e tokens como nulos. Consulte https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.