---
title: "Delete a Workspace subscription"
method: DELETE
path: "/company/webhooks/{webhookId}"
tags: ["Company Publishing", "Webhooks"]
---

# Delete a Workspace subscription

`DELETE /company/webhooks/{webhookId}`

## Request

- Base URL: `https://api.publora.com/api/v1`
- URL: `https://api.publora.com/api/v1/company/webhooks/{webhookId}`
- Auth: API key in header `x-publora-key`

Agency Workspace settings managers only. Personal webhook endpoints do not access Company subscriptions.

## Headers

- `x-publora-client` string
- `X-Publora-Workspace-Id` string, required
- `Idempotency-Key` string, required

## Request body

- object

## Response `200`

Successful Workspace-scoped response. Mutation and idempotent response snapshot commit together; identical retries return the original result.

- CompanyWebhookDeleteResponse
  - `success` true, required
  - `data` object, required
    - `accountId` string, required
    - `workspaceId` string, required
    - `webhookId` string, required
    - `deleted` true, required

## Other responses

- `400`: COMPANY_WEBHOOK_INPUT_INVALID: invalid fields, URL, events, webhook ID or idempotency key.
- `401`: API key authentication failed; existing API authentication error envelope.
- `403`: Workspace or role unavailable (AGENCY_CORE_ACCESS_DENIED).
- `404`: COMPANY_WEBHOOK_NOT_FOUND: no such subscription in the selected Workspace.
- `409`: COMPANY_WEBHOOK_CONFLICT, COMPANY_WEBHOOK_IDEMPOTENCY_CONFLICT or COMPANY_WEBHOOK_IDEMPOTENCY_IN_FLIGHT. In-flight responses include Retry-After; keep the original body and key.
- `503`: COMPANY_WEBHOOK_UNAVAILABLE: dependency or transaction unavailable. Retry the identical operation/key later.

## Changes

- **2026-10-22** `83bd5829401f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/publora/apis/publora-api/changes/company/webhooks/:webhookId/delete.md)

---

[API](https://skmtc.dev/publora/apis/publora-api.md) - [All operations](https://skmtc.dev/publora/apis/publora-api/llms.txt) - [OpenAPI document](https://skmtc.dev/publora/apis/publora-api/revisions/f93f96e52798?raw)