Rotate an API client's keys

POST

/auth/clients/{id}/rotate

const url = 'https://apisandbox.puurk.com/auth/clients/example/rotate';
const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://apisandbox.puurk.com/auth/clients/example/rotate \
  --header 'Authorization: Bearer <token>'

Deprecates all of the client’s active keys with a 7-day grace period and issues one new key. The api_key in the response is shown once and never retrievable again.

Authorizations

service_token

Parameters

Path Parameters

required

string

ID of the API client

Responses

200

New API key issued

401

Unauthorized

404

API client not found

409

API client is deactivated