brainstorms

Create a brainstorm

Creates a brainstorm and, optionally, its whole starting idea tree in one call. An idea's parent references another idea by index in this request, so a shape arrives with the board rather than in follow-up calls.

post/v1/brainstorms

Request

  • Base URL: https://api.flowral.app
  • URL: https://api.flowral.app/v1/brainstorms
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (client credentials, token URL https://api.flowral.app/v1/oauth/token, scopes: flows:write)

Request body

namestring required
ideasobject[]

Ideas to create, in order. Each: { title, notes?, parent?: index }, where parent is an index into this same array — omit it for a root idea.

Response

CREATED

idstring required
namestring required
archivedboolean required
publicboolean

Whether this brainstorm is published — readable by anyone with its link, with no account.

publicUrlstring nullable

The published link, or null when private.

ideaCountinteger
createdAtstring date-time
updatedAtstring date-time

Example response

{
  "id": "brn_4f0a12",
  "ideas": [
    {
      "id": "idea_7c1b90"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.