Sign in
latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-216381,9552.9 MB

f2cf3228f366

App Resource

Search App Resources

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

post/api/v1/search/app_resources

Request body

agentStatusesstring[] nullable

Restrict the search to AI-agent resources with one of the given agent lifecycle statuses (READY, DISABLED, DELETED). 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. Mirrors the singular app_id; both fold into the same filter, so callers may set either or both.

appUserIdsstring[] nullable

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

credentialTypesstring[] nullable

Restrict the search to resources whose credential material spine (K1) matches one of the given CredentialType values. Applies to resources with a secret_trait. When empty, credential_type is not used as a filter.

direction'SORT_DIRECTION_UNSPECIFIED' | 'SORT_DIRECTION_ASC' | 'SORT_DIRECTION_DESC'

Direction to sort in. Unspecified falls back to ASC when sort_field is set. No defined_only validation here: protoc-gen-validate mis-resolves the cross-package enum name map to this file's c1.models.app.v1 import alias instead of c1.api.search.v1, which fails to compile. The query builder already treats any unrecognized value as ASC, so this is safe to omit.

excludeDeletedAppsboolean

When true, excludes resources belonging to soft-deleted apps.

excludeDeletedResourceBindingsboolean

If true, exclude resources whose bindings have been deleted.

excludeResourceIdsstring[] nullable

A list of resource IDs to exclude from the search results.

excludeResourceTypeTraitIdsstring[] nullable

A list of resource type trait IDs to exclude from the search.

nhiTypesstring[] nullable

Restrict the search to resources whose NHI classification spine (K3) is one of the given NhiType values. When empty, nhi_type is not used as a filter.

ownerUserIdsstring[] nullable

A list of C1 user IDs to filter resources by ownership. The sentinel value "none" matches resources with no owner. Mutually exclusive with unowned_only — combine "none" with real owner IDs instead of setting unowned_only alongside them.

pageSizeinteger

The maximum number of results to return per page.

pageTokenstring

The token for fetching the next page of results.

querystring

Fuzzy search the display name of resources.

resourceIdsstring[] nullable

A list of resource IDs to restrict the search to.

resourceTypeIdsstring[] nullable

A list of resource type IDs to restrict the search by.

resourceTypeTraitIdsstring[] nullable

A list of resource type trait IDs to restrict the search by.

sortField'APP_RESOURCE_SORT_FIELD_UNSPECIFIED' | 'APP_RESOURCE_SORT_FIELD_SECRET_CREATED_AT' | 'APP_RESOURCE_SORT_FIELD_SECRET_EXPIRES_AT' | 'APP_RESOURCE_SORT_FIELD_LAST_USED_AT'

Column to sort by. Unspecified (0) keeps the server's default order (app, then display name).

unownedOnlyboolean

When true, restrict results to resources with no ownership-v2 primary-role owner. Mutually exclusive with owner_user_ids — use owner_user_ids: ["none"] instead if you also need to combine it with real owner IDs.

withOpenFindingsboolean

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

Response

The SearchAppResourcesResponse message contains a list of results and a nextPageToken if applicable.

nextPageTokenstring

The token for fetching the next page of results.