API Keys

Create an API key

Mint a new API key for the authenticated account and return its secret value exactly once. Store the key immediately; it cannot be retrieved again (GET /v1/api-keys returns metadata only). The body is optional: send { "name": "prod" } to label the key, or no body at all for an unnamed key. Requires an active Premium or Team subscription. Accounts whose credentials are managed by an SSO identity link cannot mint API keys.

post/api/v1/api-keys

Request

  • Base URL: https://api.getminds.ai
  • URL: https://api.getminds.ai/api/v1/api-keys
  • Auth: HTTP bearer

Request body

namestring nullable

Optional label shown in the key list and Settings UI. Whitespace is trimmed; an empty, null, or missing value stores the key unnamed (name: null).

Response

API key created. key is the raw secret and is only ever returned in this response.

idstring required

API key ID (cuid). Use it with DELETE /v1/api-keys/{keyId}.

namestring nullable required

Label as stored (trimmed), or null.

createdAtstring date-time required
keystring required

Raw secret, minds_ followed by 48 hex characters. Send it as Authorization: Bearer <key>. Shown only once.

Changes

No recorded changes to this operation across all 1 revision of this API.