# Batch retrieve brand context items

Retrieves specific files or folders from a brand context in a single batched call. File responses include Markdown content. Between 1 and 50 unique IDs per call. A single failed item is returned with `fetchStatus` is `failed` and the upstream error message in `fetchStatusMessage` rather than failing the whole batch. The response carries requested, succeeded, or failed completeness counts alongside the data array.

Endpoint: GET /api/v1/brand-contexts/{brandContextId}/items
Version: v2.0
Security: HTTPBearer

## Security:

  - `HTTPBearer` (unknown)
    http bearer JWT

## Path parameters:

  - `brandContextId` (string, required)
    The unique identifier of the brand context from which to retrieve items. To get this ID, you can use the [List brand contexts](#operation/brand-contexts-list_brand_contexts) endpoint to retrieve the list of brand contexts in your organization.

## Query parameters:

  - `ids` (string, required)
    Comma-separated brand context item IDs (UUIDs) of files or folders to fetch, up to 50. To get these IDs, you can use the [Retrieve a brand context by ID](#operation/brand-contexts-get_brand_context) endpoint to retrieve the complete nested folder or file tree index of the brand context.

## 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):

  - `requested` (integer)
    The number of IDs requested.
    Example: 3

  - `succeeded` (integer)
    The number of IDs whose fetch succeeded.
    Example: 2

  - `failed` (integer)
    The number of IDs whose fetch failed.
    Example: 1

  - `data` (array)
    One entry per requested ID, in the order requested. Each entry contains the fetched data for that ID, or an error if the fetch failed.

  - `data.brandContextItemId` (string)
    The unique identifier of the brand context item, which can be a folder or a file.
    Example: 3f2504e0-4f89-11d3-9a0c-0305e82c3301

  - `data.displayName` (any)
    The display name of the folder or file.
    Example: Audience Strategy

  - `data.type` (any)
    The type of the brand context item. One of 'folder' or 'file'.
    Example: file

  - `data.content` (any)
    The Markdown content of the brand context file. Null for folders, or when `fetchStatus` is `failed`.
    Example: # Audience Strategy

...

  - `data.contentLength` (any)
    The character count of the brand context file's content. Only present when content was fetched.
    Example: 3480

  - `data.fetchStatus` (string)
    The status of the fetch operation, indicating whether it succeeded or failed.
    Enum: "succeeded", "failed"

  - `data.fetchStatusMessage` (any)
    The upstream error message for a failed fetch. Null when `fetchStatus` is `succeeded`.
    Example: Not found

  - `data.createdDateTime` (any)
    Date and time the brand context item was created.
    Example: 2026-07-01T10:00:00Z

  - `data.updatedDateTime` (any)
    Date and time the brand context item was last updated.
    Example: 2026-07-02T11:00:00Z

## 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.