# FlowCastle API

**Canonical:** https://apis.io/apis/flowcastle-ai/flowcastle-ai-api/  
**Provider:** FlowCastle — https://apis.io/providers/flowcastle-ai/  
**Base URL:** https://my.flowcastle.ai  
**Documentation:** https://github.com/FlowCastle/flowcastle-sdk/blob/main/docs/CROSS_FRAMEWORK_TELEGRAM_SDK_PLAN.md

FlowCastle API is one of 2 APIs that [FlowCastle](https://apis.io/providers/flowcastle-ai/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 1 JSON Schema definition. The published artifact set on APIs.io includes an OpenAPI specification and 1 JSON Schema.

FlowCastle API as documented publicly: 12 operations. Contract generated from the documentation by API Evangelist (2026-11-08); not the provider's own document.

## Operations (12)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/mcp` | FlowCastle exposes an MCP server over Streamable HTTP |
| POST | `/api/sdk/v1/events` | matched flow event uses handled: true ; update_id is stable when Telegram supplies it |
| GET | `/api/sdk/v1/jobs` | When enabled (the default), the plugin also pulls outbound delivery jobs from FlowCastle — e.g. replies a human agent types in the Live Chat inbox — and exec... |
| POST | `/api/sdk/v1/jobs/ack` | When enabled (the default), the plugin also pulls outbound delivery jobs from FlowCastle — e.g. replies a human agent types in the Live Chat inbox — and exec... |
| GET | `/api/sdk/v1/manifest` | Retrieve the trigger manifest |
| GET | `/claims` | Fetch active conversation ownership |
| POST | `/events` | Send observed or handled sanitized updates |
| GET | `/jobs` | Lease, execute, and report outbound work |
| POST | `/jobs/ack` | Lease token is returned in ack; execute per-chat FIFO; error acks retain Telegram code/description where available |
| GET | `/manifest` | Fetch versioned trigger rules |
| POST | `/runtime-runs` | Explicit customer-code flow start |
| POST | `/runtime/heartbeat` | Bind/report runtime identity |

## Machine-readable artifacts (2)

- **OpenAPI** — https://artifacts.apis.io/flowcastle-ai/openapi/_ae-authored/flowcastle-ai-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/flowcastle-ai/json-schema/flowcastle-ai-get-api-sdk-v1-manifest-response-schema.json

## Other FlowCastle APIs (1)

- [FlowCastle API](https://apis.io/apis/flowcastle-ai/flowcastle-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/flowcastle-ai/flowcastle-ai-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/flowcastle-ai/.