Every agent is exposed as a clean REST API. Integrate AI-powered workflows into your existing stack in minutes.
Call your agents from any platform. Get responses in seconds.
Design your workflow visually in the dashboard.
Toggle the agent to public to get your webhook URL.
Send requests from Python, Node, cURL, or any language.
curl -X POST https://api.xyzgent.ai/v1/hooks/{agent_id} \
-H "Authorization: Bearer sk_..." \
-H "Content-Type: application/json" \
-d '{ "query": "Analyze Q3 report..." }'Edge-optimized infrastructure with sub-100ms response times globally.
API key authentication, webhook secrets, and encrypted data at rest.
Server-Sent Events (SSE) for streaming workflow execution updates.
Built-in vector storage and retrieval for knowledge-augmented agents.
Complete REST API documentation for all CloudAgent endpoints.
All API requests require authentication via bearer token or API key. Include your credentials in the request headers.
# Using Authorization header
curl -H "Authorization: Bearer YOUR_API_KEY" \
https://api.xyzgent.ai/v1/apps
# Using webhook secret for public hooks
curl -H "X-Webhook-Secret: YOUR_WEBHOOK_SECRET" \
-X POST https://api.xyzgent.ai/v1/hooks/{agent_id}/v1/appsList all agents/v1/appsCreate a new agent/v1/apps/{id}Get agent details/v1/apps/{id}Update an agent/v1/apps/{id}Delete an agent/v1/apps/{id}/statsGet agent statistics/v1/hooks/{agent_id}Trigger agent via webhook/v1/hooks/{agent_id}/streamTrigger with SSE streaming/v1/workflowsCreate a workflow/v1/workflows/{id}Update workflow graph/v1/workflows/{id}/runExecute a workflow/v1/datasetsList all datasets/v1/datasetsCreate a dataset/v1/datasets/{id}Get dataset details/v1/datasets/{id}Delete a dataset/v1/datasets/{id}/documentsUpload a document/v1/datasets/{id}/documentsList documents/v1/chat-messagesSend message with streaming responseAll responses are returned in JSON format. Successful webhook triggers include execution metadata in response headers.
// Success response from webhook
{
"success": true,
"run_id": "run_abc123",
"status": "succeeded",
"duration_ms": 1250,
"output": "Analysis complete. Key findings: ..."
}
// Response headers include:
// X-Execution-ID: run_abc123
// X-Execution-Status: succeeded
// X-Execution-Duration-Ms: 1250Use the /stream endpoint for real-time SSE events as your workflow executes.
const eventSource = new EventSource(
'https://api.cloudagent.ai/v1/hooks/{agent_id}/stream'
);
eventSource.onmessage = (event) => {
const data = JSON.parse(event.data);
switch (data.event) {
case 'node_started':
console.log(`Executing: ${data.node_type}`);
break;
case 'node_finished':
console.log(`Output: ${data.output}`);
break;
case 'workflow_finished':
console.log('Complete!');
eventSource.close();
break;
}
};Native client libraries for Python, Node.js, Go, and more. Sign up to get notified when they're ready.
Start building AI-powered workflows today. Free tier includes 100K tokens.