---
title: "Create a task dependency"
method: POST
path: "/api/v2/task_dependencies"
tags: ["TaskDependency"]
---

# Create a task dependency

`POST /api/v2/task_dependencies`

Creates a directional dependency between two tasks. Requires `task_id`, `dependent_task_id`, and `type_id` (1 = Blocking, 2 = Waiting on, 3 = Linked).

A paired reverse record is created automatically (`Blocking` ↔ `Waiting on`; `Linked` is symmetric) — both share lifecycle, so type updates and deletes apply to both.

```json
{
  "data": {
    "type": "task_dependencies",
    "attributes": {
      "task_id": 4421188,
      "dependent_task_id": 4421199,
      "type_id": 1
    }
  }
}
```

## Headers

- `X-Organization-Id` string, required

## Response `201`

Single task dependency

## Other responses

- `403` — Forbidden
- `422` — Unprocessable Entity

---

[API](https://skmtc.net/productive/apis/api-documentation.md) · [All operations](https://skmtc.net/productive/apis/api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/productive/api-documentation/versions/6bb0150a5c5f/schema)