Skip to main content
GET
cURL

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

app_id
string<uuid>
required

The ID of the app (connection ID or IDP resource-app ID).

user_id
string<uuid>
required

The ID of the user the access would be for.

Query Parameters

requester_id
string<uuid>

Optional ID of the person filling in the form when different from user_id. Adds the on-behalf check evaluated as that requester, following EnforceRequestOnBehalfOfUser.

Response

Whether the user can request anything in this app, and why.

Whether an asset is requestable for a user, and why.

user_id
string<uuid>
required

The ID of the user that was checked.

requestable
boolean
required
reason
enum<string>
required

Why an asset is or is not requestable for a user. Reasons are evaluated in order; the first that applies is returned. REQUESTABLE means at least one access level can be requested.

Available options:
ASSET_DELETED,
REQUESTER_CANNOT_REQUEST_FOR_USER,
UNSUPPORTED_ASSET_TYPE,
LINKED_GROUP_NOT_REQUESTABLE,
CONDITION_SCRIPT_FAILED,
REQUESTS_DISABLED,
NO_REQUESTABLE_ACCESS_LEVEL,
NO_REQUESTABLE_ITEMS,
REQUESTABLE
Example:

"REQUESTABLE"

resource_id
string<uuid>

The ID of the resource that was checked. Set for resource checks.

group_id
string<uuid>

The ID of the group that was checked. Set for group checks.

app_id
string<uuid>

The ID of the app that was checked. Set for app checks.

access_levels
object[]

Per-access-level requestability. Omitted for apps; empty remote ID for assets without levels.