---
title: "Get task relations"
method: GET
path: "/task-relation/{taskId}"
tags: ["Task Relations"]
---

# Get task relations

`GET /task-relation/{taskId}`

Get every relation where the task is the source or the target, each with a summary of both linked tasks. Relations pointing outside the caller's workspace are omitted.

## Path parameters

- `taskId` string, required

## Response `200`

Task relations with the linked task summaries

- TaskRelationWithTasks[]
  - `id` string, required
  - `sourceTaskId` string, required
  - `targetTaskId` string, required
  - `relationType` string, required — How the two tasks relate: `subtask`, `blocks`, or `related`.
  - `createdAt` string, date-time, required
  - `sourceTask` RelatedTask, nullable, required
    - `id` string, required
    - `title` string, required
    - `status` string, required
    - `priority` string, nullable, required
    - `number` number, nullable, required
    - `projectId` string, required
    - `userId` string, nullable, required
    - `assigneeName` string, nullable, required
  - `targetTask` RelatedTask, nullable, required
    - `id` string, required
    - `title` string, required
    - `status` string, required
    - `priority` string, nullable, required
    - `number` number, nullable, required
    - `projectId` string, required
    - `userId` string, nullable, required
    - `assigneeName` string, nullable, required

## Other responses

- `400` — Unknown task, or its workspace could not be determined
- `401` — Missing or invalid credentials
- `403` — No access to the task's workspace

## Changes

- **2026-08-24** `08bbb5bedb5d` — 1 breaking, 3 info
  - the response's body type/format changed from `object`/`` to `array`/`` for status `200`
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
- **2026-07-11** `32cece1ebe43` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/usekaneo/apis/kaneo-api/changes/task-relation/:taskId/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-service-production.skmtc.workers.dev/v1/apis/usekaneo/kaneo-api/revisions/9d1da42c10ce/schema)