Create an API token

Tokens authenticate automation and edge systems to Constellation OS. Create them under Settings → API.

Steps

1. Open Settings → API
2. Select scopes (minimum required for the integration)
3. Create and copy the secret immediately—it is shown once
4. Store as CONSTELLATION_API_TOKEN on the gateway or in your secrets manager

Scopes

Scope	Allows
topology:read	GET /api/v1/topology/
telemetry:write	POST /api/v1/telemetry/ingest
predictions:run	POST /api/v1/predictions/

Format

Production tokens use the cos_live_ prefix; non-production uses cos_dev_.

Authorization: Bearer cos_live_...

Example

export CONSTELLATION_API_TOKEN=cos_live_your_token_here

curl -sS -H "Authorization: Bearer $CONSTELLATION_API_TOKEN" \
  "https://api.constellation.space/api/v1/topology/"

Revoke

Delete the token in Settings → API. In-flight requests with that token fail immediately after revocation propagates.

Related

• How connection works
• API reference