# Commentary Webhooks API

**Canonical:** https://apis.io/apis/commentary-dev/commentary-dev-webhooks-api/  
**Provider:** Commentary — https://apis.io/providers/commentary-dev/  
**Base URL:** https://commentary.dev  
**Documentation:** https://commentary.dev/docs/reference

Commentary Webhooks API is one of 27 APIs that [Commentary](https://apis.io/providers/commentary-dev/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Webhook. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

The Webhooks API from Commentary — 6 operation(s) for webhooks.

## Operations (8)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/webhook-subscriptions` | List workspace webhook subscriptions |
| POST | `/api/v1/webhook-subscriptions` | Create a scoped webhook subscription and reveal its signing secret once |
| GET | `/api/v1/webhook-subscriptions/{subscriptionId}` | Get a webhook subscription without its secret |
| PATCH | `/api/v1/webhook-subscriptions/{subscriptionId}` | Conditionally update endpoint or event scopes |
| POST | `/api/v1/webhook-subscriptions/{subscriptionId}/disable` | Disable delivery and cancel pending attempts |
| POST | `/api/v1/webhook-subscriptions/{subscriptionId}/rotate-secret` | Rotate and reveal a new signing secret once |
| GET | `/api/v1/webhook-subscriptions/{subscriptionId}/deliveries` | List filtered redacted delivery diagnostics and dead letters |
| POST | `/api/v1/webhook-subscriptions/{subscriptionId}/deliveries/{deliveryId}/replay` | Confirm replay of one delivery as a new delivery id |

## Machine-readable artifacts (3)

- **OpenAPI** — https://artifacts.apis.io/commentary-dev/openapi/commentary-dev-webhooks-api-openapi.yml
- **Documentation** — https://commentary.dev/docs/build
- **APIReference** — https://commentary.dev/docs/reference

## Other Commentary APIs (12)

- [Commentary Agents API](https://apis.io/apis/commentary-dev/commentary-dev-agents-api/)
- [Commentary Authentication API](https://apis.io/apis/commentary-dev/commentary-dev-authentication-api/)
- [Commentary Draft reviews API](https://apis.io/apis/commentary-dev/commentary-dev-draft-reviews-api/)
- [Commentary Forms API](https://apis.io/apis/commentary-dev/commentary-dev-forms-api/)
- [Commentary GitHub API](https://apis.io/apis/commentary-dev/commentary-dev-github-api/)
- [Commentary Health API](https://apis.io/apis/commentary-dev/commentary-dev-health-api/)
- [Commentary Inbox API](https://apis.io/apis/commentary-dev/commentary-dev-inbox-api/)
- [Commentary Interactions API](https://apis.io/apis/commentary-dev/commentary-dev-interactions-api/)
- [Commentary Knowledge Brain API](https://apis.io/apis/commentary-dev/commentary-dev-knowledge-brain-api/)
- [Commentary MCP API](https://apis.io/apis/commentary-dev/commentary-dev-mcp-api/)
- [Commentary Package uploads API](https://apis.io/apis/commentary-dev/commentary-dev-package-uploads-api/)
- [Commentary Project evidence API](https://apis.io/apis/commentary-dev/commentary-dev-project-evidence-api/)

## Tags

Webhook

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/commentary-dev/commentary-dev-webhooks-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/commentary-dev/.
