Issue an API credential

Issues an API credential bound to one project and environment, with scopes capped by the issuing member's current role. The full secret is in this response and in no other, is not recoverable afterwards, and there is deliberately no reveal endpoint. The value is the sixteen-character display prefix followed immediately by thirty-two more characters; the example below is a visible placeholder rather than that shape, because a realistic credential in a committed file is one the repository's own secret scanner refuses.

post/v1/credentials

Request

  • Base URL: https://docs.greatwait.dev (the document declares no server; this is the origin it was published from)
  • URL: https://docs.greatwait.dev/v1/credentials
  • Auth: HTTP bearer

Request body

environmentKind'test' | 'live' required
projectstring required
scopesstring[] required

Response

Issue an API credential

createdAtstring required
displayPrefixstring required
environmentKind'test' | 'live' required
expiresAtstring
idstring required
issuedBystring
lastUsedAtstring
projectstring required
revokedAtstring
supersededBystring
scopesstring[] required
secretstring required
shownOncetrue required

Changes

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