List Account API Keys
curl --request GET \
--url https://api.aisa.one/apis/v1/agentmail/api-keys \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aisa.one/apis/v1/agentmail/api-keys"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aisa.one/apis/v1/agentmail/api-keys', 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/api-keys",
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/api-keys"
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))
}HttpResponse<String> response = Unirest.get("https://api.aisa.one/apis/v1/agentmail/api-keys")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/agentmail/api-keys")
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,
"api_keys": [
{
"api_key_id": "<string>",
"prefix": "<string>",
"name": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"pod_id": "<string>",
"inbox_id": "<string>",
"used_at": "2023-11-07T05:31:56Z",
"permissions": {
"inbox_read": true,
"inbox_create": true,
"inbox_update": true,
"inbox_delete": true,
"thread_read": true,
"thread_delete": true,
"message_read": true,
"message_send": true,
"message_update": true,
"label_spam_read": true,
"label_blocked_read": true,
"label_trash_read": true,
"draft_read": true,
"draft_create": true,
"draft_update": true,
"draft_delete": true,
"draft_send": true,
"webhook_read": true,
"webhook_create": true,
"webhook_update": true,
"webhook_delete": true,
"domain_read": true,
"domain_create": true,
"domain_update": true,
"domain_delete": true,
"list_entry_read": true,
"list_entry_create": true,
"list_entry_delete": true,
"metrics_read": true,
"api_key_read": true,
"api_key_create": true,
"api_key_delete": true,
"pod_read": true,
"pod_create": true,
"pod_delete": true
}
}
],
"next_page_token": "<string>"
}Account Configuration
List Account API Keys
List Account API Keys
GET
https://api.aisa.one/apis/v1
/
agentmail
/
api-keys
List Account API Keys
curl --request GET \
--url https://api.aisa.one/apis/v1/agentmail/api-keys \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aisa.one/apis/v1/agentmail/api-keys"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aisa.one/apis/v1/agentmail/api-keys', 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/api-keys",
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/api-keys"
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))
}HttpResponse<String> response = Unirest.get("https://api.aisa.one/apis/v1/agentmail/api-keys")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/agentmail/api-keys")
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,
"api_keys": [
{
"api_key_id": "<string>",
"prefix": "<string>",
"name": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"pod_id": "<string>",
"inbox_id": "<string>",
"used_at": "2023-11-07T05:31:56Z",
"permissions": {
"inbox_read": true,
"inbox_create": true,
"inbox_update": true,
"inbox_delete": true,
"thread_read": true,
"thread_delete": true,
"message_read": true,
"message_send": true,
"message_update": true,
"label_spam_read": true,
"label_blocked_read": true,
"label_trash_read": true,
"draft_read": true,
"draft_create": true,
"draft_update": true,
"draft_delete": true,
"draft_send": true,
"webhook_read": true,
"webhook_create": true,
"webhook_update": true,
"webhook_delete": true,
"domain_read": true,
"domain_create": true,
"domain_update": true,
"domain_delete": true,
"list_entry_read": true,
"list_entry_create": true,
"list_entry_delete": true,
"metrics_read": true,
"api_key_read": true,
"api_key_create": true,
"api_key_delete": true,
"pod_read": true,
"pod_create": true,
"pod_delete": true
}
}
],
"next_page_token": "<string>"
}Lists API key metadata for the AgentMail account:
count, next_page_token and api_keys, each with api_key_id, prefix, name, pod_id, inbox_id, used_at, permissions and created_at. The key secret itself is never returned, only its prefix. 🔴 This is the account-management surface, not a per-caller one. Every AIsa caller shares one AgentMail account, so this reaches inboxes other callers created, so the keys listed are the AIsa platform’s own, not yours. Nothing in normal mail workflows needs this — use get_agentmail_inboxes to find inboxes and get_agentmail_inbox_messages to read mail.
Example
curl -X GET "https://api.aisa.one/apis/v1/agentmail/api-keys" \
-H "Authorization: Bearer YOUR_API_KEY"
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
Bearer authentication
Query Parameters
Limit of number of items returned.
Page token for pagination.
Sort in ascending temporal order.