---
title: "Disable a webhook endpoint"
method: POST
path: "/api/v1/webhooks/endpoints/{endpointId}/disable"
tags: ["webhooks"]
---

# Disable a webhook endpoint

`POST /api/v1/webhooks/endpoints/{endpointId}/disable`

## Request

- Base URL: `https://api.trigger.dev`
- URL: `https://api.trigger.dev/api/v1/webhooks/endpoints/{endpointId}/disable`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api/docs/api/v1/webhooks/endpoints/:endpointId/disable/post.ts> (a function with typed inputs; its response is checked against the schema)

Pause an endpoint. Its status becomes `inactive` and its URL responds with `404` until you enable it, so providers see failed deliveries and retry on their own schedule. Returns the updated endpoint.

## Response `200`

Successful request

- WebhookEndpointDetailObject
  - `id` string, required: The endpoint's id.
  - `declaredId` string, required: The `id` the endpoint is declared with in code (`webhooks.endpoint.define({ id })`).
  - `source` string, required: The provider source that verifies and types the endpoint's events.
  - `status` 'active' | 'inactive' | 'deleting', required: `active` accepts deliveries. `inactive` was disabled, or is no longer in the current deployment, and its URL responds with `404`.
  - `secretProvisioning` 'provider' | 'integrator' | 'either', required: Who supplies the signing secret: `provider` issues it (store it with the set secret endpoint), `integrator` means you choose it (generate one), and `either` accepts both.
  - `secretSet` boolean, required: Whether a signing secret or public key is set. Every delivery is rejected until it is.
  - `tenantId` string, nullable, required: Reserved for dynamic endpoints. `null` for a declared endpoint.
  - `externalRef` string, nullable, required: Reserved for dynamic endpoints. `null` for a declared endpoint.
  - `url` string, required: The webhook URL to register with the provider.
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required
  - `subscribers` object[], required: The tasks and agents that receive the endpoint's deliveries.
    - `id` string, required: The subscriber id, used as `targetId` when replaying: a `webhook()` task's id, or `agentId:eventId` for an agent's `chat.event` or channel.
    - `type` 'task' | 'session', required: `task` triggers a run. `session` routes the event into an agent's session.
    - `taskId` string, required: The subscribing task, or the agent for a `session` subscriber.
    - `filter` string, nullable, required: The filter that decides which events the subscriber takes. `null` takes every event.
  - `setupPrompt` string, required: Instructions for an AI coding agent to register the endpoint with its provider and set up the signing secret.

## Other responses

- `401`: Unauthorized request
- `404`: Endpoint not found

## Changes

- **2026-10-15** `f44b1ec886c8`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api/changes/api/v1/webhooks/endpoints/:endpointId/disable/post.md)

---

[API](https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api.md) - [All operations](https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/triggerdotdev/apis/trigger-dev-v3-rest-api/revisions/441161111493?raw)