Ejento AI
HomeQuickstartGuidesRecipesREST APIsChangelogFAQs
HomeQuickstartGuidesRecipesREST APIsChangelogFAQs
Ejento AI
  1. Guides
  • 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
      • 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
      • View Corpus Id
      • View Document Id
      • Tagging
        • Corpus tagging
        • Document tagging
  • Tools
    • Features
      • Introduction
    • Guides
      • Configure RAG Tool
      • Configure Attachment Tool
      • Configure Web Search Tool
      • Configure API Tool
      • View Tool Id
  • 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
  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, test our APIs using the keys, 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. Click on Sign In#

Step 1 screenshot

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

Step 2 screenshot

3. Here is the Developer Portal Section#

Step 3 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. A popup with a key activation link appears#

Step 4 screenshot

10. Click here to follow the link#

Step 5 screenshot

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

Step 6 screenshot

12. Copy your secret key and click on "Done"#

Step 7 screenshot

13. 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 under the REST API section on docs.ejento. This playground allows you to experiment with different API endpoints and see real-time responses using your keys.

1. Server URL Configuration#

When testing the APIs, replace the your_server_name placeholder with this server URL. This URL serves as the base endpoint for all API requests during testing.
Step 1 screenshot

2. Click on View API documentation, you'll be redirected to REST API documentation#

Step 2 screenshot

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

Step 3 screenshot

4. Paste your new key in the Ocp-Apim-Subscription-Key field#

Step 4 screenshot

5. Inserting the Server URL#

Copy the provided server URL and paste it into the your_server_name field to ensure proper API functionality during testing.
Step 5 screenshot

6. Give the required parameters#

Step 6 screenshot

7. Click on Send API Request#

Step 7 screenshot

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

Step 8 screenshot

Deleting API Key#

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

1. Navigate to the API Keys List#

Step 1 screenshot

2. Click the delete icon next to the key you want to remove#

Step 2 screenshot

Click on "Revoke"#

Step 3 screenshot

The key has been removed from the API Keys List#

Step 4 screenshot

Previous
View Chatlog & Chat thread Id
Next
Email Indexing