An issue's sub-issues

GET

/v1/issues/{issueId}/sub-issues

const url = 'https://api.pealboard.com/v1/issues/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/sub-issues';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://api.pealboard.com/v1/issues/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/sub-issues \
  --header 'Authorization: Bearer <token>'

The issues this one was split into, from the cache, oldest first. Each carries its own state and its own repository, which need not be this issue’s: a sub-issue may live in another repository of the same GitHub account, and that is what a split is for.

Only sub-issues in repositories this workspace mirrors are here. GitHub records the parentage on the child, so a child in a repository Pealboard does not sync is a child Pealboard has never seen. subIssues on the issue itself is GitHub’s own count and is the one to compare against.

Access. Requires the viewer role or above (viewer, member, admin, owner). The sub-issues of an issue are readable by anybody who can read the issue. API-key scope: issues:read.

Authorizations

bearerAuth

Parameters

Path Parameters

issueId

required

From GET /v1/issues.

string format: uuid

From GET /v1/issues.

Responses

200

The sub-issues.

application/json

object

data

required

Array<object>

object

required

A UUID this API issued.

string format: uuid

nodeId

required

string

number

required

number

title

required

string

body

required

What the person typed. The attribution block Pealboard writes for a portal request or for a member, and the hidden marker beside it, are stripped here and kept on GitHub. Sending an edited body back keeps them.

string | null

state

required

GitHub’s own word for whether the issue is open or closed.

string

Allowed values: open closed

stateReason

required

Why the issue is in this state. Null while it is open. duplicate is what makes a portal show a request as Merged.

string | null

Allowed values: completed not_planned duplicate reopened

duplicateOfIssueId

required

The issue this one was closed as a duplicate of, when the close went through Pealboard with duplicateOfIssueId. GitHub takes the canonical issue and never sends it back, so a duplicate closed on GitHub itself is stateReason: duplicate with null here. Cleared on reopen.

string | null format: uuid

repository

required

object

required

A UUID this API issued.

string format: uuid

nodeId

required

string

fullName

required

string

ownerLogin

required

string

name

required

string

private

required

boolean

author

required

object

required

GitHub’s numeric user id.

number

login

required

string

avatarUrl

required

string | null format: uri

type

required

User, Bot or Organization.

string

authoredBy

required

object

membershipId

required

A UUID this API issued.

string | null format: uuid

name

required

The display name. Never an email address.

string

kind

required

team: a workspace member, the same word a portal uses for the same people. customer: a portal customer, whose request or comment the App wrote on their behalf; membershipId is null.

string

Allowed values: team customer

assignees

required

Array<object | null>

object

required

GitHub’s numeric user id.

number

login

required

string

avatarUrl

required

string | null format: uri

type

required

User, Bot or Organization.

string

labels

required

Array<object>

object

nodeId

required

string

name

required

string

color

required

string

milestone

required

object

required

A UUID this API issued.

string format: uuid

nodeId

required

string

repositoryId

required

A UUID this API issued.

string format: uuid

number

required

number

title

required

string

description

required

string | null

state

required

string

Allowed values: open closed

dueOn

required

string | null format: date-time

issueType

required

The organization issue type, when the organization uses them.

object

required

number

nodeId

required

string

name

required

string

color

required

string | null

subIssues

required

object

total

required

number

completed

required

number

percentCompleted

required

number

parent

required

The issue this one was split out of, when it is a sub-issue. The children are GET /v1/issues/{issueId}/sub-issues.

object

required

Null when the parent’s repository is not synced, so Pealboard holds no row for it.

string | null format: uuid

number

required

integer

repository

required

object

required

A UUID this API issued.

string | null format: uuid

fullName

required

string

title

required

string | null

projectItems

required

Array<object>

object

itemNodeId

required

Pass this to the project item routes.

string

projectId

required

A UUID this API issued.

string format: uuid

projectNodeId

required

string

projectTitle

required

string

fieldValues

required

Keyed by the field’s node id, which is what GitHub identifies it by.

object

key

additional properties

One of:

object

type

required

string

Allowed values: text

text

required

string

requests

required

Empty for an issue no portal knows about, which is most of them.

Array<object>

A portal request that points at this issue. One issue maps to at most one request per portal.

object

required

A UUID this API issued.

string format: uuid

portalId

required

A UUID this API issued.

string format: uuid

portalSlug

required

Lowercase letters, digits and hyphens.

string

>= 2 characters <= 40 characters /^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?$/

portalName

required

string

number

required

The portal-local request number.

string

visibility

required

string

Allowed values: private company public

voteCount

required

number

commentsCount

required

number

locked

required

boolean

htmlUrl

required

The issue on GitHub.

string format: uri

createdAt

required

string format: date-time

updatedAt

required

string format: date-time

closedAt

required

string | null format: date-time

syncedAt

required

When Pealboard last read this issue from GitHub.

string format: date-time

Example

