Ctrl+K

List webhook signing keys

get/api/policy/v1/enterprises/{enterpriseId}/webhooks/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.

Path Parameters

  • enterpriseIdstringRequired
    The enterprise ID.

Query Parameters

  • statusstring
    Filter by key status.
    Enum: ACTIVE REVOKED
  • limitintegerDefault: 50
    Maximum number of results per page. Default 50, maximum 100.
    Minimum: >= 1
    Maximum: <= 100
  • prevIdintegerDefault: 0
    Pagination offset. Default 0.
    Minimum: >= 0

200 Response

keys array[object] required
Metadata about a registered webhook signing key.
id string <uuid>required
Internal UUID of the key.
Example: f47ac10b-58cc-4372-a567-0e02b2c3d479
keyId string required
Customer-provided key identifier.
Example: customer-prod-key-2026
keyName string required
Human-readable name for the key.
Example: Production Webhook Key
algorithm
string or null
The signing algorithm (EdDSA or ECDSA). Null for JWKS URI registrations.
Allowed values: EdDSA ECDSA
Example: EdDSA
status string required
Current status of the key.
Allowed values: ACTIVE REVOKED
Example: ACTIVE
createdDate string <date-time>required
When the key was registered.
Example: 2026-01-12T10:30:00.000Z
createdBy string required
User who registered the key.
Example: user@example.com
total integer <int64>required
Total number of keys matching the query.
Example: 1
limit integer required
Maximum results per page.
Example: 50
prevId integer required
The pagination offset used in this request.
Example: 0

400 Response

One of
code string
message string
status integer

401 Response

code string
message string
status integer

403 Response

code string
message string
status integer

404 Response

code string
message string
status integer

500 Response

code string
message string
status integer