Answers across every project in the org.

Answers across every project in the org. The org comes from the validated principal and never from the request: a caller able to name the org could read…

GET /v1/todo/issues

Todo → · All API references → · Six flows, four surfaces →


Address	`https://api.hanzo.ai/v1/todo/issues`
Method	`GET`
Operation	`get_todo_issues`
Auth	`Authorization: Bearer $HANZO_API_KEY`

Answers across every project in the org.

The org comes from the validated principal and never from the request: a caller able to name the org could read another tenant's backlog, and a search is exactly the shape that would quietly return it.

Request

8 fields.

Field	In	Type	Required	Description
`q`	query	string	—	Q matches an issue's title or description.
`project`	query	string	—	Project narrows to one team key; "" searches every project in the org, which is the point of this op.
`status`	query	string	—	Status keeps one board column: backlog, todo, in_progress, done, canceled.
`kind`	query	string	—	Kind keeps one shape: issue, pr, epic.
`repo`	query	string	—	Repo keeps issues bound to one git repository.
`source`	query	string	—	Source keeps one origin: team, git, crm, helpdesk, cms, agent.
`assignee`	query	string	—	Assignee keeps issues held by one person.
`limit`	query	integer	—	Limit caps the answer; 0 means the default, and anything above the ceiling is clamped rather than refused — a search that errors on being too broad teaches…

Response

Status	Body	Meaning
`200`	issueHits	ok

200 body — 12 fields.

Field	In	Type	Always	Description
`count`	body	integer	—	Count is how many rows Issues carries — the size of THIS answer after the cap, not how many issues matched.
`issues`	body	issueHit[]	—	Issues are the matching rows grouped by status and oldest-first within a group, capped by the search's limit (50 by default, 200 at most).
`issues[].assignee`	body	string	—	Assignee is who holds the work. EMPTY MEANS UNHELD, which is what makes the issue claimable: claiming one already held by someone else is refused with 409…
`issues[].kind`	body	string	—	Kind is what the row IS: issue, pr or epic.
`issues[].number`	body	integer	—	Number is the issue's number on that board, from 1 and monotonic there.
`issues[].priority`	body	string	—	Priority is urgent, high, medium, low or none.
`issues[].project`	body	string	—	Project is the board key the issue is on.
`issues[].repo`	body	string	—	Repo is the git repository the issue is bound to, empty when it is not repo-bound.
`issues[].source`	body	string	—	Source is which surface opened it: team, git, crm, helpdesk, cms or agent.
`issues[].status`	body	string	—	Status is the board column: backlog, todo, in_progress, done or canceled.
`issues[].title`	body	string	—	Title is the issue's one-line summary — what the q filter matched, along with the description.
`issues[].url`	body	string	—	URL is the row's external anchor — its extRef — which is a link only when the feeder sent one.

Failure carries the platform error shape — see Errors.

Examples

hanzo todo issues

import { Configuration, TodoApi } from 'hanzoai';

const api = new TodoApi(new Configuration({ accessToken: process.env.HANZO_API_KEY }));
const { data } = await api.getTodoIssues();

from hanzoai.cloud import ApiClient, Configuration
from hanzoai.cloud.api import TodoApi

client = ApiClient(Configuration(access_token=os.environ["HANZO_API_KEY"]))
result = TodoApi(client).get_todo_issues()

cfg := cloud.NewConfiguration()
cfg.AddDefaultHeader("Authorization", "Bearer "+os.Getenv("HANZO_API_KEY"))
client := cloud.NewAPIClient(cfg)

resp, _, err := client.TodoAPI.GetTodoIssues(context.Background()).Execute()
if err != nil {
	return err
}

use hanzo_cloud::apis::{configuration::Configuration, todo_api};

let mut cfg = Configuration::new();
cfg.bearer_access_token = std::env::var("HANZO_API_KEY").ok();

let result = todo_api::get_todo_issues(&cfg, Default::default()).await?;

import ai.hanzo.cloud.ApiClient;
import ai.hanzo.cloud.api.TodoApi;

ApiClient client = new ApiClient();
client.setRequestInterceptor(b -> b.header("Authorization", "Bearer " + System.getenv("HANZO_API_KEY")));

var result = new TodoApi(client).getTodoIssues();

curl https://api.hanzo.ai/v1/todo/issues \
  -H "Authorization: Bearer $HANZO_API_KEY"

The door reaches todo through the todo tool, which names its 12 operations with its own verbs — this one among them, under a name only the door declares. describe explains any of them:

curl -X POST https://api.hanzo.ai/v1/mcp \
  -H "Content-Type: application/json" \
  -d '{
       "jsonrpc": "2.0",
       "id": 1,
       "method": "tools/call",
       "params": {
         "name": "describe",
         "arguments": {
           "op": "get_todo_board"
         }
       }
     }'

Todo API · All Hanzo APIs · Interactive reference

Answers across every project in the org.

Request

Response

Examples

On this page