Get Result
curl --request GET \
--url https://agentos.useparagon.com/api/tools/projects/{projectId}/results/{resultId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://agentos.useparagon.com/api/tools/projects/{projectId}/results/{resultId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://agentos.useparagon.com/api/tools/projects/{projectId}/results/{resultId}', 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://agentos.useparagon.com/api/tools/projects/{projectId}/results/{resultId}",
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://agentos.useparagon.com/api/tools/projects/{projectId}/results/{resultId}"
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://agentos.useparagon.com/api/tools/projects/{projectId}/results/{resultId}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://agentos.useparagon.com/api/tools/projects/{projectId}/results/{resultId}")
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{
"resultId": "res_0123456789abcdef0123456789abcdef",
"executionId": "exec_0123456789abcdef0123456789abcdef",
"tool": "EXAMPLE_LIST_RECORDS",
"integration": "example",
"byteSize": 42,
"tokenEstimate": 20,
"shape": "records",
"recordCount": 1,
"recordsPointer": "/records",
"totalChars": null,
"schema": {
"type": "object"
},
"expiresAt": "2026-10-06T21:00:00.000Z",
"tokenBudget": {
"fullOutputTokens": 20,
"returnedTokens": 12,
"savedTokens": 8
}
}{
"error": {
"code": "REQUEST_INVALID",
"message": "The request payload failed validation.",
"hint": "Correct the fields named in details and retry.",
"retryable": false,
"requestId": "req_01hxyz",
"details": [
{
"field": "query",
"issue": "query should not be empty"
}
]
}
}{
"error": {
"code": "REQUEST_INVALID",
"message": "The request payload failed validation.",
"hint": "Correct the fields named in details and retry.",
"retryable": false,
"requestId": "req_01hxyz",
"details": [
{
"field": "query",
"issue": "query should not be empty"
}
]
}
}Tools
Get Result
Read the envelope for a stored tool result.
GET
/
api
/
tools
/
projects
/
{projectId}
/
results
/
{resultId}
Get Result
curl --request GET \
--url https://agentos.useparagon.com/api/tools/projects/{projectId}/results/{resultId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://agentos.useparagon.com/api/tools/projects/{projectId}/results/{resultId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://agentos.useparagon.com/api/tools/projects/{projectId}/results/{resultId}', 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://agentos.useparagon.com/api/tools/projects/{projectId}/results/{resultId}",
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://agentos.useparagon.com/api/tools/projects/{projectId}/results/{resultId}"
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://agentos.useparagon.com/api/tools/projects/{projectId}/results/{resultId}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://agentos.useparagon.com/api/tools/projects/{projectId}/results/{resultId}")
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{
"resultId": "res_0123456789abcdef0123456789abcdef",
"executionId": "exec_0123456789abcdef0123456789abcdef",
"tool": "EXAMPLE_LIST_RECORDS",
"integration": "example",
"byteSize": 42,
"tokenEstimate": 20,
"shape": "records",
"recordCount": 1,
"recordsPointer": "/records",
"totalChars": null,
"schema": {
"type": "object"
},
"expiresAt": "2026-10-06T21:00:00.000Z",
"tokenBudget": {
"fullOutputTokens": 20,
"returnedTokens": 12,
"savedTokens": 8
}
}{
"error": {
"code": "REQUEST_INVALID",
"message": "The request payload failed validation.",
"hint": "Correct the fields named in details and retry.",
"retryable": false,
"requestId": "req_01hxyz",
"details": [
{
"field": "query",
"issue": "query should not be empty"
}
]
}
}{
"error": {
"code": "REQUEST_INVALID",
"message": "The request payload failed validation.",
"hint": "Correct the fields named in details and retry.",
"retryable": false,
"requestId": "req_01hxyz",
"details": [
{
"field": "query",
"issue": "query should not be empty"
}
]
}
}Returns a stored envelope for a tool output rather than the full provider payload.
Use Get Result Rows when
shape is records, and Get Result Content when shape is text to get output details.Authorizations
Your Paragon User Token (JWT), which you can generate using your project's signing keys.
Response
Stored result envelope.