The Sequentum Cloud API supports two authentication schemes. API keys are what most server-to-server integrations should use. OAuth bearer tokens are used by the Control Center web UI and by partners building user-facing integrations.
API key (recommended)
Send your key in the Authorization header, prefixed with ApiKey:
import os
import requests
response = requests.get(
"https://dashboard.sequentum.com/api/v1/agent/all",
headers={"Authorization": f"ApiKey {os.environ['SEQUENTUM_API_KEY']}"},
)
Generating a key
API keys are issued per user and can only be created by a workspace administrator.
- As an admin, open the Users page in Control Center.
- Find the user the key belongs to and click Manage API keys.
- Click New API key.
- Set an expiration (default: 1 year — adjust to match your security policy) and an optional description.
- Copy the key immediately. Sequentum stores only a hash; if the key is lost, the only path forward is to delete the entry and generate a new one.
API keys are full-access on behalf of the user they were issued to. Treat them like passwords: never commit them, never put them in client-side code, rotate when staff leave.
Storing keys
Use environment variables, not source files:
import os
key = os.environ["SEQUENTUM_API_KEY"]
Revocation
An admin revokes a key from the same Users → Manage API keys screen. Revocation is immediate; in-flight requests using the key will continue to completion.
Scopes
All keys are currently full-access for the user they were issued to. Scoped keys (read-only, runs-only, billing-only) are on the roadmap.
OAuth bearer token
For user-context flows (the Control Center web UI, OAuth-integrated partner apps), exchange an OAuth credential for a JWT and send it as a Bearer token:
import os
import requests
response = requests.get(
"https://dashboard.sequentum.com/api/v1/agent/all",
headers={"Authorization": f"Bearer {os.environ['JWT']}"},
)
The JWT carries the user’s identity and Space membership. Bearer tokens are short-lived; refresh per the standard OAuth 2.0 flow when they expire.
If you’re building a server-side integration, prefer the API key path above — it’s simpler, doesn’t require a token-refresh loop, and produces clearer audit trails.