# webhookLimits

Query

Get the current workspace's outbound-webhook caps (maximum subscriptions, maximum content views per subscription, maximum metadata size) and how many subscriptions it already has. The caps come from the workspace plan tier unless a negotiated override applies (see `capsSource`).

Available to agents as MCP tool `getWebhookLimits` — see [Read tools](/api/v2/docs/mcp/read-tools#get-webhook-limits).

## Arguments

This field takes no arguments.

## Returns

Returns [`WebhookLimits!`](/api/v2/docs/types/webhook-limits).

## Examples

### Get webhook limits

Read the workspace's webhook caps (subscriptions, content views per subscription, metadata size) and how many subscriptions it already has, before creating or widening one.

```graphql
query WebhookLimitsDefault {
  webhookLimits {
    tier
    maxSubscriptions
    usedSubscriptions
    maxViewsPerSubscription
    metadataMaxBytes
    capsSource
  }
}
```

Response — HTTP 200:

```json
{
  "data": {
    "webhookLimits": {
      "tier": "base",
      "maxSubscriptions": 5,
      "usedSubscriptions": 2,
      "maxViewsPerSubscription": 5,
      "metadataMaxBytes": 4096,
      "capsSource": "workspace_override"
    }
  }
}
```