Getting Started with Unltd AI API

Introduction

Welcome to our API. We use a RESTful API that enables you to interact with our platform programmatically. This API supports standard HTTP verbs (GET, PATCH, POST, DELETE) to perform operations on our resources.

This guide will help you get started with our API, from authentication to making simple requests.

Authentication

All requests to our API must be authenticated. Authentication is handled by sending a Bearer token in the Authorization header of your HTTP requests.


    Authorization: Bearer YOUR_TOKEN_HERE

To acquire a Bearer token, you must first establish an "organization" via the dashboard. After the organization is created, go to the organization's profile, and select the "Tokens" tab. From there, click on the "Generate New Token" button, which opens the "Generate API Token" dialog box. Proceed by clicking "Yes, Generate!".

Your newly generated token will appear in the Tokens panel. To copy the token to your clipboard, simply click on the "clipboard" icon.

Making Requests

You can use any HTTP client to make requests to our API. Here's an example of a simple GET request to our /bots endpoint using the curl command-line tool:


    curl -X GET 'https://api.unltd.ai/v1/bots' -H 'Authorization: Bearer YOUR_TOKEN_HERE'

This request will retrieve a list of all bots.

Example Request

Below you will find an example of making a request to the /bots endpoint using different programming languages. Remember to replace 'YOUR_TOKEN_HERE' with your actual token.

API Example

Language

Organization Token

const fetch = require('node-fetch');

async function fetchApiData() {
  const response = await fetch('https://api.unltd.ai/v1/bots/', {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer ',
      'Content-Type': 'application/json',
    },
  });

  const data = await response.json();
  console.log(data);
}

fetchApiData();

Next Steps

Now that you've made your first request, you can start exploring the other endpoints in our API. We recommend you read the full API Documentation to get familiar with all the available endpoints and operations.