Zatomic
API Reference

Create File Context

Creating a new file context requires a name and a file, everything else is optional. The context will be created along with its first version, which becomes the context's primary version by default.

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/contexts/file

Endpoint Request

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

Endpoint Response

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

HTTP Status Codes
201 Created The context was created.
400 Bad Request The name was not provided in the request.
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.
500 Internal Server Error Something went wrong on Zatomic's end.