Удаление вебхука

DELETE /v1/webhooks/{id}

Немедленное удаление вебхука. После удаления эндпоинт прекратит получать события.

Попробуйте

Протестируйте этот эндпоинт интерактивно в Swagger UI.

Требуется авторизация

Укажите ваш API-ключ в заголовке Authorization.

DANGER

Удаление вебхука происходит немедленно и является необратимым. Эндпоинт немедленно прекратит получать события. Это действие нельзя отменить -- вам потребуется создать новый вебхук.

Запрос

Заголовки

Заголовок	Значение	Обязательно
Authorization	Bearer <token>	Да

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

Параметр	Тип	Обязательно	Описание
id	string	Да	ID вебхука для удаления (например, webhook-abc123def456).

Примеры кода

curl

curl -X DELETE https://api.docmap.io/v1/webhooks/webhook-abc123def456 \
  -H "Authorization: Bearer dm_live_abc123def456ghi789jkl012mno345"

TypeScript

const apiKey = process.env.DOCMAP_API_KEY
const webhookId = 'webhook-abc123def456'

const response = await fetch(
  `https://api.docmap.io/v1/webhooks/${webhookId}`,
  {
    method: 'DELETE',
    headers: { 'Authorization': `Bearer ${apiKey}` },
  },
)

const result = await response.json()
console.log(result) // { success: true }

Python

import requests

api_key = "dm_live_abc123def456ghi789jkl012mno345"
webhook_id = "webhook-abc123def456"

response = requests.delete(
    f"https://api.docmap.io/v1/webhooks/{webhook_id}",
    headers={"Authorization": f"Bearer {api_key}"},
)

print(response.json())  # {"success": True}

Ответ

Статус: 200 OK

Пример

{
  "success": true
}

Ошибки

Статус	Код	Описание
401	UNAUTHORIZED	Отсутствующий, недействительный или просроченный API-ключ / токен.
403	FORBIDDEN	Вебхук принадлежит другому пользователю. Вы можете удалять только свои собственные вебхуки.
404	NOT_FOUND	Вебхук с указанным ID не найден.