AuthZEN Access Evaluations | API Reference

POST

/v1/mgmt/fga/authzen/access/v1/evaluations

Authorization

Descope Project ID and Management Key

AuthorizationBearer <token>

Project ID:Management Key as bearer token.

In: header

Request Body

application/json

subject?object

Top-level default subject/resource/action/context applied to each evaluation when omitted there.

resource?object

action?object

context?object

evaluations?array<AuthZenEvaluationItem>

options?object

Options controlling how a batch of evaluations is executed (spec §7.1.2).

Evaluate a batch of OpenID AuthZEN Access Evaluation requests, with optional default values and combining semantics (execute_all, deny_on_first_deny, permit_on_first_permit).

curl -X POST "https://api.descope.com/v1/mgmt/fga/authzen/access/v1/evaluations" \
  -H "Content-Type: application/json" \
  -d '{}'

curl -X POST "https://api.descope.com/v1/mgmt/fga/authzen/access/v1/evaluations" \  -H "Content-Type: application/json" \  -d '{}'

ResponseOK

{
  "evaluations": [
    {
      "decision": true,
      "context": {}
    }
  ]
}

{  "evaluations": [    {      "decision": true,      "context": {}    }  ]}

TypeScript

export interface Response {
/**
 * For "execute_all", one decision per request evaluation in order. For the ordered semantics
 *  ("deny_on_first_deny"/"permit_on_first_permit"), a single combined decision.
 */
evaluations?: AuthZenEvaluationResponse[]
}
export interface AuthZenEvaluationResponse {
decision?: boolean
/**
 * Optional context; carries an informational "reason" when the decision is denied
 */
context?: {

}
}

export interface Response {/** * For "execute_all", one decision per request evaluation in order. For the ordered semantics *  ("deny_on_first_deny"/"permit_on_first_permit"), a single combined decision. */evaluations?: AuthZenEvaluationResponse[]}export interface AuthZenEvaluationResponse {decision?: boolean/** * Optional context; carries an informational "reason" when the decision is denied */context?: {}}

Was this helpful?