Skip to main content
Every /v1 request requires a Watchdog API key in the Authorization header.

Create a key

  1. Sign in to Watchdog.
  2. Open Settings → API keys.
  3. Choose Create API key. You must be an organization administrator.
  4. Give the key a name that identifies the consuming service.
  5. Copy the token into a secrets manager before closing the dialog.
Watchdog shows the plaintext token once. It cannot be recovered later. If it is lost or exposed, revoke it and create a replacement.

Send a request

Keep keys on the server. Do not embed them in browser code, mobile applications, documentation examples, logs, or source control.

Rotate or revoke a key

Create the replacement before revoking the old key so the consuming service can be updated without interruption. Revoked and disabled keys receive an authentication or authorization error and cannot be re-enabled by the client.