POST
Renew device credentials
POS sync device Cannot be undone For: Integrator Conditions
  • The caller must present the device’s own access token as a bearer token, and the token must match the device in the URL; otherwise the call is refused with 401.
  • The device must be active; a revoked device is refused with 401.
  • A rotation must have been requested by a manager first; otherwise the call is refused with 409.
  • The organization’s sync topic must be provisioned.
  • The route is rate limited.
What else happens
  • Issues a new broker secret, returned only in this response; the previous secret stops working.
  • Records the rotation time, clears the rotation request and removes the stored credentials replay bundle. The API token stays valid.
Part of Connect offline POS devices.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

instance
string
required

Identifier of the POS sync device (27-character KSUID).

Response

200 - application/json

PosSyncInstanceCredentialsResource

data
PosSyncInstanceCredentialsResource · object
required

Items of this page.