curl https://api.saturn-pay.com/v1/agents/agt_abc123 \
-H "Authorization: Bearer sk_agt_..."
const agentId = 'agt_abc123';
const response = await fetch(`https://api.saturn-pay.com/v1/agents/${agentId}`, {
headers: { 'Authorization': 'Bearer sk_agt_...' }
});
const agent = await response.json();
{
"id": "agt_abc123",
"name": "research-agent",
"killed": false,
"createdAt": "2024-01-15T10:30:00Z",
"lastActiveAt": "2024-01-20T14:22:00Z"
}
{
"error": {
"code": "NOT_FOUND",
"message": "Agent not found"
}
}
Agents
Get Agent
Get a specific agent by ID
GET
/
v1
/
agents
/
{id}
curl https://api.saturn-pay.com/v1/agents/agt_abc123 \
-H "Authorization: Bearer sk_agt_..."
const agentId = 'agt_abc123';
const response = await fetch(`https://api.saturn-pay.com/v1/agents/${agentId}`, {
headers: { 'Authorization': 'Bearer sk_agt_...' }
});
const agent = await response.json();
{
"id": "agt_abc123",
"name": "research-agent",
"killed": false,
"createdAt": "2024-01-15T10:30:00Z",
"lastActiveAt": "2024-01-20T14:22:00Z"
}
{
"error": {
"code": "NOT_FOUND",
"message": "Agent not found"
}
}
Returns details for a specific agent.
Path Parameters
string
required
The agent ID (e.g.,
agt_abc123)Response
string
Unique agent identifier
string
Agent name
boolean
Whether the kill switch is active
string
ISO 8601 timestamp
string
Last API call timestamp
curl https://api.saturn-pay.com/v1/agents/agt_abc123 \
-H "Authorization: Bearer sk_agt_..."
const agentId = 'agt_abc123';
const response = await fetch(`https://api.saturn-pay.com/v1/agents/${agentId}`, {
headers: { 'Authorization': 'Bearer sk_agt_...' }
});
const agent = await response.json();
{
"id": "agt_abc123",
"name": "research-agent",
"killed": false,
"createdAt": "2024-01-15T10:30:00Z",
"lastActiveAt": "2024-01-20T14:22:00Z"
}
{
"error": {
"code": "NOT_FOUND",
"message": "Agent not found"
}
}