# Flowral Brainstorms API

**Canonical:** https://apis.io/apis/flowral-app/flowral-app-brainstorms-api/  
**Provider:** Flowral — https://apis.io/providers/flowral-app/  
**Base URL:** https://api.flowral.app  
**Documentation:** https://flowral.app/api/reference

Flowral Brainstorms API is one of 10 APIs that [Flowral](https://apis.io/providers/flowral-app/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include brainstorms. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Idea-tree boards, and the ideas on them.

## Operations (20)

| Method | Path | Summary |
|---|---|---|
| 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 |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/flowral-app/openapi/flowral-app-brainstorms-api-openapi.yml
- **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

## Other Flowral APIs (9)

- [Flowral Auth API](https://apis.io/apis/flowral-app/flowral-app-auth-api/)
- [Flowral Flows API](https://apis.io/apis/flowral-app/flowral-app-flows-api/)
- [Flowral Notifications API](https://apis.io/apis/flowral-app/flowral-app-notifications-api/)
- [Flowral Search API](https://apis.io/apis/flowral-app/flowral-app-search-api/)
- [Flowral Tasks API](https://apis.io/apis/flowral-app/flowral-app-tasks-api/)
- [Flowral Team API](https://apis.io/apis/flowral-app/flowral-app-team-api/)
- [Flowral Templates API](https://apis.io/apis/flowral-app/flowral-app-templates-api/)
- [Flowral Work API](https://apis.io/apis/flowral-app/flowral-app-work-api/)
- [Flowral Workspace API](https://apis.io/apis/flowral-app/flowral-app-workspace-api/)

## Tags

brainstorms

---

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