Get Access Policy
Get an access policy by ID. A policy with a published version returns that version. A policy that has only a draft returns the draft. Returns 404 if the ID is unknown in your organization.
expand=owners returns the owners as ids. owners.users and owners.groups return the full users and groups. Any owners expand needs permission to list both users and groups, or the request returns 403.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The access policy's ID, which GET /v1/access-policies returns as id.
Query Parameters
Fields to expand: owners, owners.users, owners.groups.
Response
Successful Response
The full representation of an access policy returned by the V1 API.
The name of the access policy.
Explanation for why this policy exists.
500The unique ID of the access policy.
The status of the access policy.
draft, published Whether the access policy is enabled.
The apps and entitlements granted by this access policy.
The Lumos Condition object determining which identities qualify for this policy. For more information, see the Lumos Conditions documentation.
True when the policy applies to everyone in your organization. In that case, access_condition holds the condition Lumos uses to match everyone.
The users and groups that own this access policy. Returned only with expand=owners, owners.users, or owners.groups.