Mobius

Sign inGet started
GuidesAPI Reference
Sign inGet started

Guides

Create a project-pinned API key for workers or service integrations. The flow takes under a minute.

Before you start

  • You are signed in to Mobius and have selected a project with the Create API keys permission.

Steps

  1. Open Projects → [your project] → API Keys.
    • The page lists existing keys with their name, key prefix, and last-used timestamp.
  2. Click New key.
    • The New project API key form opens.
  3. Enter a descriptive Name (e.g. dev-worker). Optionally, select a Service account to associate the key with a service account for attribution.
  4. Click Create key.
    • The page returns to API Keys and shows a Project API key created banner containing the key value.
  5. Copy the key value from the banner.
    • The key is shown once. If you close the banner without copying, revoke the key and create a new one.
  6. Store the key in your secret manager and supply it as Authorization: Bearer <key> in requests to Mobius.

You have a usable API key when the new row appears in the API Keys list with a Last used timestamp of —.

Do the same via API

curl -X POST "$MOBIUS_BASE_URL/v1/api-keys" \
  -H "Authorization: Bearer $MOBIUS_ADMIN_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "dev-worker", "project_id": "$PROJECT_ID"}'

The response includes the raw key under key. It is only returned on creation; subsequent reads omit it.

For the full request schema, see the createAPIKey operation.

Troubleshooting

  • "Failed to create key" notification appears: the name is empty or already in use within the project — supply a unique, non-empty name and retry.
  • You closed the banner without copying the key: click the trash icon (tooltip: Revoke) on the key's row to permanently revoke it, then create a new one.

See also