Skip to main content
PUT
Configure the audit webhook

Authorizations

Authorization
string
header
required

A personal access token (POST /v1/auth/tokens) or a machine identity token (POST /v1/projects/{project_id}/identities/{identity_id}/tokens), both prefixed qumo_pat_. A token's scopes cap what it can do; see Scopes and permissions. A personal token names no organization: on a route whose path names no project or organization, pass ?organization_id=.

Query Parameters

organization_id
string<uuid>

The organization the request acts in. Required with a personal token or a session, which name no organization themselves; an identity token's organization is implied.

Body

application/json
url
string<uri>
required

A public https URL audit entries are posted to.

Example:

"https://hooks.example.com/qumo-audit"

secret
string
required

The key deliveries are signed with. At least 32 bytes.

Minimum string length: 32
Example:

"3b7e9a1c5d2f8e4a6c0b9d7f1e3a5c8b"

Response

Configured.