# List brand contexts

Retrieves all brand contexts available within an organization. Returns metadata only; document content is not included.

Endpoint: GET /api/v1/brand-contexts
Version: v2.0
Security: HTTPBearer

## Security:

  - `HTTPBearer` (unknown)
    http bearer JWT

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

  - `brandContextId` (string)
    The unique identifier of the brand context.
    Example: b1234567-89ab-4cde-f012-3456789abcde

  - `displayName` (string)
    The display name of the brand context.
    Example: Contoso

  - `sourceRef` (any)
    The source URL the brand context was bootstrapped from. Null if it was not bootstrapped from a site.
    Example: https://www.contoso.com

  - `runStatus` (any)
    The status of the most recent bootstrap run. Null if the brand context has never been bootstrapped.
    Example: completed

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

  - `updatedDateTime` (string)
    Date and time the brand context 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.