Skip to main content
POST
Rotate
🔑 Requires the api_keys.rotate scope.

Authorizations

Authorization
string
header
required

API key from your incident.io dashboard (Settings → API keys)

Path Parameters

id
string
required

Unique identifier of the API key to rotate

Example:

"01FCNDV6P870EA6S7TK1DSYDG0"

Body

application/json
grace_period_minutes
integer<int64>
default:30
required

How many minutes to keep the old access token alive.

Required range: 0 <= x <= 60
Example:

30

Response

201 - application/json

Created response.

api_key
object
required
token
string
required

The new bearer token to use in API requests. This is the only time the token is returned — store it securely.

Example:

"inc_0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef"