> ## 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 > Didit 애플리케이션의 태그를 사기 네트워크에 추가합니다. 태그가 포함된 네트워크 상세 정보를 반환합니다. 네트워크 태그 추가 API 프롬프트 프롬프트를 클립보드에 복사 \

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

\
붙여넣을 곳 애플리케이션의 태그 중 하나를 네트워크에 추가합니다. 예를 들어 후속 조치가 필요한 네트워크를 표시하거나 팀이 내린 결론을 기록할 때 사용할 수 있습니다. 애플리케이션 태그의 UUID를 `tag_uuid`로 전달합니다. 다른 애플리케이션에 속한 태그를 지정하면, 존재하지 않는 태그와 마찬가지로 `404`를 반환합니다.응답은 전체 [네트워크 상세 정보](https://docs.didit.me/ko/management-api/networks/get.md)이며, 태그가 추가된 경우 `201`을, 태그가 이미 네트워크에 있었던 경우 `200`을 반환합니다. 같은 태그로 다시 호출해도 변경되는 것은 없으므로 안전하게 재시도할 수 있습니다.`tags`에는 애플리케이션의 태그 중 네트워크에 추가된 태그가 가장 오래된 순으로 나열됩니다. `added_by`는 API 키가 태그를 추가한 경우 `null`이고, 콘솔 멤버가 추가한 경우 해당 멤버의 이메일 주소입니다. 네트워크의 `fraud_tags`(멤버가 보유한 태그)는 영향을 받지 않습니다.## 관련 문서- [네트워크 태그 삭제](https://docs.didit.me/ko/management-api/networks/remove-tag.md) - [네트워크 조회](https://docs.didit.me/ko/management-api/networks/get.md) - [네트워크 목록 조회](https://docs.didit.me/ko/management-api/networks/list.md) ## OpenAPI ````yaml ko/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입니다. 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: 네트워크에 태그 추가 description: >- 귀하의 애플리케이션 태그 중 하나를 네트워크에 추가합니다. `tags`에 해당 네트워크에 있는 귀하의 애플리케이션 태그가 나열된 네트워크 상세 정보를 반환하며, 태그가 추가되었을 때는 `201`을, 이미 네트워크에 있었을 때는 `200`을 반환합니다. 다른 애플리케이션에 속해 있거나 존재하지 않는 태그는 404 `Tag not found.`를 반환합니다. 전체 액세스 API 키가 필요하거나, 콘솔 멤버의 경우 `write:networks` 권한이 필요합니다. operationId: add_network_tag parameters: - name: organization_id in: path required: true schema: type: string format: uuid description: 조직 UUID입니다. - name: application_id in: path required: true schema: type: string format: uuid description: 애플리케이션 UUID입니다. - name: network_uuid in: path required: true schema: type: string format: uuid example: 3fa85f64-5717-4562-b3fc-2c963f66afa6 description: 네트워크 UUID입니다. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/NetworkTagRequest' example: tag_uuid: 7c9e6679-7425-40de-944b-e07fc1f90ae7 responses: '200': description: 태그가 이미 네트워크에 존재하여 그대로 유지됩니다. 네트워크 세부 정보를 반환합니다. 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: 태그가 추가되었습니다. 네트워크 세부 정보를 반환합니다. 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: '유효하지 않은 본문: `tag_uuid`가 누락되었거나 UUID가 아닙니다.' content: application/json: schema: type: object properties: tag_uuid: type: array items: type: string examples: Missing tag_uuid: summary: tag_uuid가 누락되었습니다 value: tag_uuid: - This field is required. Invalid tag_uuid: summary: 유효하지 않은 tag_uuid value: tag_uuid: - Must be a valid UUID. '401': description: 자격 증명이 누락되었거나 유효하지 않습니다. content: application/json: schema: type: object properties: detail: type: string code: type: string description: '코드화된 오류에 표시됩니다(예: `networks_not_entitled`).' examples: Missing or invalid credentials: summary: 자격 증명이 누락되었거나 유효하지 않음 value: detail: >- Authentication credentials were not provided or are invalid. '403': description: >- API 키가 다른 애플리케이션에 속해 있거나 접근 권한이 제한된 키입니다. Networks 엔드포인트에는 전체 접근 권한 키가 필요합니다. 콘솔 멤버 토큰에는 `write:networks` 권한이 필요합니다. 조직에 Networks가 활성화되어 있지 않은 경우 `code: networks_not_entitled`와 함께 반환되기도 합니다. content: application/json: schema: type: object properties: detail: type: string code: type: string description: '코드화된 오류에 표시됩니다(예: `networks_not_entitled`).' examples: Networks not enabled: summary: 네트워크가 활성화되지 않았습니다 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: 제한된 API 키 value: detail: This API key has no access to this endpoint. No permission: summary: 권한 없음 value: detail: You do not have permission to perform this action. '404': description: 찾을 수 없습니다. content: application/json: schema: type: object properties: detail: type: string code: type: string description: '코드화된 오류에 표시됩니다(예: `networks_not_entitled`).' examples: Network not found: summary: 네트워크를 찾을 수 없습니다 value: detail: Network not found. Tag not found: summary: 태그를 찾을 수 없음 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입니다. example: tag_uuid: 7c9e6679-7425-40de-944b-e07fc1f90ae7 NetworkDetailResponse: description: >- 네트워크 세부 정보와 조직의 공유 모드, 교차 조직 신호 적용 여부, 네트워크에서의 애플리케이션 태그, 멤버 결과 및 패턴 점수입니다. allOf: - $ref: '#/components/schemas/NetworkDetail' - type: object properties: sharing_mode: type: string enum: - 'off' - private - global description: >- 조직의 조직 간 공유 모드입니다. `global`만 조직 간 네트워크를 비교하며, `private` 및 `off`는 해당 조직 자체의 이력으로만 제한합니다. example: global cross_org_available: type: boolean description: 조직 간 신호가 이 조직에 적용되는지 여부입니다. 엔터프라이즈 플랜과 `global` 공유 모드가 모두 필요합니다. example: true cross_org_unavailable_reason: type: string enum: - plan - sharing_mode nullable: true description: >- 조직 간 신호가 적용되지 않는 이유(확인 순서 기준). `plan`: 공유 모드와 관계없이 조직의 요금제에 조직 간 사기 방지 네트워크가 포함되어 있지 않습니다(Enterprise 요금제 필요). `sharing_mode`: 요금제에는 포함되어 있으나 공유 모드가 `private` 또는 `off`입니다. `cross_org_available`이 `true`인 경우 null입니다. example: null tags: type: array items: $ref: '#/components/schemas/NetworkTag' description: >- 네트워크상에서 귀하 애플리케이션의 태그로, 오래된 순으로 정렬됩니다. 각 애플리케이션은 자신의 태그만 볼 수 있습니다. `fraud_tags`는 별개이며 변경되지 않습니다. 이는 네트워크 멤버들이 보유한 태그입니다. outcomes: $ref: '#/components/schemas/NetworkOutcomes' patterns: type: array items: $ref: '#/components/schemas/NetworkPatternScore' description: 전체 네트워크에 걸친 패턴 점수입니다. 현재는 `background` 항목 하나만 제공됩니다. NetworkDetail: allOf: - $ref: '#/components/schemas/NetworkListItem' - type: object properties: stats: type: object description: '네트워크에 대한 집계 통계입니다(예: 멤버 총수).' fraud_tags: type: array items: type: object description: 네트워크에 나타난 사기 패턴 태그입니다. risk_signals: type: object description: >- 위험 신호 요약: 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: 이 조사에 포함된 비공개 분석가 메모 수입니다. NetworkTag: type: object description: 네트워크에서 해당 애플리케이션의 태그 중 하나입니다. properties: uuid: type: string format: uuid description: 태그의 UUID로, `tag_uuid`로 전달하는 값과 동일합니다. name: type: string color: type: string description: '16진수 색상 코드입니다(예: `#6366F1`).' source: type: string enum: - didit - custom description: Didit 사전 설정 태그의 경우 `didit`, 팀에서 생성한 태그의 경우 `custom`. added_by: type: string nullable: true description: 태그를 추가한 콘솔 멤버의 이메일입니다. API 키로 추가한 경우 null입니다. added_at: type: string format: date-time NetworkOutcomes: type: object description: >- 네트워크의 개인 및 기업의 현재 상태입니다. 조회 가능한 각 멤버는 결정에 도달한 가장 최근 인증 상태에 따라 한 번씩 카운트됩니다. 거래 당사자는 카운트되지 않습니다. properties: approved: type: integer description: 가장 최근 결정된 인증이 승인된 멤버입니다. declined: type: integer description: 가장 최근 결정된 인증이 거부된 멤버입니다. in_review: type: integer description: 가장 최근 결정된 인증이 검토 중인 멤버입니다. total: type: integer description: >- 결정 여부와 관계없이 최소 한 번 이상 인증을 진행한 멤버입니다. 모든 인증이 미결정(시작되지 않음, 진행 중, 만료됨, 중단됨) 상태인 멤버는 여기에만 집계되고 다른 키에는 집계되지 않습니다. NetworkPatternScore: type: object description: >- 전체 네트워크에서 멤버들의 데이터 중 한 유형이 얼마나 유사한지 나타냅니다. 패턴은 신호가 아닙니다. 공유된 값이 멤버들을 연결하지는 않습니다. properties: type: type: string enum: - background description: >- `background`: 인물을 마스킹 처리한 후 멤버의 셀피 배경 쌍 간의 평균 유사도입니다. 각 인물의 최신 셀피 중 가장 최근의 최대 50개를 읽으며 연령 보증 세션은 제외합니다. 사용자 애플리케이션의 멤버뿐만 아니라 전체 네트워크를 대상으로 합니다. score: type: number nullable: true minimum: 0 maximum: 1 description: 0부터 1까지의 값이며, 소수점 넷째 자리에서 반올림됩니다. `reason`이 설정된 경우 null입니다. members: type: integer nullable: true description: >- 점수 산정 시 비교한 멤버 셀피 수입니다. 판독할 수 없거나 배경이 너무 적게 표시된 셀피는 비교되지 않습니다. `computing` 중에는 null이고, `not_enough_selfies`인 경우 0 또는 1입니다. reason: type: string enum: - computing - not_enough_selfies nullable: true description: >- 점수가 없는 이유입니다. `computing`: 현재 멤버의 점수를 계산하는 중이므로 나중에 네트워크를 다시 조회하세요. `not_enough_selfies`: 사용 가능한 셀피를 보유한 멤버가 2명 미만입니다. 점수가 있으면 null입니다. computed_at: type: string format: date-time nullable: true description: 점수가 산정된 시점입니다. `computing` 상태인 동안에는 null입니다. NetworkListItem: type: object properties: uuid: type: string format: uuid network_id: type: string description: '사람이 읽을 수 있는 조직별 순차 ID(예: N-0001)입니다.' name: type: string nullable: true status: type: string enum: - active - in_review - resolved - dismissed description: >- 네트워크 라이프사이클 상태입니다. 네트워크 내부의 신청자별 outcome_status(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: 이 네트워크에서 감지된 클러스터링 패턴입니다. signal_types: type: array items: type: string enum: - ip_address - device - face - document_number - phone - email - address description: 이 네트워크에 존재하는 고유한 신호 유형들입니다. member_counts: type: object description: '카테고리별 멤버 수(예: 전체, outcome_status별).' member_status: type: object description: outcome_status별 멤버 내역입니다. signal_coverage: type: object description: 이 네트워크 멤버들의 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: 위험 점수, 0-100. band: type: string enum: - low - medium - high description: 점수가 표시되는 구간입니다. 70 이상은 high, 40 이상은 medium, 그 외에는 low입니다. bar: type: number format: float description: 위험 바를 렌더링하기 위한 정규화된 0-1 값입니다. securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Business Console의 Developers -> API keys에서 발급받은 귀하 애플리케이션의 API 키입니다. 기본 키는 전체 접근 권한을 갖습니다. 이름이 지정된 키는 리소스별 none, read, write 범위로 권한을 제한할 수 있으며 특정 워크플로나 승인된 세션, IP 주소 목록, 만료일 등으로 제한할 수도 있습니다. 401은 키가 잘못되었거나 폐기되었거나 만료되었음을 의미합니다. 403은 키가 전송되지 않았거나, 키에 해당 리소스나 작업에 대한 접근 권한이 없거나, 요청이 허용된 IP 목록 외부 주소에서 발생했음을 의미합니다. 세션 경로에서의 404는 해당 세션이 키의 허용 워크플로 또는 상태 범위를 벗어났음을 의미합니다. 미디어 접근 권한이 없는 키는 이미지, 비디오, PDF URL을 null로 수신하며, 세션 write 권한이 없는 키는 세션 링크와 token을 null로 수신합니다. https://docs.didit.me/console/api-keys 를 참고하십시오. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.