Get an agent execution
curl --request GET \
--url https://api.tuyo.com/public/agent_executions/{id} \
--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/agent_executions/{id}"
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/agent_executions/{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.tuyo.com/public/agent_executions/{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>",
"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/agent_executions/{id}"
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/agent_executions/{id}")
.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/agent_executions/{id}")
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{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"podId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"transactionId": "<string>",
"status": "awaiting_signature",
"expiresAt": "2023-11-07T05:31:56Z",
"transactionHash": "<unknown>",
"summary": {
"kind": "send",
"recipient": "<string>",
"from": "<unknown>",
"to": "<unknown>",
"fees": [
"<unknown>"
]
},
"signing": {
"version": 1,
"method": "personal_sign",
"encoding": "hex",
"data": "<string>",
"expiresAt": "2023-11-07T05:31:56Z",
"submission": {
"method": "POST",
"path": "<string>",
"headers": {},
"body": {
"signature": null
}
}
},
"userOperation": {
"sender": "<unknown>",
"nonce": "<unknown>",
"factory": "<unknown>",
"factoryData": "<unknown>",
"callData": "<unknown>",
"callGasLimit": "<unknown>",
"verificationGasLimit": "<unknown>",
"preVerificationGas": "<unknown>",
"maxFeePerGas": "<unknown>",
"maxPriorityFeePerGas": "<unknown>",
"paymaster": "<unknown>",
"paymasterData": "<unknown>",
"paymasterVerificationGasLimit": "<unknown>",
"paymasterPostOpGasLimit": "<unknown>"
},
"chainId": 0
}{
"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>"
}
}API Reference
Get an agent execution
Requires account:read and the originating OAuth authorization; the original manager identity assertion is also required. submitted means queued or broadcast, settling means source inclusion with destination settlement pending. succeeded means financial completion. Signature material is never returned.
GET
/
agent_executions
/
{id}
Get an agent execution
curl --request GET \
--url https://api.tuyo.com/public/agent_executions/{id} \
--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/agent_executions/{id}"
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/agent_executions/{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.tuyo.com/public/agent_executions/{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>",
"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/agent_executions/{id}"
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/agent_executions/{id}")
.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/agent_executions/{id}")
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{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"podId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"transactionId": "<string>",
"status": "awaiting_signature",
"expiresAt": "2023-11-07T05:31:56Z",
"transactionHash": "<unknown>",
"summary": {
"kind": "send",
"recipient": "<string>",
"from": "<unknown>",
"to": "<unknown>",
"fees": [
"<unknown>"
]
},
"signing": {
"version": 1,
"method": "personal_sign",
"encoding": "hex",
"data": "<string>",
"expiresAt": "2023-11-07T05:31:56Z",
"submission": {
"method": "POST",
"path": "<string>",
"headers": {},
"body": {
"signature": null
}
}
},
"userOperation": {
"sender": "<unknown>",
"nonce": "<unknown>",
"factory": "<unknown>",
"factoryData": "<unknown>",
"callData": "<unknown>",
"callGasLimit": "<unknown>",
"verificationGasLimit": "<unknown>",
"preVerificationGas": "<unknown>",
"maxFeePerGas": "<unknown>",
"maxPriorityFeePerGas": "<unknown>",
"paymaster": "<unknown>",
"paymasterData": "<unknown>",
"paymasterVerificationGasLimit": "<unknown>",
"paymasterPostOpGasLimit": "<unknown>"
},
"chainId": 0
}{
"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.
Response
Successful response.