Ejento APIs
V2
  • V2
  • V1
  1. Corpus
Ejento APIs
V2
  • V2
  • V1
  • Overview
  • Changelog
  • Versioning
  • Legacy
    • Introduction to Legacy APIs
    • Agent
      • Create Agent By Agent Builder
      • Create Agent By Configure
      • Get All Agents
      • Get Agent By Team
      • Get Agent By User Team
      • Agent Filtered
      • Get Agent
      • Edit Agent
      • Get Recent Agents
      • Create Recent Agent
      • Delete Recent Agent
      • Get Starred Agents
      • Create Starred Agent
      • Delete Starred Agent
    • Agent Corpus Connection
      • Create Agent Corpus Connection
      • Get Agent Corpus Connection
      • Edit Agent Corpus Connection
      • Delete Agent Corpus Connection
      • Get All Agent Corpus Connections
      • Delete All Agent Corpus Connections
    • Agent Response
      • Create Agent Response
      • Get All Agent Responses
      • Get Agent Responses By User
      • Get Agent Responses By Project
      • Get Agent Responses By Chat Thread
      • Get Agent Response
      • Delete Agent Response
      • Create Agent Response Comment
      • Get Agent Response Comment
      • Get Agent Response Dashboard
      • Create Agent Response Feedback
      • Create Agent Response Log
      • Pin Agent Response
      • Unpin Agent Response
      • Get Pinned Agent Responses
    • Agent Reviews
      • Create Review
      • Get All Reviews
      • Get Reviews by Agent
      • Delete Review
    • Agent Rating
      • Get All Agent Ratings
      • Get Agent Rating
      • Update Agent Rating
    • Agent Alias
      • Get All Agent Aliases
      • Create Agent Alias
      • Update Agent Alias
      • Delete Agent Alias
    • Agent Access
      • Get Agent Access
      • Update Agent Access
    • Agent Type
      • Get All Agent Types
      • Get Agent Type
      • Update Agent Type
    • Agent User
      • Add Users to Agent
      • Get Users Of Agent
      • Delete User from Agent
      • Get User Agent Permission
      • Get All Agents with Users
    • Agent Tags
      • Get All Distinct Agent Tags
      • Annotate an Agent with Tags
    • Agent Vote
      • Create Agent Vote
      • Get Agent Vote
    • Agent Comment
      • Create Comment on an Agent
      • Get Comments for an Agent
      • Edit Agent Comment
    • Chat Thread
      • Create Chat Thread
      • Get All Chat Threads Of An Agent
      • Get All Chat Threads With Admin Panel Filters And Pagination
      • Get Reduced Chatlogs by Thread ID for Admin Panel
      • Get Chat Thread
      • Edit Chat Thread
      • Delete Chat Thread
      • Add ChatThread-Corpus Connection
      • Get ChatThread-Corpus Connection
      • Delete ChatThread-Corpus Connection
    • Project
      • Create Project
      • Get All Projects
      • Project Filtered
      • Get All Agents Of Project
      • Get All Projects By Team
      • Get Project
      • Edit Project
      • Delete Project
      • Fetch Project Details
      • Add Recent Project
      • Get Recent Projects
    • User Project
      • Add Users To Project
      • Get All Projects By User Teams
      • Get Projects By User and Team
      • Delete Users from Project
    • Document
      • Get Document
      • Edit Document
      • Add Or Remove Tags On Document
      • Document Polling
    • Corpus
      • Create Corpus
        POST
      • Get All Corpus
        GET
      • Get Corpus
        GET
      • Edit Corpus
        PUT
      • Delete Corpus
        DELETE
      • Create Document In Corpus
        POST
      • Get All Documents From Corpus
        GET
      • Delete All Documents from Corpus
        DELETE
      • Check Duplicate Documents
        POST
      • Get All Agents By Corpus
        GET
      • Get Corpus Permissions
        GET
      • Get Corpus Permission By User
        GET
      • Annotate Corpus
        POST
    • Notification
      • Create Notification
      • Retrieve All Notifications
      • Read Notifications By User ID
      • Retrieve Notification
      • Read Notification
      • Delete Notification
    • Feature Flag
      • Get All Feature Flags
      • Get DALL-E Feature Flag
      • Get Share Agent Feature Flag
      • Get Agent Alias Feature Flag
      • Get SharePoint Index Feature Flag
      • Get Chat Agent Creation Feature Flag
      • Get OAuth Feature Flags
      • Get Google OAuth Feature Flag
      • Get LinkedIn OAuth Feature Flag
      • Get MS SSO OAuth Feature Flag
      • Get Github OAuth Feature Flag
    • Team
      • Create Team
      • Get All Teams
      • Get Team Details
      • Edit Team
      • Delete Team
      • Create Recent Team
      • Get Recent Teams
      • Add Users to Team
      • Get Users in a Team
      • Get Teams Of User
      • Get User Role By Team
      • Get Agents Of User Team
      • Get Projects And Team
    • User
      • Create User In Organization
      • Get All Users By Organization
      • Get User
      • Edit User
      • Delete User
      • Batch Delete Users
      • User Filtered
      • Create User Permission
      • Get User Permission
      • Edit User Permission
      • Delete User Permission
    • Email Indexing Authorization
      • Email Authorize
    • Conversation Starters
      • Create Conversation Starter
      • Get Conversation Starters
    • Tool
      • Create Tool
      • Get All Tools
      • Get Tool
      • Edit Tool
      • Delete Tool
    • Agent Tool Connection
      • Enable Agent Tool
      • Get All Agent Tools
      • Disable Agent Tool
    • Organization Tool
      • Enable Organization Tool
    • API Tool Template
      • Create API Tool Template
      • Get All API Tool Templates
    • LLM Config
      • Get All LLM Configs
      • Get Active Config
      • Get LLM Config
      • Get Model Deployment
      • Get Org Configs
      • Set Agent Config View
  • Latest
    • Introduction to Latest APIs
    • Agents
      • Agent Access
        • Get Agent Access
        • Update Agent Access
      • Agent Alias
        • Get Agent Alias
        • Create an Agent Alias
        • Update an Agent Alias
        • Delete an Agent Alias
        • Get all Agent Aliases
      • Agent Tags
        • Add or Remove Tags from an Agent
        • Get all Tags for a given Project, Team, or Organization
        • Get all Tags grouped by Agent for a given Project, Team, or Organization
      • Agent Comment
        • Get all Comments for an Agent
        • Create a Comment
        • Update a Comment
        • Delete a Comment
      • Agent Rating
        • Get Ratings of an Agent
        • Update Agent Rating
        • Get all Agent Ratings
      • Agent Review
        • Get all Reviews for specific Agent
        • Create a new Review
        • Get all Reviews of the Authenticated User
        • Update a Review
        • Delete a Review
      • Agent Tools
        • List all Tools with their enabled status for the given Agent
        • Unlink an Agent from a Tool
        • Link an Agent to a Tool
        • List all tools that are connected to the Agent
      • Agent User
        • Get Users of an Agent
        • Add user to Agent
        • Delete User from Agent
        • Get all Agents Users
      • Agent User Permission
        • Get User Agent Permission
      • Agent Vote
        • Get Vote Information for an Agent
        • Vote on an Agent
      • Agent Type
        • Get all Agent Types
        • Get a specific Agent Type
        • Update a specific Agent Type
      • Get all Agents
      • Create a new Agent
      • Get an Agent
      • Update an Agent
      • Delete an Agent
      • Activate an Agent
      • Get agent history with pagination
      • Restore an agent to a previous checkpoint
      • Get Agent Prompt History
      • Create a Recent Agent
      • Delete a Recent Agent
      • Create Starred Agent
      • Delete Starred Agent
      • Get the Status of an Agent
      • Get User's Team Role for an Agent
      • Create or Update an Agent using the Agent Builder
      • Get Agent Filter
      • Generate an image for an agent based on the provided description
      • Get all Agents by Project
      • Get list of Recent Agents
      • Get all Starred Agents of the Authenticated User
      • Get Agents accessible to the Current User across their Teams
      • Get Agents by Project team, User team
    • Agent Response Steps
      • List Steps for Agent Response
      • Create Step for Agent Response
      • Delete All Steps for Agent Response
      • Retrieve a Step for Agent Response
      • Update a Step for Agent Response
      • Delete a Step for Agent Response
    • Corpora
      • Get all Corpus
      • Create a Corpus
      • Get a Corpus
      • Update a Corpus
      • Delete a Corpus
      • Get Corpus Agent Connections
      • Get Default Corpus Agent Connection
      • Annotate/Tag a Corpus
      • Get Conversation Starters for a Corpus
      • Get all Documents for a Corpus
      • Upload a Document to a Corpus
      • Delete Document(s) from a Corpus
      • Check Duplicate Documents in a Corpus
      • Get all Permissions for a Corpus
      • Create a new Permission for a Corpus
      • Delete a user permission for a corpus
      • Get all user permissions for a corpus
    • Documents
      • Get a Document
      • Update a Document
      • Delete a Document
      • Annotate a Document
      • Retrieve multiple Documents by IDs
    • Chat Logs
      • Get Chat Log Details
      • Get Chat Log Search Results
    • Chat Thread
      • Agent Response
        • Get Agent Responses for a Chat Thread
        • Delete Agent Responses for a Chat Thread
      • Chat Logs
        • Get Chat Logs for a Chat Thread
      • Corpus Connection
        • Get Corpus Connection by ChatThread ID
        • Delete Corpus Connection by ChatThread ID
        • Get a ChatThread-Corpus connection
        • Create a ChatThread-Corpus connection
        • Delete a ChatThread-Corpus connection
      • Documents
        • Get Documents in Chat Thread
      • Get Chat Thread
      • Update Chat Thread
      • Delete Chat Thread
      • Get Chat Threads based on various filters
    • Configurations
      • Update the LLM configuration for an Agent
      • Get OAuth-related Feature Flags
    • Evaluations
      • Retrieve all evaluations or filter by dataset
      • Create a new evaluation
      • Delete a set of evaluations or a specific evaluation
      • Retrieve all evaluation datasets for a specific agent
      • Create a new evaluation dataset for the given agent
      • Delete multiple datasets or all datasets for an agent
      • Retrieve a specific evaluation
      • Update an evaluation run
      • Delete a specific evaluation
      • List query results for an evaluation run
      • Create a query result and save metrics
      • Retrieve a specific dataset
      • Update an evaluation dataset
      • Delete a specific dataset
      • Retrieve queries for an evaluation dataset
      • Create a new query for evaluation
      • Retrieve all unique tags from all datasets in the organization
      • Get a specific metric result by ID
      • Retrieve all metrics or filter by category name
      • Create a new metric
      • Retrieve a specific metric
      • Update a metric
      • Delete a metric
      • Get all metric results for a specific metric
      • Create a new metric result entry for the given metric
      • Retrieve a specific evaluation query
      • Update an evaluation query
      • Delete an evaluation query
      • Get a specific query result with metrics
      • Update a query result
    • SharePoint
      • Get SharePoint Item By Full Path
      • Get SharePoint Item
      • Create a SharePoint Item
      • Update a SharePoint Item
      • Delete SharePoint Hierarchy Item
    • SharePoint Connector
      • Get Corpus IDs by SharePoint Drive ID
      • Get SharePoint URLs by Corpus ID
      • Get SharePoint Drive Mappings
      • Create or Update SharePoint Drive Mapping
      • Update SharePoint Drive Mapping Token or Subscription
      • Get SharePoint Drive Token Information
      • Get All SharePoint Subscriptions
    • Guardrails
      • Get available guardrail types for agent
      • Enable/disable a guardrail type for agent
      • Get Guardrails
      • Update Guardrails
      • Delete Guardrails
      • Get Guardrails in Organization
      • Create Guardrail in Organization
      • Enable or Disable Guardrail for Organization
    • Conversation Starters
      • Get Conversation Starters for an Agent
      • Create a new Conversation Starter.
    • Analytics
      • Get Agent Cost Data
      • Get Agent Document Count Data
      • Get Agent Indexing Mode Data
      • Get Agent Most Active Data
      • Get Agent Query Count Data
      • Get Recent Agent Data
      • Get Agent Summary Statistics
      • Get Agent Token Data
      • Get Agent Vote Data
      • Get Corpus Document Count Data
      • Get Corpus Indexing Mode Data
      • Get Cost Data
      • Get Document Count Data
      • Get Indexing Mode Data
      • Get Project Cost Data
      • Get Project Document Count Data
      • Get Project Indexing Mode Data
      • Get Project Most Active Data
      • Get Project Query Count Data
      • Get Recent Project Data
      • Get Project Summary Statistics
      • Get Project Token Data
      • Get Project Vote Data
      • Get Overall Summary Statistics
      • Get Team Cost Data
      • Get Team Document Count Data
      • Get Team Indexing Mode Data
      • Get Team Most Active Data
      • Get Team Query Count Data
      • Get Recent Team Data
      • Get Team Summary Statistics
      • Get Team Token Data
      • Get Team Vote Data
      • Get Total Entity Counts
      • Get User Cost Data
      • Get User Document Count Data
      • Get User Indexing Mode Data
      • Get User Most Active Data
      • Get User Query Count Data
      • Get Recent User Data
      • Get User Summary Statistics
      • Get User Token Data
      • Get User Vote Data
      • Get Vote Count Data
      • Get Query Count Data
      • Get Token Data
    • Teammates
      • Get All Active Carousels
      • Create Carousel
    • Tools
      • Get Tool by ID
      • Update Tool by ID
      • Delete Tool by ID
      • Get all Tools
    • Feature Flags
      • Get All Feature Flags
      • Get Agent Alias Feature Flag
      • Get Api Tools Feature Flag
      • Get Chat Agent Creation Feature Flag
      • Get dall_e Image Generation Feature Flag
      • Get Developer Portal Feature Flag
      • Get Guardrail Feature Flag
      • Get PII Redaction Feature Flag
      • Get Share Agent Feature Flag
      • Get Sharepoint Index Feature Flag
      • Get Youtube Index Feature Flag
    • Users
      • Get a User
      • Update a User
      • Delete a User
      • Get all User Permissions
      • Create a new User Organization Permission
      • Update the Organization Permission of a User
      • Delete a User Organization Permission
      • Delete multiple Users
      • Get a specific User by user_email
      • Get all Users
      • Get authenticated User
    • Notifications
      • Get all Notifications
      • Create a new Notification
      • Get a Notification
      • Update a Notification
      • Delete a Notification
    • Projects
      • Retrieve all Projects
      • Create a Project
      • Get a Project
      • Update a Project
      • Delete a Project
      • Get Agent Responses using Project ID
      • Add a Recent Project for a User
      • Add Users to a Project
      • Remove a User from a Project
      • Get multiple Projects by their IDs
      • Get Projects based on filters
      • Get Recent Projects for a User
      • Get Projects with Team Details
    • Teams
      • Get all Teams
      • Create a Team
      • Get a Team
      • Update a Team
      • Delete a Team
      • Get all Projects of a Team
      • Create a Recent Team
      • Get all Users in a Team
      • Add Users to a Team
      • Get Recent Teams
      • Get all Teams of the Authenticated User
      • Get all Agents of User's Team
    • Organizations
      • Get all Configurations
      • Get active configuration for an Organization
      • Get the Model Deployment for an Organization
      • Get Organization Logo
      • Get all Tools in an Organization
      • Disable a Tool for all Agents in an Organization
      • Enable a Tool for all Agents in an Organization
      • Get all API Tool Templates
      • Create a new API Tool Template
      • Create a new API tool
      • Create an attachment tool
      • Create a new RAG tool in an Organization
      • Create a Web Search Tool in an Organization
      • Get all Users in an Organization
      • Create a User in an Organization
      • Get all Configurations of user's Organization
      • Get all LLM configurations of the user's Organization
      • Get a specific LLM configuration by ID
  1. Corpus

