Context Bundles - Hexel Studio

Use a context bundle when you need to assemble the right context for a specific run — gathering relevant knowledge and memory into one place before an orchestration task starts. Think of it as packing a briefcase: you decide which knowledge stores and memory stores matter for this job, and the bundle gives the task a single, consistent view to query against. A context bundle is a prepared set of grounded context drawn from knowledge stores and memory, assembled for a specific run. It provides a consistent, queryable view of the information a task needs, and can be refreshed as underlying sources change.

Operations

Operation	Method	Endpoint
Create	`POST`	`/data/v1/context-bundles`
Get	`GET`	`/data/v1/context-bundles/{bundle_id}`
Query	`POST`	`/data/v1/context-bundles/{bundle_id}/query`
Refresh	`POST`	`/data/v1/context-bundles/{bundle_id}/refresh`

Create a context bundle

curl -X POST https://api.hexelstudio.com/data/v1/context-bundles \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "knowledge_store_ids": ["YOUR_STORE_ID"],
    "memory_store_ids": ["YOUR_MEMORY_STORE_ID"]
  }'

string[]

Knowledge stores to include in this bundle.

string[]

Memory stores to include in this bundle.

Response

string

Unique bundle identifier.

string[]

Included knowledge stores.

string[]

Included memory stores.

string

ISO 8601 creation timestamp.

Get a context bundle

curl https://api.hexelstudio.com/data/v1/context-bundles/YOUR_BUNDLE_ID \
  -H "Authorization: Bearer $TOKEN"

Query a context bundle

Retrieve grounded context from within the bundle using semantic search.

curl -X POST https://api.hexelstudio.com/data/v1/context-bundles/YOUR_BUNDLE_ID/query \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "refund policy",
    "top_k": 5
  }'

string

required

Semantic search query. Length: 1–10,000 characters.

integer

default:"10"

Number of results. Range: 1–100.

Query response

array

Ranked results from across the bundle’s stores, each with content, score, source_type, and source_id.

Refresh a context bundle

Updates the bundle to reflect current content in its underlying stores. Call this after ingesting new documents or writing new memory items.

curl -X POST https://api.hexelstudio.com/data/v1/context-bundles/YOUR_BUNDLE_ID/refresh \
  -H "Authorization: Bearer $TOKEN"

Errors

`code`	HTTP	When
`VALIDATION`	400	No sources specified, or an invalid query.
`AUTH.PERMISSION_DENIED`	403	Missing read permission on a referenced store.
`RESOURCE.NOT_FOUND`	404	The bundle or a referenced knowledge store doesn’t exist.

Security

Concern	Detail
Access	A bundle can only reference knowledge stores and memory stores you have `data-platform:knowledge:read` or `data-platform:memory:read` access to.
Scoping	Bundles are scoped to your organization, workspace, and environment.
Storage	Assembled context lives on platform-managed storage for the bundle’s lifetime and is deleted when the bundle is deleted.

Production recommendations

Scope each bundle tightly to the sources a run actually needs — unrelated stores dilute retrieval.
Refresh on a cadence that matches how often the underlying content changes; a bundle reflects its sources at assembly time.
Reuse one bundle across related runs for consistent, reproducible context.

Rate limits

10,000 requests per organization per hour.

When to refresh

A bundle reflects its sources at assembly time. Refresh after:

New documents are ingested into a referenced knowledge store.
A connector sync completes.
New memory items are written to a referenced memory store.

Bundle scoping guidance

Include only the stores a specific task needs. Over-broad bundles (many unrelated stores) dilute retrieval relevance. Create separate bundles for different task types.

Knowledge Stores

Sources for bundle content.

Memory

Recallable context included in bundles.

Orchestration

How bundles support task execution.

Data Platform Overview

The full data model.

Next steps

Explore Orchestration to put knowledge and memory to work in tasks.

​Operations

​Create a context bundle

​Response

​Get a context bundle

​Query a context bundle

​Query response

​Refresh a context bundle

​Errors

​Security

​Production recommendations

​Rate limits

​Related pages

Knowledge Stores

Memory

Orchestration

Data Platform Overview

​Next steps

Operations

Create a context bundle

Response

Get a context bundle

Query a context bundle

Query response

Refresh a context bundle

Errors

Security

Production recommendations

Rate limits

Related pages

Next steps