Skip to main content
POST
/
api
/
v1
/
boards
/
{board_id}
/
ideations
Create Ideation
curl --request POST \
  --url https://api.example.com/api/v1/boards/{board_id}/ideations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "<string>",
  "assignee_id": "<string>",
  "complexity": "<string>",
  "description": "<string>",
  "labels": [
    "<string>"
  ],
  "problem_statement": "<string>",
  "proposed_approach": "<string>",
  "scope_assessment": {},
  "screen_mockups": [
    {
      "id": "<string>",
      "title": "<string>",
      "annotations": [
        {
          "id": "<string>",
          "text": "<string>",
          "author_id": "<string>"
        }
      ],
      "description": "<string>",
      "html_content": "",
      "order": 0,
      "screen_type": "page"
    }
  ]
}
'
{
  "assignee_id": "<string>",
  "board_id": "<string>",
  "complexity": "small",
  "created_at": "2023-11-07T05:31:56Z",
  "created_by": "<string>",
  "description": "<string>",
  "id": "<string>",
  "labels": [
    "<string>"
  ],
  "problem_statement": "<string>",
  "proposed_approach": "<string>",
  "scope_assessment": {},
  "status": "draft",
  "title": "<string>",
  "updated_at": "2023-11-07T05:31:56Z",
  "version": 123,
  "architecture_designs": [],
  "archived": false,
  "knowledge_bases": [],
  "pre_archive_status": "<string>",
  "qa_items": [],
  "refinements": [],
  "screen_mockups": [
    {
      "id": "<string>",
      "title": "<string>",
      "annotations": [
        {
          "id": "<string>",
          "text": "<string>",
          "author_id": "<string>"
        }
      ],
      "description": "<string>",
      "html_content": "",
      "order": 0,
      "screen_type": "page"
    }
  ],
  "specs": []
}

Documentation Index

Fetch the complete documentation index at: https://docs.oktolabs.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

board_id
string
required

Body

application/json

Schema for creating an ideation.

title
string
required
Required string length: 1 - 500
assignee_id
string | null
complexity
string | null
description
string | null
labels
string[] | null
problem_statement
string | null
proposed_approach
string | null
scope_assessment
Scope Assessment · object
screen_mockups
ScreenMockup · object[] | null

Response

Successful Response

Schema for full ideation response.

assignee_id
string | null
required
board_id
string
required
complexity
enum<string> | null
required

Ideation complexity level — determines whether refinements are needed.

Available options:
small,
medium,
large
created_at
string<date-time>
required
created_by
string
required
description
string | null
required
id
string
required
labels
string[] | null
required
problem_statement
string | null
required
proposed_approach
string | null
required
scope_assessment
Scope Assessment · object
required
status
enum<string>
required

Ideation lifecycle status.

Available options:
draft,
review,
approved,
evaluating,
done,
cancelled
title
string
required
updated_at
string<date-time>
required
version
integer
required
architecture_designs
ArchitectureDesignSummary · object[]
archived
boolean
default:false
knowledge_bases
IdeationKnowledgeSummary · object[]
pre_archive_status
string | null
qa_items
IdeationQAResponse · object[]
refinements
RefinementSummary · object[]
screen_mockups
ScreenMockup · object[] | null
specs
SpecSummary · object[]
Last modified on May 8, 2026