{
  "data": [
    {
      "id": "8f1c2b3e-0a4d-4e6f-9c11-2d3e4f5a6b7c",
      "nodeId": "I_kwDOAbc123",
      "number": 412,
      "title": "Board columns lose their order after a drag",
      "body": "Dragging a card to the last column reorders every other column.",
      "state": "open",
      "stateReason": null,
      "duplicateOfIssueId": null,
      "repository": {
        "id": "1b2c3d4e-5f60-4718-8293-a4b5c6d7e8f9",
        "nodeId": "R_kgDOAbc123",
        "fullName": "mersoft-corp/pealboard-api",
        "ownerLogin": "mersoft-corp",
        "name": "pealboard-api",
        "private": false
      },
      "author": {
        "id": 4891,
        "login": "jdoe",
        "avatarUrl": null,
        "type": "User"
      },
      "authoredBy": null,
      "assignees": [
        {
          "id": 5120,
          "login": "asmith",
          "avatarUrl": null,
          "type": "User"
        }
      ],
      "labels": [
        {
          "nodeId": "LA_kwDOAbc",
          "name": "bug",
          "color": "d73a4a"
        }
      ],
      "milestone": null,
      "issueType": null,
      "subIssues": null,
      "parent": null,
      "projectItems": [],
      "requests": [],
      "commentsCount": 3,
      "locked": false,
      "htmlUrl": "https://github.com/mersoft-corp/pealboard-api/issues/412",
      "createdAt": "2026-09-01T09:14:00.000Z",
      "updatedAt": "2026-09-08T16:02:11.000Z",
      "closedAt": null,
      "syncedAt": "2026-09-08T16:02:14.000Z"
    }
  ]
}

401

No valid credentials.

application/json

object

error

required

object

code

required

A stable identifier for the kind of failure. Safe to branch on.

string

message

required

What went wrong, written for a person.

string

detail

Structured particulars, when there are any.

object

key

additional properties

remedy

What to do about it, when there is something to do.

string

requestId

required

Quote this when asking about a specific failure.

string

Example^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "detail": {
      "additionalProperty": "example"
    },
    "remedy": "example",
    "requestId": "example"
  }
}

403

Authenticated, but not permitted.

application/json

object

error

required

object

code

required

A stable identifier for the kind of failure. Safe to branch on.

string

message

required

What went wrong, written for a person.

string

detail

Structured particulars, when there are any.

object

key

additional properties

remedy

What to do about it, when there is something to do.

string

requestId

required

Quote this when asking about a specific failure.

string

Example^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "detail": {
      "additionalProperty": "example"
    },
    "remedy": "example",
    "requestId": "example"
  }
}

404

No such resource, or it is not visible to you.

application/json

object

error

required

object

code

required

A stable identifier for the kind of failure. Safe to branch on.

string

message

required

What went wrong, written for a person.

string

detail

Structured particulars, when there are any.

object

key

additional properties

remedy

What to do about it, when there is something to do.

string

requestId

required

Quote this when asking about a specific failure.

string

Example^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "detail": {
      "additionalProperty": "example"
    },
    "remedy": "example",
    "requestId": "example"
  }
}

409

The request conflicts with the current state.

application/json

object

error

required

object

code

required

A stable identifier for the kind of failure. Safe to branch on.

string

message

required

What went wrong, written for a person.

string

detail

Structured particulars, when there are any.

object

key

additional properties

remedy

What to do about it, when there is something to do.

string

requestId

required

Quote this when asking about a specific failure.

string

Example^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "detail": {
      "additionalProperty": "example"
    },
    "remedy": "example",
    "requestId": "example"
  }
}

422

The request did not match the expected shape.

application/json

object

error

required

object

code

required

A stable identifier for the kind of failure. Safe to branch on.

string

message

required

What went wrong, written for a person.

string

detail

Structured particulars, when there are any.

object

key

additional properties

remedy

What to do about it, when there is something to do.

string

requestId

required

Quote this when asking about a specific failure.

string

Example^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "detail": {
      "additionalProperty": "example"
    },
    "remedy": "example",
    "requestId": "example"
  }
}

429

Rate limited. Retry after the interval in the header.

application/json

object

error

required

object

code

required

A stable identifier for the kind of failure. Safe to branch on.

string

message

required

What went wrong, written for a person.

string

detail

Structured particulars, when there are any.

object

key

additional properties

remedy

What to do about it, when there is something to do.

string

requestId

required

Quote this when asking about a specific failure.

string

Example^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "detail": {
      "additionalProperty": "example"
    },
    "remedy": "example",
    "requestId": "example"
  }
}

502

GitHub or another dependency refused or did not answer. Nothing in the workspace changed.

application/json

object

error

required

object

code

required

A stable identifier for the kind of failure. Safe to branch on.

string

message

required

What went wrong, written for a person.

string

detail

Structured particulars, when there are any.

object

key

additional properties

remedy

What to do about it, when there is something to do.

string

requestId

required

Quote this when asking about a specific failure.

string

Example^generated

{
  "error": {
    "code": "example",
    "message": "example",
    "detail": {
      "additionalProperty": "example"
    },
    "remedy": "example",
    "requestId": "example"
  }
}

An issue's sub-issues

Authorizations

Parameters

Path Parameters

Responses

200

Example

401

Examplegenerated

403

Examplegenerated

404

Examplegenerated

409

Examplegenerated

422

Examplegenerated

429

Examplegenerated

502

Examplegenerated

Example^generated

Example^generated

Example^generated

Example^generated

Example^generated

Example^generated

Example^generated