discovery

Create an API key for the active organization (session only, owner/admin)

Requires a signed-in dashboard session, not another API key — an agent cannot mint its own first key this way. Owner or admin (job L). The full key is only ever returned once, in this response; store it immediately.

post/v1/api-keys

Request

  • Base URL: https://postbag.dev
  • URL: https://postbag.dev/v1/api-keys
  • Auth: HTTP bearer

Request body

namestring

A label to tell keys apart, e.g. 'CI deploy key'. Maximum 32 characters.

scopesstring[]

manage ⊇ read ⊇ submit — a manage key satisfies every read- or submit-scoped call too.

Response

created

idstring required
namestring nullable required
prefixstring nullable required
scopesstring[] required
keystring required
created_atstring required

Changes

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