API Introduction - Flowyble Documentation

Overview

The Flowyble API lets you programmatically execute agents and tools, check run statuses, and retrieve results. All endpoints are versioned and return JSON responses. Base URL:

https://api.flowyble.com/v1

What you can do

Endpoint Group	Description
Agents	Run agents, check status, get detailed results
Tools	Run tools, check status, get results
Webhooks	Receive triggers from external systems

Rate limiting

API requests are rate-limited to 100 requests per 60 seconds per API key. Webhook endpoints have a separate limit of 30 requests per 60 seconds. When you exceed the limit, you’ll receive a 429 Too Many Requests response. Wait and retry after the rate limit window resets.

Response format

All responses follow a consistent JSON structure:

{
  "success": true,
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "Pending",
  "message": "Agent run started"
}

Error responses include details:

{
  "success": false,
  "message": "Insufficient credits"
}

Requirements

API Access must be enabled on your subscription plan
A valid API Key (see Authentication)
Sufficient credits in your organization balance