Skip to main content
POST
Move Refinement

Authorizations

Authorization
string
header
required

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

Path Parameters

refinement_id
string
required

Body

application/json

Schema for changing refinement status.

status
enum<string>
required

Refinement lifecycle status.

Available options:
draft,
review,
approved,
done,
cancelled

Response

Successful Response

Schema for full refinement response.

analysis
string | null
required
assignee_id
string | null
required
board_id
string
required
created_at
string<date-time>
required
created_by
string
required
decisions
string[] | null
required
description
string | null
required
id
string
required
ideation_id
string
required
in_scope
string[] | null
required
labels
string[] | null
required
out_of_scope
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
architecture_designs
ArchitectureDesignSummary · object[]
archived
boolean
default:false
knowledge_bases
RefinementKnowledgeSummary · object[]
pre_archive_status
string | null
qa_items
RefinementQAResponse · object[]
screen_mockups
ScreenMockup · object[] | null
specs
SpecSummary · object[]
Last modified on May 17, 2026