Ejento APIs
V2
  • V2
  • V1
  1. Agent Corpus Connection
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
        POST
      • Get Agent Corpus Connection
        GET
      • Edit Agent Corpus Connection
        PUT
      • Delete Agent Corpus Connection
        DELETE
      • Get All Agent Corpus Connections
        GET
      • Delete All Agent Corpus Connections
        DELETE
    • 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
      • Get All Corpus
      • Get Corpus
      • Edit Corpus
      • Delete Corpus
      • Create Document In Corpus
      • Get All Documents From Corpus
      • Delete All Documents from Corpus
      • Check Duplicate Documents
      • Get All Agents By Corpus
      • Get Corpus Permissions
      • Get Corpus Permission By User
      • Annotate Corpus
    • 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. Agent Corpus Connection

Create Agent Corpus Connection

POST
/v2/api/agent/{agent_id}/corpus/{corpus_id}
Agent Corpus Connection
Establishes a connection between a specific agent and a corpus, enabling the agent to utilize the knowledge contained within the selected corpus.
This association allows the agent to fetch relevant content, respond more intelligently to queries, and function within the context defined by the corpus data.
The request must include the unique identifiers (agent_id and corpus_id) of both entities in the path parameters.
On successful execution, this endpoint returns detailed metadata about the newly established connection, including agent and corpus information, connection status, and timestamps.
Use this endpoint when you want to:
Connect a new corpus to an agent.
Reconfigure an agent’s knowledge base.

Purpose of Agent ID#

The Agent ID is essential for:
Identifying specific agents when making API requests.
Managing and modifying agent configurations.
Fetching agent-related data efficiently.

How to View Your Agent ID?#

To find your agent's Agent ID, follow the step-by-step guide here:
View Your Agent ID

Purpose of Corpus ID#

Identifies and retrieves specific corpora linked to an agent.
Helps AI agents access relevant knowledge bases for better responses.
Defines the scope of information available to an assistant.

How to View Your Corpus ID?#

To find your Corpus ID, visit the View Corpus ID Guide.
For more detailed information about agent and corpus, refer to the Agent Guide Corpus Guide.
📝 Note: "Assistant" is another name for "Agent".
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/v2/api/agent/1297/corpus/1227'
Response Response Example
201 - Example 1
{
    "id": 1079,
    "agent": {
        "id": 1297,
        "agent_type": {
            "id": 1,
            "name": "QnA"
        },
        "instructions": [],
        "agent_name": "FC Barca",
        "domain": "",
        "prefix_prompt": "abc",
        "alias": "FCBarcelonaInfoAssistant_1297-dev@ejento.ai",
        "is_deleted": false,
        "created_by": "user@example.com",
        "access": "Only me",
        "project": 254,
        "llm_config": 1
    },
    "corpus": {
        "id": 1227,
        "indexing_mode": {
            "id": 3,
            "mode": "basic"
        },
        "name": "HZ8Hub_Default",
        "description": null,
        "owner": {
            "id": 147,
            "email": "user@example.com",
            "is_superuser": true,
            "first_name": "user",
            "last_name": "user",
            "organization": {
                "id": 1,
                "org_name": "Data Science Dojo"
            }
        },
        "tags": []
    },
    "created_by": "user@example.com",
    "created_on": "2025-04-01T07:06:09.470040Z",
    "modified_by": "",
    "modified_on": "2025-04-01T07:06:09.470056Z",
    "is_enabled": true,
    "is_default": false,
    "is_deleted": false,
    "connected_by": 147
}

Request

Path Params
agent_id
integer <int64>
required
The unique identifier of the agent.
Example:
1297
corpus_id
integer <int64>
required
The unique identifier of the corpus.
Example:
1227

Responses

🟢201Created
application/json
Successfully created the agent corpus connection.
Body
Response containing details of the agent corpus connection.
id
integer <int64>
optional
The unique identifier of the created agent corpus connection.
Example:
1079
agent
object 
optional
Details of the agent associated with the connection.
id
integer <int64>
optional
The unique identifier of the agent.
Example:
1297
agent_type
object 
optional
The type of agent.
instructions
array[string]
optional
Instructions associated with the agent.
Example:
[]
agent_name
string 
optional
The name of the agent.
Example:
FC Barca
domain
string 
optional
The domain of the agent (if any).
Example:
prefix_prompt
string 
optional
The prefix prompt for the agent.
Example:
abc
alias
string 
optional
The alias of the agent.
Example:
FCBarcelonaInfoAssistant_1297-dev@ejento.ai
is_deleted
boolean 
optional
Indicates if the agent is deleted.
Example:
false
created_by
string <email>
optional
The email of the user who created the agent.
Example:
user@example.com
access
string 
optional
The access level of the agent.
Example:
Only me
project
integer 
optional
The ID of the project the agent belongs to.
Example:
254
llm_config
integer 
optional
The configuration ID of the language model used.
Example:
1
corpus
object 
optional
Details of the corpus associated with the connection.
id
integer 
optional
The unique identifier of the corpus.
Example:
1227
indexing_mode
object 
optional
The indexing mode of the corpus.
name
string 
optional
The name of the corpus.
Example:
HZ8Hub_Default
description
string  | null 
optional
A description of the corpus (if available).
Example:
null
owner
object 
optional
The owner of the corpus.
tags
array[string]
optional
Tags associated with the corpus.
Example:
[]
created_by
string <email>
optional
The email of the user who created the connection.
Example:
user@example.com
created_on
string <date-time>
optional
The timestamp when the connection was created.
Example:
2025-04-01T07:06:09.470040Z
modified_by
string 
optional
The email of the user who last modified the connection (if applicable).
Example:
modified_on
string <date-time>
optional
The timestamp when the connection was last modified.
Example:
2025-04-01T07:06:09.470056Z
is_enabled
boolean 
optional
Indicates if the connection is enabled.
Example:
true
is_default
boolean 
optional
Indicates if the connection is the default connection.
Example:
false
is_deleted
boolean 
optional
Indicates if the connection is deleted.
Example:
false
connected_by
integer 
optional
The unique identifier of the user who connected the agent and corpus.
Example:
147
🟠400Bad Request
🟠401Unauthorized
🟠403Forbidden
🟠404Record Not Found
🔴500Server Error
Previous
Delete Starred Agent
Next
Get Agent Corpus Connection