Skip to main content
POST
Create a dependency

Authorizations

X-API-Key
string
header
required

Organization-scoped API key. Create one in the BuildingSwell app under Organization settings, API keys.

Body

application/json
rootParentId
string<uuid>
required

Root of the tree both nodes belong to.

fromId
string<uuid>
required

Node the link runs from, the predecessor.

toId
string<uuid>
required

Node the link runs to, the successor.

id
string<uuid>

Unique id. Generated on create unless you supply one.

type
enum<string>
default:fs

Link type: fs finish-to-start, ff finish-to-finish, sf start-to-finish, ss start-to-start.

Available options:
fs,
ff,
sf,
ss
lagTimeSec
integer
default:0

Lag between the two nodes, in seconds. Negative values lead.

isArchived
boolean
default:false

Archived links no longer affect scheduling.

archivedAt
string<date-time> | null

When the link was archived.

createdAt
string<date-time>

When the record was created.

updatedAt
string<date-time>

When the record last changed.

Response

The created dependency. An array request returns values instead of value.

value
object
required

A scheduling link between two deliverables in the same tree. Creating or changing one re-rolls the downstream node's dates.