keys

Create key

Create a new API key for the specified org.

Send an Idempotency-Key header to make a retry safe: a resend with the same key returns the ORIGINAL key (including its one-time secret) instead of minting a second key.

Errors: 401 authentication_required: The login token is missing, invalid, or expired. 403 permission_denied: You are not a member of this org. 422 IDEMPOTENCY_KEY_CONFLICT: The Idempotency-Key was reused with a different body.

post/api/keys

Request

  • Base URL: https://api.mymarky.ai
  • URL: https://api.mymarky.ai/api/keys
  • Auth: HTTP bearer

Headers

Idempotency-Keystring nullable

Optional. Send a unique value (e.g. a UUID) to make this create request safe to retry. A repeat with the same key returns the original response instead of creating a duplicate. Cached for 24h, scoped to your org. Reusing a key with a different body returns 422.

Marky-Version'2026-04-08' | '2026-07-17' | '2026-08-02' | '2026-08-04' | '2026-08-06'
Example:2026-08-06

Opt into a dated API version. Omit to stay on the floor (2026-04-08) forever — unpinned clients never break. Pin to a newer date (e.g. 2026-08-06) to receive the newest response shapes. Unknown values fall back to the floor. See https://docs.mymarky.ai for the versioning model.

Request body

namestring required

A label for this API key (e.g. 'n8n production')

org_idstring required

Organization ID to create the key for

Response

Successful Response

idstring required

API key ID

keystring required

Full API key (shown only once)

namestring required
key_prefixstring required

Key prefix for identification

created_atstring required

Changes

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