Ejento AI
GuidesQuickstartRecipesREST APIsRelease NotesFAQs
GuidesQuickstartRecipesREST APIsRelease NotesFAQs
Ejento AI
  1. Guides
  • Getting Started
  • Basic Operations
    • Features
      • Teams → Projects → Assistants Hierarchy
    • Guides
      • Login/Signup
  • Assistants
    • Features
      • Introduction to Assistants
      • Assistant Access Control
      • Caching Responses for Assistants
      • Assistant Evaluation
      • Evaluation Metrics
      • URL-based Chat Thread Creation and Prepopulation
      • Reasoning Modes
    • Guides
      • Add Assistant
      • Evaluate Assistant
      • Edit Assistant
      • Embed Assistant
      • Delete Assistant
      • Add Favourite Assistants
      • View Assistant Id
      • View Dataset Id
  • Workflows
    • Features
      • Overview and Types of Supervisors
    • Guides
      • Add Workflow
      • Workflow Chat
  • Corpus
    • Features
      • Introduction
      • Corpus Permissions
      • PII Redaction
    • Guides
      • Assistant Corpus Setup
      • Assistant Corpus Settings
      • Corpus Access Control
      • Corpus Connections
      • ETag Setup for Corpus Incremental Refresh
      • View Corpus Id
      • View Document Id
      • Tagging
        • Corpus tagging
        • Document tagging
  • Tools
    • Features
      • Introduction
    • Guides
      • Tools Overview
      • Create External Tool
      • Connect Tool to Assistant
  • Analytics
    • Guides
      • Analytics
  • User Settings
    • Features
      • Ejento AI User Access Levels
    • Guides
      • Assistant Edit Access
      • Add new user
      • Add User in a Team
      • Remove User from a Team
      • View my Access level in a Team
      • View my User Id
  • Chatlogs
    • Guides
      • Chatlogs
      • View Chatlog & Chat thread Id
  • API Keys
    • Guides
      • API Keys
  • Integrations
    • Email Indexing
    • Microsoft Teams
    • Sharepoint Indexing
    • MS Teams Integration Setup
  • Teams
    • Features
      • Introduction
    • Guides
      • Add a Team
      • Edit a Team
      • Delete a Team
      • View Team Id
  • Projects
    • Features
      • Introduction
    • Guides
      • Add a Project
      • Edit a Project
      • Delete a Project
      • View Project Id
  • Ejento AI Shield
    • Introduction
  1. Guides

API Keys

Developer Portal#

Welcome to the Ejento AI Developer Portal tutorial. This guide will walk you through the steps to manage your API subscription keys, obtain your authentication token, test our APIs using the keys and token, and navigate the portal.

Accessing the Developer Portal#

To start, you need to access the Developer Portal.
1.
Login to your account.
2.
From the dashboard, navigate to the API KEYS section.

1. Go to the Admin Panel from the sidebar.#

Step 1 screenshot

2. Under Admin Panel in the Sidebar, Click on Settings#

Step 2 screenshot

3. Click on API Keys#

Step 3 screenshot

4. From here, copy your server URL, which you’ll need to pass as the baseURL when using the APIs.#

Step 4 screenshot

5. From here, you can copy your auth token, which you’ll need to include in the header as a Bearer token when using the APIs.#

Step 6 screenshot

Creating New API Key#

1. Click on "Create new secret key"#

Step 1 screenshot

2. Name your key in this field#

Step 1 screenshot

3. Here, you can see different permission scopes: All, Read Only, and Restricted#

Step 2 screenshot

4. Permission: All#

The user gets access to all the APIs
Step 3 screenshot

5. Permission: Read Only#

The user gets access to only GET requests
Step 4 screenshot

6. Permission: Restricted#

Category level Permissions:
None: No access to any operations in the category
Read: Access to only GET requests under that category
Write: Access to all the APIs under that category (GET, POST, PUT, DELETE, etc.)
Step 5 screenshot

7. Select Permission for each category#

Step 6 screenshot

8. Click on Create#

Step 7 screenshot

9. Click here to follow the link#

Step 4 screenshot

10. In the new tab, Click on Allow access to activate your key#

Step 6 screenshot

11. Copy your secret key and click on Done.#

The key will only be shown once, so make sure to copy and save it — you won’t be able to view it again.
Step 7 screenshot

12. Your new key will appear in the list of API keys.#

Step 8 screenshot

Testing API Key in the REST API Playground#

You can test your newly generated API keys using the API Playground on api.ejento.ai. This playground allows you to experiment with different API endpoints and see real-time responses using your keys.

1. Click on View API documentation, you'll be redirected to Ejento APIs #

Step 2 screenshot

2. Choose one of the endpoints to test your new key#

Step 3 screenshot

3. Click on Try it#

Step 4 screenshot

4. Click on this icon#

Step 24 screenshot

5. Click on your-server-name variable to set your dynamic base URL.#

Step 3 screenshot

6. Here, you’ll need to replace these variables with their actual values.#

Step 6 screenshot

7. Paste the values you copied and saved.#

Replace your-server-name with the Server URL you copied in step 4.
Replace your-api-key with the API Key you created.
Replace your-access-token with the Authorization Token you copied in step 5.
Step 27 screenshot

8. Click on Save & Exit#

Step 7 screenshot

9. Give the required parameters#

Step 11 screenshot

10. Click on Send#

Step 12 screenshot

11. The response from the API can be seen here#

Step 13 screenshot

Deleting API Key#

If you need to delete a key:
1.
Navigate to the Keys List.
2.
Click the Delete Key icon next to the key you want to remove.
3.
Confirm the deletion by clicking "Revoke" in the confirmation prompt.

1. Click the Delete Key icon next to the key you want to remove#

Step 2 screenshot

2. Click on "Revoke"#

Step 3 screenshot

3. Confirmation popup message that the key has been deleted#

Step 4 screenshot

Previous
View Chatlog & Chat thread Id
Next
Email Indexing