Get a list of resources

Paginated resources, with optional integrationId, search and externalId. Without integrationId, returns resources across every integration you can read. Narrow the results with ids, requestable, workflowId, ownerId, maintainerId, type and tags; each of these except requestable has an optional <param>Operator, and tags also has tagsRelation. All filters are combined with AND. search cannot be combined with these filters unless externalId is provided. Each item includes its requestable state, workflow, owner, maintainers and tags. To read the whole list reliably, page with afterId instead of page.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
number
≥ 1
Defaults to 1
number
1 to 100
Defaults to 100
uuid

Cursor for reading the whole list without skipping or repeating items while it changes. Results are sorted by id, so pass the id of the last item of the previous page to get the items after it, and stop when a page returns fewer than perPage items. totalResults then counts only the items after afterId. Cannot be combined with a page other than 1 or with search.

Search resources by name. Exact matches are ranked first, followed by case-insensitive and partial matches.

string

Filter resources by external identifier (the source system ID, e.g. Okta Group ID).

uuid

Filter resources by integration. When omitted, returns resources across every integration you can read. To get integration IDs, use GET /public/v1/integrations.

ids
array of uuids

Filter resources by ID, up to 100 IDs. Accepts a comma-separated list or a repeated parameter. Cannot be combined with search unless externalId is provided.

ids
string
enum
Defaults to is

How ids is matched: is returns the given resources, isNot returns every resource except them. Requires ids.

Allowed:
boolean

Filter resources by whether they are requestable. Cannot be combined with search unless externalId is provided.

workflowId
array of uuids or null

Filter resources by workflow ID. Accepts a comma-separated list or a repeated parameter. Use null to match resources with no workflow of their own. Cannot be combined with search unless externalId is provided. To get workflow IDs, use GET /public/v1/workflows.

workflowId
string
enum
Defaults to is

How workflowId is matched: is returns resources with one of the given workflows, isNot returns resources with none of them (including resources with no workflow when null is not given). Requires workflowId.

Allowed:
ownerId
array of uuids or null

Filter resources by owner user ID. Accepts a comma-separated list or a repeated parameter. Use null to match resources with no owner. Cannot be combined with search unless externalId is provided. To get user IDs, use GET /public/v1/users.

ownerId
string
enum
Defaults to is

How ownerId is matched: is returns resources owned by one of the given users, isNot returns resources owned by none of them (including resources with no owner when null is not given). Requires ownerId.

Allowed:
maintainerId
array of uuids | null

Filter resources by maintainer (user or group IDs). Accepts a comma-separated list or a repeated parameter, or null to filter by whether the resource has any maintainer. Cannot be combined with search unless externalId is provided. To get user IDs, use GET /public/v1/users; for group IDs, use GET /public/v1/directoryGroups.

maintainerId
string
enum

How maintainerId is matched. With IDs: contains (default) returns resources that have at least one of the given maintainers, notContains returns resources that have none of them. With null: is (default) returns resources without maintainers, isNot returns resources with at least one maintainer. Requires maintainerId.

Allowed:
type
array of strings

Filter resources by type. Accepts a comma-separated list or a repeated parameter. Cannot be combined with search unless externalId is provided.

type
string
enum
Defaults to is

How type is matched: is (default) returns resources whose type is one of the values, isNot returns resources whose type is none of them, contains returns resources whose type contains any of the values, notContains returns resources whose type contains none of them. Requires type.

Allowed:
tags
array of strings

Filter resources by tag. Matches both system tags (tags) and custom tags (userDefinedTags). Accepts a comma-separated list or a repeated parameter. Cannot be combined with search unless externalId is provided.

tags
string
enum
Defaults to is

How tags is matched: is (default) returns resources that have the tags, isNot returns resources that do not have them, including resources with no tags. Combined with tagsRelation. Requires tags.

Allowed:
string
enum
Defaults to or

How multiple tags values are combined. With is: or (default) matches resources that have any of the tags, and matches resources that have all of them. With isNot: or (default) matches resources that have none of the tags, and matches resources that are missing at least one of them. Requires tags.

Allowed:
Response

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

©2003-2026 BeyondTrust Corporation. All Rights Reserved. Other trademarks identified on this page are owned by their respective owners. BeyondTrust is not a chartered bank or trust company, or depository institution. It is not authorized to accept deposits or trust accounts and is not licensed or regulated by any state or federal banking authority.