API

API: authentication

Create API keys, authenticate requests, base URL, versioning and scopes.

Base URL

https://app.tenium.app/api/v1

All responses are JSON. Timestamps are ISO 8601 in UTC. IDs are UUIDs.

API keys

Settings → API keys → New key. Keys are shown once. Each key has a scope:

• read: list and read monitors, incidents, checks, status pages. Available on every plan.
• write: create, update and delete. Pro and Agency.
• Keys created by a client-workspace viewer are scoped to that workspace.

Authenticating

Send the key as a bearer token:

curl -H "Authorization: Bearer tn_live_3f9a..." https://app.tenium.app/api/v1/monitors

Versioning

The path contains the major version (v1). Backwards-compatible additions (new fields, new endpoints) happen without a version change. Breaking changes get a new major version with at least 6 months of overlap.

Pagination

List endpoints accept limit (default 50, max 200) and cursor. Responses include nextCursor when more results exist.

{ "data": [ ... ], "nextCursor": "eyJpZCI6..." }

Idempotency

POST requests accept an Idempotency-Key header. Repeating a request with the same key within 24 hours returns the original response.