🚀 REST API Documentation

📋 Introduction

Welcome to the Genii by Tolk.ai REST API documentation. This API provides a comprehensive set of endpoints for managing resources in your application. Our API follows REST principles and uses standard HTTP methods and status codes.

💡 Base URL: https://genii-api.tolk.ai/v1

📄 Content Type: All requests and responses use JSON format: Content-Type: application/json

🔐 Authentication

🔑 API Key Authentication

The API uses two API key authentication. Include your secret and your public API key in x-public-key and x-secret-key in your header using the followin scheme:

x-public-key: pk_...YOUR_PUBLIC_API_KEY
x-secret-key: sk_...YOUR_SECRET_API_KEY

📝 Getting Your API Key

1. Login on genii at https://genii.tolk.ai
2. Navigate to the API section in your settings : https://genii.tolk.ai/settings/api
3. Name and generate a new API key
4. Copy and securely store your public and secret API key

💻 Authentication Example

bash
curl -H "x-public-key: pk_...YOUR_PUBLIC_API_KEY" \\
     -H "x-secret-key: sk_...YOUR_SECRET_API_KEY" \\
     -H "Content-Type: application/json" \\
     <https://api.example.com/v1/users>

❌ Error Responses

Authentication errors return a 401 Unauthorized status: