List my work items

curl "https://api.example.test/v1/me/work-items?open=1" \  -H "Authorization: Bearer $TOKEN"

The items assigned to the token holder across every project the token may see, with the same paging, sorting and filters as a project's list. Pass open=1 for what is still to do.

Requires ability

work-item:view-any

The token must hold this ability, or the call is refused with 403.

MCP tool

list_my_work

Runs the same action from an agent, behind the same ability.

Authorization

bearerToken

AuthorizationBearer <token>

A personal access token minted in the app under Account Settings, then API Tokens, sent as Authorization: Bearer zg_live_…. The token carries the abilities each endpoint lists under Requires ability and is frozen to one team, and optionally to one project, at mint time.

In: header

Query Parameters

type?|

Narrow to one kind: story, task, subtask, bug, spike or improvement.

status?|

Narrow to one status: backlog, ready, in_progress, in_review, in_qa, done or cancelled.

open?|

When true, only the items that are neither done nor cancelled.

epic_id?|

Narrow to the items under one epic.

Formatuuid

parent_id?|

Narrow to the items under one parent item.

Formatuuid

assignee_id?|

Narrow to the items one person is doing.

Formatuuid

label_id?|

Narrow to the items carrying one label.

Formatuuid

priority?|

Narrow to one priority: lowest, low, medium, high or highest.

search?|

Words the reference or the title must contain, up to 120 characters.

Lengthlength <= 120

page?integer

The 1-based page to return. A page past the last answers an empty data array with meta.total still filled, so a loop can stop without guessing.

Range1 <= value

Default1

per_page?integer

Rows per page, 1 to 100. A higher value clamps to the cap silently. Defaults to 25.

Range1 <= value <= 100

Default25

sort_by?string

The column to order by. Defaults to created_at; a column the endpoint does not offer falls back to the default rather than failing.

Default"created_at"

sort_direction?string

asc or desc. Defaults to desc.

Default"desc"

Value in

"asc"
"desc"

limit?integer

Alias of per_page, kept for clients that send it. per_page wins when both are sent.

Range1 <= value <= 100

Responses

200OKapplication/json

One page of the items assigned to the token holder, across every project the token may see.

data*array<>

The items on this page.

links*

Links to the first, last, previous and next pages.

meta*

The paging counters for this page.

401UnauthorizedAUTHENTICATION_REQUIREDapplication/json

The request carries no bearer token, or one that is revoked, malformed, or minted for another environment (a zg_test_ token on production).

error*

The one envelope every failure uses.

403ForbiddenTOKEN_MISSING_ABILITYapplication/json

The token is valid but does not carry the ability this endpoint requires; error.context.required_ability names the one to grant. An endpoint that also checks who registered a row answers FORBIDDEN with the same status, and says so in its own description.

error*

The one envelope every failure uses.

422Validation failedVALIDATION_FAILEDapplication/json

The payload broke a rule, and error.fields maps each offending key to its messages. A refusal from the domain, such as a role code already taken or a team the caller does not own, uses the same code with error.message saying why and no fields. On this endpoint: VALIDATION_FAILED: when a filter is malformed.

error*

The one envelope every failure uses.

429Too many requestsRATE_LIMITEDapplication/json

The token has spent its 300 requests a minute or 10,000 an hour; Retry-After says when the next one is accepted.

error*

The one envelope every failure uses.

Call it from your code

A sample request in your language, the body each status answers with, and the types to hold them.

curl -X GET "https://example.com/v1/me/work-items"

{  "data": [    {      "id": "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e",      "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",      "number": 142,      "reference": "CRM-142",      "type": "story",      "parent_id": null,      "epic_id": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",      "title": "Tier upgrade email",      "description": "<p>Tell a member they reached the next tier the day it happens.</p>",      "status": "in_progress",      "resolution": null,      "priority": "high",      "assignee_id": "c3d4e5f6-a7b8-4c9d-8e0f-1a2b3c4d5e6f",      "assignee_name": "Nimal Fernando",      "reporter_id": "d4e5f6a7-b8c9-4d0e-9f1a-2b3c4d5e6f70",      "reporter_name": "Dilani Perera",      "reviewer_id": null,      "qa_owner_id": null,      "story_points": "5",      "estimate_minutes": null,      "remaining_minutes": null,      "due_on": "2026-11-20",      "started_at": "2026-11-02T09:00:00+00:00",      "completed_at": null,      "persona_id": "e5f6a7b8-c9d0-4e1f-8a2b-3c4d5e6f7a81",      "as_a": "gold member",      "i_want": "to be told the day I reach platinum",      "so_that": "I use the new perks straight away",      "business_value_points": 8,      "severity": null,      "environment_id": null,      "component_id": null,      "steps_to_reproduce": null,      "expected_result": null,      "actual_result": null,      "reproducible": null,      "timebox_minutes": null,      "outcome": null,      "component_ids": [        "f6a7b8c9-d0e1-4f2a-8b3c-4d5e6f7a8b92"      ],      "labels": [        null      ],      "acceptance_criteria": [        null      ],      "position": 3,      "version": 0,      "approved_at": null,      "created_at": "2026-10-28T09:20:00+00:00",      "updated_at": "2026-11-02T09:00:00+00:00"    }  ],  "links": {    "first": "string",    "last": "string",    "prev": "string",    "next": "string"  },  "meta": {    "current_page": 1,    "from": 1,    "last_page": 1,    "links": [      {        "url": "string",        "label": "string",        "active": true      }    ],    "path": "string",    "per_page": 0,    "to": 1,    "total": 0  }}

Type definitions

The shapes above as types, ready to paste into your client.

export interface Response {  data: WorkItemResource[];  links: Links;  meta: Meta;}export interface WorkItemResource {  id: string;  project_id: string;  number: number;  reference: string;  type: string;  parent_id: string | null;  epic_id: string | null;  title: string;  description: string | null;  status: string;  resolution: string | null;  priority: string;  assignee_id: string | null;  assignee_name: string | null;  reporter_id: string | null;  reporter_name: string | null;  reviewer_id: string | null;  qa_owner_id: string | null;  story_points: string | null;  estimate_minutes: number | null;  remaining_minutes: number | null;  due_on: string | null;  started_at: string | null;  completed_at: string | null;  persona_id: string | null;  as_a: string | null;  i_want: string | null;  so_that: string | null;  business_value_points: number | null;  severity: string | null;  environment_id: string | null;  component_id: string | null;  steps_to_reproduce: string | null;  expected_result: string | null;  actual_result: string | null;  reproducible: string | null;  timebox_minutes: number | null;  outcome: string | null;  component_ids: string[];  labels: unknown[];  acceptance_criteria: unknown[];  position: number;  version: number;  approved_at: string | null;  created_at: string | null;  updated_at: string | null;}export interface Links {  first: string | null;  last: string | null;  prev: string | null;  next: string | null;}export interface Meta {  current_page: number;  from: number | null;  last_page: number;  links: Link[];  path: string | null;  per_page: number;  to: number | null;  total: number;}export interface Link {  url: string | null;  label: string;  active: boolean;}

List my work items

AuthorizationCopy Anchor Link

Query ParametersCopy Anchor Link

ResponsesCopy Anchor Link

Authorization

Query Parameters

Responses