# Search for assets

Searches for digital assets such as videos, images, and documents using query terms, file types, or tags.
**Limitations**
- Asset search results are limited to a maximum of 10 items per request.
- This endpoint doesn't support pagination. Parameters such as `pageNumber`, `pageSize`, and `continuationToken` are ignored.
- The response does not include pagination metadata such as `totalCount` or `next`.

Endpoint: GET /api/v1/assets/search
Version: v2.0
Security: HTTPBearer

## Security:

  - `HTTPBearer` (unknown)
    http bearer JWT

## Query parameters:

  - `query` (any)
    The search term to filter assets.

  - `language` (any)
    The language code to filter assets.

  - `type` (any)
    The file type to filter assets such as image, video, or document.

## Header parameters:

  - `x-sc-job-id` (any)
    A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.

## Response 200:

  - `200` (unknown)
    Successful response

## Response 200 fields (application/json):

  - `itemId` (string)
    The unique identifier of the asset.
    Example: a1b2c3d4-e5f6-7890-abcd-ef1234567890

  - `path` (string)
    The path of the asset in the content tree.
    Example: /sitecore/media library/Images/Sample Image

  - `name` (string)
    The name of the asset.
    Example: Sample Image

  - `displayName` (any)
    The display name of the asset, or null if not set.
    Example: Sample Image Display Name

  - `type` (any)
    The type of asset such as image or document.
    Example: image

  - `templateId` (string)
    The unique identifier of the template used by the asset.
    Example: 9f8c7e6d-5b4a-4c3d-8e7f-1a2b3c4d5e6f

  - `templateName` (string)
    The name of the template used by the asset.
    Example: Image

  - `innerItem` (any)
    Metadata about the asset.

  - `innerItem.alt` (any)
    Alternative text for the asset, or null if not provided.
    Example: A beautiful sunset over the mountains.

  - `innerItem.width` (any)
    The width of the asset in pixels, or null if not applicable.
    Example: 1920

  - `innerItem.height` (any)
    The height of the asset in pixels, or null if not applicable.
    Example: 1080

  - `innerItem.extension` (any)
    The file extension of the asset (e.g., jpg, png), or null if not applicable.
    Example: jpg

  - `innerItem.size` (any)
    The size of the asset in bytes, or null if not applicable.
    Example: 204800

  - `innerItem.description` (any)
    A description of the asset, or null if not provided.
    Example: This is a sample image used for demonstration purposes.

## Response 422:

  - `422` (unknown)
    Unprocessable entity

## Response 422 fields (application/json):

  - `detail` (array)

  - `detail.loc` (array)
    The location of the error in the request.

  - `detail.msg` (string)
    The error message.

  - `detail.type` (string)
    The type of error.

  - `detail.input` (any)
    The input that caused the error.

  - `detail.ctx` (object)
    The context in which the error occurred.