Issue a new secret; the previous one keeps working during the overlap (default 24 h)

POST

/api-credentials/{credentialId}/rotate

curl --request POST \
  --url https://acme.gravitastec.com/api/v1/api-credentials/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/rotate \
  --header 'Content-Type: application/json' \
  --cookie __Host-gravitas=<__Host-gravitas> \
  --data '{ "overlapHours": 24 }'

Authorizations

• portalSession

Parameters

Path Parameters

credentialId

required

string format: uuid

Request Body

Media typeapplication/json

object

overlapHours

integer

default: 24 <= 168

Responses

200

New secret (shown once)

Media typeapplication/json

object

clientSecret

string

Example ^generated

{
  "clientSecret": "example"
}

404

Not found or outside the credential scope

Media typeapplication/problem+json

object

type

string

title

string

status

integer

code

string

errors

Array<object>

object

path

string

message

string

Example ^generated

{
  "type": "example",
  "title": "example",
  "status": 1,
  "code": "example",
  "errors": [
    {
      "path": "example",
      "message": "example"
    }
  ]
}