Skip to main content
POST
/
registers
/
{registerId}
/
credentials
/
rotate
Rotate a register credential
curl --request POST \
  --url https://api.openfiskal.com/v1/registers/{registerId}/credentials/rotate \
  --header 'Authorization: Bearer <token>'
{
  "object": "<string>",
  "register_id": "<string>",
  "register_api_key": "ofk_reg_live_...",
  "rotated_at": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization
string
header
required

Platform API key sent as Authorization: Bearer ofk_platform_.... Platform integrators also pass OpenFiskal-Organization: org_xxx to act on behalf of a merchant.

Headers

OpenFiskal-Organization
string

Merchant organization ID. Required for platform integrators acting on behalf of a specific merchant. Omit when using an organization-scoped API key directly.

Path Parameters

registerId
string
required

Response

Credential rotated. New key returned once.

object
string
Allowed value: "register_credential_rotation"
register_id
string
register_api_key
string

The new register API key. Returned once only. The previous key is already revoked. Provision this to the device immediately.

Example:

"ofk_reg_live_..."

rotated_at
string<date-time>