Create Document In Corpus

POST
/v2/api/corpus/{corpus_id}/document
Corpus
Enables authorized users to upload a new document into a specific corpus by providing essential details such as content type, source text, upload method, and user ID.
Purpose:
Designed for adding new content to an existing corpus for indexing, searching, or analysis purposes.
Ensures each document is properly linked with a corpus and can be processed asynchronously.
Returns a unique document identifier (document ID)
What is a Corpus?
A corpus is a structured collection of documents or data grouped under a specific context or use case. It is commonly used for organizing content intended for search, training, redaction, or analysis.

How to View Your Corpus ID?#

To find your Corpus ID, visit the View Corpus ID Guide.
For more detailed information about corpus, refer to the Corpus Guide.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/v2/api/corpus//document' \
--form 'content_type="text"' \
--form 'source="Example Source"' \
--form 'upload_from="web"' \
--form 'user_id="147"'
Response Response Example
{
    "id": "315b5b4540d54977bfab89ec2d067a99",
    "statusQueryGetUri": "https://func-ejento-indexing-dev.azurewebsites.net/runtime/webhooks/durabletask/instances/315b5b4540d54977bfab89ec2d067a99?taskHub=funcejentoindexingdev&connection=Storage&code=xxx",
    "sendEventPostUri": "https://func-ejento-indexing-dev.azurewebsites.net/runtime/webhooks/durabletask/instances/315b5b4540d54977bfab89ec2d067a99/raiseEvent/{eventName}?taskHub=funcejentoindexingdev&connection=Storage&code=xxx",
    "terminatePostUri": "https://func-ejento-indexing-dev.azurewebsites.net/runtime/webhooks/durabletask/instances/315b5b4540d54977bfab89ec2d067a99/terminate?reason={text}&taskHub=funcejentoindexingdev&connection=Storage&code=xxx",
    "rewindPostUri": "https://func-ejento-indexing-dev.azurewebsites.net/runtime/webhooks/durabletask/instances/315b5b4540d54977bfab89ec2d067a99/rewind?reason={text}&taskHub=funcejentoindexingdev&connection=Storage&code=xxx",
    "purgeHistoryDeleteUri": "https://func-ejento-indexing-dev.azurewebsites.net/runtime/webhooks/durabletask/instances/315b5b4540d54977bfab89ec2d067a99?taskHub=funcejentoindexingdev&connection=Storage&code=xxx",
    "restartPostUri": "https://func-ejento-indexing-dev.azurewebsites.net/runtime/webhooks/durabletask/instances/315b5b4540d54977bfab89ec2d067a99/restart?taskHub=funcejentoindexingdev&connection=Storage&code=xxx",
    "suspendPostUri": "https://func-ejento-indexing-dev.azurewebsites.net/runtime/webhooks/durabletask/instances/315b5b4540d54977bfab89ec2d067a99/suspend?reason={text}&taskHub=funcejentoindexingdev&connection=Storage&code=xxx",
    "resumePostUri": "https://func-ejento-indexing-dev.azurewebsites.net/runtime/webhooks/durabletask/instances/315b5b4540d54977bfab89ec2d067a99/resume?reason={text}&taskHub=funcejentoindexingdev&connection=Storage&code=xxx"
}

