Create Batch | Zep Documentation

Create a draft batch that can be filled with graph episodes and thread messages.

Request

Create batch request

ignore_roleslist of enumsOptional

Optional list of message role types to skip during graph ingestion for thread_message items in this batch. The messages are still stored and retained as context, but no graph extraction is performed for them. Has no effect on graph_episode items.

metadatamap from strings to anyOptional

Response

Created batch

batch_idstring

completed_atstring

created_atstring

ignore_roleslist of enums

item_countinteger

metadatamap from strings to any

processed_atstring

progressobject

statusenum

updated_atstring

Errors

400

Bad Request Error

403

Forbidden Error

500

Internal Server Error

1	from zep_cloud import Zep
2
3	client = Zep(
4	api_key="YOUR_API_KEY",
5	)
6	client.batch.create()

1	{
2	"batch_id": "string",
3	"completed_at": "string",
4	"created_at": "string",
5	"ignore_roles": [
6	"norole"
7	],
8	"item_count": 1,
9	"metadata": {},
10	"processed_at": "string",
11	"progress": {
12	"canceled_items": 1,
13	"failed_items": 1,
14	"percent_complete": 1.1,
15	"processing_items": 1,
16	"queued_items": 1,
17	"skipped_items": 1,
18	"succeeded_items": 1,
19	"total_items": 1
20	},
21	"status": "draft",
22	"updated_at": "string"
23	}