List views
const url = 'https://api.pealboard.com/v1/views';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/views \ --header 'Authorization: Bearer <token>'The workspace’s shared views and the calling member’s own personal ones. Another member’s personal views are never listed. Shared views first, then by name.
Access. Requires the viewer role or above (viewer, member, admin, owner). A view is a saved filter over issues the member can already read. API-key scope: views:read.
Authorizations
Section titled “Authorizations”Responses
Section titled “Responses”The views.
object
object
A UUID this API issued.
board groups by the view’s groupBy; the other two do not.
object
Full text over title, number, label names and body.
Repository ids. Any of them matches.
Label names. An issue must carry every one of them.
GitHub logins, @me for the caller, or none for unassigned. Any of them matches.
Milestone ids, or none.
Project ids. Any of them matches.
Issue type names, or none.
Project field node id to the value it must hold, or none for not set. Every entry must match.
object
An ISO 8601 instant, or a window such as -7d, -24h, -2w.
The same forms as updatedSince.
Issues on no project, or on one whose Status field is not set.
Issues that are a request in at least one portal.
object
object
For a view saved before any project existed. Resolved when the board is run.
A UUID this API issued.
object
object
object
object
The columns the table layout shows, in order. Empty means the client’s own default set.
Shared with the workspace. A view that is not shared is visible only to the member who owns it.
Null for a shared view.
Which of the six seeded views this started as, or null for one somebody made.
Example
{ "data": [ { "id": "3c9a1f52-7b8e-4d21-9f03-6a5b4c3d2e1f", "name": "Needs triage", "layout": "list", "filter": { "state": "open", "noProjectStatus": true }, "sort": { "key": "created", "order": "desc" }, "groupBy": null, "columns": [], "shared": true, "ownerMembershipId": null, "builtIn": "needs_triage", "createdAt": "2026-09-09T10:00:00.000Z", "updatedAt": "2026-09-09T10:00:00.000Z" } ]}No valid credentials.
object
object
A stable identifier for the kind of failure. Safe to branch on.
What went wrong, written for a person.
Structured particulars, when there are any.
object
What to do about it, when there is something to do.
Quote this when asking about a specific failure.
Examplegenerated
{ "error": { "code": "example", "message": "example", "detail": { "additionalProperty": "example" }, "remedy": "example", "requestId": "example" }}Authenticated, but not permitted.
object
object
A stable identifier for the kind of failure. Safe to branch on.
What went wrong, written for a person.
Structured particulars, when there are any.
object
What to do about it, when there is something to do.
Quote this when asking about a specific failure.
Examplegenerated
{ "error": { "code": "example", "message": "example", "detail": { "additionalProperty": "example" }, "remedy": "example", "requestId": "example" }}No such resource, or it is not visible to you.
object
object
A stable identifier for the kind of failure. Safe to branch on.
What went wrong, written for a person.
Structured particulars, when there are any.
object
What to do about it, when there is something to do.
Quote this when asking about a specific failure.
Examplegenerated
{ "error": { "code": "example", "message": "example", "detail": { "additionalProperty": "example" }, "remedy": "example", "requestId": "example" }}The request conflicts with the current state.
object
object
A stable identifier for the kind of failure. Safe to branch on.
What went wrong, written for a person.
Structured particulars, when there are any.
object
What to do about it, when there is something to do.
Quote this when asking about a specific failure.
Examplegenerated
{ "error": { "code": "example", "message": "example", "detail": { "additionalProperty": "example" }, "remedy": "example", "requestId": "example" }}The request did not match the expected shape.
object
object
A stable identifier for the kind of failure. Safe to branch on.
What went wrong, written for a person.
Structured particulars, when there are any.
object
What to do about it, when there is something to do.
Quote this when asking about a specific failure.
Examplegenerated
{ "error": { "code": "example", "message": "example", "detail": { "additionalProperty": "example" }, "remedy": "example", "requestId": "example" }}Rate limited. Retry after the interval in the header.
object
object
A stable identifier for the kind of failure. Safe to branch on.
What went wrong, written for a person.
Structured particulars, when there are any.
object
What to do about it, when there is something to do.
Quote this when asking about a specific failure.
Examplegenerated
{ "error": { "code": "example", "message": "example", "detail": { "additionalProperty": "example" }, "remedy": "example", "requestId": "example" }}GitHub or another dependency refused or did not answer. Nothing in the workspace changed.
object
object
A stable identifier for the kind of failure. Safe to branch on.
What went wrong, written for a person.
Structured particulars, when there are any.
object
What to do about it, when there is something to do.
Quote this when asking about a specific failure.
Examplegenerated
{ "error": { "code": "example", "message": "example", "detail": { "additionalProperty": "example" }, "remedy": "example", "requestId": "example" }}