Skip to main content
GET
/
api
/
v1
/
ideations
/
{ideation_id}
/
refinements
List Refinements
curl --request GET \
  --url https://api.example.com/api/v1/ideations/{ideation_id}/refinements \
  --header 'Authorization: Bearer <token>'
[
  {
    "assignee_id": "<string>",
    "board_id": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "created_by": "<string>",
    "description": "<string>",
    "id": "<string>",
    "ideation_id": "<string>",
    "labels": [
      "<string>"
    ],
    "status": "draft",
    "title": "<string>",
    "updated_at": "2023-11-07T05:31:56Z",
    "version": 123,
    "archived": false,
    "pre_archive_status": "<string>"
  }
]

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

​
ideation_id
string
required

Query Parameters

​
status
string | null
​
include_archived
boolean
default:false

Response

Successful Response

​
assignee_id
string | null
required
​
board_id
string
required
​
created_at
string<date-time>
required
​
created_by
string
required
​
description
string | null
required
​
id
string
required
​
ideation_id
string
required
​
labels
string[] | null
required
​
status
enum<string>
required

Refinement lifecycle status.

Available options:
draft,
review,
approved,
done,
cancelled
​
title
string
required
​
updated_at
string<date-time>
required
​
version
integer
required
​
archived
boolean
default:false
​
pre_archive_status
string | null
Last modified on May 8, 2026