> ## 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 > Добавьте один из тегов вашего приложения в мошенническую сеть через 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/ru/management-api/networks/get.md). Код `201` возвращается, когда тег добавлен, и `200`, когда он уже был добавлен в сеть. Повторный вызов с тем же тегом ничего не меняет, поэтому повторную попытку можно выполнять безопасно.`tags` содержит теги вашего приложения, назначенные сети, от старых к новым. `added_by` равен `null`, если тег добавил API-ключ, и содержит адрес электронной почты участника консоли, если тег добавил участник. Поле `fraud_tags` сети, то есть теги, которые есть у её участников, не затрагивается.## Связанные материалы- [Удалить тег сети](https://docs.didit.me/ru/management-api/networks/remove-tag.md) - [Получить сеть](https://docs.didit.me/ru/management-api/networks/get.md) - [Список сетей](https://docs.didit.me/ru/management-api/networks/list.md) ## OpenAPI ````yaml ru/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-ключ принадлежит другому приложению или имеет ограниченный доступ: для endpoint’ов раздела Networks требуется ключ с полным доступом. Для токена участника консоли требуется `write:networks`. Также возвращается с `code: networks_not_entitled`, если Networks не включен для организации. 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: >- Применяются ли сигналы между организациями к этой организации. Для них требуются как тариф Enterprise, так и режим общего доступа `global`. example: true cross_org_unavailable_reason: type: string enum: - plan - sharing_mode nullable: true description: >- Причина, по которой межорганизационные сигналы не применяются; проверяются в следующем порядке. `plan`: тариф организации не включает межорганизационную сеть защиты от мошенничества (требуется тариф Enterprise) независимо от режима обмена данными. `sharing_mode`: тариф включает её, но режим обмена установлен как `private` или `off`. Null, если `cross_org_available` равен `true`. 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: Шестнадцатеричный цвет (hex), например `#6366F1`. source: type: string enum: - didit - custom description: >- `didit` для предустановленного тега Didit, `custom` для тега, созданного вашей командой. added_by: type: string nullable: true description: >- Электронная почта участника консоли, добавившего тег. Null, если он добавлен с помощью API-ключа. 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, округлено до 4 знаков после запятой. Null, когда задано поле `reason`. members: type: integer nullable: true description: >- Количество селфи участников, с которыми производилось сравнение. Селфи, которое невозможно прочитать или на котором слишком мало фона, не сравнивается. Равно null во время `computing`; 0 или 1 при `not_enough_selfies`. reason: type: string enum: - computing - not_enough_selfies nullable: true description: >- Почему оценка отсутствует. `computing`: оценка для текущих участников вычисляется; повторно запросите данные сети позднее. `not_enough_selfies`: менее чем у двух участников есть пригодное селфи. Null, если оценка есть. computed_at: type: string format: date-time nullable: true description: Время расчёта оценки. Null во время `computing`. NetworkListItem: type: object properties: uuid: type: string format: uuid network_id: type: string description: >- Понятный человеку порядковый идентификатор в рамках организации, например 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: >- Диапазон, в котором отображается оценка. high >= 70, medium >= 40, иначе low. bar: type: number format: float description: Нормализованное значение от 0 до 1 для отображения шкалы риска. securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- API-ключ вашего приложения из раздела «Разработчикам» -> «API-ключи» в Business Console. Основной ключ имеет полный доступ. Именованный ключ может иметь ограниченную область действия: без доступа, чтение или запись для каждого ресурса, ограничение определенными сценариями или одобренными сессиями, списком IP-адресов и сроком действия. 401 означает, что ключ неверен, отозван или его срок действия истек; 403 означает, что ключ не был передан, у ключа нет доступа к этому ресурсу или действию, либо запрос поступил с адреса вне его списка IP-адресов; 404 на маршруте сессии означает, что сессия не входит в сценарии или статусы ключа. Ключ без доступа к медиа получает URL изображений, видео и PDF как null, а ключ без прав на запись сессий получает ссылки на сессии и токены как null. См. https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.