curl --request GET \
--url https://api.tuyo.com/public/managed_pods \
--header 'Authorization: Bearer <token>' \
--header 'Tuyo-API-Version: <tuyo-api-version>' \
--header 'Tuyo-Agent-Identity: <tuyo-agent-identity>'import requests
url = "https://api.tuyo.com/public/managed_pods"
headers = {
"Tuyo-API-Version": "<tuyo-api-version>",
"Tuyo-Agent-Identity": "<tuyo-agent-identity>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'Tuyo-API-Version': '<tuyo-api-version>',
'Tuyo-Agent-Identity': '<tuyo-agent-identity>',
Authorization: 'Bearer <token>'
}
};
fetch('https://api.tuyo.com/public/managed_pods', 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.tuyo.com/public/managed_pods",
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>",
"Tuyo-API-Version: <tuyo-api-version>",
"Tuyo-Agent-Identity: <tuyo-agent-identity>"
],
]);
$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.tuyo.com/public/managed_pods"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Tuyo-API-Version", "<tuyo-api-version>")
req.Header.Add("Tuyo-Agent-Identity", "<tuyo-agent-identity>")
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.tuyo.com/public/managed_pods")
.header("Tuyo-API-Version", "<tuyo-api-version>")
.header("Tuyo-Agent-Identity", "<tuyo-agent-identity>")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.tuyo.com/public/managed_pods")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Tuyo-API-Version"] = '<tuyo-api-version>'
request["Tuyo-Agent-Identity"] = '<tuyo-agent-identity>'
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"items": [
"<unknown>"
],
"page": {
"endCursor": "<string>",
"hasNextPage": true
},
"meta": {
"asOf": "2023-11-07T05:31:56Z"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true
},
"meta": {
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true
},
"meta": {
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true
},
"meta": {
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true
},
"meta": {
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true
},
"meta": {
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true
},
"meta": {
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true
},
"meta": {
"requestId": "<string>"
}
}List pods managed by the authenticated agent
Returns valid owner-approved management permissions for this signing key and the originating OAuth authorization, including before any on-chain installation. Pass accountId as podId when preparing an agent execution. Expired or revoked permissions and deleted pods are omitted. Empty results mean this key has no matching management permissions on this authorization. Chain installation is tracked separately; execution still validates current permission and chain state.
curl --request GET \
--url https://api.tuyo.com/public/managed_pods \
--header 'Authorization: Bearer <token>' \
--header 'Tuyo-API-Version: <tuyo-api-version>' \
--header 'Tuyo-Agent-Identity: <tuyo-agent-identity>'import requests
url = "https://api.tuyo.com/public/managed_pods"
headers = {
"Tuyo-API-Version": "<tuyo-api-version>",
"Tuyo-Agent-Identity": "<tuyo-agent-identity>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'Tuyo-API-Version': '<tuyo-api-version>',
'Tuyo-Agent-Identity': '<tuyo-agent-identity>',
Authorization: 'Bearer <token>'
}
};
fetch('https://api.tuyo.com/public/managed_pods', 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.tuyo.com/public/managed_pods",
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>",
"Tuyo-API-Version: <tuyo-api-version>",
"Tuyo-Agent-Identity: <tuyo-agent-identity>"
],
]);
$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.tuyo.com/public/managed_pods"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Tuyo-API-Version", "<tuyo-api-version>")
req.Header.Add("Tuyo-Agent-Identity", "<tuyo-agent-identity>")
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.tuyo.com/public/managed_pods")
.header("Tuyo-API-Version", "<tuyo-api-version>")
.header("Tuyo-Agent-Identity", "<tuyo-agent-identity>")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.tuyo.com/public/managed_pods")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Tuyo-API-Version"] = '<tuyo-api-version>'
request["Tuyo-Agent-Identity"] = '<tuyo-agent-identity>'
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"items": [
"<unknown>"
],
"page": {
"endCursor": "<string>",
"hasNextPage": true
},
"meta": {
"asOf": "2023-11-07T05:31:56Z"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true
},
"meta": {
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true
},
"meta": {
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true
},
"meta": {
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true
},
"meta": {
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true
},
"meta": {
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true
},
"meta": {
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true
},
"meta": {
"requestId": "<string>"
}
}Headers
Opaque five-minute proof from the original agent key. Run tuyo-signer identity --signer agent offline and use its token as this header; --json or MCP returns headers.Tuyo-Agent-Identity. Scope defaults to all, adding no restriction to existing permissions; other scopes are currently rejected. OAuth and operation signatures remain separate requirements.