> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentlinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Delivery Webhooks tools

> Inputs, access and errors for 5 registered delivery webhooks tools.

Generated 2026-09-13T03:11:22.248Z from `src/tool-registry.js` by `scripts/export-mint-tool-docs.mjs`. 5 of 62 registered tools. Authenticated cloud tools have REST endpoints under `/v1/`. The anonymous `verify_link_free` tool uses `POST /free/check` and `/free/mcp`.

## create\_webhook

Subscribe an HTTPS receiver to source or destination events, or periodic digests. Returns the signing secret once. Delivery is signed, at-least-once, and starts at the current sequence; deduplicate by Linktrail-Delivery-Id and recover gaps through the event feed. A 410 receiver response disables delivery.

* **State**: Registered.
* **Access**: write · scope: `watches:write` · defined at `src/tool-registry.js:67`

| Input             | Type    | Required | Notes                                                                                           |
| ----------------- | ------- | -------- | ----------------------------------------------------------------------------------------------- |
| `projectId`       | string  | no       | Identifier of the project returned by its create or list operation.                             |
| `url`             | string  | yes      | Public HTTPS endpoint or destination URL required by this operation.                            |
| `description`     | string  | no       | Optional human-readable description of this resource.                                           |
| `eventTypes`      | array   | no       | Event type filters for this subscription; omitted means all supported types.                    |
| `feeds`           | array   | no       | Independent source or destination event feeds to subscribe to.                                  |
| `deliveryMode`    | string  | no       | Choose individual event deliveries or one digest per configured window.; one of: events, digest |
| `digestFrequency` | string  | no       | Digest window frequency; applicable only when deliveryMode is digest.; one of: daily, weekly    |
| `digestHourUtc`   | integer | no       | UTC hour from 0 to 23 when the digest window closes.                                            |

**Side effects**: write

**Error codes**: `PROJECT_DENIED` · `WEBHOOK_ENDPOINT_NOT_FOUND`

## list\_webhooks

List this workspace's webhook endpoints with their state, subscribed feeds and types, consecutive failure count and why any was disabled. Secrets are never returned.

* **State**: Registered.
* **Access**: read · scope: `events:read` · defined at `src/tool-registry.js:68`

No inputs.

**Error codes**: `PROJECT_DENIED` · `WEBHOOK_ENDPOINT_NOT_FOUND`

## rotate\_webhook\_secret

Add a second active signing secret, or retire the older one. Both secrets sign every request while two are active, so a receiver updates its configuration whenever it likes rather than deploying in lockstep with us. The new secret is returned ONCE.

* **State**: Registered and locally tested.
* **Access**: write · scope: `watches:write` · defined at `src/tool-registry.js:69`

| Input        | Type    | Required | Notes                                                                              |
| ------------ | ------- | -------- | ---------------------------------------------------------------------------------- |
| `endpointId` | string  | yes      | Identifier of the endpoint returned by its create or list operation.               |
| `retire`     | boolean | no       | True retires the older signing secret immediately; false adds a new active secret. |

**Side effects**: write

**Error codes**: `PROJECT_DENIED` · `WEBHOOK_ENDPOINT_NOT_FOUND`

## set\_webhook\_state

Enable or disable one endpoint. Disabling stops delivery and loses nothing: undelivered events stay in the feed and can be read with a cursor. Re-enabling clears the failure count.

* **State**: Registered.
* **Access**: write · scope: `watches:write` · defined at `src/tool-registry.js:70`

| Input        | Type   | Required | Notes                                                                                               |
| ------------ | ------ | -------- | --------------------------------------------------------------------------------------------------- |
| `endpointId` | string | yes      | Identifier of the endpoint returned by its create or list operation.                                |
| `state`      | string | yes      | Requested resource state or saved-observation filter, as enumerated here.; one of: active, disabled |

**Side effects**: write

**Error codes**: `PROJECT_DENIED` · `WEBHOOK_ENDPOINT_NOT_FOUND`

## list\_webhook\_deliveries

Read recent delivery attempts for one endpoint: state, attempt count, last HTTP status and error. Diagnostic only; it does not resend.

* **State**: Registered.
* **Access**: read · scope: `events:read` · defined at `src/tool-registry.js:71`

| Input        | Type    | Required | Notes                                                                       |
| ------------ | ------- | -------- | --------------------------------------------------------------------------- |
| `endpointId` | string  | yes      | Identifier of the endpoint returned by its create or list operation.        |
| `limit`      | integer | no       | Maximum rows in this page or bounded report; subject to the schema maximum. |

**Error codes**: `PROJECT_DENIED` · `WEBHOOK_ENDPOINT_NOT_FOUND`