curl --request GET \
--url https://api.runflow.ai/api/v1/runtime/agents/{id}import requests
url = "https://api.runflow.ai/api/v1/runtime/agents/{id}"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.runflow.ai/api/v1/runtime/agents/{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.runflow.ai/api/v1/runtime/agents/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$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.runflow.ai/api/v1/runtime/agents/{id}"
req, _ := http.NewRequest("GET", url, nil)
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.runflow.ai/api/v1/runtime/agents/{id}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.runflow.ai/api/v1/runtime/agents/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "Customer Support Bot",
"description": "AI-powered customer support agent",
"category": "CUSTOMER_SUPPORT",
"status": "ACTIVE",
"code": "export function main() { return \"Hello World\"; }",
"language": "typescript",
"branch": "main",
"tags": [
"ai",
"customer-support",
"chatbot"
],
"createdAt": "2025-01-01T00:00:00.000Z",
"updatedAt": "2025-01-01T00:00:00.000Z",
"tenantId": "123e4567-e89b-12d3-a456-426614174000",
"userId": "123e4567-e89b-12d3-a456-426614174000",
"subcategory": "TIER_1_SUPPORT",
"lastDeploy": "2025-01-01T00:00:00.000Z",
"logo": "https://example.com/logo.png",
"repositoryUrl": "https://github.com/user/agent-repo",
"endpointUrl": "https://chatbot.acme.runflow.ai",
"fileTree": [
{
"name": "src",
"type": "folder",
"children": [
{
"name": "index.ts",
"type": "file",
"content": "export function main() { return \"Hello World\"; }"
}
]
}
],
"commit": "abc123def456",
"stagingCommit": "2025-01-01T00-00-00-000Z",
"stagingEndpointUrl": "https://staging.runflow.ai/agent/abc123",
"_count": {
"executions": 15,
"dataSources": 3,
"triggers": 2
},
"repositoryName": "agent-repo",
"scheduleArn": "arn:aws:scheduler:us-east-1:123456789012:schedule/default/my-schedule",
"newEngine": true
}Get agent by ID (CLI/SDK)
Retrieves detailed information about a specific agent.
curl --request GET \
--url https://api.runflow.ai/api/v1/runtime/agents/{id}import requests
url = "https://api.runflow.ai/api/v1/runtime/agents/{id}"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.runflow.ai/api/v1/runtime/agents/{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.runflow.ai/api/v1/runtime/agents/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$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.runflow.ai/api/v1/runtime/agents/{id}"
req, _ := http.NewRequest("GET", url, nil)
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.runflow.ai/api/v1/runtime/agents/{id}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.runflow.ai/api/v1/runtime/agents/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"id": "123e4567-e89b-12d3-a456-426614174000",
"name": "Customer Support Bot",
"description": "AI-powered customer support agent",
"category": "CUSTOMER_SUPPORT",
"status": "ACTIVE",
"code": "export function main() { return \"Hello World\"; }",
"language": "typescript",
"branch": "main",
"tags": [
"ai",
"customer-support",
"chatbot"
],
"createdAt": "2025-01-01T00:00:00.000Z",
"updatedAt": "2025-01-01T00:00:00.000Z",
"tenantId": "123e4567-e89b-12d3-a456-426614174000",
"userId": "123e4567-e89b-12d3-a456-426614174000",
"subcategory": "TIER_1_SUPPORT",
"lastDeploy": "2025-01-01T00:00:00.000Z",
"logo": "https://example.com/logo.png",
"repositoryUrl": "https://github.com/user/agent-repo",
"endpointUrl": "https://chatbot.acme.runflow.ai",
"fileTree": [
{
"name": "src",
"type": "folder",
"children": [
{
"name": "index.ts",
"type": "file",
"content": "export function main() { return \"Hello World\"; }"
}
]
}
],
"commit": "abc123def456",
"stagingCommit": "2025-01-01T00-00-00-000Z",
"stagingEndpointUrl": "https://staging.runflow.ai/agent/abc123",
"_count": {
"executions": 15,
"dataSources": 3,
"triggers": 2
},
"repositoryName": "agent-repo",
"scheduleArn": "arn:aws:scheduler:us-east-1:123456789012:schedule/default/my-schedule",
"newEngine": true
}Path Parameters
Agent UUID
Response
Agent found.
Agent unique identifier
"123e4567-e89b-12d3-a456-426614174000"
Agent name
"Customer Support Bot"
Agent description
"AI-powered customer support agent"
Agent category
SALES, CUSTOMER_SUPPORT, VOICE, OPERATIONS, FINANCIAL_PREVENTION, FINANCIAL_RECOVERY, MARKETING, ANALYTICS "CUSTOMER_SUPPORT"
Agent status
ACTIVE, INACTIVE, ERROR, DEPLOYING "ACTIVE"
Agent source code
"export function main() { return \"Hello World\"; }"
Programming language
"typescript"
Git branch
"main"
Agent tags
["ai", "customer-support", "chatbot"]
Creation timestamp
"2025-01-01T00:00:00.000Z"
Last update timestamp
"2025-01-01T00:00:00.000Z"
Tenant ID that the agent belongs to
"123e4567-e89b-12d3-a456-426614174000"
User ID that owns the agent
"123e4567-e89b-12d3-a456-426614174000"
Agent subcategory for more specific classification
SDR_OUTBOUND, SDR_INBOUND, ACCOUNT_MANAGER, SALES_CLOSER, LEAD_QUALIFIER, TIER_1_SUPPORT, TECHNICAL_SUPPORT, ESCALATION_HANDLER, CHAT_SUPPORT, COLD_CALLING, CUSTOMER_SERVICE_VOICE, APPOINTMENT_SETTER, SURVEY_CALLER, DATA_PROCESSOR, WORKFLOW_AUTOMATOR, QUALITY_CHECKER, REPORT_GENERATOR, FRAUD_DETECTOR, RISK_ASSESSOR, COMPLIANCE_MONITOR, DEBT_COLLECTOR, PAYMENT_NEGOTIATOR, RECOVERY_SPECIALIST, CONTENT_CREATOR, CAMPAIGN_MANAGER, SOCIAL_MEDIA_MANAGER, EMAIL_MARKETER, DATA_ANALYST, PERFORMANCE_TRACKER, INSIGHT_GENERATOR, DASHBOARD_CREATOR "TIER_1_SUPPORT"
Last deployment timestamp
"2025-01-01T00:00:00.000Z"
Agent logo URL
"https://example.com/logo.png"
Repository URL
"https://github.com/user/agent-repo"
Agent endpoint URL (populated by provisioning service)
"https://chatbot.acme.runflow.ai"
File tree structure for IDE-like interface
[
{
"name": "src",
"type": "folder",
"children": [
{
"name": "index.ts",
"type": "file",
"content": "export function main() { return \"Hello World\"; }"
}
]
}
]
Git commit hash
"abc123def456"
Staging commit hash (latest deploy to staging)
"2025-01-01T00-00-00-000Z"
Staging endpoint URL
"https://staging.runflow.ai/agent/abc123"
Agent related statistics
{
"executions": 15,
"dataSources": 3,
"triggers": 2
}
Repository name
"agent-repo"
AWS Scheduler ARN
"arn:aws:scheduler:us-east-1:123456789012:schedule/default/my-schedule"
Use new executor-engine (Go) instead of legacy execution-engine (NestJS)
true