Get Any Thread

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

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

fetch('https://api.aisa.one/apis/v1/agentmail/threads/{thread_id}', 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/{thread_id}",
  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/{thread_id}"

	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/{thread_id}")

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

{
  "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",
  "messages": [
    {
      "inbox_id": "<string>",
      "thread_id": "<string>",
      "message_id": "<string>",
      "labels": [
        "<string>"
      ],
      "timestamp": "2023-11-07T05:31:56Z",
      "from": "<string>",
      "to": [
        "<string>"
      ],
      "size": 123,
      "updated_at": "2023-11-07T05:31:56Z",
      "created_at": "2023-11-07T05:31:56Z",
      "reply_to": [
        "<string>"
      ],
      "cc": [
        "<string>"
      ],
      "bcc": [
        "<string>"
      ],
      "subject": "<string>",
      "preview": "<string>",
      "text": "<string>",
      "html": "<string>",
      "extracted_text": "<string>",
      "extracted_html": "<string>",
      "attachments": [
        {
          "attachment_id": "<string>",
          "size": 123,
          "filename": "<string>",
          "content_type": "<string>",
          "content_disposition": "inline",
          "content_id": "<string>"
        }
      ],
      "in_reply_to": "<string>",
      "references": [
        "<string>"
      ],
      "headers": {}
    }
  ],
  "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>"
    }
  ]
}

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

GET

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

agentmail

threads

{thread_id}

Get Any Thread

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

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

fetch('https://api.aisa.one/apis/v1/agentmail/threads/{thread_id}', 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/{thread_id}",
  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/{thread_id}"

	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/{thread_id}")

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

{
  "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",
  "messages": [
    {
      "inbox_id": "<string>",
      "thread_id": "<string>",
      "message_id": "<string>",
      "labels": [
        "<string>"
      ],
      "timestamp": "2023-11-07T05:31:56Z",
      "from": "<string>",
      "to": [
        "<string>"
      ],
      "size": 123,
      "updated_at": "2023-11-07T05:31:56Z",
      "created_at": "2023-11-07T05:31:56Z",
      "reply_to": [
        "<string>"
      ],
      "cc": [
        "<string>"
      ],
      "bcc": [
        "<string>"
      ],
      "subject": "<string>",
      "preview": "<string>",
      "text": "<string>",
      "html": "<string>",
      "extracted_text": "<string>",
      "extracted_html": "<string>",
      "attachments": [
        {
          "attachment_id": "<string>",
          "size": 123,
          "filename": "<string>",
          "content_type": "<string>",
          "content_disposition": "inline",
          "content_id": "<string>"
        }
      ],
      "in_reply_to": "<string>",
      "references": [
        "<string>"
      ],
      "headers": {}
    }
  ],
  "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>"
    }
  ]
}

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

Fetches one thread by id without naming an inbox: thread_id, inbox_id, labels, timestamp, received_timestamp, sent_timestamp, senders, recipients, subject, preview, attachments and messages. Because no inbox is named, this resolves against the whole account. Every AIsa caller shares one AgentMail account, so this reaches inboxes other callers created, so a thread id that is not yours still resolves — check the returned inbox_id. The scoped twin is get_agentmail_inbox_thread.

Example

curl -X GET "https://api.aisa.one/apis/v1/agentmail/threads/{thread_id}" \
  -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

Path Parameters

thread_id

string

required

ID of thread.

Response

Response with status 200

inbox_id

string

required

The ID of the inbox.

thread_id

string

required

ID of thread.

labels

string[]

required

Labels of thread.

timestamp

string<date-time>

required

Timestamp of last sent or received message.

senders

string[]

required

Senders in thread. In format username@domain.com or Display Name <username@domain.com>.

recipients

string[]

required

Recipients in thread. In format username@domain.com or Display Name <username@domain.com>.

last_message_id

string

required

ID of last message in thread.

message_count

integer

required

Number of messages in thread.

size

integer

required

Size of thread in bytes.

updated_at

string<date-time>

required

Time at which thread was last updated.

created_at

string<date-time>

required

Time at which thread was created.

messages

Message · object[]

required

Messages in thread. Ordered by timestamp ascending.

Show child attributes

received_timestamp

string<date-time>

Timestamp of last received message.

sent_timestamp

string<date-time>

Timestamp of last sent message.

subject

string

Subject of thread.

preview

string

Text preview of last message in thread.

attachments

Attachment · object[]

Attachments in thread.

Show child attributes

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

Get Any Thread

Example

Authorizations

Headers

Path Parameters

Response

​Example

Authorizations

Headers

Path Parameters

Response

Example