---
title: "Create Dependency (Project)"
method: POST
path: "/folders/{folderId}/dependencies"
tags: ["Dependencies"]
---

# Create Dependency (Project)

`POST /folders/{folderId}/dependencies`

## Request

- Base URL: `https://www.wrike.com/api/v4`
- URL: `https://www.wrike.com/api/v4/folders/{folderId}/dependencies`
- Auth: HTTP bearer

Add dependency between projects. Every ID must be the ID of an existing project, any folder or task ID is rejected as an invalid ID. If a dependency already exists, attempting to recreate will result in an error.

<b>Scopes:</b> Default, wsReadWrite

## Path parameters

- `folderId` string, required

## Query parameters

- `predecessorId` string, required
- `successorId` string, required
- `relationType` 'FinishToFinish' | 'StartToStart' | 'StartToFinish' | 'FinishToStart', required: * `FinishToFinish` - Finish to finish. For task dependencies allowed only when predecessor and successor are Planned or Milestone tasks * `StartToStart` - Start to start. For task dependencies allowed only when both predecessor and successor are Planned tasks * `StartToFinish` - Start to finish. For task dependencies allowed only when predecessor is Planned, and successor is Planned or Milestone task * `FinishToStart` - Finish to start. For task dependencies allowed only when predecessor is Planned or Milestone, and successor is Planned task
- `lagTime` number: Always in minutes, positive numbers are lag time and negative numbers are lead time. For project dependencies the lag is stored in whole work days of 480 minutes, so any partial day is rounded up to the next whole day, keeping the sign: 1 to 480 minutes become 1 day, 481 to 960 minutes become 2 days, -1 to -480 minutes become -1 day. A project dependency's lag must be within ±2147483520 minutes

## Response `2XX`

success response

- object
  - `kind` 'accounts' | 'users' | 'contacts' | 'assets' | 'eDiscoveryReport' | 'folders' | 'folderTree' | 'tasks' | 'taskIds' | 'timelogs' | 'timelogCategories' | 'timelogLockPeriods' | 'timetrackerTimers' | 'comments' | 'attachments' | 'url' | 'version' | 'dataExport' | 'dataExportSchema' | 'auditLog' | 'accessRoles' | 'stream' | 'changes' | 'posts' | 'mailSettings' | 'integrationInfo' | 'gmailIntegrationSettings' | 'workTypesForIntegrations' | 'ids' | 'backups' | 'domains' | 'dependencies' | 'workflows' | 'workschedules' | 'workscheduleExclusions' | 'workscheduleUserExclusions' | 'customfields' | 'customfieldIds' | 'customstatuses' | 'invitations' | 'notifications' | 'jobroles' | 'placeholders' | 'groups' | 'session' | 'dashboards' | 'widgets' | 'taskCreationSettings' | 'colors' | 'experiments' | 'topics' | 'topicComments' | 'webhooks' | 'reviews' | 'boards' | 'textSearch' | 'chatChannels' | 'chatMessages' | 'forms' | 'requestForms' | 'request' | 'report' | 'platformWidgets' | 'platformWidgetInstances' | 'spaces' | 'pdf' | 'customerSatisfaction' | 'asyncJob' | 'approvals' | 'highlights' | 'highlightsList' | 'highlightsSettings' | 'highlightsCard' | 'timesheet' | 'timesheetRow' | 'timesheetSubmissionRule' | 'mobileFeatures' | 'mobileSettings' | 'folderBlueprintTree' | 'taskBlueprintTree' | 'blueprintSearch' | 'feedback' | 'timeline_snapshot' | 'contactIds' | 'bookings' | 'integrateThreshold' | 'hourlyRatesProvision' | 'hourlyRates' | 'projectTeamMembers' | 'contactsHistory' | 'tasksHistory' | 'foldersHistory' | 'activityDigest' | 'workItemTemplates' | 'workTemplates' | 'workItemMetadata' | 'workItem' | 'customItemTypes' | 'verificationCode' | 'views' | 'listView' | 'tableView' | 'userTypes' | 'reactions' | 'externalRequesters' | 'workscheduleCapacityOverrides' | 'userCapacityOverrides' | 'userCapacityExclusions' | 'rollups' | 'requestFormPrefill' | 'mcpFeatures' | 'attachmentUploadUrl' | 'userAggregatedCapacity' | 'cascadingFieldSettings' | 'recommendResources' | 'aggregatedAllocatedEffort' | 'aggregatedTotalUserEffort' | 'aggregatedTimeSpent' | 'folderBlueprint' | 'taskBlueprint'
  - `data` Dependency[]
    - `relationType` 'FinishToFinish' | 'StartToStart' | 'StartToFinish' | 'FinishToStart': * `FinishToFinish` - Finish to finish. For task dependencies allowed only when predecessor and successor are Planned or Milestone tasks * `StartToStart` - Start to start. For task dependencies allowed only when both predecessor and successor are Planned tasks * `StartToFinish` - Start to finish. For task dependencies allowed only when predecessor is Planned, and successor is Planned or Milestone task * `FinishToStart` - Finish to start. For task dependencies allowed only when predecessor is Planned or Milestone, and successor is Planned task
    - `successorId` string
    - `lagTime` number: Always in minutes, positive numbers are lag time and negative numbers are lead time. For project dependencies the lag is kept in whole work days of 480 minutes, so the value is always a multiple of 480
    - `id` string
    - `predecessorId` string

## Other responses

- `4XX`: client-side error response
- `5XX`: server-side error response

## Changes

- **2026-11-03** `7b0a63c547dd`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/wrike/apis/wrike-api/changes/folders/:folderId/dependencies/post.md)

---

[API](https://skmtc.dev/wrike/apis/wrike-api.md) - [All operations](https://skmtc.dev/wrike/apis/wrike-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wrike/apis/wrike-api/revisions/7b0a63c547dd?raw)