API Keys

API keys provide programmatic access to the Hub API.

Create a key

curl -X POST https://hub.meshsat.net/api/auth/keys \
  -H "Authorization: Bearer <owner-token>" \
  -H "Content-Type: application/json" \
  -d '{"label": "CI pipeline", "role": "admin"}'

Response includes the key once — store it securely:

{
  "id": "abc123",
  "label": "CI pipeline",
  "key": "meshsat_live_abc123...",
  "role": "admin",
  "created_at": "2026-03-23T00:00:00Z"
}

Use a key

curl https://hub.meshsat.net/api/devices \
  -H "Authorization: Bearer meshsat_live_abc123..."

List and delete

# List all keys (owner only)
curl https://hub.meshsat.net/api/auth/keys \
  -H "Authorization: Bearer <owner-token>"

# Delete a key
curl -X DELETE https://hub.meshsat.net/api/auth/keys/abc123 \
  -H "Authorization: Bearer <owner-token>"