Skip to content
AbloAblo
Esc
↑↓navigate↵open⌘Jpreview

Rotate a capability, keeping its grant

POST/v1/capabilities/{id}/rotate
Path parameters
idstringrequired
Request body
application/json
graceSecondsinteger
max 9007199254740991
ttlSecondsinteger
max 9007199254740991
Responses
201The rotated capability
capabilityIdstringrequired
min length 1
tokenstringrequired
min length 1
expiresAtstring<date-time> | anyrequired
Show properties
Any of:
string<date-time>
string<date-time>
any
any
organizationIdstringrequired
min length 1
scopeobjectrequired
Show properties
organizationIdstringrequired
min length 1
projectIdstring | anyrequired
default: null
Show properties
Any of:
string
string
any
any
branchIdstring | anyrequired
default: null
Show properties
Any of:
string
string
any
any
branchRootbooleanrequired
default: false
syncGroupsstring[]required
operationsstring[]required
participantKindstringrequired
Allowed:useragentsystem
participantIdstringrequired
min length 1
rotatedFromobjectrequired
Show properties
capabilityIdstringrequired
min length 1
expiresAtstring<date-time>required
matches ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
400The request did not satisfy the published contract.
typestringrequired
codestring
paramstring
messagestringrequired
doc_urlstring
request_idstring
errorsobject[]
Show properties
Array of object
codestring
messagestringrequired
paramstring
401The Bearer credential is missing, malformed, or expired.
typestringrequired
codestring
paramstring
messagestringrequired
doc_urlstring
request_idstring
errorsobject[]
Show properties
Array of object
codestring
messagestringrequired
paramstring
403The credential does not authorize this operation.
typestringrequired
codestring
paramstring
messagestringrequired
doc_urlstring
request_idstring
errorsobject[]
Show properties
Array of object
codestring
messagestringrequired
paramstring
404The addressed resource does not exist in the credential scope.
typestringrequired
codestring
paramstring
messagestringrequired
doc_urlstring
request_idstring
errorsobject[]
Show properties
Array of object
codestring
messagestringrequired
paramstring
409The request conflicts with current claim, version, or idempotency state.
typestringrequired
codestring
paramstring
messagestringrequired
doc_urlstring
request_idstring
errorsobject[]
Show properties
Array of object
codestring
messagestringrequired
paramstring
429The caller exceeded an enforced rate limit.
typestringrequired
codestring
paramstring
messagestringrequired
doc_urlstring
request_idstring
errorsobject[]
Show properties
Array of object
codestring
messagestringrequired
paramstring
500The server could not complete the request.
typestringrequired
codestring
paramstring
messagestringrequired
doc_urlstring
request_idstring
errorsobject[]
Show properties
Array of object
codestring
messagestringrequired
paramstring
503A required service is temporarily unavailable.
typestringrequired
codestring
paramstring
messagestringrequired
doc_urlstring
request_idstring
errorsobject[]
Show properties
Array of object
codestring
messagestringrequired
paramstring
defaultAn HTTP error not otherwise listed; decoded through the canonical envelope.
typestringrequired
codestring
paramstring
messagestringrequired
doc_urlstring
request_idstring
errorsobject[]
Show properties
Array of object
codestring
messagestringrequired
paramstring
Request
curl -X POST "https://api.abloatai.com/api/v1/capabilities/string/rotate" \
  -H "Content-Type: application/json" \
  -d '{
  "graceSeconds": 0,
  "ttlSeconds": 0
}'
Response
{
  "capabilityId": "string",
  "token": "string",
  "expiresAt": "2024-01-01T00:00:00Z",
  "organizationId": "string",
  "scope": {
    "organizationId": "string",
    "projectId": null,
    "branchId": null,
    "branchRoot": false,
    "syncGroups": [
      "string"
    ],
    "operations": [
      "string"
    ],
    "participantKind": "user",
    "participantId": "string"
  },
  "rotatedFrom": {
    "capabilityId": "string",
    "expiresAt": "2024-01-01T00:00:00Z"
  }
}