Ejento APIs
Stable
  • Stable
  • V2
  • V2 Legacy
    Ejento APIs
    Stable
    • Stable
    • V2
    • V2 Legacy
    • Overview
    • Changelog
    • Versioning
    • Quick-Start Template for Building an App
    • FAQs
    • Guides
      • How to generate API Key and Auth Token
      • Build an App with Ejento APIs
      • How to Import Ejento APIs into Postman
      • Response API Migration
      • Indexing API Migration
      • Voice Call API Integration Guide
    • Authentication
      • Getting Started with Authentication
      • SSO
        • Initiate Google SSO Login
        • Initiate Microsoft SSO Login
        • Initiate LinkedIn SSO Login
        • Initiate Okta SSO Login
      • Feature Flags
        • Get Login Feature Flags
      • Authenticate User
      • Request Passwordless Exchange Token
      • Exchange Passwordless Token for Access Tokens
      • Register User
      • Update Own Password
      • Refresh Access Token
      • Passwordless Authentication (Email Magic Link)
      • Validate Magic Link Token
      • Verify Email OTP
    • 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 or Organization
        • Get all Tags grouped by Agent for a given Project or Organization
      • Agent Chat Threads
        • Get Chat Threads of an Agent
        • Create Chat Thread for an Agent
      • 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 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
      • Evaluation Datasets
        • List Agent Evaluation Datasets
        • Create Agent Evaluation Dataset
        • Batch Delete Agent Evaluation Datasets
        • Get Agent Evaluation Dataset
        • Update Agent Evaluation Dataset
        • Delete Agent Evaluation Dataset
      • Evaluation Runs
        • List Agent Evaluation Runs
        • Create Agent Evaluation Run
        • Batch Delete Agent Evaluation Runs
        • Get Agent Evaluation Run
        • Update Agent Evaluation Run
        • Delete Agent Evaluation Run
      • Agent Permissions
        • List all permissions on an agent
        • Grant permission on an agent
        • Update a permission on an agent
        • Revoke permission on an agent
        • Grant multiple permissions on an agent
        • Revoke multiple permissions on an agent
        • Get user permissions on a specific agent
        • Get user permissions on multiple agents
      • Get all Agents
      • Create a new Agent
      • Get an Agent
      • Update an Agent
      • Delete an Agent
      • Activate an Agent
      • Get Agent-Corpus Connections
      • Create Multiple Agent-Corpus Connections
      • Delete Agent-Corpus Connections
      • Get Agent-Corpus Connection Details
      • Create Agent-Corpus Connection
      • Update Agent-Corpus Connection
      • Delete Agent-Corpus Connection
      • Get agent history with pagination
      • Restore an agent to a previous checkpoint
      • Get a single agent history record by history ID
      • Create Custom Instructions for an Agent
      • Update Custom Instructions for an Agent
      • Delete a Custom Instruction for an Agent
      • Get Agent Prompt History
      • Create a Recent Agent
      • Delete a Recent Agent
      • Get Agent Details with Starred Status
      • Create Starred Agent
      • Delete Starred Agent
      • Get the Status of an Agent
      • Get all Character Voices
      • 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
    • Agent Response
      • Stream Agent Response (SSE)
      • Generate Agent Response (Non-Streaming)
      • Generate Token for Voice Call
      • Get an Agent Response
      • Update an Agent Response
      • Delete an Agent Response
      • Get Comments for Agent Response
      • Create a Comment for Agent Response
      • Create a Feedback for an Agent Response
      • Pin an Agent Response
      • Unpin an Agent Response
      • Get Supporting Content of an Agent Response
      • Get Thoughts of an Agent Response
      • Get Agent Responses based on filters
      • Get Agent Responses of an Agent
      • Create Agent Response Log
      • Get Pinned Agent Responses
      • Create Bulk Agent Response Logs
    • 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
    • Chat Logs
      • Get Chat Log Details
      • Get Chat Log Search Results
    • Conversation Starters
      • Get Conversation Starters for an Agent
      • Create a new Conversation Starter.
    • Teams
      • Team Permissions
        • List all permissions on a team
        • Grant permission on a team
        • Update a permission on a team
        • Revoke permission on a team
        • Grant multiple permissions on a team
        • Revoke multiple permissions on a team
        • Get user permissions on a specific team
        • Get user permissions on multiple 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
      • Remove User from Team
      • Get Recent Teams
      • Get all Teams of the Authenticated User
    • Projects
      • Project Permissions
        • List all permissions on a project
        • Grant permission on a project
        • Update a permission on a project
        • Revoke permission on a project
        • Grant multiple permissions on a project
        • Revoke multiple permissions on a project
        • Get user permissions on a specific project
        • Get user permissions on multiple 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 all Workflows for a Project
      • Get multiple Projects by their IDs
      • Get Projects based on filters
      • Get Recent Projects for a User
      • Get Projects with Team Details
    • Corpora
      • Get all Corpus
      • Upload a Document to a 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
      • 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
      • Trigger a Refresh (Reindex) of a Corpus
      • Get Sitemaps for a Corpus
      • Get Corpora with Refresh (Reindex) Enabled
    • Documents
      • Get a Document
      • Update a Document
      • Delete a Document
      • Annotate a Document
      • Get Conversation Starters for a Document
      • Trigger a Refresh (Reindex) of a Document
      • Retrieve multiple Documents by IDs
    • Organizations
      • Organization Permissions
        • List all permissions on an organization
        • Get user permissions on a specific organization
      • Get all Configurations
      • Get active configuration for an Organization
      • Get the Model Deployment for an Organization
      • 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
    • Users
      • Get a User
      • Update a User
      • Delete a User
      • Get Agent Responses of a User
      • Get all User Permissions
      • Get Projects of a User
      • Get all Workflow Tables for a User
      • Get all Workflows for a User
      • Delete multiple Users
      • Get a specific User by user_email
      • Get all Users
      • Get authenticated User
      • Get User Projects
    • 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 Workflow Summary Statistics
      • Get Query Count Data
      • Get Token Data
    • Configurations
      • Update the LLM configuration for an Agent
      • Get OAuth-related Feature Flags
    • Guardrails
      • Get available guardrail types for agent
      • Enable/disable a guardrail type for agent
      • Get Guardrails
      • Apply Guardrails on Input Text
      • Update Guardrails
      • Delete Guardrails
      • Get Guardrails in Organization
      • Create Guardrail in Organization
      • Enable or Disable Guardrail for Organization
    • Feature Flags
      • Get All Feature Flags
      • Get Agent Alias Feature Flag
      • Get Api Tools Feature Flag
      • Get Caching Feature Flag
      • Get Call Feature Flag
      • Get Chat Agent Creation Feature Flag
      • Get Chat Widget Feature Flag
      • Get dall_e Image Generation Feature Flag
      • Get Developer Portal Feature Flag
      • Get Flush Cache Feature Flag
      • Get Guardrail Feature Flag
      • Get PII Redaction Feature Flag
      • Get Share Agent Feature Flag
      • Get Sharepoint Legacy Feature Flag
      • Show Quota Limit Feature Flag
      • Get Workflow Evaluation Feature Flag
      • Get Youtube Index Feature Flag
      • Get Agent Evaluation Feature Flag
    • Notifications
      • Get all Notifications
      • Create a new Notification
      • Update Notifications by User ID
      • Get a Notification
      • Update a Notification
      • Delete a Notification
    • Tools
      • Get Tool by ID
      • Update Tool by ID
      • Delete Tool by ID
    • Workflows
      • Evaluation Datasets
        • List Workflow Evaluation Datasets
        • Create Workflow Evaluation Dataset
        • Batch Delete Workflow Evaluation Datasets
        • Get Workflow Evaluation Dataset
        • Update Workflow Evaluation Dataset
        • Delete Workflow Evaluation Dataset
      • Evaluation Runs
        • List Workflow Evaluation Runs
        • Create Workflow Evaluation Run
        • Batch Delete Workflow Evaluation Runs
        • Get Workflow Evaluation Run
        • Update Workflow Evaluation Run
        • Delete Workflow Evaluation Run
      • Get all Workflows
      • Create a Workflow
      • Get a Workflow
      • Stream Workflow Response (SSE)
      • Update a Workflow
      • Delete a Workflow
      • Get all Workflow Chat Threads
      • Create a Workflow Chat Thread
      • Get all Workflow Responses
      • Create a Workflow Chat Response
      • Get a Workflow Chat Thread
      • Update a Workflow Chat Thread
      • Delete a Workflow Chat Thread
      • Get all Workflow Chat Responses
      • Delete a Workflow Response
      • Create a Workflow Feedback
      • Retrieve a list of reviews for a given workflow response
      • Create a Workflow Review
    • Citation
      • Get Citation File Content
    • Sitemaps
      • Get a Sitemap
      • Toggle Sitemap Syncing
      • Delete a Sitemap (cascade)
      • Get documents linked to a Sitemap

    Quick-Start Template for Building an App

    The Ejento AI Quick-Start Template is a Next.js application that demonstrates how to build AI-powered chat applications using Ejento AI APIs with minimal setup.
    This guide walks you through the complete setup process to get you up and running quickly.

    Prerequisites#

    Before you begin, ensure you have the following installed:
    Node.js 20.x or later
    npm package manager
    Git

    Step 1: Join the Ejento AI Ecosystem#

    Visit ejento.ai — or your organization's custom deployment if you are already a customer — to create an account or log in.
    💡 New here?
    Follow our Login Guide for detailed instructions on creating and accessing your account.

    Step 2: Create Your Agent#

    Once you're logged into Ejento AI, create and configure your own agent according to your requirements. The Quick-Start Template requires an active agent to function.
    💡 New to agent creation?
    Check out our Agent Creation Tutorial for step-by-step guidance.

    Step 3: Obtain Your API Credentials#

    You will need the following credentials from your administrator:
    1.
    Ejento AI API Key (referred to as Ocp-Apim-Subscription-Key)
    2.
    Ejento AI Base URL
    🔑 Are you an administrator?
    Follow the API Keys Guide to retrieve these credentials.

    Step 4: Authentication Setup (Optional)#

    The Quick-Start Template supports an optional built-in authentication flow. Your setup will differ depending on whether authentication is enabled or disabled.

    If Authentication Is Enabled#

    Users authenticate via the built-in login flow.
    The Ejento Access Token is issued automatically after a successful login.
    You do not need to manually generate or configure an access token.

    If Authentication Is Disabled#

    You must manually generate and provide an Ejento Access Token.
    Refer to the Ejento Authentication Guide for instructions on generating the token.
    Token Expiry
    Ejento Access Tokens expire every 7 days. Bookmark the Authentication Guide so you can quickly regenerate tokens or log in again when your requests become unauthorized.

    Step 5: Verify Your Credentials#

    Before proceeding, confirm you have collected all required credentials based on your setup.

    Required in All Cases#

    CredentialDescription
    Base URLYour Ejento API instance URL
    API KeyYour Ocp-Apim-Subscription-Key
    Agent IDThe ID of the agent you created (visible in the agent details)

    Required Only If Authentication Is Disabled#

    CredentialDescription
    Ejento Access TokenA valid, manually generated authentication token

    Step 6: Clone and Set Up the Template#

    1.
    Clone the Quick-Start Template repository.
    2.
    Follow the setup instructions in the repository's README, which include:
    Installing dependencies
    Configuring environment variables
    Enabling or disabling authentication
    Running the development server

    Next Steps#

    Once the template is running, you can:
    Customize the chat interface to match your brand
    Enable or disable authentication based on your deployment needs
    Integrate additional Ejento AI features using the available APIs
    Deploy the application to your preferred hosting platform

    Need Help?#

    Browse the Ejento Documentation Hub
    Review the template's README for technical details
    Contact support if you encounter any issues

    Ready to build?
    You have everything you need — let's get started with your AI-powered application!
    Previous
    Versioning
    Next
    FAQs
    Built with