Hanzo
OpenapiTodo

Returns the boards of your org — the places your work actually is.

Returns the boards of your org — the places your work actually is. The key addresses the board's issues.

GET /v1/todo/projects

Addresshttps://api.hanzo.ai/v1/todo/projects
MethodGET
Operationget_todo_projects
AuthAuthorization: Bearer $HANZO_API_KEY

Returns the boards of your org — the places your work actually is. The key addresses the board's issues.

A BOARD IS A PLACE WORK IS, not an object somebody provisioned. So the list is assembled from the work itself: the repositories your org has filed issues on, plus the boards the index holds. A repository with nothing on it is not in the list and is still perfectly addressable — GET /projects/<name> reads it and a create files into it — so nothing is lost by leaving it out.

Measured, which is why: reading the forge's whole repository inventory put 745 boards here, of which all but a handful were vendored forks and mirrors (.github, .profile, DOMPurify, BoatAttack) that will never carry this org's work. A list that long is not a list — the estate's real roadmap was in it somewhere and no one could see it.

The forge half is the FORGE's answer for your own account, so two people in one org can legitimately see different boards.

Request

GET /v1/todo/projects takes no parameters and no body — the credential is the whole request.

Response

StatusBodyMeaning
200todoProject[]ok

200 body — 7 fields.

FieldInTypeAlwaysDescription
[].createdAtbodyintegerCreatedAt is when the board was created, in unix seconds.
[].descriptionbodystringDescription is whatever an index board was created with.
[].idbodystringID is the board's opaque handle, and it is NOT how you address it — Key is.
[].keybodystringKey addresses the board everywhere else — /v1/todo/projects/<key>/issues — and prefixes every issue identifier on it.
[].namebodystringName is the board's display name.
[].orgbodystringOrg is the IAM org the board belongs to, taken from the validated principal and never from the request.
[].updatedAtbodyintegerUpdatedAt is when the board record last changed, in unix seconds — the BOARD, not the work on it, so filing an issue does not move it.

Failure carries the platform error shape — see Errors.

Examples

hanzo todo projects list

Todo API · All Hanzo APIs · Interactive reference

How is this guide?

On this page