Revalidate and renew administrator preauthorization for a Mode B Agent Grant.

POST

/api/admin/agent-grants/{id}/preauthorize

Code sample: Shell / cURL

curl --request POST \
  --url https://auth.example.com/api/admin/agent-grants/example/preauthorize \
  --header 'Authorization: Bearer <token>'

Requires a human Admin session. Rechecks the OAuth client scopes, delegator, Machine Principal tenant boundary, and every permission ceiling before atomically updating both authorization records and audit evidence for the current Grant version.

Authorizations

• adminBearer
• adminSessionCookie

Parameters

Path Parameters

id

required

string

Responses

200

Mode B preauthorization is current.

Media type application/json

object

grant_id

required

string

consent_version

required

integer

>= 1

consent_current

required

boolean

key

additional properties

Example

{
  "consent_current": true
}

400

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

401

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

403

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

404

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

409

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

503

Error response.

Media type application/json

object

error

string

message

string

error_description

string

key

additional properties

Example ^generated

{
  "error": "example",
  "message": "example",
  "error_description": "example"
}