> ## 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. # Afegir una etiqueta a una xarxa de frau API > Afegeix una etiqueta de la teva aplicació a una xarxa de frau a Didit. Retorna el detall de la xarxa amb les seves etiquetes. Prompt de l'API per afegir una etiqueta de xarxa Copia el prompt al porta-retalls \

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

\
Enganxa a Posa una de les etiquetes de la teva aplicació a una xarxa, per exemple per marcar-la per fer-ne seguiment o per registrar què ha conclòs el teu equip. Passa l'UUID d'una de les etiquetes de la teva aplicació com a `tag_uuid`. Una etiqueta que pertany a una altra aplicació retorna `404`, igual que una etiqueta que no existeix.La resposta és el [detall de la xarxa](https://docs.didit.me/ca/management-api/networks/get.md) complet, amb `201` quan s'ha afegit l'etiqueta i `200` quan ja hi era a la xarxa. Tornar a cridar l'endpoint amb la mateixa etiqueta no canvia res, així que pots reintentar-ho sense risc.`tags` enumera les etiquetes de la teva aplicació a la xarxa, de la més antiga a la més recent. `added_by` és `null` quan una clau d'API ha afegit l'etiqueta, i el correu electrònic del membre de la consola quan l'ha afegit un membre. Els `fraud_tags` de la xarxa, les etiquetes que porten els seus membres, no es veuen afectats.## Relacionats- [Eliminar l'etiqueta de la xarxa](https://docs.didit.me/ca/management-api/networks/remove-tag.md) - [Obtenir una xarxa](https://docs.didit.me/ca/management-api/networks/get.md) - [Llistar xarxes](https://docs.didit.me/ca/management-api/networks/list.md) ## OpenAPI ````yaml ca/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ó d'identitat. Autentica't amb la capçalera 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: Afegeix una etiqueta a una xarxa description: >- Afegeix una de les etiquetes de la teva aplicació a la xarxa. Retorna el detall de la xarxa, on `tags` llista les etiquetes de la teva aplicació a la xarxa, amb `201` quan l'etiqueta s'ha afegit i `200` quan ja era a la xarxa. Una etiqueta que pertany a una altra aplicació, o que no existeix, retorna 404 `Tag not found.`. Requereix una clau d'API d'accés complet, o `write:networks` per a un membre de la consola. operationId: add_network_tag parameters: - name: organization_id in: path required: true schema: type: string format: uuid description: UUID de l'organització. - name: application_id in: path required: true schema: type: string format: uuid description: UUID de l'aplicació. - name: network_uuid in: path required: true schema: type: string format: uuid example: 3fa85f64-5717-4562-b3fc-2c963f66afa6 description: UUID de la xarxa. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/NetworkTagRequest' example: tag_uuid: 7c9e6679-7425-40de-944b-e07fc1f90ae7 responses: '200': description: >- L'etiqueta ja era a la xarxa i es deixa tal com està. Retorna el detall de la xarxa. 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: L'etiqueta s'ha afegit. Retorna el detall de la xarxa. 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: 'Cos no vàlid: `tag_uuid` falta o no és un UUID.' content: application/json: schema: type: object properties: tag_uuid: type: array items: type: string examples: Missing tag_uuid: summary: Falta el tag_uuid value: tag_uuid: - This field is required. Invalid tag_uuid: summary: tag_uuid no vàlid value: tag_uuid: - Must be a valid UUID. '401': description: Falten les credencials o no són vàlides. content: application/json: schema: type: object properties: detail: type: string code: type: string description: >- Present en errors codificats, per exemple `networks_not_entitled`. examples: Missing or invalid credentials: summary: Falten les credencials o no són vàlides value: detail: >- Authentication credentials were not provided or are invalid. '403': description: >- La clau d'API pertany a una altra aplicació o és una clau amb accés restringit: els endpoints de Networks necessiten una clau amb accés complet. Un token de membre de la consola necessita `write:networks`. També es retorna amb `code: networks_not_entitled` quan Networks no està habilitat per a l'organització. content: application/json: schema: type: object properties: detail: type: string code: type: string description: >- Present en errors codificats, per exemple `networks_not_entitled`. examples: Networks not enabled: summary: Xarxes no habilitades 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: Clau d'API restringida value: detail: This API key has no access to this endpoint. No permission: summary: Sense permís value: detail: You do not have permission to perform this action. '404': description: No s'ha trobat. content: application/json: schema: type: object properties: detail: type: string code: type: string description: >- Present en errors codificats, per exemple `networks_not_entitled`. examples: Network not found: summary: No s'ha trobat la xarxa value: detail: Network not found. Tag not found: summary: Etiqueta no trobada 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 d'una de les etiquetes de la teva aplicació. example: tag_uuid: 7c9e6679-7425-40de-944b-e07fc1f90ae7 NetworkDetailResponse: description: >- El detall de la xarxa, a més del mode d'ús compartit de l'organització, si se li apliquen senyals interorganitzatius, les etiquetes de la teva aplicació a la xarxa, els resultats dels membres i les puntuacions de patrons. allOf: - $ref: '#/components/schemas/NetworkDetail' - type: object properties: sharing_mode: type: string enum: - 'off' - private - global description: >- El mode de compartició entre organitzacions de l'organització. Només `global` compara xarxes entre organitzacions; `private` i `off` les mantenen a l'historial propi de l'organització. example: global cross_org_available: type: boolean description: >- Indica si els senyals entre organitzacions s'apliquen a aquesta organització. Necessiten tant el pla Enterprise com el mode de compartició `global`. example: true cross_org_unavailable_reason: type: string enum: - plan - sharing_mode nullable: true description: >- Per què no s'apliquen els senyals interorganitzacionals, comprovats en aquest ordre. `plan`: el pla de l'organització no inclou la xarxa de frau interorganitzacional (necessita el pla Enterprise), independentment del mode de compartició. `sharing_mode`: el pla la inclou, però el mode de compartició és `private` o `off`. Null quan `cross_org_available` és `true`. example: null tags: type: array items: $ref: '#/components/schemas/NetworkTag' description: >- Les etiquetes de la teva aplicació a la xarxa, les més antigues primer. Cada aplicació només veu les seves pròpies etiquetes. `fraud_tags` és independent i no canvia: les etiquetes que porten els membres de la xarxa. outcomes: $ref: '#/components/schemas/NetworkOutcomes' patterns: type: array items: $ref: '#/components/schemas/NetworkPatternScore' description: >- Puntuacions de patrons a tota la xarxa. Actualment un element, `background`. NetworkDetail: allOf: - $ref: '#/components/schemas/NetworkListItem' - type: object properties: stats: type: object description: Estadístiques agregades de la xarxa (p. ex., totals de membres). fraud_tags: type: array items: type: object description: Etiquetes de patrons de frau detectades a la xarxa. risk_signals: type: object description: >- Resums dels senyals de risc: 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: Nombre de notes privades d'analista en aquesta investigació. NetworkTag: type: object description: Una de les etiquetes de la teva aplicació a la xarxa. properties: uuid: type: string format: uuid description: L'UUID de l'etiqueta, el mateix valor que passes com a `tag_uuid`. name: type: string color: type: string description: Color hexadecimal, per exemple `#6366F1`. source: type: string enum: - didit - custom description: >- `didit` per a una etiqueta predefinida de Didit, `custom` per a una etiqueta que hagi creat el teu equip. added_by: type: string nullable: true description: >- Correu electrònic del membre de la consola que ha afegit l'etiqueta. Null quan l'ha afegit una clau d'API. added_at: type: string format: date-time NetworkOutcomes: type: object description: >- Estat en què es troben les persones i empreses de la xarxa. Cada membre que pots veure compta un cop, segons l'estat de la seva verificació més recent que hagi arribat a una decisió. Les parts de la transacció no es comptabilitzen. properties: approved: type: integer description: >- Membres la verificació decidida més recent dels quals ha estat aprovada. declined: type: integer description: >- Membres la verificació decidida més recent dels quals ha estat rebutjada. in_review: type: integer description: >- Membres la verificació decidida més recent dels quals està en revisió. total: type: integer description: >- Membres amb almenys una verificació, decidida o no. Un membre amb totes les verificacions no decidides (no iniciades, en curs, caducades o abandonades) es compta aquí i en cap altra clau. NetworkPatternScore: type: object description: >- Fins a quin punt s'assembla un tipus de dada entre els membres de tota la xarxa. Un patró no és un senyal: cap valor compartit no enllaça els membres. properties: type: type: string enum: - background description: >- `background`: la similitud mitjana de cada parell de fons de les selfies dels membres, emmascarant la persona. Llegeix la selfie més recent de cada persona, com a màxim les 50 més recents, i omet les sessions d'assegurament de l'edat. Cobreix tota la xarxa, no només els membres de les teves aplicacions. score: type: number nullable: true minimum: 0 maximum: 1 description: De 0 a 1, arrodonit a 4 decimals. Null quan s'hagi definit `reason`. members: type: integer nullable: true description: >- Quantes selfies de membres ha comparat la puntuació. Una selfie que no es pugui llegir o que mostri massa poc fons no es compara. Null mentre estigui en estat `computing`; 0 o 1 amb `not_enough_selfies`. reason: type: string enum: - computing - not_enough_selfies nullable: true description: >- Per què no hi ha puntuació. `computing`: s'està calculant la puntuació per als membres actuals; torna a llegir la xarxa més tard. `not_enough_selfies`: menys de dos membres tenen una selfie utilitzable. Null quan hi ha una puntuació. computed_at: type: string format: date-time nullable: true description: >- Quan es va calcular la puntuació. Null mentre estigui en estat `computing`. NetworkListItem: type: object properties: uuid: type: string format: uuid network_id: type: string description: ID seqüencial per organització llegible per a humans, p. ex. N-0001. name: type: string nullable: true status: type: string enum: - active - in_review - resolved - dismissed description: >- Estat del cicle de vida de la xarxa. Distint de l'outcome_status per sol·licitant dins d'una xarxa (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: Els patrons d'agrupament detectats en aquesta xarxa. signal_types: type: array items: type: string enum: - ip_address - device - face - document_number - phone - email - address description: Els diferents tipus de senyals presents en aquesta xarxa. member_counts: type: object description: >- Recomptes de membres per categoria (p. ex. total, per outcome_status). member_status: type: object description: Desglossament dels membres per outcome_status. signal_coverage: type: object description: Cobertura dels membres d'aquesta xarxa per signal_type. 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ó de risc, 0-100. band: type: string enum: - low - medium - high description: >- Franja en què es representa la puntuació. high >= 70, medium >= 40; altrament, low. bar: type: number format: float description: Valor normalitzat de 0 a 1 per renderitzar una barra de risc. securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau primària té accés complet. Una clau amb nom pot tenir l'abast limitat: cap, lectura o escriptura per recurs, limitada a determinats fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 significa que la clau és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una ruta de sessió significa que la sessió està fora dels fluxos de treball o estats de la clau. Una clau sense accés a fitxers multimèdia rep els URL d'imatge, vídeo i PDF com a null, i una clau sense permís d'escriptura de sessions rep els enllaços de sessió i els tokens com a null. Consulta https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.