> ## 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 Tambah Tag ke Jaringan Fraud > Tambahkan salah satu tag aplikasi Anda ke jaringan fraud di Didit. Respons mengembalikan detail jaringan beserta tag-tagnya. Prompt API untuk Menambahkan Tag Jaringan Salin prompt ke papan klip \

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

\
Tempel ke Tambahkan salah satu tag aplikasi Anda ke jaringan, misalnya untuk menandainya untuk tindak lanjut atau mencatat kesimpulan tim Anda. Berikan UUID tag dari tag aplikasi Anda sebagai `tag_uuid`. Tag yang milik aplikasi lain mengembalikan `404`, sama seperti tag yang tidak ada.Respons berupa [detail jaringan](https://docs.didit.me/id/management-api/networks/get.md) lengkap, dengan `201` jika tag berhasil ditambahkan dan `200` jika tag sudah ada di jaringan. Memanggil ulang dengan tag yang sama tidak mengubah apa pun, sehingga Anda dapat mencoba lagi dengan aman.`tags` berisi daftar tag aplikasi Anda di jaringan, diurutkan dari yang paling lama. `added_by` bernilai `null` jika kunci API menambahkan tag, dan berisi email anggota konsol jika anggota yang menambahkannya. `fraud_tags` milik jaringan, yaitu tag yang dimiliki anggotanya, tidak terpengaruh.## Terkait- [Hapus tag jaringan](https://docs.didit.me/id/management-api/networks/remove-tag.md) - [Ambil jaringan](https://docs.didit.me/id/management-api/networks/get.md) - [Daftar jaringan](https://docs.didit.me/id/management-api/networks/list.md) ## OpenAPI ````yaml id/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 Verifikasi Identitas. Lakukan autentikasi dengan header 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: Tambahkan tag ke jaringan description: >- Menempatkan salah satu tag aplikasi Anda di jaringan. Mengembalikan detail jaringan, yang mana `tags` mencantumkan tag aplikasi Anda di jaringan tersebut, dengan `201` saat tag ditambahkan dan `200` saat tag sudah ada di jaringan. Tag milik aplikasi lain, atau yang tidak ada, mengembalikan 404 `Tag not found.`. Memerlukan kunci API akses penuh, atau `write:networks` untuk anggota konsol. operationId: add_network_tag parameters: - name: organization_id in: path required: true schema: type: string format: uuid description: UUID organisasi. - name: application_id in: path required: true schema: type: string format: uuid description: UUID aplikasi. - name: network_uuid in: path required: true schema: type: string format: uuid example: 3fa85f64-5717-4562-b3fc-2c963f66afa6 description: UUID jaringan. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/NetworkTagRequest' example: tag_uuid: 7c9e6679-7425-40de-944b-e07fc1f90ae7 responses: '200': description: >- Tag sudah ada di jaringan dan dibiarkan apa adanya. Mengembalikan detail jaringan. 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: Tag telah ditambahkan. Mengembalikan detail jaringan. 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: 'Body tidak valid: `tag_uuid` hilang atau bukan UUID.' content: application/json: schema: type: object properties: tag_uuid: type: array items: type: string examples: Missing tag_uuid: summary: tag_uuid tidak ada value: tag_uuid: - This field is required. Invalid tag_uuid: summary: tag_uuid tidak valid value: tag_uuid: - Must be a valid UUID. '401': description: Kredensial tidak ada atau tidak valid. content: application/json: schema: type: object properties: detail: type: string code: type: string description: >- Hadir pada error berkode, misalnya `networks_not_entitled`. examples: Missing or invalid credentials: summary: Kredensial tidak ada atau tidak valid value: detail: >- Authentication credentials were not provided or are invalid. '403': description: >- Kunci API milik aplikasi lain, atau merupakan kunci dengan akses terbatas: Endpoint Networks memerlukan kunci akses penuh. Token anggota konsol memerlukan `write:networks`. Juga dikembalikan dengan `code: networks_not_entitled` saat Networks tidak diaktifkan untuk organisasi. content: application/json: schema: type: object properties: detail: type: string code: type: string description: >- Hadir pada error berkode, misalnya `networks_not_entitled`. examples: Networks not enabled: summary: Jaringan tidak diaktifkan 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: Kunci API terbatas value: detail: This API key has no access to this endpoint. No permission: summary: Tidak ada izin value: detail: You do not have permission to perform this action. '404': description: Tidak ditemukan. content: application/json: schema: type: object properties: detail: type: string code: type: string description: >- Hadir pada error berkode, misalnya `networks_not_entitled`. examples: Network not found: summary: Jaringan tidak ditemukan value: detail: Network not found. Tag not found: summary: Tag tidak ditemukan 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 dari salah satu tag aplikasi Anda. example: tag_uuid: 7c9e6679-7425-40de-944b-e07fc1f90ae7 NetworkDetailResponse: description: >- Detail jaringan, ditambah mode berbagi organisasi, apakah sinyal lintas organisasi berlaku untuknya, tag aplikasi Anda di jaringan, hasil anggota, dan skor pola. allOf: - $ref: '#/components/schemas/NetworkDetail' - type: object properties: sharing_mode: type: string enum: - 'off' - private - global description: >- Mode berbagi lintas-organisasi milik organisasi. Hanya `global` yang membandingkan jaringan di seluruh organisasi; `private` dan `off` membatasinya hanya pada riwayat organisasi itu sendiri. example: global cross_org_available: type: boolean description: >- Menentukan apakah sinyal lintas organisasi berlaku untuk organisasi ini. Fitur ini memerlukan paket Enterprise dan mode berbagi `global`. example: true cross_org_unavailable_reason: type: string enum: - plan - sharing_mode nullable: true description: >- Alasan mengapa sinyal lintas organisasi tidak berlaku, diperiksa dalam urutan ini. `plan`: paket organisasi tidak mencakup jaringan penipuan lintas organisasi (memerlukan paket Enterprise), apa pun mode berbaginya. `sharing_mode`: paket mencakupnya, tetapi mode berbagi adalah `private` atau `off`. Null jika `cross_org_available` bernilai `true`. example: null tags: type: array items: $ref: '#/components/schemas/NetworkTag' description: >- Tag aplikasi Anda di jaringan, yang terlama lebih dahulu. Setiap aplikasi hanya melihat tag miliknya sendiri. `fraud_tags` terpisah dan tidak berubah: tag yang dimiliki oleh anggota jaringan. outcomes: $ref: '#/components/schemas/NetworkOutcomes' patterns: type: array items: $ref: '#/components/schemas/NetworkPatternScore' description: Skor pola di seluruh jaringan. Saat ini satu item, `background`. NetworkDetail: allOf: - $ref: '#/components/schemas/NetworkListItem' - type: object properties: stats: type: object description: Statistik agregat untuk jaringan (misalnya total anggota). fraud_tags: type: array items: type: object description: Tag pola penipuan yang muncul di jaringan. risk_signals: type: object description: >- Ringkasan sinyal risiko: 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: Jumlah catatan analis privat dalam investigasi ini. NetworkTag: type: object description: Salah satu tag aplikasi Anda di jaringan. properties: uuid: type: string format: uuid description: >- UUID tag, nilai yang sama dengan yang Anda kirimkan sebagai `tag_uuid`. name: type: string color: type: string description: Warna hex, misalnya `#6366F1`. source: type: string enum: - didit - custom description: >- `didit` untuk tag prasetel Didit, `custom` untuk tag yang dibuat tim Anda. added_by: type: string nullable: true description: >- Email anggota konsol yang menambahkan tag tersebut. Null jika ditambahkan oleh kunci API. added_at: type: string format: date-time NetworkOutcomes: type: object description: >- Status individu dan bisnis dalam jaringan. Setiap anggota yang dapat Anda lihat dihitung satu kali, berdasarkan status verifikasi terbaru mereka yang mencapai keputusan. Pihak transaksi tidak dihitung. properties: approved: type: integer description: >- Anggota yang verifikasi terbaru yang telah diputuskan berstatus disetujui. declined: type: integer description: >- Anggota yang verifikasi terbaru yang telah diputuskan berstatus ditolak. in_review: type: integer description: >- Anggota yang verifikasi terbaru yang telah diputuskan berada dalam peninjauan. total: type: integer description: >- Anggota dengan setidaknya satu verifikasi, baik yang telah diputuskan maupun belum. Anggota yang semua verifikasinya belum diputuskan (belum dimulai, sedang berlangsung, kedaluwarsa, atau ditinggalkan) dihitung di sini dan tidak pada kunci lainnya. NetworkPatternScore: type: object description: >- Tingkat kesamaan salah satu jenis data anggota di seluruh jaringan. Pola bukanlah sinyal: tidak ada nilai bersama yang menghubungkan para anggota. properties: type: type: string enum: - background description: >- `background`: rerata kemiripan dari setiap pasangan latar belakang swafoto anggota, dengan orangnya disamarkan. Ini membaca swafoto terbaru dari setiap orang, paling banyak 50 swafoto terbaru, dan mengabaikan sesi verifikasi usia. Ini mencakup seluruh jaringan, tidak hanya anggota dari aplikasi Anda. score: type: number nullable: true minimum: 0 maximum: 1 description: >- Dari 0 hingga 1, dibulatkan ke 4 tempat desimal. Bernilai null saat `reason` diatur. members: type: integer nullable: true description: >- Berapa banyak swafoto anggota yang dibandingkan dalam penilaian. Swafoto yang tidak dapat dibaca, atau menampilkan latar belakang yang terlalu sedikit, tidak dibandingkan. Null selama `computing`; 0 atau 1 dengan `not_enough_selfies`. reason: type: string enum: - computing - not_enough_selfies nullable: true description: >- Alasan mengapa tidak ada skor. `computing`: skor untuk anggota saat ini sedang dihitung; kueri jaringan lagi nanti. `not_enough_selfies`: kurang dari dua anggota memiliki swafoto yang dapat digunakan. Null jika ada skor. computed_at: type: string format: date-time nullable: true description: Waktu skor dihitung. Null selama `computing`. NetworkListItem: type: object properties: uuid: type: string format: uuid network_id: type: string description: >- ID berurutan per organisasi yang dapat dibaca manusia, misalnya N-0001. name: type: string nullable: true status: type: string enum: - active - in_review - resolved - dismissed description: >- Status siklus hidup jaringan. Berbeda dari outcome_status per pemohon di dalam jaringan (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: Pola pengelompokan yang terdeteksi di jaringan ini. signal_types: type: array items: type: string enum: - ip_address - device - face - document_number - phone - email - address description: Jenis sinyal berbeda yang ada di jaringan ini. member_counts: type: object description: >- Jumlah anggota berdasarkan kategori (misalnya total, per outcome_status). member_status: type: object description: Rincian anggota berdasarkan outcome_status. signal_coverage: type: object description: Cakupan per signal_type dari anggota jaringan ini. 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: Skor risiko, 0-100. band: type: string enum: - low - medium - high description: Rentang tampilan skor. high >= 70, medium >= 40, selain itu low. bar: type: number format: float description: Nilai 0-1 yang dinormalisasi untuk menampilkan bilah risiko. securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Kunci API aplikasi Anda, dari Developers -> API keys di Business Console. Kunci utama memiliki akses penuh. Kunci bernama dapat diberi cakupan: none, read, atau write per sumber daya, dibatasi pada beberapa alur kerja atau pada sesi yang disetujui, pada daftar alamat IP, dan pada tanggal kedaluwarsa. 401 berarti kuncinya salah, dicabut, atau kedaluwarsa; 403 berarti tidak ada kunci yang dikirimkan, kunci tidak memiliki akses ke sumber daya atau tindakan ini, atau permintaan datang dari alamat di luar daftar IP-nya; 404 pada rute sesi berarti sesi berada di luar alur kerja atau status kunci tersebut. Kunci tanpa akses media menerima URL gambar, video, dan PDF sebagai null, dan kunci tanpa izin tulis sesi menerima tautan sesi dan token sebagai null. Lihat https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.