Request

Path Params
corpus_id
integer 
required
Unique identifier of the corpus where the document will be added.
Body Params multipart/form-data
content_type
string 
required
Type of content being uploaded.
Example:
text
source
string 
required
The text content of the document.
Example:
Example Source
upload_from
string 
required
The source from where the document is uploaded.
Example:
web
user_id
integer 
required
ID of the user uploading the document.
Example:
147

Responses

🟢200OK
application/json
Document successfully created and processing started.
Body
id
string <uuid>
optional
Unique identifier for the created document.
Example:
315b5b4540d54977bfab89ec2d067a99
statusQueryGetUri
string <uri>
optional
URI to check the status of the document processing.
Example:
https://func-ejento-indexing-dev.azurewebsites.net/runtime/webhooks/durabletask/instances/315b5b4540d54977bfab89ec2d067a99?taskHub=funcejentoindexingdev&connection=Storage&code=xxx
sendEventPostUri
string <uri>
optional
URI to send events related to the document processing.
Example:
https://func-ejento-indexing-dev.azurewebsites.net/runtime/webhooks/durabletask/instances/315b5b4540d54977bfab89ec2d067a99/raiseEvent/{eventName}?taskHub=funcejentoindexingdev&connection=Storage&code=xxx
terminatePostUri
string <uri>
optional
URI to terminate the document processing.
Example:
https://func-ejento-indexing-dev.azurewebsites.net/runtime/webhooks/durabletask/instances/315b5b4540d54977bfab89ec2d067a99/terminate?reason={text}&taskHub=funcejentoindexingdev&connection=Storage&code=xxx
rewindPostUri
string <uri>
optional
URI to rewind the document processing to an earlier state.
Example:
https://func-ejento-indexing-dev.azurewebsites.net/runtime/webhooks/durabletask/instances/315b5b4540d54977bfab89ec2d067a99/rewind?reason={text}&taskHub=funcejentoindexingdev&connection=Storage&code=xxx
purgeHistoryDeleteUri
string <uri>
optional
URI to purge the document processing history.
Example:
https://func-ejento-indexing-dev.azurewebsites.net/runtime/webhooks/durabletask/instances/315b5b4540d54977bfab89ec2d067a99?taskHub=funcejentoindexingdev&connection=Storage&code=xxx
restartPostUri
string <uri>
optional
URI to restart the document processing.
Example:
https://func-ejento-indexing-dev.azurewebsites.net/runtime/webhooks/durabletask/instances/315b5b4540d54977bfab89ec2d067a99/restart?taskHub=funcejentoindexingdev&connection=Storage&code=xxx
suspendPostUri
string <uri>
optional
URI to suspend the document processing.
Example:
https://func-ejento-indexing-dev.azurewebsites.net/runtime/webhooks/durabletask/instances/315b5b4540d54977bfab89ec2d067a99/suspend?reason={text}&taskHub=funcejentoindexingdev&connection=Storage&code=xxx
resumePostUri
string <uri>
optional
URI to resume the document processing after suspension.
Example:
https://func-ejento-indexing-dev.azurewebsites.net/runtime/webhooks/durabletask/instances/315b5b4540d54977bfab89ec2d067a99/resume?reason={text}&taskHub=funcejentoindexingdev&connection=Storage&code=xxx
🟠400Bad Request
🟠401Unauthorized
🟠403Forbidden
🟠404Record Not Found
🔴500Server Error
Previous
Delete Corpus
Next
Get All Documents From Corpus