Set up access

Create a workspace API key and choose your authentication method.

You can authenticate with either:

  • x-api-key (recommended for server-to-server calls)
  • Authorization: Bearer … (interactive sessions and admin actions)
  1. Sign in at platform.gospace.ai and select your workspace.
  2. Open Account → Developer.
  3. Create an API key and store it in a secret manager.

Use one key per workspace and environment.

Use your key

curl -X GET "https://api.gospace.ai/v1/system/workspaces" \
  -H "x-api-key: $GOSPACE_API_KEY"

If your credential is not workspace-bound (rare), add x-workspace-key: <workspace_id>.

Service principals (optional)

If you need short-lived tokens and fine-grained scopes, use a service principal.

See Authentication for the token exchange flow.