Create a typed lateral link from the source task ([taskId]) to another task in the same project

POST 
/api/projects/:id/tasks/:taskId/links

Create a typed lateral link from the source task ([taskId]) to another task in the same project. The body either links an existing task ({ targetTaskId, linkType }) or creates a new follow-up task and links it ({ newTaskTitle, linkType }, status BACKLOG or the project default, reporter = caller — PT-479). Supported link types: BLOCKS | RELATES | DUPLICATES | CLONES | CAUSES | FOLLOWS. Both tasks must be in the same project. The create-new branch also requires tasks.create.

Request

Responses

201

Successful response

401

Unauthorized — authentication credentials are missing or invalid

403

Forbidden — both intents require tasks.update.any; the create-new-follow-up variant ({ newTaskTitle }) additionally requires tasks.create.

409

Conflict — a link with this (source, target, type) triple already exists