task

Create a new relation between two tasks

Creates a new relation between two tasks. The user needs to have update permissions on the base task and at least read permissions on the other task. Both tasks do not need to be on the same project. Take a look at the docs for available task relation kinds.

put/tasks/{taskID}/relations

Request

  • Base URL
    /api/v1 (relative, and the document was published on a file host, not at the API’s origin)
  • URL
    /api/v1/tasks/{taskID}/relations
  • Auth
    API key in header Authorization

Path parameters

taskIDinteger required

Task ID

Request body

createdstring

A timestamp when this label was created. You cannot change this value.

other_task_idinteger

The ID of the other task, the task which is being related.

relation_kind'unknown' | 'subtask' | 'parenttask' | 'related' | 'duplicateof' | 'duplicates' | 'blocking' | 'blocked' | 'precedes' | 'follows' | 'copiedfrom' | 'copiedto'
task_idinteger

The ID of the "base" task, the task which has a relation to another.

Response

The created task relation object.

createdstring

A timestamp when this label was created. You cannot change this value.

other_task_idinteger

The ID of the other task, the task which is being related.

relation_kind'unknown' | 'subtask' | 'parenttask' | 'related' | 'duplicateof' | 'duplicates' | 'blocking' | 'blocked' | 'precedes' | 'follows' | 'copiedfrom' | 'copiedto'
task_idinteger

The ID of the "base" task, the task which has a relation to another.

Changes

No recorded changes to this operation across all 74 revisions of this API.