> ## 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 añadir una etiqueta a una red de fraude > Añade una etiqueta de tu aplicación a una red de fraude con la API de Didit. Devuelve el detalle de la red junto con sus etiquetas. Prompt de la API para añadir una etiqueta a una red Copiar el prompt al portapapeles \

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

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

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/add/" \
-H "x-api-key: YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{"tag_uuid": "7c9e6679-7425-40de-944b-e07fc1f90ae7"}'

Behavior:
\- 201 when the tag was added, 200 when it was already on the network (left as it is). Safe to retry.
\- Both return the network detail (same shape as get network). Its tags array lists my application's tags on the network, oldest first: {uuid, name, color, source (didit|custom), added_by, added_at}.
\- added_by is null when an API key adds the tag, and the console member's email when a member does.
\- Each application sees and changes only its own tags. fraud_tags (the tags the members carry) is not affected.

Failure modes:
\- 400: tag_uuid missing or not a UUID. {"tag_uuid": ["This field is required."]}
\- 404: {"detail": "Network not found."} (the network does not exist or has no member visible to this application), or {"detail": "Tag not found."} (the tag does not exist or belongs to another application).
\- 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.`

\
Pegar en Añade una de las etiquetas de tu aplicación a una red, por ejemplo para marcarla para seguimiento o para dejar constancia de lo que concluyó tu equipo. Pasa el UUID de la etiqueta, tomado de las etiquetas de tu aplicación, como `tag_uuid`. Una etiqueta que pertenece a otra aplicación devuelve `404`, igual que una etiqueta que no existe.La respuesta es el [detalle completo de la red](https://docs.didit.me/es/management-api/networks/get.md), con `201` cuando se añadió la etiqueta y `200` cuando la red ya la tenía. Volver a llamar a la API con la misma etiqueta no cambia nada, así que puedes reintentar sin riesgo.`tags` enumera las etiquetas de tu aplicación en la red, de la más antigua a la más reciente. `added_by` es `null` cuando una clave de API añadió la etiqueta, y el correo electrónico del miembro de la consola cuando la añadió un miembro. Los `fraud_tags` de la red, las etiquetas que llevan sus miembros, no se ven afectados.## Relacionado- [Eliminar una etiqueta de una red](https://docs.didit.me/es/management-api/networks/remove-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/add/ 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/add/: post: tags: - Networks summary: Añadir una etiqueta a una red description: >- Añade una de las etiquetas de tu aplicación a la red. Devuelve el detalle de la red, cuyo `tags` enumera las etiquetas de tu aplicación en la red, con `201` cuando se añadió la etiqueta y `200` cuando ya estaba en la red. Una etiqueta que pertenece a otra aplicación, o que no existe, devuelve 404 `Tag not found.`. Requiere una clave de API de acceso completo, o `write:networks` para un miembro de la consola. operationId: add_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: >- La etiqueta ya estaba en la red y se deja tal como está. 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: - uuid: 7c9e6679-7425-40de-944b-e07fc1f90ae7 name: SUSPICIOUS color: '#6366F1' source: custom added_by: null added_at: '2026-10-13T08:15:00Z' 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' '201': description: Se añadió la etiqueta. 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: - uuid: 7c9e6679-7425-40de-944b-e07fc1f90ae7 name: SUSPICIOUS color: '#6366F1' source: custom added_by: null added_at: '2026-10-13T08:15:00Z' 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. 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/add/' \ -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.add_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.addTag("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.AddTag(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().addTag("3fa85f64-5717-4562-b3fc-2c963f66afa6", NetworkTagRequest.builder() .tagUuid("7c9e6679-7425-40de-944b-e07fc1f90ae7") .build()); System.out.println(result); - lang: php label: PHP source: >- networks->addTag('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.add_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.AddTagAsync("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.