API tokens and scopes

Tokens authenticate your calls to the Ferrow API. Create one for each integration, so you can revoke it without breaking the others.

Scopes

• monitors:read lists and reads monitors.

• monitors:write creates, edits and deletes monitors.

• alerts:read reads alerts and incidents.

• webhooks:manage manages webhook endpoints.

Use a token

curl https://api.ferrow.dev/v1/monitors \
  -H "Authorization: Bearer frw_live_xxx"

curl https://api.ferrow.dev/v1/monitors \
  -H "Authorization: Bearer frw_live_xxx"

curl https://api.ferrow.dev/v1/monitors \
  -H "Authorization: Bearer frw_live_xxx"

Rotation

Create the new token first, update your integration, then delete the old one. The last-used time on each token shows when nothing uses it any more.