Zatomic
API Reference

Create File Context Item Version

Creating a new file context item version requires only the file; the name is optional.

Maximum file size is 100 MB and the allowed file types are: .csv, .doc, .docx, .gif, .jpg, .jpeg, .md, .pdf, .png, .ppt, .pptx, .svg, .txt, .webp, .xls, .xlsx.

Endpoint 
POST https://api.zatomic.ai/v1/context/items/{contextItemId}/versions/file

// Example
POST https://api.zatomic.ai/v1/context/items/ctx_2qRzu8geIvfudcJTwP0pur4TbMJ/versions/file

Endpoint Request

Request Properties
file
multipart/form-data
 The file to be uploaded for the context item version.
name
string, optional
 Name of the context item version.
Request Body 
curl -X POST "https://api.zatomic.ai/v1/context/items/ctx_2qRzu8geIvfudcJTwP0pur4TbMJ/versions/file" \
   -F "name=Employee Handbook" \
   -F "file=employee-handbook.pdf" \
   -F "version_name=2026 Handbook"

Endpoint Response

A successful call returns a 201 status code with a response that contains the context item version object.

HTTP Status Codes
201 Created The context item version was created.
400 Bad Request The file was not provided in the request.
400 Bad Request The file size was greater than 100 MB.
400 Bad Request The file type was not allowed.
404 Not Found The context item didn't exist.
500 Internal Server Error Something went wrong on Zatomic's end.