> ## 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 eliminar una etiqueta de una red de fraude

> Elimina con la API de Didit una etiqueta de tu aplicación de una red de fraude. Devuelve el detalle de la red con las etiquetas restantes.



Prompt de la API para eliminar una etiqueta de red
        Copiar el prompt al portapapeles



      
      

\<pre>

\`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": "<uuid of the tag to remove>"}

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.`

\</pre>



      
      

Pegar en

Elimina una de las etiquetas de tu aplicación de una red.
Pasa el UUID de la etiqueta como `tag_uuid`: el mismo `uuid` que aparece en `tags` del detalle de la red.
La respuesta es el [detalle de la red](https://docs.didit.me/es/management-api/networks/get.md) completo, cuyo `tags` ya no incluye la etiqueta.| Estado | Cuándo |
| - | - |
| `200` | La etiqueta se eliminó de la red. |
| `404` `Network not found.` | La red no existe o no tiene ningún miembro visible para tu aplicación. |
| `404` `Tag not found.` | La etiqueta no existe o pertenece a otra aplicación. |
| `404` `This tag is not on the network.` | La etiqueta es tuya, pero no está en la red. |Los `fraud_tags` de la red, las etiquetas que tienen sus miembros, no se ven afectados.## Relacionado- [Añadir una etiqueta de red](https://docs.didit.me/es/management-api/networks/add-tag.md)
- [Obtener una red](https://docs.didit.me/es/management-api/networks/get.md)
- [Listar redes](https://docs.didit.me/es/management-api/networks/list.md)


## OpenAPI

````yaml es/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 verificación de identidad. Autentícate con el encabezado 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: Quitar una etiqueta de una red
      description: >-
        Quita de la red una de las etiquetas de tu aplicación. Devuelve el
        detalle de la red. Devuelve 404 cuando la etiqueta no está en la red o
        no pertenece a tu aplicación. Requiere una clave de API con acceso
        completo, o `write:networks` para un miembro de la consola.
      operationId: remove_network_tag
      parameters:
        - name: organization_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: UUID de la organización.
        - name: application_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: UUID de la aplicación.
        - name: network_uuid
          in: path
          required: true
          schema:
            type: string
            format: uuid
            example: 3fa85f64-5717-4562-b3fc-2c963f66afa6
          description: UUID de la red.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/NetworkTagRequest'
            example:
              tag_uuid: 7c9e6679-7425-40de-944b-e07fc1f90ae7
      responses:
        '200':
          description: Se eliminó la etiqueta de la red. Devuelve el detalle de la red.
          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: 'Cuerpo no válido: falta `tag_uuid` o no es un UUID.'
          content:
            application/json:
              schema:
                type: object
                properties:
                  tag_uuid:
                    type: array
                    items:
                      type: string
              examples:
                Missing tag_uuid:
                  summary: Falta tag_uuid
                  value:
                    tag_uuid:
                      - This field is required.
                Invalid tag_uuid:
                  summary: tag_uuid no válido
                  value:
                    tag_uuid:
                      - Must be a valid UUID.
        '401':
          description: Credenciales ausentes o no válidas.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                  code:
                    type: string
                    description: >-
                      Presente en errores con código, por ejemplo
                      `networks_not_entitled`.
              examples:
                Missing or invalid credentials:
                  summary: Credenciales ausentes o no válidas
                  value:
                    detail: >-
                      Authentication credentials were not provided or are
                      invalid.
        '403':
          description: >-
            La clave de API pertenece a otra aplicación o es una clave con
            acceso restringido: los endpoints de Networks necesitan una clave de
            acceso completo. Un token de miembro de la consola necesita
            `write:networks`. También se devuelve con `code:
            networks_not_entitled` cuando Networks no está habilitado para la
            organización.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                  code:
                    type: string
                    description: >-
                      Presente en errores con código, por ejemplo
                      `networks_not_entitled`.
              examples:
                Networks not enabled:
                  summary: Redes no 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: Clave de API restringida
                  value:
                    detail: This API key has no access to this endpoint.
                No permission:
                  summary: Sin permiso
                  value:
                    detail: You do not have permission to perform this action.
        '404':
          description: No encontrado.
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                  code:
                    type: string
                    description: >-
                      Presente en errores con código, por ejemplo
                      `networks_not_entitled`.
              examples:
                Network not found:
                  summary: Red no encontrada
                  value:
                    detail: Network not found.
                Tag not found:
                  summary: Etiqueta no encontrada
                  value:
                    detail: Tag not found.
                Tag not on the network:
                  summary: La etiqueta no está en la red
                  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: >-
            <?php


            require 'vendor/autoload.php';


            use Didit\DiditClient;


            // Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID

            // and DIDIT_APPLICATION_ID.

            $didit = new DiditClient();


            $result =
            $didit->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 una de las etiquetas de tu aplicación.
      example:
        tag_uuid: 7c9e6679-7425-40de-944b-e07fc1f90ae7
    NetworkDetailResponse:
      description: >-
        El detalle de la red, junto con el modo de compartición de la
        organización, si se le aplican las señales entre organizaciones, las
        etiquetas de tu aplicación en la red, los resultados de los miembros y
        las puntuaciones de patrones.
      allOf:
        - $ref: '#/components/schemas/NetworkDetail'
        - type: object
          properties:
            sharing_mode:
              type: string
              enum:
                - 'off'
                - private
                - global
              description: >-
                El modo de uso compartido entre organizaciones de la
                organización. Solo `global` compara redes entre organizaciones;
                `private` y `off` las limitan al historial propio de la
                organización.
              example: global
            cross_org_available:
              type: boolean
              description: >-
                Indica si las señales entre organizaciones se aplican a esta
                organización. Requieren tanto el plan Enterprise como el modo de
                compartición `global`.
              example: true
            cross_org_unavailable_reason:
              type: string
              enum:
                - plan
                - sharing_mode
              nullable: true
              description: >-
                Por qué no se aplican las señales entre organizaciones,
                comprobado en este orden. `plan`: el plan de la organización no
                incluye la red de fraude entre organizaciones (requiere el plan
                Enterprise), sea cual sea el modo de compartición.
                `sharing_mode`: el plan la incluye, pero el modo de compartición
                es `private` u `off`. Null cuando `cross_org_available` es
                `true`.
              example: null
            tags:
              type: array
              items:
                $ref: '#/components/schemas/NetworkTag'
              description: >-
                Las etiquetas de tu aplicación en la red, de la más antigua a la
                más reciente. Cada aplicación solo ve sus propias etiquetas.
                `fraud_tags` es independiente y no cambia: son las etiquetas que
                tienen los miembros de la red.
            outcomes:
              $ref: '#/components/schemas/NetworkOutcomes'
            patterns:
              type: array
              items:
                $ref: '#/components/schemas/NetworkPatternScore'
              description: >-
                Puntuaciones de patrones sobre toda la red. Actualmente, un
                elemento: `background`.
    NetworkDetail:
      allOf:
        - $ref: '#/components/schemas/NetworkListItem'
        - type: object
          properties:
            stats:
              type: object
              description: Estadísticas agregadas de la red (p. ej., totales de miembros).
            fraud_tags:
              type: array
              items:
                type: object
              description: Etiquetas de patrones de fraude detectadas en la red.
            risk_signals:
              type: object
              description: >-
                Resúmenes de señales de riesgo: 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 en esta investigación.
    NetworkTag:
      type: object
      description: Una de las etiquetas de tu aplicación en la red.
      properties:
        uuid:
          type: string
          format: uuid
          description: El UUID de la etiqueta, el mismo valor que pasas como `tag_uuid`.
        name:
          type: string
        color:
          type: string
          description: Color hexadecimal, por ejemplo `#6366F1`.
        source:
          type: string
          enum:
            - didit
            - custom
          description: >-
            `didit` para una etiqueta predefinida de Didit, `custom` para una
            etiqueta que creó tu equipo.
        added_by:
          type: string
          nullable: true
          description: >-
            Correo electrónico del miembro de la consola que añadió la etiqueta.
            Null cuando la añadió una clave de API.
        added_at:
          type: string
          format: date-time
    NetworkOutcomes:
      type: object
      description: >-
        Estado de las personas y empresas de la red. Cada miembro que puedes ver
        cuenta una vez, según el estado de su verificación más reciente que
        llegó a una decisión. Las partes de las transacciones no se cuentan.
      properties:
        approved:
          type: integer
          description: Miembros cuya verificación decidida más reciente fue aprobada.
        declined:
          type: integer
          description: Miembros cuya verificación decidida más reciente fue rechazada.
        in_review:
          type: integer
          description: Miembros cuya verificación decidida más reciente está en revisión.
        total:
          type: integer
          description: >-
            Miembros con al menos una verificación, decidida o no. Un miembro
            cuyas verificaciones están todas sin decidir (no iniciadas, en
            curso, expiradas o abandonadas) se cuenta aquí y en ninguna otra
            clave.
    NetworkPatternScore:
      type: object
      description: >-
        Qué tan parecido es un tipo de datos de los miembros en toda la red. Un
        patrón no es una señal: ningún valor compartido vincula a los miembros.
      properties:
        type:
          type: string
          enum:
            - background
          description: >-
            `background`: la similitud media de cada par de fondos de las
            selfies de los miembros, con la persona enmascarada. Lee la selfie
            más reciente de cada persona, como máximo las 50 más recientes, y
            excluye las sesiones de verificación de edad. Abarca toda la red, no
            solo los miembros de tus aplicaciones.
        score:
          type: number
          nullable: true
          minimum: 0
          maximum: 1
          description: >-
            De 0 a 1, redondeado a 4 decimales. Null cuando `reason` está
            definido.
        members:
          type: integer
          nullable: true
          description: >-
            Cuántas selfies de miembros comparó la puntuación. Una selfie que no
            se puede leer, o que muestra muy poco fondo, no se compara. Null
            mientras sea `computing`; 0 o 1 con `not_enough_selfies`.
        reason:
          type: string
          enum:
            - computing
            - not_enough_selfies
          nullable: true
          description: >-
            Por qué no hay puntuación. `computing`: se está calculando la
            puntuación de los miembros actuales; vuelve a leer la red más tarde.
            `not_enough_selfies`: menos de dos miembros tienen una selfie
            utilizable. Es null cuando hay puntuación.
        computed_at:
          type: string
          format: date-time
          nullable: true
          description: >-
            Fecha y hora en que se calculó la puntuación. Nulo mientras está en
            `computing`.
    NetworkListItem:
      type: object
      properties:
        uuid:
          type: string
          format: uuid
        network_id:
          type: string
          description: ID secuencial legible por organización, p. ej. N-0001.
        name:
          type: string
          nullable: true
        status:
          type: string
          enum:
            - active
            - in_review
            - resolved
            - dismissed
          description: >-
            Estado del ciclo de vida de la red. Es distinto del outcome_status
            de cada solicitante dentro de una red
            (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: Los patrones de agrupamiento detectados en esta red.
        signal_types:
          type: array
          items:
            type: string
            enum:
              - ip_address
              - device
              - face
              - document_number
              - phone
              - email
              - address
          description: Los distintos tipos de señal presentes en esta red.
        member_counts:
          type: object
          description: >-
            Recuentos de miembros por categoría (p. ej., total, por
            outcome_status).
        member_status:
          type: object
          description: Desglose de los miembros por outcome_status.
        signal_coverage:
          type: object
          description: Cobertura por signal_type de los miembros de esta red.
        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: Puntuación de riesgo, de 0 a 100.
        band:
          type: string
          enum:
            - low
            - medium
            - high
          description: >-
            Banda con la que se muestra la puntuación. high >= 70, medium >= 40;
            en otro caso, low.
        bar:
          type: number
          format: float
          description: Valor normalizado de 0 a 1 para representar una barra de riesgo.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        La clave de API de tu aplicación, que encontrarás en Developers -> API
        keys en la Business Console. La clave principal tiene acceso completo.
        Una clave con nombre puede tener un alcance limitado: ninguno, lectura o
        escritura por recurso, limitada a algunos flujos o a sesiones aprobadas,
        a una lista de direcciones IP y a una fecha de caducidad. 401 significa
        que la clave es incorrecta, se revocó o expiró; 403 significa que no se
        envió ninguna clave, que la clave no tiene acceso a este recurso o
        acción, o que la solicitud provino de una dirección fuera de su lista de
        IP; 404 en una ruta de sesión significa que la sesión está fuera de los
        flujos o estados de la clave. Una clave sin acceso a contenido
        multimedia recibe las URL de imágenes, videos y PDF como null, y una
        clave sin permiso de escritura en sesiones recibe los enlaces y tokens
        de sesión como null. Consulta https://docs.didit.me/console/api-keys.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.