Rotate the access token for an API key. This generates a new bearer token and optionally keeps the old token valid for a configurable grace period (up to 60 minutes), allowing a seamless rollover without downtime. The calling API key must have all the scopes of the key being rotated.
This endpoint requires a valid API key with the api_keys_manage role at either the account level or team level.
API key from your incident.io dashboard (Settings → API keys)
Unique identifier of the API key to rotate
"01FCNDV6P870EA6S7TK1DSYDG0"
How many minutes to keep the old access token alive.
0 <= x <= 6030
Created response.
{
"created_at": "2021-08-17T13:28:57.801578Z",
"creator": {
"api_key": {
"id": "01FCNDV6P870EA6S7TK1DSYDG0",
"name": "My test API key"
},
"user": {
"email": "lisa@incident.io",
"id": "01FCNDV6P870EA6S7TK1DSYDG0",
"name": "Lisa Karlin Curtis",
"role": "viewer",
"slack_user_id": "U02AYNF2XJM"
}
},
"id": "01FCNDV6P870EA6S7TK1DSYDG0",
"name": "My test API key",
"roles": [
{
"description": "Can create incidents",
"name": "viewer"
}
],
"team_ids": ["01FCNDV6P870EA6S7TK1DSYDG0"],
"team_roles": [
{
"description": "Can read schedules",
"name": "schedules_editor"
}
],
"token_last_issued_at": "2021-08-17T13:28:57.801578Z"
}
The new bearer token to use in API requests. This is the only time the token is returned — store it securely.
"inc_0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef"