Retrieve a brand context by ID

Request

Retrieves a brand context's metadata and its complete nested folder or file tree index. No document content is included.

Security

HTTPBearer

Path

brandContextIdstring, (uuid)(Brandcontextid)required

The unique identifier of the brand context to retrieve. To get this ID, you can use the List brand contexts endpoint to retrieve the list of brand contexts in your organization.

Example:3f2504e0-4f89-11d3-9a0c-0305e82c3301

Headers

x-sc-job-idany(X-Sc-Job-Id)

A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.

Example:job-1234

curl -i -X GET \
  https://edge-platform.sitecorecloud.io/stream/ai-agent-api/api/v1/brand-contexts/3f2504e0-4f89-11d3-9a0c-0305e82c3301 \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'x-sc-job-id: job-1234'

Responses

Successful response

Bodyapplication/json

brandContextIdstring(Brandcontextid)

The unique identifier of the brand context.

Example:"b1234567-89ab-4cde-f012-3456789abcde"

displayNamestring(Displayname)

The display name of the brand context.

Example:"Contoso"

sourceRefstring or null(Sourceref)

Example:"https://www.contoso.com"

Any of:

The source URL the brand context was bootstrapped from.

string

runStatusstring or null(Runstatus)

Example:"completed"

Any of:

The status of the most recent bootstrap run.

string

createdDateTimestring, (date-time)(Createddatetime)

Date and time the brand context was created.

Example:"2026-07-01T10:00:00Z"

updatedDateTimestring, (date-time)(Updateddatetime)

Date and time the brand context was last updated.

Example:"2026-07-02T11:00:00Z"

childrenArray of any(Children)

The nested folder or file tree of the brand context.

Default:[]

Response

{
  "brandContextId": "b1234567-89ab-4cde-f012-3456789abcde",
  "displayName": "Contoso",
  "sourceRef": "https://www.contoso.com",
  "runStatus": "completed",
  "createdDateTime": "2026-07-01T10:00:00Z",
  "updatedDateTime": "2026-07-02T11:00:00Z",
  "children": []
}