Skip to main content
PUT
Store LabelGrid credentials

Description

secret. At least one of bearerToken/webhookSecret is required; supplying only one preserves the other. Values are encrypted at rest (pgcrypto) — there is no plaintext credential path. The response echoes only the masked LabelGridCredentialSummary — never the value that was just stored. Authorization:
  • Required role: owner only

Code Examples

Authorizations

Authorization
string
header
required

JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"

Body

application/json
bearerToken
string

Printable ASCII, no whitespace, within LabelGrid's token length bounds. Must not include a "Bearer " prefix.

webhookSecret
string

Printable ASCII, no whitespace, within the webhook secret length bounds.

Response

Success

status
string
Example:

"success"

message
string
Example:

"LabelGrid credentials saved"

data
object

The only credential-shaped object that may cross an HTTP boundary. Contains no secret material — booleans, timestamps, and a fixed-width mask.