> ## 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. # Aggiungere un tag a una rete di frodi: API > Aggiungi un tag della tua applicazione a una rete di frodi con Didit. Restituisce il dettaglio della rete con i suoi tag. Prompt API per aggiungere un tag alla rete Copia il prompt negli appunti \

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

\
Incolla in Aggiungi un tag della tua applicazione a una rete, ad esempio per segnalarla per un approfondimento o per registrare le conclusioni del tuo team. Passa l'UUID del tag, preso dai tag della tua applicazione, come `tag_uuid`. Un tag che appartiene a un'altra applicazione restituisce `404`, allo stesso modo di un tag che non esiste.La risposta è il [dettaglio completo della rete](https://docs.didit.me/it/management-api/networks/get.md), con `201` quando il tag è stato aggiunto e `200` quando era già presente sulla rete. Chiamare di nuovo l'endpoint con lo stesso tag non modifica nulla, quindi puoi riprovare senza rischi.`tags` elenca i tag della tua applicazione presenti sulla rete, dal più vecchio al più recente. `added_by` è `null` quando a inserire il tag è stata una chiave API, e l'email del membro della console quando a farlo è stato un membro. I `fraud_tags` della rete, cioè i tag associati ai suoi membri, non vengono modificati.## Correlati- [Rimuovi tag dalla rete](https://docs.didit.me/it/management-api/networks/remove-tag.md) - [Ottieni rete](https://docs.didit.me/it/management-api/networks/get.md) - [Elenca le reti](https://docs.didit.me/it/management-api/networks/list.md) ## OpenAPI ````yaml it/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 di verifica dell'identità. Autenticati con l'intestazione 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: Aggiungi un tag a una rete description: >- Applica uno dei tag della tua applicazione alla rete. Restituisce i dettagli della rete, il cui campo `tags` elenca i tag della tua applicazione sulla rete, con `201` quando il tag è stato aggiunto e `200` quando era già presente sulla rete. Un tag che appartiene a un'altra applicazione, o che non esiste, restituisce 404 `Tag not found.`. Richiede una chiave API con accesso completo, oppure `write:networks` per un membro della console. operationId: add_network_tag parameters: - name: organization_id in: path required: true schema: type: string format: uuid description: UUID dell'organizzazione. - name: application_id in: path required: true schema: type: string format: uuid description: UUID dell'applicazione. - name: network_uuid in: path required: true schema: type: string format: uuid example: 3fa85f64-5717-4562-b3fc-2c963f66afa6 description: UUID della rete. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/NetworkTagRequest' example: tag_uuid: 7c9e6679-7425-40de-944b-e07fc1f90ae7 responses: '200': description: >- Il tag era già presente sulla rete e viene lasciato invariato. Restituisce i dettagli della rete. 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: Il tag è stato aggiunto. Restituisce i dettagli della rete. 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: 'Corpo non valido: `tag_uuid` mancante o non è un UUID.' content: application/json: schema: type: object properties: tag_uuid: type: array items: type: string examples: Missing tag_uuid: summary: tag_uuid mancante value: tag_uuid: - This field is required. Invalid tag_uuid: summary: tag_uuid non valido value: tag_uuid: - Must be a valid UUID. '401': description: Credenziali mancanti o non valide. content: application/json: schema: type: object properties: detail: type: string code: type: string description: >- Presente sugli errori codificati, ad esempio `networks_not_entitled`. examples: Missing or invalid credentials: summary: Credenziali mancanti o non valide value: detail: >- Authentication credentials were not provided or are invalid. '403': description: >- La chiave API appartiene a un'altra applicazione, oppure è una chiave con accesso limitato: gli endpoint Networks richiedono una chiave con accesso completo. Un token di un membro della console richiede `write:networks`. Viene restituito anche con `code: networks_not_entitled` quando Networks non è abilitato per l'organizzazione. content: application/json: schema: type: object properties: detail: type: string code: type: string description: >- Presente sugli errori codificati, ad esempio `networks_not_entitled`. examples: Networks not enabled: summary: Reti non abilitate 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: Chiave API con restrizioni value: detail: This API key has no access to this endpoint. No permission: summary: Nessuna autorizzazione value: detail: You do not have permission to perform this action. '404': description: Non trovato. content: application/json: schema: type: object properties: detail: type: string code: type: string description: >- Presente sugli errori codificati, ad esempio `networks_not_entitled`. examples: Network not found: summary: Rete non trovata value: detail: Network not found. Tag not found: summary: Tag non trovato 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 di uno dei tag della tua applicazione. example: tag_uuid: 7c9e6679-7425-40de-944b-e07fc1f90ae7 NetworkDetailResponse: description: >- I dettagli della rete, oltre alla modalità di condivisione dell'organizzazione, all'eventuale applicazione di segnali tra organizzazioni, ai tag della tua applicazione sulla rete, agli esiti dei membri e ai punteggi dei pattern. allOf: - $ref: '#/components/schemas/NetworkDetail' - type: object properties: sharing_mode: type: string enum: - 'off' - private - global description: >- La modalità di condivisione tra organizzazioni dell'organizzazione. Solo `global` confronta le reti tra organizzazioni; `private` e `off` le limitano alla cronologia interna dell'organizzazione. example: global cross_org_available: type: boolean description: >- Indica se i segnali tra organizzazioni si applicano a questa organizzazione. Richiedono sia il piano Enterprise sia la modalità di condivisione `global`. example: true cross_org_unavailable_reason: type: string enum: - plan - sharing_mode nullable: true description: >- Il motivo per cui i segnali inter-organizzazione non sono applicabili, verificati in questo ordine. `plan`: il piano dell'organizzazione non include la rete antifrode inter-organizzazione (richiede il piano Enterprise), indipendentemente dalla modalità di condivisione. `sharing_mode`: il piano la include, ma la modalità di condivisione è `private` o `off`. Null quando `cross_org_available` è `true`. example: null tags: type: array items: $ref: '#/components/schemas/NetworkTag' description: >- I tag della tua applicazione sulla rete, dal meno recente al più recente. Ciascuna applicazione visualizza solo i propri tag. `fraud_tags` è separato e invariato: i tag associati ai membri della rete. outcomes: $ref: '#/components/schemas/NetworkOutcomes' patterns: type: array items: $ref: '#/components/schemas/NetworkPatternScore' description: >- Punteggi dei pattern sull'intera rete. Attualmente un elemento, `background`. NetworkDetail: allOf: - $ref: '#/components/schemas/NetworkListItem' - type: object properties: stats: type: object description: Statistiche aggregate per la rete (ad es. totali dei membri). fraud_tags: type: array items: type: object description: Tag dei pattern di frode rilevati sulla rete. risk_signals: type: object description: >- Riepiloghi dei segnali di rischio: 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: Numero di note private dell'analista in questa indagine. NetworkTag: type: object description: Uno dei tag della tua applicazione sulla rete. properties: uuid: type: string format: uuid description: L'UUID del tag, lo stesso valore passato come `tag_uuid`. name: type: string color: type: string description: Colore esadecimale, ad esempio `#6366F1`. source: type: string enum: - didit - custom description: >- `didit` per un tag predefinito di Didit, `custom` per un tag creato dal tuo team. added_by: type: string nullable: true description: >- Email del membro della console che ha aggiunto il tag. Null se aggiunto tramite chiave API. added_at: type: string format: date-time NetworkOutcomes: type: object description: >- Lo stato delle persone e delle aziende della rete. Ciascun membro visibile viene conteggiato una sola volta, in base allo stato della verifica più recente che ha raggiunto una decisione. Le parti della transazione non vengono conteggiate. properties: approved: type: integer description: Membri la cui verifica decisa più recente è stata approvata. declined: type: integer description: Membri la cui verifica decisa più recente è stata rifiutata. in_review: type: integer description: Membri la cui verifica decisa più recente è in revisione. total: type: integer description: >- Membri con almeno una verifica, decisa o meno. Un membro le cui verifiche sono tutte senza decisione (non avviata, in corso, scaduta o abbandonata) viene conteggiato qui e in nessun'altra chiave. NetworkPatternScore: type: object description: >- Grado di somiglianza di un tipo di dati dei membri all'interno dell'intera rete. Un pattern non costituisce un segnale: nessun valore condiviso collega i membri. properties: type: type: string enum: - background description: >- `background`: la somiglianza media dello sfondo dei selfie di ogni coppia di membri, con la persona mascherata. Legge il selfie più recente di ciascuna persona, al massimo i 50 più recenti, ed esclude le sessioni di verifica dell'età. Copre l'intera rete, non solo i membri delle tue applicazioni. score: type: number nullable: true minimum: 0 maximum: 1 description: >- Da 0 a 1, arrotondato a 4 decimali. Null quando `reason` è impostato. members: type: integer nullable: true description: >- Di quanti membri sono stati confrontati i selfie dal punteggio. Un selfie illeggibile o con troppo poco sfondo non viene confrontato. Null durante `computing`; 0 o 1 con `not_enough_selfies`. reason: type: string enum: - computing - not_enough_selfies nullable: true description: >- Il motivo per cui non è presente un punteggio. `computing`: il punteggio per i membri attuali è in fase di calcolo; interroga nuovamente la rete più tardi. `not_enough_selfies`: meno di due membri hanno un selfie utilizzabile. Null quando è presente un punteggio. computed_at: type: string format: date-time nullable: true description: >- Quando il punteggio è stato calcolato. Null mentre è in stato `computing`. NetworkListItem: type: object properties: uuid: type: string format: uuid network_id: type: string description: >- ID sequenziale per organizzazione leggibile dall'utente, ad es. N-0001. name: type: string nullable: true status: type: string enum: - active - in_review - resolved - dismissed description: >- Stato del ciclo di vita della rete. Distinto dall'outcome_status per richiedente all'interno di una rete (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: I pattern di clustering rilevati in questa rete. signal_types: type: array items: type: string enum: - ip_address - device - face - document_number - phone - email - address description: I diversi tipi di segnale presenti in questa rete. member_counts: type: object description: >- Conteggi dei membri per categoria (ad es. totale, per outcome_status). member_status: type: object description: Suddivisione dei membri per outcome_status. signal_coverage: type: object description: Copertura per signal_type dei membri di questa rete. 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: Punteggio di rischio, 0-100. band: type: string enum: - low - medium - high description: >- Fascia a cui viene assegnato il punteggio. high >= 70, medium >= 40, altrimenti low. bar: type: number format: float description: >- Valore normalizzato compreso tra 0 e 1 per il rendering di una barra di rischio. securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.