POST https://api.zatomic.ai/v1/context/sources/file
API Reference
- Overview
- Versioning
- Authentication
- Workspaces
- Status Codes and Errors
- Credit Usage
- Expanding Objects
- OpenAPI Spec
- Context Sources
- The Context Source Object
- Create File Context Source
- Create Text Context Source
- Update Context Source
- Delete Context Source
- Retrieve Context Source
- Retrieve All Context Sources
- Context Source Versions
- The Context Source Version Object
- Create File Context Source Version
- Create Text Context Source Version
- Update File Context Source Version
- Update Text Context Source Version
- Delete Context Source Version
- Retrieve Context Source Version
- Retrieve All Context Source Versions
- Context Packs
- The Context Pack Object
- Create Context Pack
- Update Context Pack
- Delete Context Pack
- Retrieve Context Pack
- Retrieve All Context Packs
- Context Pack Versions
- The Context Pack Version Object
- Create Context Pack Version
- Update Context Pack Version
- Delete Context Pack Version
- Retrieve Context Pack Version
- Retrieve All Context Pack Versions
- Projects
- The Project Object
- Create Project
- Update Project
- Delete Project
- Retrieve Project
- Retrieve All Projects
- Prompts
- The Prompt Object
- Create Prompt
- Update Prompt
- Delete Prompt
- Retrieve Prompt
- Retrieve All Prompts
- Generate Prompt
- Prompt Versions
- The Prompt Version Object
- Create Prompt Version
- Update Prompt Version
- Delete Prompt Version
- Retrieve Prompt Version
- Retrieve All Prompt Versions
- Calculate Prompt Version Score
- Retrieve Prompt Version Score
- Generate Prompt Version Heatmap
- Retrieve Prompt Version Heatmap
- Analyze Prompt Version Balance
- Retrieve Prompt Version Balance
- Analyze Prompt Version Risk
- Retrieve Prompt Version Risk
- Improve Prompt Version
- Scoring Criteria
- The Scoring Criteria Object
- The Scoring Criterion Object
- Create Scoring Criteria
- Update Scoring Criteria
- Delete Scoring Criteria
- Retrieve Scoring Criteria
- Retrieve All Scoring Criteria
- Generate Scoring Criteria
- Create Scoring Criterion
- Update Scoring Criterion
- Delete Scoring Criterion
- Retrieve Scoring Criterion
- Scoring Criteria Results
- The Scoring Criteria Results Object
- Scoring
- The Scoring Object
- Calculate Prompt Score
- Heatmaps
- The Heatmap Object
- Generate Prompt Heatmap
- Balance
- The Balance Object
- Analyze Prompt Balance
- Risk
- The Risk Object
- Analyze Prompt Risk
Create File Context Source
Creating a new file context source requires a name and a file, everything else is optional. The context source will be created along with its first version, which becomes the context source's primary version by default.
Maximum file size is 50 MB.
Endpoint
Endpoint Request
| Request Properties | |
|---|---|
|
name
string
|
Name of the context source. |
|
file
multipart/form-data
|
The file to be uploaded for the context source. |
|
description
string, optional
|
Description for the context source. |
|
version_name
string, optional
|
Name for the context source version. |
Request Body
curl -X POST "https://api.zatomic.ai/v1/context/sources/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 source object.
| HTTP Status Codes | ||
|---|---|---|
| 201 | Created | The context source 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. |
| 403 | Forbidden | Credit limit has been reached. |
| 500 | Internal Server Error | Something went wrong on Zatomic's end. |