API Keys

Mint an API key

Dashboard session only. The plaintext key is returned once in this response and never again — store it securely. Optional profileId pins the key to a single profile; cross-profile reads/writes 404 under that key.

post/v1/api-keys

Request

  • Base URL: https://api.letmepost.dev
  • URL: https://api.letmepost.dev/v1/api-keys
  • Auth: none required

Headers

Idempotency-Keystring
Example:post-launch-2026-05-15-001

Recommended on every write. Replays within 24 hours return the original response; conflicting bodies surface as 409 idempotency_conflict. See Idempotency.

Request body

namestring required
prefix'lmp_live_' | 'lmp_test_'
scopesstring[]
profileIdstring uuid nullable

Optional profile scope. When set, the key only authenticates requests targeting that profile; cross-profile reads/writes 404.

Example request

{
  "name": "ci-publish-key"
}

Response

Key minted — plaintext shown once.

idstring required
namestring required
prefixstring required
last4string required
scopesstring[] required
profileIdstring nullable
keystring required

Plaintext key — returned once at creation and never again. Store it securely.

createdAtstring date-time required

Example response

{
  "key": "lmp_live_AbC123…"
}

Changes

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