A 2 UI5

Access Conflict4

Access Review12

Access Review Template4

Access Review Templates5

AI Governance Settings6

App7

App Entitlement17

App Entitlement Automation4

App Entitlement Automation Exclusion3

App Entitlement Configuration Rule6

App Entitlement Monitor Binding3

App Entitlement Owner6

App Entitlement Owner V29

App Entitlement Proxy Binding3

App Entitlement User Binding3

App Entitlement User Binding Feed1

App Entitlement User Binding History1

App Owner6

App Owner V29

App Reports2

App Resource7

App Resource Owner6

App Resource Owner V29

App Resource Type5

App Secrets1

App Secrets Admin1

App Usage Controls2

App User Owner V27

AppAccessRequestDefaults3

Application Managed State3

AppUsers6

Artifact6

Attribute6

Auth1

Auth Config5

AuthZEN Policies5

AuthZEN Servers5

Automations15

AWS External ID Settings1

Classifier Templates4

Classifiers8

Compliance Framework4

Connector17

Connector Authoring Activation2

Connector Catalog1

Connector Owner V29

Contacts2

Conversations1

Credential Inventory6

Cross-App Access36

Decoy7

Directory5

Edge33

External Client1

External OAuth Client4

Feedback1

Finding Routing Rules5

Finding Settings4

Finding Transformation Rules5

Findings10

Function8

Function Commit5

Function Invocation4

Function Tag2

Fund App Caps7

Fund Assignments9

Fund Policy8

Fund Rules7

Hook6

Identity Policy Defaults2

LLM Gateway Keys3

LLM Gateway Provider Credentials3

Local Directory9

MCP Resources5

MCP Servers13

MCP Tools6

MCP Toolsets15

Model API Key4

My Fund Limits8

Onboarding Settings2

Org Domain2

Org Notification Settings2

Personal Client7

Personal Device6

Policy8

Recovery Policy6

Report8

Request Catalog26

Request Schema4

Request Schema Entitlement Binding3

Request Settings2

Risk Level4

Role3

Role Mining19

Secrets10

Secrets Admin4

Service Principal10

Service Principal Binding3

Session Policy15

Session Settings3

Short Links8

Sign-In Policy6

Spend Insights9

SSF Receiver9

SSO18

Step Up Authentication Providers8

Step Up Authentication Transactions2

Subject App Limits7

System Log1

System Log Exporter7

Task24

Tenant Email Provider5

Terraform Export1

Tool Gates6

Tunnel9

User6

User Developer Preferences2

User Notification Settings2

User Owner V27

UserAttributeMappings6

Vault4

Virtual MCP Servers12

Webhook7

Workload Federation13

AppUsers

Search

Changed on Aug 21, 2026

Search app users based on filters specified in the request body.

post/api/v1/search/app_users

Request

Base URL
https://example.conductor.one
URL
https://example.conductor.one/api/v1/search/app_users
Auth
HTTP bearer and OAuth 2
Client credentials
Token URL: /auth/v1/token

Request body

agentStatusesstring[] nullable

Restrict to app users whose agent trait lifecycle status (agent_status) matches one of these values. When empty, agent_status is not used as a filter.

appIdstring

The app ID to restrict the search to.

appIdsstring[] nullable

A list of app IDs to restrict the search to.

appUserDomainsstring[] nullable

A list of account domains to restrict the search to.

appUserIdsstring[] nullable

A list of app user IDs to restrict the search to.

appUserStatusDetailsstring[] nullable

A list of app user status details to restrict the search to.

appUserStatusesstring[] nullable

A list of app user statuses to restrict the search to.

appUserTypesstring[] nullable

A list of app user types to restrict the search to.

excludeAppUserIdsstring[] nullable

A list of app user IDs to remove from the results.

excludeDeletedAppsboolean

When true, excludes app users belonging to soft-deleted apps.

nhiTypesstring[] nullable

Restrict to app users whose NHI trait classification (nhi_type) matches one of these values. When empty, nhi_type is not used as a filter.

pageSizeinteger

The pageSize where 0 <= pageSize <= 100. Values < 10 will be set to 10. A value of 0 returns the default page size (currently 25)

pageTokenstring

The pageToken field.

querystring

Query the apps with a fuzzy search on display name and description.

sortBy'APP_USER_SEARCH_SORT_BY_UNSPECIFIED' | 'APP_USER_SEARCH_SORT_BY_APP'

Ordering of the results. Defaults to display-name ordering.

userIdsstring[] nullable

A list of user IDs to restrict the search by.

withOpenFindingsboolean

When true, restrict results to app users that have at least one open finding (index-backed EXISTS semi-join). When false/unset, results are unfiltered.

withoutResponsiblePartyboolean

When true, restrict results to app users with no responsible party (identity_user_id empty) — i.e. unowned, for any app-user type.

Response

Successful response

nextPageTokenstring

The nextPageToken is shown for the next page if the number of results is larger than the max page size. The server returns one page of results and the nextPageToken until all results are retrieved. To retrieve the next page, use the same request and append a pageToken field with the value of nextPageToken shown on the previous page.

Changes

Aug 21, 2026f2cf3228f366 Revision changes
- breaking
  the request property became not nullable
- breaking
  the request property became not nullable
- breaking
  the request property became not nullable
- breaking
  the request property became not nullable
- breaking
  the request property became not nullable
- breaking
  the request property became not nullable
- breaking
  the request property became not nullable
- breaking
  the request property became not nullable
- breaking
  the request property type changed from object to no type
- breaking
  added subschema #2 to the // response property oneOf list for the response status
- breaking
  the // response's property type changed from object to no type for status
- warning
  removed the request property /
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- warning
  removed the optional property /// from the response with the status
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added subschema #2 to the request property oneOf list
May 7, 2025112d28188277 Revision changes
- warning
  removed the request property
- info
  added the new optional request property

Operation history (3 revisions)

Search

Request

Request body

Response 200OK

Changes

Response