# Удалить API-ключ

Source: https://provod.ai/ru/docs/keys-delete

**`DELETE /v1/keys/{hash}`**

Отзовите обычный API-ключ навсегда. Для временного отключения используйте PATCH с disabled: true.

## Авторизация

`Authorization: Bearer <MANAGEMENT_API_KEY>`: управляющий ключ выбранного рабочего пространства. У создателя ключа проверяется действующее право `apiKeys.revoke`.

Рабочее пространство определяется ключом. Заголовок `X-Org-Id` не поддерживается.

## Параметры пути


| Поле   | Тип                  | Описание                                                                         |
| ------ | -------------------- | -------------------------------------------------------------------------------- |
| `hash` | string · обязательно | SHA-256 из `data.hash` при создании или из списка. Не секрет и не внутренний ID. |


## Ответ · 200


| Поле      | Тип     | Описание                         |
| --------- | ------- | -------------------------------- |
| `deleted` | boolean | Всегда true при успешном отзыве. |


### Пример ответа

Все идентификаторы и суммы в примерах условные.


**JSON ответа**


```json
{
  "deleted": true
}
```



## Пример запроса

Загрузите ключ в переменную окружения на сервере. TypeScript использует встроенный fetch в Node.js, Python только стандартную библиотеку.

Замените пример хеша на `data.hash` своего ключа.




TypeScript



Python



cURL




```typescript
const response = await fetch("https://api.provod.ai/v1/keys/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", {
  method: "DELETE",
  headers: {
    Authorization: `Bearer ${process.env.MANAGEMENT_API_KEY}`,
  },
});
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
console.log(await response.json());
```



```python
import json
import os
from urllib.request import Request, urlopen

request = Request(
    "https://api.provod.ai/v1/keys/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
    method="DELETE",
    headers={"Authorization": f"Bearer {os.environ['MANAGEMENT_API_KEY']}"},
)
with urlopen(request) as response:
    print(json.load(response))
```



```bash
curl --fail-with-body --silent --show-error -X DELETE \
  "https://api.provod.ai/v1/keys/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
  -H "Authorization: Bearer ${MANAGEMENT_API_KEY}"
```



## Ошибки


| HTTP  | Ошибка       | Причина                                                                                                             |
| ----- | ------------ | ------------------------------------------------------------------------------------------------------------------- |
| `401` | Unauthorized | Отсутствующий, недействительный, отключённый, отозванный или истёкший ключ. Заголовок `X-Org-Id` также отклоняется. |
| `403` | Forbidden    | Неверный тип ключа или недостаточно прав в рабочем пространстве.                                                    |
| `404` | Not Found    | Ключ не найден, отозван или принадлежит другому пространству.                                                       |


Пример ошибки авторизации:

```json
{
  "error": {
    "code": "invalid_api_key",
    "message": "Invalid API key",
    "metadata": {}
  }
}
```

Пример ошибки метода:

```json
{
  "message": "API key not found",
  "error": "Not Found",
  "statusCode": 404
}
```

## Далее

* [Управляющие ключи](/ru/docs/management-keys)
* [Стоимость запроса](/ru/docs/generation-metadata)
