REST API — for integrators
If you use the Studio UI, you can skip this page. Studio already calls AI Flow for you.
Typical base path: /api/v1. Use the Bearer token or API key issued for your integration. The interactive API list is available at /docs on your assigned AIFlow host.
Typical user sequence
- Obtain integration credentials from your PowerMind administrator.
- List flows:
GET /api/v1/flows/. - Run a flow:
POST /api/v1/run/{flow_id}with the input payload the graph expects (chat text, JSON, and optional tweaks). - Check health:
GET /health.
Exact request bodies depend on the flow (Chat Input vs webhook vs custom fields). Use Playground first so you know what a good input looks like.
Groups you will see in Swagger
| Area | Paths (examples) |
|---|---|
| Authentication | /api/v1/login |
| Flows | /api/v1/flows/, /api/v1/flows/{id} |
| Run | /api/v1/run/{flow_id} |
| Files | /api/v1/files, /api/v2/files |
| MCP | /api/v1/mcp related routes |
| Health | /health |
Locks on Swagger rows mean you must Authorize first.
Use the interactive API reference for the complete request and response schemas available to your account.