List And Create 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{
"api_keys": [
{
"api_key_id": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"name": "<string>",
"prefix": "<string>",
"type": "bearer",
"updated_at": "2023-11-07T05:31:56Z",
"expires_at": "2023-11-07T05:31:56Z",
"inbox_id": "<string>",
"permissions": {
"account_update": true,
"api_key_create": true,
"api_key_delete": true,
"api_key_read": true,
"api_key_update": true,
"app_connect": true,
"app_share_owner": true,
"calendar_event_create": true,
"calendar_event_delete": true,
"calendar_event_read": true,
"calendar_event_update": true,
"calendar_read": true,
"calendar_update": true,
"domain_create": true,
"domain_delete": true,
"domain_read": true,
"domain_update": true,
"draft_create": true,
"draft_delete": true,
"draft_read": true,
"draft_send": true,
"draft_update": true,
"inbox_create": true,
"inbox_delete": true,
"inbox_read": true,
"inbox_update": true,
"label_blocked_read": true,
"label_spam_read": true,
"label_trash_read": true,
"label_unauthenticated_read": true,
"list_entry_create": true,
"list_entry_delete": true,
"list_entry_read": true,
"message_delete": true,
"message_read": true,
"message_reply": true,
"message_send": true,
"message_update": true,
"metrics_read": true,
"pod_create": true,
"pod_delete": true,
"pod_read": true,
"pod_update": true,
"webhook_create": true,
"webhook_delete": true,
"webhook_read": true,
"webhook_update": true
},
"pod_id": "<string>",
"used_at": "2023-11-07T05:31:56Z"
}
],
"count": 123,
"next_page_token": "<string>"
}List And Create API Keys
List Account API Keys
GET
https://api.aisa.one
/
apis
/
v1
/
agentmail
/
api-keys
List And Create 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{
"api_keys": [
{
"api_key_id": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"name": "<string>",
"prefix": "<string>",
"type": "bearer",
"updated_at": "2023-11-07T05:31:56Z",
"expires_at": "2023-11-07T05:31:56Z",
"inbox_id": "<string>",
"permissions": {
"account_update": true,
"api_key_create": true,
"api_key_delete": true,
"api_key_read": true,
"api_key_update": true,
"app_connect": true,
"app_share_owner": true,
"calendar_event_create": true,
"calendar_event_delete": true,
"calendar_event_read": true,
"calendar_event_update": true,
"calendar_read": true,
"calendar_update": true,
"domain_create": true,
"domain_delete": true,
"domain_read": true,
"domain_update": true,
"draft_create": true,
"draft_delete": true,
"draft_read": true,
"draft_send": true,
"draft_update": true,
"inbox_create": true,
"inbox_delete": true,
"inbox_read": true,
"inbox_update": true,
"label_blocked_read": true,
"label_spam_read": true,
"label_trash_read": true,
"label_unauthenticated_read": true,
"list_entry_create": true,
"list_entry_delete": true,
"list_entry_read": true,
"message_delete": true,
"message_read": true,
"message_reply": true,
"message_send": true,
"message_update": true,
"metrics_read": true,
"pod_create": true,
"pod_delete": true,
"pod_read": true,
"pod_update": true,
"webhook_create": true,
"webhook_delete": true,
"webhook_read": true,
"webhook_update": true
},
"pod_id": "<string>",
"used_at": "2023-11-07T05:31:56Z"
}
],
"count": 123,
"next_page_token": "<string>"
}Lists API key metadata for the AgentMail account:
Currently disabled.
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"
Request contract
- Method and path: GET /apis/v1/agentmail/api-keys
- Availability: disabled
- Request URL template:
https://api.aisa.one/apis/v1/agentmail/api-keys - ascending: query; optional
- limit: query; optional
- page_token: query; optional
- type: query; optional
{
"operationId": "get_agentmail_api_keys",
"method": "GET",
"path": "/apis/v1/agentmail/api-keys",
"servers": [
{
"url": "https://api.aisa.one"
}
],
"parameters": [
{
"in": "query",
"name": "ascending",
"required": false,
"schema": {
"description": "Sort in ascending temporal order.",
"title": "Ascending",
"type": "boolean"
}
},
{
"in": "query",
"name": "limit",
"required": false,
"schema": {
"description": "Limit of number of items returned.",
"title": "Limit",
"type": "integer"
}
},
{
"in": "query",
"name": "page_token",
"required": false,
"schema": {
"description": "Page token for pagination.",
"title": "PageToken",
"type": "string"
}
},
{
"description": "Restrict the list to one credential family. Omit for every family.",
"in": "query",
"name": "type",
"required": false,
"schema": {
"enum": [
"bearer",
"public_key"
],
"title": "ApiKeyType",
"type": "string"
}
}
],
"security": [
{
"bearerAuth": []
}
],
"x-aisa-status": "disabled",
"components": {
"securitySchemes": {
"bearerAuth": {
"scheme": "bearer",
"type": "http"
}
}
}
}
Cost and request rules
Historical archive: disabled, cannot be called, and no price is published.Authorizations
Query Parameters
Response
Response with status 200