---
title: "List my assigned tasks"
method: GET
path: "/task/assigned"
tags: ["Tasks"]
---

# List my assigned tasks

`GET /task/assigned`

## Request

- Base URL: `https://cloud.kaneo.app/api`
- URL: `https://cloud.kaneo.app/api/task/assigned`
- Auth: HTTP bearer

Get the open tasks assigned to the caller across a workspace's active projects. Completed and archived tasks are excluded. Ordered by due date (undated last), then priority. At most 100 tasks are returned; total counts all of them. Set countOnly=true to return just that total without loading task rows or labels.

## Query parameters

- `workspaceId` string, required
- `countOnly` 'true' | 'false': Return only the total, with an empty tasks array, without loading task rows or labels.

## Response `200`

Open tasks assigned to the caller

- AssignedTasks
  - `tasks` AssignedTask[], required
    - `id` string, required
    - `projectId` string, required
    - `number` number, nullable, required
    - `title` string, required
    - `status` string, required: The slug of the column the task sits in.
    - `statusName` string, nullable, required: The column's display name. Null for tasks outside a column, such as planned ones.
    - `statusIcon` string, nullable, required
    - `priority` string, required: One of: no-priority, low, medium, high, urgent.
    - `dueDate` string, date-time, nullable, required
    - `projectName` string, required
    - `projectSlug` string, required
    - `projectIcon` string, nullable, required
    - `labels` TaskLabel[], required
      - `id` string, required
      - `name` string, required
      - `color` string, required
  - `total` number, required: All open tasks assigned to the caller, including any beyond the first 100 returned.

## Other responses

- `400`: Invalid workspace ID or query parameters
- `401`: Missing or invalid credentials
- `403`: Missing project:read or task:read permission
- `404`: Workspace not found
- `429`: The API key exceeded its rate limit or usage quota. Wait the number of seconds in Retry-After before retrying. The X-RateLimit headers are sent only when the rate limit was hit.

## Changes

- **2026-10-09** `c9984766c765`: 1 info
  - added the non-success response with the status `404`
- **2026-10-08** `c7b8a842601b`: 3 breaking, 4 info
  - removed the media type `text/plain` for the response with the status `400`
  - removed the media type `text/plain` for the response with the status `403`
  - removed the media type `text/plain` for the response with the status `429`
  - added the media type `application/json` for the response with the status `400`
  - …3 more
- **2026-10-08** `2ed51b8af657`: 3 breaking, 3 info
  - removed the media type `application/json` for the response with the status `400`
  - removed the media type `application/json` for the response with the status `401`
  - removed the media type `application/json` for the response with the status `403`
  - added the media type `text/plain` for the response with the status `400`
  - …2 more
- **2026-10-07** `df1439c724ee`: 2 breaking, 3 info
  - removed the media type `text/plain` for the response with the status `400`
  - removed the media type `text/plain` for the response with the status `403`
  - added the media type `application/json` for the response with the status `400`
  - added the media type `application/json` for the response with the status `401`
  - …1 more
- **2026-10-02** `83c5b7a505eb`: 1 info
  - added the new optional `query` request parameter `countOnly`

[Operation history](https://skmtc.dev/usekaneo/apis/kaneo-api/changes/task/assigned/get.md)

---

[API](https://skmtc.dev/usekaneo/apis/kaneo-api.md) - [All operations](https://skmtc.dev/usekaneo/apis/kaneo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/usekaneo/apis/kaneo-api/revisions/93f78789100c?raw)
