Auth Grants

Add AuthGrant to your profile

post

Add AuthGrant to your profile

Authorizations

Authorization

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

namestringOptional

descriptionstringOptional

scopestringOptional

expiresAtany ofOptional

string · date-timeOptionalPattern: ^(?:(?:\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))$

or

nullOptional

Responses

200

Successful response

application/json

stringOptional

400

Invalid input data

application/json

401

Authorization not provided

application/json

403

Insufficient access

application/json

500

Internal server error

application/json

post

/auth-grant/create

HTTPcURLJavaScriptPython

POST /api/auth-grant/create HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 90

{
  "name": "text",
  "description": "text",
  "scope": "text",
  "expiresAt": "2026-03-06T17:59:47.378Z"
}

text

Get AuthGrant

get

Get AuthGrant

Authorizations

Authorization

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

Responses

200

Successful response

application/json

idstringOptional

namestringOptional

descriptionstringOptional

challengestring · min: 10 · max: 100OptionalPattern: ^auth-grant:.*

statusstring · enumOptionalPossible values:

scopestringOptional

createdAtstring · date-timeOptionalPattern: ^(?:(?:\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))$

expiresAtany ofOptional

string · date-timeOptionalPattern: ^(?:(?:\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))$

or

nullOptional

400

Invalid input data

application/json

401

Authorization not provided

application/json

403

Insufficient access

application/json

404

Not found

application/json

500

Internal server error

application/json

get

/auth-grant/{id}

HTTPcURLJavaScriptPython

GET /api/auth-grant/{id} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "text",
  "name": "text",
  "description": "text",
  "challenge": "text",
  "status": "revoked",
  "scope": "text",
  "createdAt": "2026-03-06T17:59:47.378Z",
  "expiresAt": "2026-03-06T17:59:47.378Z"
}

Delete AuthGrant

delete

Delete AuthGrant

Authorizations

Authorization

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

Responses

200

Successful response

application/json

booleanOptional

400

Invalid input data

application/json

401

Authorization not provided

application/json

403

Insufficient access

application/json

404

Not found

application/json

500

Internal server error

application/json

delete

/auth-grant/{id}

HTTPcURLJavaScriptPython

DELETE /api/auth-grant/{id} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

true

Get My AuthGrants

post

Get My AuthGrants

Authorizations

Authorization

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

limitnumberOptional

cursorstringOptional

Responses

200

Successful response

application/json

idstringRequired

namestringRequired

descriptionstringOptional

challengestring · min: 10 · max: 100RequiredPattern: ^auth-grant:.*

statusstring · enumRequiredPossible values:

scopestringRequired

createdAtstring · date-timeRequiredPattern: ^(?:(?:\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))$

expiresAtany ofOptional

string · date-timeOptionalPattern: ^(?:(?:\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))$

or

nullOptional

400

Invalid input data

application/json

401

Authorization not provided

application/json

403

Insufficient access

application/json

500

Internal server error

application/json

post

/profile/auth-grants

HTTPcURLJavaScriptPython

POST /api/profile/auth-grants HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 102

{
  "limit": 1,
  "cursor": "text",
  "query": {
    "id": "text",
    "name": "text",
    "description": "text",
    "status": "active"
  }
}

[
  {
    "id": "text",
    "name": "text",
    "description": "text",
    "challenge": "text",
    "status": "revoked",
    "scope": "text",
    "createdAt": "2026-03-06T17:59:47.378Z",
    "expiresAt": "2026-03-06T17:59:47.378Z"
  }
]

Update AuthGrant

post

Update AuthGrant

Authorizations

Authorization

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

Body

application/json

Responses

200

Successful response

application/json

booleanOptional

400

Invalid input data

application/json

401

Authorization not provided

application/json

403

Insufficient access

application/json

500

Internal server error

application/json

post

/auth-grant/update/{id}

HTTPcURLJavaScriptPython

POST /api/auth-grant/update/{id} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 48

{
  "updates": {
    "name": "text",
    "description": "text"
  }
}

true

Revoke AuthGrant

post

Revoke AuthGrant

Authorizations

Authorization

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

idstringRequired

Responses

200

Successful response

application/json

booleanOptional

400

Invalid input data

application/json

401

Authorization not provided

application/json

403

Insufficient access

application/json

500

Internal server error

application/json

post

/auth-grant/{id}/revoke

HTTPcURLJavaScriptPython

POST /api/auth-grant/{id}/revoke HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

true