COconductorone
Session Policy

Search Policy Users

Changed on

Searches the users a policy applies to, expanded: direct assignments plus per-user expansion of conferred groups, one page at a time. Served from the asynchronously-replicated Postgres mirror of the binding store, so a just-made assignment may not appear immediately; the user-scoped reads (GetEffectiveSessionPolicy, ListUserPolicies) reflect current state. Search, not List: the results are a filtered, server-paginated discovery over the binding store (query and source facets), not a bounded collection of a named object.

post/api/v1/session-policies/{id}/users/search

Request

  • Base URL
    https://example.conductor.one
  • URL
    https://example.conductor.one/api/v1/session-policies/{id}/users/search
  • Auth
    HTTP bearer and OAuth 2
    Client credentials
    Token URL: /auth/v1/token

Path parameters

idstring required

The session policy whose applied users to search.

Request body

pageSizeinteger

The maximum number of users to return per page. The server clamps this to its own bounds (currently 5..100). Always follow next_page_token to complete the search.

pageTokenstring

The page token from the previous response.

querystring

Fuzzy search on user display name and email. Empty matches all users the policy applies to. Applied in the query together with the source facet, so pages carry only matching rows.

source'EFFECTIVE_SESSION_POLICY_SOURCE_FILTER_UNSPECIFIED' | 'EFFECTIVE_SESSION_POLICY_SOURCE_FILTER_DIRECT' | 'EFFECTIVE_SESSION_POLICY_SOURCE_FILTER_GROUP'

When set, restrict results to this source. UNSPECIFIED returns all users.

Response

SessionPolicyServiceSearchPolicyUsersResponse carries one page of the users a policy applies to.

nextPageTokenstring

The token for the next page. Empty when this is the last page.

Changes