> ## 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. # Remover tag de rede de fraude via API > Remova uma tag da sua aplicação de uma rede de fraude na Didit. A resposta traz os detalhes da rede com as tags restantes. Prompt da API para remover tag de rede Copiar o prompt para a área de transferência \

\`Remove one of my application's tags from a fraud network through the Management API.

Endpoint:
POST https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/networks/{network_uuid}/tags/remove/

Authentication:
Use the x-api-key header with my Didit API key.
Networks endpoints need a full-access API key: a key with restricted access gets 403.

Path parameter:
\- network_uuid: the network's UUID, from list networks.

Request body:
\{"tag_uuid": ""}

Example call:
curl -X POST "https://verification.didit.me/v3/organization/{organization_id}/application/{application_id}/networks/{network_uuid}/tags/remove/" \
-H "x-api-key: YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{"tag_uuid": "7c9e6679-7425-40de-944b-e07fc1f90ae7"}'

Behavior:
\- 200 with the network detail (same shape as get network). Its tags array no longer lists the tag.
\- Only my application's own tags can be removed. fraud_tags (the tags the members carry) is not affected.
\- Removing a tag that is not on the network is a 404, so a retry after a success returns 404.

Failure modes:
\- 400: tag_uuid missing or not a UUID. {"tag_uuid": ["This field is required."]}
\- 404: {"detail": "Network not found."}, {"detail": "Tag not found."} (the tag does not exist or belongs to another application), or {"detail": "This tag is not on the network."}.
\- 401: missing or invalid x-api-key.
\- 403: the API key belongs to another application, or it has restricted access (Networks needs a full-access key). A console member token needs write:networks.
\- 403 with {"code": "networks_not_entitled"}: Networks is not enabled for the organization.

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

\
Colar em Remova uma das tags da sua aplicação de uma rede. Passe o UUID da tag como `tag_uuid`: o mesmo `uuid` listado em `tags` no detalhe da rede. A resposta é o [detalhe da rede](https://docs.didit.me/pt-br/management-api/networks/get.md) completo, cujo `tags` não lista mais a tag.| Status | Quando | | - | - | | `200` | A tag foi removida da rede. | | `404` `Network not found.` | A rede não existe ou não tem nenhum membro visível para a sua aplicação. | | `404` `Tag not found.` | A tag não existe ou pertence a outra aplicação. | | `404` `This tag is not on the network.` | A tag é sua, mas não está na rede. |As `fraud_tags` da rede, ou seja, as tags que os membros dela carregam, não são afetadas.## Conteúdo relacionado- [Adicionar tag de rede](https://docs.didit.me/pt-br/management-api/networks/add-tag.md) - [Obter rede](https://docs.didit.me/pt-br/management-api/networks/get.md) - [Listar redes](https://docs.didit.me/pt-br/management-api/networks/list.md) ## OpenAPI ````yaml pt-br/openapi-25.json POST /v3/organization/{organization_id}/application/{application_id}/networks/{network_uuid}/tags/remove/ 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}/networks/{network_uuid}/tags/remove/: post: tags: - Networks summary: Remover uma tag de uma rede description: >- Remove da rede uma das tags da sua aplicação. Retorna o detalhe da rede. Retorna 404 quando a tag não está na rede ou não pertence à sua aplicação. Requer uma chave de API com acesso total, ou `write:networks` para um membro do console. operationId: remove_network_tag 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: network_uuid in: path required: true schema: type: string format: uuid example: 3fa85f64-5717-4562-b3fc-2c963f66afa6 description: UUID da rede. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/NetworkTagRequest' example: tag_uuid: 7c9e6679-7425-40de-944b-e07fc1f90ae7 responses: '200': description: A tag foi removida da rede. Retorna o detalhe da rede. content: application/json: schema: $ref: '#/components/schemas/NetworkDetailResponse' example: uuid: 3fa85f64-5717-4562-b3fc-2c963f66afa6 network_id: N-0042 name: null status: in_review risk: score: 82 band: high bar: 0.82 pattern_types: - exact_same_device - same_email signal_types: - device - email member_counts: total: 3 users: 3 businesses: 0 transaction_parties: 0 member_status: approved: 1 declined: 1 in_review: 0 not_completed: 1 signal_coverage: device: signals: 1 subjects: 3 coverage: 1 email: signals: 1 subjects: 2 coverage: 0.6667 first_activity_at: '2026-10-01T09:12:44Z' last_activity_at: '2026-10-12T16:03:10Z' stats: members: total: 3 users: 3 businesses: 0 transaction_parties: 0 member_status: approved: 1 declined: 1 in_review: 0 not_completed: 1 signals: total: 2 by_type: device: signals: 1 subjects: 3 coverage: 1 email: signals: 1 subjects: 2 coverage: 0.6667 fraud_tags: [] risk_signals: residential_proxy_reuse: detected: false signal_count: 0 max_subject_count: 0 email_intelligence: enriched_signal_count: 1 high_risk_count: 0 social_profile_count: 0 phone_intelligence: enriched_signal_count: 0 high_risk_count: 0 reviewed_at: '2026-10-12T16:30:00Z' reviewed_by: reviewer@example.com review_reason: Shared device across three new accounts. notes_count: 0 sharing_mode: global cross_org_available: true cross_org_unavailable_reason: null tags: [] outcomes: approved: 1 declined: 1 in_review: 0 total: 3 patterns: - type: background score: 0.8125 members: 3 reason: null computed_at: '2026-10-13T08:00:00Z' '400': description: 'Corpo inválido: `tag_uuid` está ausente ou não é um UUID.' content: application/json: schema: type: object properties: tag_uuid: type: array items: type: string examples: Missing tag_uuid: summary: tag_uuid ausente value: tag_uuid: - This field is required. Invalid tag_uuid: summary: tag_uuid inválido value: tag_uuid: - Must be a valid UUID. '401': description: Credenciais ausentes ou inválidas. content: application/json: schema: type: object properties: detail: type: string code: type: string description: >- Presente em erros com código, por exemplo `networks_not_entitled`. examples: Missing or invalid credentials: summary: Credenciais ausentes ou inválidas value: detail: >- Authentication credentials were not provided or are invalid. '403': description: >- A chave de API pertence a outra aplicação ou é uma chave com acesso restrito: os endpoints de Networks exigem uma chave com acesso total. Um token de membro do console precisa de `write:networks`. Também é retornado com `code: networks_not_entitled` quando o Networks não está habilitado para a organização. content: application/json: schema: type: object properties: detail: type: string code: type: string description: >- Presente em erros com código, por exemplo `networks_not_entitled`. examples: Networks not enabled: summary: Redes não habilitadas value: detail: >- Networks is disabled for this organization. Contact Didit support if you believe this is an error. code: networks_not_entitled Restricted API key: summary: Chave de API restrita value: detail: This API key has no access to this endpoint. No permission: summary: Sem permissão value: detail: You do not have permission to perform this action. '404': description: Não encontrado. content: application/json: schema: type: object properties: detail: type: string code: type: string description: >- Presente em erros com código, por exemplo `networks_not_entitled`. examples: Network not found: summary: Rede não encontrada value: detail: Network not found. Tag not found: summary: Tag não encontrada value: detail: Tag not found. Tag not on the network: summary: A tag não está na rede value: detail: This tag is not on the network. 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/networks/3fa85f64-5717-4562-b3fc-2c963f66afa6/tags/remove/' \ -H 'x-api-key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"tag_uuid": "7c9e6679-7425-40de-944b-e07fc1f90ae7"}' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID # and DIDIT_APPLICATION_ID. client = Didit() result = client.networks.remove_tag( "3fa85f64-5717-4562-b3fc-2c963f66afa6", tag_uuid="7c9e6679-7425-40de-944b-e07fc1f90ae7", ) 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.networks.removeTag("3fa85f64-5717-4562-b3fc-2c963f66afa6", { tag_uuid: "7c9e6679-7425-40de-944b-e07fc1f90ae7", }); 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.Networks.RemoveTag(ctx, \"3fa85f64-5717-4562-b3fc-2c963f66afa6\", didit.NetworkTagRequest{\n\tTagUUID: \"7c9e6679-7425-40de-944b-e07fc1f90ae7\",\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.NetworkTagRequest; // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID // and DIDIT_APPLICATION_ID. Didit client = new Didit(); var result = client.networks().removeTag("3fa85f64-5717-4562-b3fc-2c963f66afa6", NetworkTagRequest.builder() .tagUuid("7c9e6679-7425-40de-944b-e07fc1f90ae7") .build()); System.out.println(result); - lang: php label: PHP source: >- networks->removeTag('3fa85f64-5717-4562-b3fc-2c963f66afa6', [ 'tag_uuid' => '7c9e6679-7425-40de-944b-e07fc1f90ae7', ]); 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.networks.remove_tag( "3fa85f64-5717-4562-b3fc-2c963f66afa6", tag_uuid: "7c9e6679-7425-40de-944b-e07fc1f90ae7" ) 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.Networks.RemoveTagAsync("3fa85f64-5717-4562-b3fc-2c963f66afa6", new NetworkTagRequest { TagUuid = "7c9e6679-7425-40de-944b-e07fc1f90ae7", }); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: NetworkTagRequest: type: object required: - tag_uuid properties: tag_uuid: type: string format: uuid description: UUID de uma das tags da sua aplicação. example: tag_uuid: 7c9e6679-7425-40de-944b-e07fc1f90ae7 NetworkDetailResponse: description: >- Os detalhes da rede, além do modo de compartilhamento da organização, se os sinais entre organizações se aplicam a ela, as tags da sua aplicação na rede, os resultados dos membros e as pontuações de padrões. allOf: - $ref: '#/components/schemas/NetworkDetail' - type: object properties: sharing_mode: type: string enum: - 'off' - private - global description: >- O modo de compartilhamento entre organizações da organização. Somente `global` compara redes entre organizações; `private` e `off` as restringem ao histórico da própria organização. example: global cross_org_available: type: boolean description: >- Indica se os sinais entre organizações se aplicam a esta organização. Eles exigem tanto o plano Enterprise quanto o modo de compartilhamento `global`. example: true cross_org_unavailable_reason: type: string enum: - plan - sharing_mode nullable: true description: >- Por que os sinais entre organizações não se aplicam, verificados nesta ordem. `plan`: o plano da organização não inclui a rede antifraude entre organizações (ela exige o plano Enterprise), qualquer que seja o modo de compartilhamento. `sharing_mode`: o plano a inclui, mas o modo de compartilhamento é `private` ou `off`. Nulo quando `cross_org_available` é `true`. example: null tags: type: array items: $ref: '#/components/schemas/NetworkTag' description: >- As tags da sua aplicação na rede, das mais antigas para as mais recentes. Cada aplicação vê apenas as próprias tags. `fraud_tags` é separado e não muda: as tags que os membros da rede carregam. outcomes: $ref: '#/components/schemas/NetworkOutcomes' patterns: type: array items: $ref: '#/components/schemas/NetworkPatternScore' description: >- Pontuações de padrões em toda a rede. Atualmente, um item, `background`. NetworkDetail: allOf: - $ref: '#/components/schemas/NetworkListItem' - type: object properties: stats: type: object description: Estatísticas agregadas da rede (por exemplo, totais de membros). fraud_tags: type: array items: type: object description: Tags de padrões de fraude identificadas na rede. risk_signals: type: object description: >- Resumos dos sinais de risco: residential_proxy_reuse, email_intelligence, phone_intelligence. reviewed_at: type: string format: date-time nullable: true reviewed_by: type: string nullable: true review_reason: type: string nullable: true properties: notes_count: type: integer minimum: 0 readOnly: true description: Número de notas privadas de analistas nesta investigação. NetworkTag: type: object description: Uma das tags da sua aplicação na rede. properties: uuid: type: string format: uuid description: O UUID da tag, o mesmo valor que você passa como `tag_uuid`. name: type: string color: type: string description: Cor hexadecimal, por exemplo, `#6366F1`. source: type: string enum: - didit - custom description: >- `didit` para uma tag predefinida da Didit, `custom` para uma tag criada pela sua equipe. added_by: type: string nullable: true description: >- E-mail do membro do console que adicionou a tag. Null quando uma chave de API a adicionou. added_at: type: string format: date-time NetworkOutcomes: type: object description: >- Situação das pessoas e empresas da rede. Cada membro que você pode ver é contado uma vez, pelo status da sua verificação mais recente que chegou a uma decisão. As partes de transações não são contadas. properties: approved: type: integer description: Membros cuja verificação decidida mais recente foi aprovada. declined: type: integer description: Membros cuja verificação decidida mais recente foi recusada. in_review: type: integer description: Membros cuja verificação decidida mais recente está em revisão. total: type: integer description: >- Membros com pelo menos uma verificação, decidida ou não. Um membro cujas verificações estão todas sem decisão (não iniciadas, em andamento, expiradas ou abandonadas) é contado aqui e em nenhuma outra chave. NetworkPatternScore: type: object description: >- Quão semelhante é um tipo de dado dos membros em toda a rede. Um padrão não é um sinal: nenhum valor compartilhado vincula os membros. properties: type: type: string enum: - background description: >- `background`: a similaridade média de todos os pares de fundos das selfies dos membros, com a pessoa mascarada. Considera a selfie mais recente de cada pessoa, no máximo as 50 mais recentes, e exclui as sessões de verificação de idade. Abrange toda a rede, não apenas os membros das suas aplicações. score: type: number nullable: true minimum: 0 maximum: 1 description: >- De 0 a 1, arredondado para 4 casas decimais. Null quando `reason` está definido. members: type: integer nullable: true description: >- Quantas selfies de membros a pontuação comparou. Uma selfie que não pode ser lida, ou que mostra pouco fundo, não é comparada. Null enquanto `computing`; 0 ou 1 com `not_enough_selfies`. reason: type: string enum: - computing - not_enough_selfies nullable: true description: >- Por que não há pontuação. `computing`: a pontuação dos membros atuais está sendo calculada; consulte a rede novamente mais tarde. `not_enough_selfies`: menos de dois membros têm uma selfie utilizável. Nulo quando há pontuação. computed_at: type: string format: date-time nullable: true description: Quando a pontuação foi calculada. Nulo enquanto estiver `computing`. NetworkListItem: type: object properties: uuid: type: string format: uuid network_id: type: string description: ID sequencial legível por organização, por exemplo N-0001. name: type: string nullable: true status: type: string enum: - active - in_review - resolved - dismissed description: >- Status do ciclo de vida da rede. Diferente do outcome_status por candidato dentro de uma rede (approved/in_review/declined/not_completed). risk: $ref: '#/components/schemas/NetworkRiskDisplay' pattern_types: type: array items: type: string enum: - exact_same_device - similar_device - same_ip_address - same_address - similar_selfie_backgrounds - similar_poa_documents - same_document_number - same_phone_number - same_email description: Os padrões de agrupamento detectados nesta rede. signal_types: type: array items: type: string enum: - ip_address - device - face - document_number - phone - email - address description: Os tipos de sinal distintos presentes nesta rede. member_counts: type: object description: >- Contagens de membros por categoria (por exemplo, total, por outcome_status). member_status: type: object description: Distribuição dos membros por outcome_status. signal_coverage: type: object description: Cobertura por signal_type dos membros desta rede. first_activity_at: type: string format: date-time nullable: true last_activity_at: type: string format: date-time nullable: true NetworkRiskDisplay: type: object properties: score: type: integer description: Pontuação de risco, de 0 a 100. band: type: string enum: - low - medium - high description: >- Faixa em que a pontuação é exibida. high >= 70, medium >= 40, caso contrário low. bar: type: number format: float description: Valor normalizado de 0 a 1 para renderizar uma barra de risco. 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.