Subject Filtering
Lookup Subject endpoint lets you ask questions in form of “Which subjects can do action Y on entity:X?”. As a response of this you’ll get a subject results in a format of string array.
In this endpoint you’ll get directly the IDs’ of the subjects that are authorized in an array.
Path Parameters
Identifier of the tenant, if you are not using multi-tenancy (have only one tenant) use pre-inserted tenant <code>t1</code> for this field. Required, and must match the pattern \“[a-zA-Z0-9-,]+\“, max 64 bytes.
Body
PermissionLookupSubjectRequest is the request message for the LookupSubject method in the Permission service.
PermissionLookupSubjectRequestMetadata metadata for the PermissionLookupSubjectRequest.
Entity represents an entity with a type and an identifier.
Permission to be checked, can be a permission or relation. Required, and must match the pattern "^([a-zA-Z][a-zA-Z0-9_]{1,62}[a-zA-Z0-9])$", max 64 bytes.
The RelationReference message provides a reference to a specific relation.
Context encapsulates the information related to a single operation, including the tuples involved and the associated attributes.
page_size is the number of tenants to be returned in the response. The value should be between 1 and 100.
continuous_token is an optional parameter used for pagination. It should be the value received in the previous response.
Response
PermissionLookupSubjectResponse is the response message for the LookupSubject method in the Permission service.
List of identifiers for subjects that match the lookup.
continuous_token is a string that can be used to paginate and retrieve the next set of results.