Skip to main content
Already have a key? Go directly to the quickstart. Your administrator supplies the API gateway address for a private deployment.

Create a key in the console

New API key form with identity, scope binding, and permissions steps An API key is the credential your code sends on every request. In the console, open Access → API Keys and click Create API key. The form walks four steps.

1 · Identity

Name the key (e.g. Production gateway) and choose the principal it acts as: My user (uses your org role and selected team) or a Service account (a dedicated non-human identity. Service accounts are recommended for production use cases).

2 · Scope binding

Pick the organization and team the key belongs to. A key can only see resources inside that one team in that one org, so choose the team whose models, files, and agents this key should reach. Keys must be scoped to a team, and the Default team is already there. If you’re a member who belongs to no team, ask an admin to add you to one before you create a key.

3 · Permissions (scopes)

Choose which resources the key can read and write. Scopes are checked on every request. Use a preset to move fast, then adjust:
  • Standard - the everyday read/write scopes for building apps (responses, conversations, files, vector stores, prompts, agents, and more). For an admin, the preset also includes the repositories scopes.
  • Read-only - every read: scope you’re allowed to issue, and nothing else.
  • All - every scope, including admin-only ones. Available only to org owners and admins.
Some scopes are admin-only: compute, repositories, budgets, batches, and fine-grained authorization (read and write), plus write access to the model registry and guardrails. These rows appear only if you’re an owner or admin. Grant the narrowest set the key actually needs.

4 · Rate limiting (optional)

Optionally cap the key to a maximum number of requests per minute, hour, or day. The gateway enforces it and returns 429 Too Many Requests before the request reaches a model, so over-limit calls cost nothing.
Copy the secret now — it’s shown only onceWhen you click Create key, the full secret is revealed a single time. Copy it immediately and store it somewhere safe (a secrets manager or your .env). If you lose it, you can’t view it again. Regenerate the key to get a new secret. Treat it like a password: never commit it to source control or expose it in browser code. Deleting a key immediately cuts off every application that uses it.

Choose an identity

Use a service account for production applications. See End-user identity when your server acts for application users, or Short-lived tokens when a downstream client needs temporary access.

Send your API key

Pass your API key as a bearer token.
Use https://apigw.mka1.com as the base URL.
If your API key is missing, invalid, or does not have access to the requested resource, the MKA1 API returns an authentication or authorization error.