Create API Key
ethora-api-key-createMint a revocable API key for the signed-in user, to authorise a script, a CI job or another AI client. The key is a user token with the account's full access: send it as Authorization: Bearer <key> to the Ethora API or the hosted MCP endpoint (or set it in the stdio client). Shown once; store it somewhere safe and do not repeat it in later messages. On an OAuth connection (Claude.ai, ChatGPT) this needs the admin permission and confirm: true, the key lives 30 days by default and 90 at most, and it keeps working after the connector is disconnected until it expires or is revoked with ethora-api-key-revoke. The user can also create and revoke keys in the dashboard under Account > AI Assistants.
Requires: a signed-in user.
Auth: user mode. Errors: 401 not signed in; 403 INSUFFICIENT_SCOPE without the admin permission on an OAuth connection; 409 API_KEY_LIMIT_REACHED at 20 active keys; 422 ttlDays out of range.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Label to recognise the key later (e.g. `ci-runner`, `import-script`). Defaults to a label naming the client that created it. | |
| confirm | No | Required (`true`) on an OAuth connection: acknowledges that the key value will appear in this conversation and is not limited by this connection's permissions. | |
| ttlDays | No | Lifetime in days. Default 90 (30 on an OAuth connection, where the maximum is 90). |