---
title: "Отозвать общую ссылку"
method: POST
path: "/api/v1/invitations/shared-links/{id}/revoke"
tags: ["Invitations"]
---

# Отозвать общую ссылку

`POST /api/v1/invitations/shared-links/{id}/revoke`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/invitations/shared-links/{id}/revoke`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://erp.akeda.ru/oauth2/authorize`, token URL `https://erp.akeda.ru/oauth2/token`, scopes: `akeda:delegate`)

Ссылка перестаёт работать сразу; те, кто уже присоединился, остаются участниками — их доступ закрывают в «Команде». Повторный отзыв безопасен.

## Path parameters

- `id` string, uuid, required

## Headers

- `X-Tenant` string, required

## Response `200`

Отозванная ссылка

- InvitationSharedLink
  - `id` string, uuid, required
  - `tenant_id` string, uuid, required
  - `tenant_name` string
  - `role_id` string, uuid, required
  - `role_name` string
  - `affiliation` 'own' | 'external' | 'guest', required
  - `organization_contact_id` string, uuid
  - `access_until` string, date
  - `max_uses` integer, required
  - `used_count` integer, required
  - `expires_at` string, date-time, required
  - `created_by` integer, required
  - `created_by_name` string
  - `created_at` string, date-time, required
  - `revoked_at` string, date-time
  - `status` 'active' | 'expired' | 'exhausted' | 'revoked', required
  - `invite_url` string: Адрес ссылки; только в ответе на создание

## Other responses

- `400`: Некорректный запрос или нарушение бизнес-правила
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `404`: Запись не найдена или не видима текущему пользователю

---

[API](https://skmtc.dev/akeda/apis/akeda-erp-client-api.md) · [All operations](https://skmtc.dev/akeda/apis/akeda-erp-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/akeda/apis/akeda-erp-client-api/revisions/3c60ded179f2?raw)