List Agents

GET /api/agents

Lists all agents with support for searching, filtering, and pagination.

Code Examples

cURL

curl --request GET \
  --url 'https://tess.pareto.io/api/agents' \
  --header 'Authorization: Bearer YOUR_API_KEY'

Node.js

const axios = require('axios');

const config = {
  method: 'get',
  url: 'https://tess.pareto.io/api/agents',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
};

try {
  const response = await axios(config);
  console.log(response.data);
} catch (error) {
  console.error(error);
}

Python

import requests

url = "https://tess.pareto.io/api/agents"
headers = {
    "Authorization": "Bearer YOUR_API_KEY"
}

response = requests.get(url, headers=headers)
print(response.json())

PHP

<?php
$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://tess.pareto.io/api/agents",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer YOUR_API_KEY"
  ]
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "Error: " . $err;
} else {
  echo $response;
}

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://tess.pareto.io/api/agents"))
    .header("Authorization", "Bearer YOUR_API_KEY")
    .GET()
    .build();

HttpResponse<String> response = client.send(request,
    HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

Go

package main

import (
    "fmt"
    "io/ioutil"
    "net/http"
)

func main() {
    client := &http.Client{}
    req, err := http.NewRequest("GET", "https://tess.pareto.io/api/agents", nil)
    if err != nil {
        fmt.Println(err)
        return
    }
    
    req.Header.Add("Authorization", "Bearer YOUR_API_KEY")
    
    resp, err := client.Do(req)
    if err != nil {
        fmt.Println(err)
        return
    }
    defer resp.Body.Close()
    
    body, err := ioutil.ReadAll(resp.Body)
    if err != nil {
        fmt.Println(err)
        return
    }
    
    fmt.Println(string(body))
}

.NET

using System;
using System.Net.Http;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        using (var client = new HttpClient())
        {
            client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");
            
            try
            {
                var response = await client.GetAsync("https://tess.pareto.io/api/agents");
                response.EnsureSuccessStatusCode();
                string responseBody = await response.Content.ReadAsStringAsync();
                Console.WriteLine(responseBody);
            }
            catch(HttpRequestException e)
            {
                Console.WriteLine("\nException Caught!");
                Console.WriteLine("Message :{0} ",e.Message);
            }
        }
    }
}

Ruby

require 'uri'
require 'net/http'
require 'json'


uri = URI('https://tess.pareto.io/api/agents')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request['Authorization'] = 'Bearer YOUR_API_KEY'

response = http.request(request)
puts response.read_body

Headers

Parameter	Type	Required	Description
x-workspace-id	integer	No	ID of the workspace. If not provided, the user's selected workspace will be used.

Note: This field will be required in a future release of the API. It is highly recommended to set it now to ensure compatibility with future updates.

Query Parameters

Parameter	Type	Required	Description
q	string	No	Search agents by title, description and long description
type	string	No	Filter by agents type (chat, image, text, video)
page	integer	No	Current page (default: 1)
per_page	integer	No	Number of items per page (default: 15)

Response

{
"current_page": 1,
"data": [
  {
    "id": 8794,
    "title": "Tess AI - API Docs Helper",
    "description": null,
    "long_description": null,
    "workspace_id": 11,
    "visibility": "public",
    "slug": "tess-ai-docs-helper-pB9ujA",
    "active": 1,
    "type": "chat",
    "questions": [
      {
        "type": "select",
        "name": "temperature",
        "description": "Let Tess know if you want her to be more objective or more creative with her responses.",
        "required": true,
        "options": [
          "0",
          "0.25",
          "0.5",
          "0.75",
          "1"
        ]
      },
      {
        "type": "select",
        "name": "model",
        "description": "Choose the Model version",
        "required": true,
        "options": [
          "gpt-4o-mini",
          "gpt-4o",
          "tess-5",
          "tess-ai-3",
          "gpt-o1-preview",
          "gpt-o1-mini",
          "gemini-2.0-flash",
          "gemini-1.5-flash",
          "gemini-1.5-pro",
          "claude-3-5-haiku-latest",
          "claude-3-5-sonnet-20240620",
          "claude-3-5-sonnet-latest",
          "claude-3-opus-20240229",
          "meta-llama-3.1-405b-instruct",
          "meta-llama-3-70b-instruct",
          "meta-llama-3-8b-instruct",
          "cohere-command-r",
          "cohere-command-r-plus",
          "gpt-3.5-turbo",
          "gpt-4-turbo",
          "claude-3-haiku-20240307",
          "claude-3-sonnet-20240229",
          "gemini-1.0-pro",
          "llama-2-13b-chat",
          "llama-2-70b-chat"
        ]
      },
      {
        "type": "select",
        "name": "tools",
        "description": "Choose the Model version",
        "required": true,
        "options": [
          "no-tools",
          "internet",
          "twitter",
          "wikipedia",
          "quora",
          "reddit",
          "medium",
          "linkedin",
          "instagram",
          "facebook"
        ]
      },
      {
        "type": "number",
        "name": "root_id",
        "description": "The stored session id to continue conversation.",
        "required": false
      },
      {
        "type": "array",
        "name": "messages",
        "description": "The list of messages in the chat history. Use a list of objects with role and content, same as OpenAI API.",
        "required": true
      }
    ],
    "created_at": "2025-01-05T18:09:18.000000Z",
    "updated_at": "2025-01-05T18:45:31.000000Z",
    "created_by": 13
  }
],
"first_page_url": "https://tess.pareto.io/api/agents?page=1",
"from": 1,
"last_page": 1,
"last_page_url": "https://tess.pareto.io/api/agents?page=1",
"links": [
  {
    "url": null,
    "label": "pagination.previous",
    "active": false
  },
  {
    "url": "https://tess.pareto.io/api/agents?page=1",
    "label": "1",
    "active": true
  },
  {
    "url": null,
    "label": "pagination.next",
    "active": false
  }
],
"next_page_url": null,
"path": "https://tess.pareto.io/api/agents",
"per_page": 15,
"prev_page_url": null,
"to": 1,
"total": 1
}

Try it out!

Authentication

This endpoint requires Bearer token authentication.

Test Endpoint

q

type

page

per_page