---
title: "Get a project's task relations"
method: GET
path: "/task-relation/project/{projectId}"
tags: ["Task Relations"]
---

# Get a project's task relations

`GET /task-relation/project/{projectId}`

## Request

- Base URL: `https://cloud.kaneo.app/api`
- URL: `https://cloud.kaneo.app/api/task-relation/project/{projectId}`
- Auth: HTTP bearer

Get every relation joining two tasks in the project, without the task summaries the per-task endpoint returns. Intended for views that render many tasks at once and already hold them. Relations reaching outside the project are omitted.

## Path parameters

- `projectId` string, required

## Response `200`

Relations between tasks in the project

- TaskRelation[]
  - `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

## Other responses

- `401`: Missing or invalid credentials
- `403`: No access to the project, or missing task:read permission
- `404`: Project 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-27** `93f78789100c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/usekaneo/apis/kaneo-api/changes/task-relation/project/:projectId/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)