Skip to content
Glowo
Esc
↑↓navigate↵open⌘Jpreview
On this page

API keys

Create, scope, rotate and revoke keys for scripts and integrations.

An API key lets a script, a CI job or an AI agent act on your workspace without a browser session.

Authorization: Bearer gl_...

Creating one

Keys are created in Settings → API keys, with a name, an expiry, and a set of permissions.

ExpiryWhenFreeProBusiness
1 dayA laptop, a debugging session, a credential you want gone by tomorrow✓✓✓
7 daysA one-off job or a short contract — expires without anyone remembering to revoke it✓✓✓
30 daysShort-lived automation, one-off tasks✓✓✓
90 daysA reasonable default✓✓✓
365 daysLong-lived integrations you will remember to rotate—✓✓

A dash means the plan's ceiling is shorter than that lifetime: Free caps at 90 days, Pro caps at 365 days, Business caps at 365 days. Omitting an expiry resolves to that ceiling, not to “never” — an unbounded credential is not a default anyone should get by omission.

Where a key may be used

A key also declares its surfaces — which APIs will accept it at all.

SurfaceWhat it opensGive it to
restThe REST API at api.glowo.devCI jobs, scripts, your own integrations
mcpThe Model Context Protocol transport at /mcpAn AI agent you have pasted a key into

A key minted for mcp is refused on the REST API with 403, and a rest key is refused by the agent transport. The credential is perfectly valid in both cases; it is simply not for that door, and re-presenting it will never help.

To hand a key to an AI agent, see Use an API key.

This matters more than it looks. The MCP tool list is a much smaller surface than the REST API — there is no status-page-delete tool, but there is a REST route — so a key someone reviewed as “it can only use these tools” must not also open everything behind the REST guard.

Capabilities a key can hold

CapabilityGrantsAlso carriesAssignable to a key
monitors:readRead monitors and heartbeats—✓
monitors:writeCreate, update, pause and resume monitors; run on-demand checksmonitors:read✓
monitors:deleteDelete monitorsmonitors:read✓
status_pages:readRead status pages—✓
status_pages:writeCreate, update and publish status pagesstatus_pages:read✓
status_pages:deleteDelete status pagesstatus_pages:read✓
incidents:readRead incidents—✓
incidents:writeFile, update, resolve and reopen incidentsincidents:read✓
incidents:deleteDelete incidentsincidents:read✓
postmortems:readRead postmortems—✓
postmortems:writeWrite and publish postmortemspostmortems:read✓
postmortems:deleteDelete postmortemspostmortems:read✓
notifications:readRead notification channels and delivery history—✓
notifications:writeManage notification channels and send testsnotifications:read✓
notifications:deleteDelete notification channelsnotifications:read✓
maintenance:writeSchedule maintenance windows—✓
identity:readView workspace and plan—✓
workspace:manageManage workspace settings——
billing:manageManage billing and subscription——
members:manageInvite and manage members——
audit:readRead the audit log——

The four marked unassignable are session-only by design. A leaked key must not be able to change your billing, add members, alter workspace settings, or read the audit log that would show what it did.

Give each key the least it needs. A key that only reads monitors for a dashboard should carry monitors:read and nothing else — not monitors:write, and certainly not monitors:delete.

Rotating and revoking

  • Rotate issues a new secret for the same key, keeping its name and permissions. Use it on a schedule and whenever someone with access leaves.
  • Revoke disables the key immediately while keeping the record, so the audit trail survives.
  • Delete removes it entirely.

Rotate rather than delete-and-recreate: rotation keeps the key’s identity and history intact.

Keeping keys safe

  • Never commit a key. Use your secret manager or CI variables.
  • Never put a key in client-side code. For a public status widget use a publishable embed key instead — that is what it is for.
  • One key per consumer. Separate keys for CI, your dashboard and your AI agent mean you can revoke one without breaking the others.
  • Review them periodically. Key creation, rotation and revocation are all recorded in the audit log.

Was this page helpful?