Flowral

Flowral Brainstorms API

Idea-tree boards, and the ideas on them.

GitHub OpenAPI

Operations 20

GET /v1/brainstorms List brainstorms #
POST /v1/brainstorms Create a brainstorm #
GET /v1/brainstorms/archived List the archive #
GET /v1/brainstorms/{brainstormId} Get a brainstorm #
PATCH /v1/brainstorms/{brainstormId} Rename a brainstorm #
DELETE /v1/brainstorms/{brainstormId} Archive a brainstorm #
POST /v1/brainstorms/{brainstormId}/restore Restore an archived brainstorm #
GET /v1/brainstorms/{brainstormId}/shares List a brainstorm's guests #
POST /v1/brainstorms/{brainstormId}/shares Share a brainstorm with a guest #
DELETE /v1/brainstorms/{brainstormId}/shares/{shareId} Remove a guest from a brainstorm #
POST /v1/brainstorms/{brainstormId}/publish Publish a brainstorm #
DELETE /v1/brainstorms/{brainstormId}/publish Un-publish a brainstorm #
GET /v1/brainstorms/{brainstormId}/ideas List a brainstorm's ideas #
POST /v1/brainstorms/{brainstormId}/ideas Add an idea #
GET /v1/ideas/{ideaId} Get an idea #
PATCH /v1/ideas/{ideaId} Update an idea #
DELETE /v1/ideas/{ideaId} Delete an idea #
GET /v1/ideas/{ideaId}/comments List comments #
POST /v1/ideas/{ideaId}/comments Comment on an idea #
POST /v1/ideas/{ideaId}/attachments Attach a file #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/flowral-app/openapi/flowral-app-brainstorms-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/flowral-app/json-schema/flowral-app-brainstorm-summary-schema.json
📊
JSONSchema
https://artifacts.apis.io/flowral-app/json-schema/flowral-app-idea-schema.json
📊
JSONSchema
https://artifacts.apis.io/flowral-app/json-schema/flowral-app-share-schema.json
📊
JSONSchema
https://artifacts.apis.io/flowral-app/json-schema/flowral-app-attachment-schema.json
📊
JSONSchema
https://artifacts.apis.io/flowral-app/json-schema/flowral-app-idea-comment-schema.json
📊
JSONSchema
https://artifacts.apis.io/flowral-app/json-schema/flowral-app-brainstorm-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/flowral-app:flowral-app-brainstorms-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

flowral-app-brainstorms-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Flowral Brainstorms API
  version: 1.0.0
  summary: Client projects as dependency graphs — over HTTP.
  description: 'The Flowral public API: flows, the tasks in them, and the derived state that

    makes a dependency planner useful — what is ready, what is blocked, and when a

    project actually lands.


    **Authentication.** Every request carries a credential created in the app under

    **API & AI**. Either send an API key as a bearer token, or exchange a client id

    and secret for a short-lived token at `POST /v1/oauth/token`. A credential

    belongs to a workspace and carries its own role: it can never do more than that

    role allows, and it cannot move between workspaces.


    **Errors** are `{ "error": { "code", "message" } }`. Switch on `code`; the

    message is for humans and may change.


    **Lists** are `{ "total", "items" }` and take `size` and `from`.


    **Rate limit** 120 requests/minute per credential, burst 240. Exceeding it

    returns `429` with `Retry-After`.


    **Stability.** This is v1. Fields get added; nothing that exists is removed or

    repurposed without a new major version. The platform API the web app uses is a

    different, unversioned surface — it is not this, and it will change without

    notice.'
  contact:
    name: Flowral
    email: hello@flowral.app
    url: https://flowral.app/api
  license:
    name: Proprietary
    url: https://flowral.app/terms
servers:
- url: https://api.flowral.app
  description: Production
security:
- apiKey: []
- oauth2: []
tags:


# --- truncated at 32 KB (49 KB total) ---
# Full source: https://artifacts.apis.io/flowral-app/openapi/flowral-app-brainstorms-api-openapi.yml