ConnectCloud Developers

Make one item of the project start after another ended (desk:write)

POST /api/desk/v1/projects/{id}/dependencies

Module: Desk · operationId: createItemDependency · Tag: Projects · Auth: access token (Authorization: Bearer <accessToken>)

Parameters

Name In Type Required Description
id path string yes

Request body

application/json (required)

  • predecessorId (string, required): Item id or number
  • successorId (string, required): Item id or number
  • lagDays (integer): (max 365)

Example:

{
  "lagDays": 1,
  "predecessorId": "#58",
  "successorId": "#59"
}

Responses

  • 201 Dependency (application/json)
  • 400 An item is not one of the project
  • 409 dependency_cycle, or duplicate (the pair exists)

Fields of the 201 answer:

  • createdAt (string (date-time), read-only): When it was created
  • createdBy (string, read-only): Login (e-mail) of who created it
  • id (string, read-only): Id of the dependency
  • kind (string): Kind of dependency (one of finish_to_start)
  • lagDays (integer): Days between the predecessor's end and the successor's start; negative = overlap (max 365)
  • predecessorId (string): Item that has to end first
  • projectId (string, read-only): Project of the dependency
  • successorId (string): Starts lagDays after the predecessor ended (finish-to-start)

Example 201 answer:

{
  "createdAt": "2026-11-02T07:30:00Z",
  "createdBy": "emma.maier@muster-it.example",
  "id": "8e5f6a7b-9c0d-4e1f-8a3b-5c6d7e8f9a01",
  "kind": "finish_to_start",
  "lagDays": 1,
  "predecessorId": "4a1b2c3d-5e6f-4a7b-8c9d-1e2f3a4b5d0b",
  "projectId": "5b2c3d4e-6f7a-4b8c-9d0e-2f3a4b5c6d01",
  "successorId": "4a1b2c3d-5e6f-4a7b-8c9d-1e2f3a4b5d0c"
}

Example request

curl -X POST 'https://api.mbcom.cloud/api/desk/v1/projects/string/dependencies' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"lagDays":1,"predecessorId":"#58","successorId":"#59"}'

View as Markdown · Interactive reference · OpenAPI