For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
PlaygroundDiscordStatusDashboardSign Up >
DocumentationSDK ReferenceGraphiti
DocumentationSDK ReferenceGraphiti
  • SDK Reference
      • POSTCreate Batch
      • POSTAdd Batch Items
      • POSTProcess Batch
      • GETList Batches
      • GETGet Batch
      • DELDelete Batch
      • GETList Batch Items
LogoLogo
PlaygroundDiscordStatusDashboardSign Up >
SDK ReferenceBatch

Add Batch Items

POST
https://api.getzep.com/api/v2/batches/:batchId/items
POST
/api/v2/batches/:batchId/items
1from zep_cloud import BatchAddItem, Zep
2
3client = Zep(
4    api_key="YOUR_API_KEY",
5)
6client.batch.add(
7    batch_id="batchId",
8    items=[
9        BatchAddItem(
10            type="graph_episode",
11        )
12    ],
13)
1[
2  {
3    "created_at": "string",
4    "episode_uuid": "string",
5    "error": {},
6    "graph_id": "string",
7    "item_id": "string",
8    "kind": "graph_episode",
9    "sequence_index": 1,
10    "source_uuid": "string",
11    "status": "pending",
12    "thread_id": "string",
13    "updated_at": "string",
14    "user_id": "string"
15  }
16]
Add graph episodes and thread messages to a draft batch. Items are appended in request order.
Was this page helpful?
Previous

Process Batch

Next
Built with

Path parameters

batchIdstringRequired
The batch ID.

Request

Batch items to add
itemslist of objectsRequired

Response

Added batch items
created_atstring
episode_uuidstring

EpisodeUUID is the UUID of the episode that will be (or has been) created for this batch item. Populated for every item kind and always equal to SourceUUID — the underlying source row’s UUID is reused as the episode UUID during processing.

errormap from strings to any
graph_idstring
item_idstring
kindenum
Allowed values:
sequence_indexinteger
source_uuidstring
statusenum
thread_idstring
updated_atstring
user_idstring

Errors

400
Bad Request Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
500
Internal Server Error