---
title: "Search App Resources"
method: POST
path: "/v2/app-resources/search"
tags: ["App Resource API"]
---

# Search App Resources

`POST /v2/app-resources/search`

Search app resources with filters in the request body. Filter by team ID, app instance IDs, or external IDs.

## Request body

- SvflowPublicapiSearchAppResourcesRequest
  - `teamId` string, nullable — Filter by team ID. Required if app_instance_ids is not provided.
  - `appInstanceIds` string[] — Filter by app instance IDs.
  - `externalIds` string[] — Filter by external IDs. Requires exactly one app_instance_id.
  - `resourceIds` string[] — Filter by specific resource IDs.
  - `pageSize` integer, nullable — Maximum number of results to return. Default is 10000, maximum is 10000.
  - `pageToken` string, nullable — Token for pagination. Leave empty for the first request.

## Response `200`

Success

- SvflowPublicapiSearchAppResourcesResponse
  - `data` SvflowPubapimodelsResource[] — The list of resources.
    - `id` string — The ID of the resource.
    - `appInstanceId` string — The ID of the app instance that the resource belongs to.
    - `resourceType` string — The type of the resource.
    - `name` string — The name of the resource.
    - `description` string, nullable — A description of the resource.
    - `externalId` string, nullable — The external ID of the resource.
    - `tagIds` string[] — IDs of the tags currently attached to this resource.
  - `nextPageToken` string, nullable — Token for retrieving the next page of results. Empty if no more results.

## Other responses

- `default` — Error

---

[API](https://skmtc.net/serval/apis/serval-public-api.md) · [All operations](https://skmtc.net/serval/apis/serval-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/serval/serval-public-api/versions/0549515e9384/schema)