---
title: "Link a task to an issue"
method: POST
path: "/issues/{issueId}/tasks"
tags: ["Issues"]
---

# Link a task to an issue

`POST /issues/{issueId}/tasks`

## Request

- Base URL: `https://api.sazabi.com/v1`
- URL: `https://api.sazabi.com/v1/issues/{issueId}/tasks`
- Auth: none declared

Link an existing task in the connected Linear, Jira, or GitHub workspace to an issue. The issue shows the task and follows its status like a task Sazabi filed. Linking is idempotent.

## Path parameters

- `issueId` string, uuid, required: Issue to link the task to.

## Request body

- object
  - `task` string, required: The task's identifier (for example `ENG-123`), provider id, or URL in the connected Linear, Jira, or GitHub workspace.

## Response `200`

OK

- object
  - `taskLink` object, required
    - `provider` 'linear' | 'jira' | 'github', required
    - `identifier` string, required
    - `url` string, uri, required
  - `created` boolean, required: False when the task was already linked to this issue.

## Changes

- **2026-11-03** `5350cf35e446`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sazabi/apis/sazabi-public-api/changes/issues/:issueId/tasks/post.md)

---

[API](https://skmtc.dev/sazabi/apis/sazabi-public-api.md) - [All operations](https://skmtc.dev/sazabi/apis/sazabi-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sazabi/apis/sazabi-public-api/revisions/87089d7ea293?raw)
