---
title: "Archive Webhook"
method: PATCH
path: "/v0/webhooks/{webhook_id}/archive"
tags: ["Webhooks"]
---

# Archive Webhook

`PATCH /v0/webhooks/{webhook_id}/archive`

Archive a webhook by its ID to permanently stop event delivery and remove it from the active webhook list. Archived webhooks and their event history are retained for reference but will no longer trigger notifications.

## Path parameters

- `webhook_id` integer, required — ID of the webhook

## Response `200`

Successful Response

- WebhookResponseV0
  - `url` string, uri, required — URL of the webhook
  - `search_id` integer, required — ID of the search that the webhook is listening to.
  - `description` string, nullable — Description of the webhook
  - `listening_start_time` string, date-time, nullable — Date when the webhook started listening for events. If listening_start_time is None, the webhook will listen to all events matching the search query regardless of when they occurred.
  - `trigger_once_per_company` boolean — Only for webhook type ='job.new'. If true, Company A with 5 jobs → 1 event triggered. If false, Company A with 5 jobs → 5 events triggered
  - `active_event_types` WebhookEventType[], required
  - `id` integer, required
  - `user_id` integer, required
  - `team_id` integer, required
  - `is_active` boolean, required
  - `is_archived` boolean, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `search_name` string, required
  - `webhook_type` 'jobs' | 'companies', required
  - `scanning_frequency` string — Scanning frequency for the webhook
  - `has_secret` boolean, required
  - `event_type` 'job_new' | 'company_new' | 'job_closed', required

## Other responses

- `400` — Bad Request
- `402` — Payment Required
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

[API](https://skmtc.net/theirstack/apis/theirstack-api-reference.md) · [All operations](https://skmtc.net/theirstack/apis/theirstack-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/theirstack/theirstack-api-reference/versions/2723cd54b43e/schema)