Search All Threads

curl --request GET \
  --url https://api.aisa.one/apis/v1/agentmail/threads/search \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.aisa.one/apis/v1/agentmail/threads/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/agentmail/threads/search",
  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 <token>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.aisa.one/apis/v1/agentmail/threads/search"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/agentmail/threads/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "count": 123,
  "threads": [
    {
      "inbox_id": "<string>",
      "thread_id": "<string>",
      "labels": [
        "<string>"
      ],
      "timestamp": "2023-11-07T05:31:56Z",
      "senders": [
        "<string>"
      ],
      "recipients": [
        "<string>"
      ],
      "last_message_id": "<string>",
      "message_count": 123,
      "size": 123,
      "updated_at": "2023-11-07T05:31:56Z",
      "created_at": "2023-11-07T05:31:56Z",
      "received_timestamp": "2023-11-07T05:31:56Z",
      "sent_timestamp": "2023-11-07T05:31:56Z",
      "subject": "<string>",
      "preview": "<string>",
      "attachments": [
        {
          "attachment_id": "<string>",
          "size": 123,
          "filename": "<string>",
          "content_type": "<string>",
          "content_disposition": "inline",
          "content_id": "<string>"
        }
      ],
      "highlights": {
        "from": [
          "<string>"
        ],
        "recipients": [
          "<string>"
        ],
        "subject": [
          "<string>"
        ],
        "text": [
          "<string>"
        ]
      }
    }
  ],
  "limit": 123,
  "next_page_token": "<string>"
}

{
  "name": "<string>",
  "errors": "<unknown>"
}

{
  "name": "<string>",
  "message": "<string>"
}

GET

https://api.aisa.one/apis/v1

agentmail

threads

Search All Threads

curl --request GET \
  --url https://api.aisa.one/apis/v1/agentmail/threads/search \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.aisa.one/apis/v1/agentmail/threads/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/agentmail/threads/search",
  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 <token>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.aisa.one/apis/v1/agentmail/threads/search"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/agentmail/threads/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "count": 123,
  "threads": [
    {
      "inbox_id": "<string>",
      "thread_id": "<string>",
      "labels": [
        "<string>"
      ],
      "timestamp": "2023-11-07T05:31:56Z",
      "senders": [
        "<string>"
      ],
      "recipients": [
        "<string>"
      ],
      "last_message_id": "<string>",
      "message_count": 123,
      "size": 123,
      "updated_at": "2023-11-07T05:31:56Z",
      "created_at": "2023-11-07T05:31:56Z",
      "received_timestamp": "2023-11-07T05:31:56Z",
      "sent_timestamp": "2023-11-07T05:31:56Z",
      "subject": "<string>",
      "preview": "<string>",
      "attachments": [
        {
          "attachment_id": "<string>",
          "size": 123,
          "filename": "<string>",
          "content_type": "<string>",
          "content_disposition": "inline",
          "content_id": "<string>"
        }
      ],
      "highlights": {
        "from": [
          "<string>"
        ],
        "recipients": [
          "<string>"
        ],
        "subject": [
          "<string>"
        ],
        "text": [
          "<string>"
        ]
      }
    }
  ],
  "limit": 123,
  "next_page_token": "<string>"
}

{
  "name": "<string>",
  "errors": "<unknown>"
}

{
  "name": "<string>",
  "message": "<string>"
}

Full-text search over threads in every inbox in the account. Returns count, limit, next_page_token and threads; page with next_page_token. Same fields as get_agentmail_threads, which is the one to use for everything in date order. This is the organization-wide view spanning every inbox in the account. Every AIsa caller shares one AgentMail account, so this reaches inboxes other callers created; the inbox-scoped twin get_agentmail_inbox_threads_search is the one to use when a single inbox is meant.

Example

curl -X GET "https://api.aisa.one/apis/v1/agentmail/threads/search" \
  -H "Authorization: Bearer YOUR_API_KEY"

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Authorization

string

required

Bearer authentication

Query Parameters

string

required

Full-text search query. Matched against the sender, recipients, and subject (substring) and the message body (tokenized full text).

limit

integer

Limit of number of items returned.

page_token

string

Page token for pagination.

before

string<date-time>

Timestamp before which to filter by.

after

string<date-time>

Timestamp after which to filter by.

Response

Response with status 200

count

integer

required

Number of items returned.

threads

SearchThreadItem · object[]

required

Ordered by relevance, best match first.

Show child attributes

limit

integer

Limit of number of items returned.

next_page_token

string

Page token for pagination.

Overview

Chat API

Embeddings & Rerank

Search API

Perplexity API

Financial API

Twitter API

Reddit API

Instagram API

Pinterest API

Scholar API

WaveInflu API

Prediction Market API

CoinGecko

DataForSEO

AgentMail

Apollo

Ahrefs API

Semrush API

Foreplay API

CNPJá API

SimilarWeb API

Essentials

Search All Threads

Example

Authorizations

Headers

Query Parameters

Response

​Example

Authorizations

Headers

Query Parameters

Response

Example