Webhook Keys

List webhook signing keys

Lists all webhook signing keys registered for an enterprise.

Authorization: Caller must be an admin of the specified enterprise.

Returns key metadata only — actual public key material and JWK data are not included in the response.

get/api/policy/v1/enterprises/{enterpriseId}/webhooks/keys

Path parameters

enterpriseIdstring required

The enterprise ID.

Query parameters

status'ACTIVE' | 'REVOKED'

Filter by key status.

limitinteger

Maximum number of results per page. Default 50, maximum 100.

prevIdinteger

Pagination offset. Default 0.

Response

A paginated list of webhook signing keys.

totalinteger required

Total number of keys matching the query.

limitinteger required

Maximum results per page.

prevIdinteger required

The pagination offset used in this request.

Example response

{
  "keys": [
    {
      "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "keyId": "customer-prod-key-2026",
      "keyName": "Production Webhook Key",
      "algorithm": "EdDSA",
      "status": "ACTIVE",
      "createdDate": "2026-01-12T10:30:00.000Z",
      "createdBy": "user@example.com"
    }
  ],
  "total": 1,
  "limit": 50
}

Changes

No recorded changes to this endpoint across all 17 revisions of this API.