POST /api/keys/default

api

api_keys

Get or Create a Default API Key

post/api/keys/default

Request

sellerIdstring required

The seller ID to get or create the API key for.

_idstring required

The ID of the API key.

activeboolean

Whether the API key can be used to authenticate against the API.

namestring required

An internal name to identify the API key.

sellerIdstring

The ID of the seller that owns the API key.

orgIdstring

The ID of the organisation that owns the API key.

keystring required

The secret key to be used to authenticate against the API.

createdAtstring date-time required

An ISO Timestamp indicating when the API Key was created.

updatedAtstring date-time required

An ISO Timestamp indicating when the API Key was last updated.

expiresAtstring date-time nullable

Optional ISO instant after which the key no longer authenticates; omit or null for no automatic expiry.

versioninteger

The version of the API key.

fullSellerAccessboolean

Seller keys only: when true, grants full seller access (seller-admin equivalent).

permissionsstring[]

Explicit permissions

{
  "key": "key_somerandomcombinationofnumbersandletters"
}