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

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

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
​
labels
string[] | null
required
​
status
enum<string>
required

Spec lifecycle status.

Available options:
draft,
review,
approved,
validated,
in_progress,
done,
cancelled
​
title
string
required
​
updated_at
string<date-time>
required
​
version
integer
required
​
architecture_designs
ArchitectureDesignSummary · object[]
​
archived
boolean
default:false
​
ideation_id
string | null
​
pre_archive_status
string | null
​
refinement_id
string | null
Last modified on May 17, 2026