Workflows

Workflows define the stages a project moves through — from proposal to completion. Create custom workflows, add stages with colors, and assign workflows to projects.

The Workflow Object

Field	Type	Description
id	uuid
account_id	uuid
name	string
is_default	bool
stages	object[]
created_at	datetime
updated_at	datetime

Create a new workflow with stages

Endpoint: workflows-create

Field	Type	Required	Description
name	string	Yes
stages	object[]	Yes

curl -X POST https://api.driftwoodapp.com/api/workflows-create \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "...", "stages": []}'

Delete a non-default workflow

Endpoint: workflows-delete

Field	Type	Required	Description
id	string	Yes

curl -X POST https://api.driftwoodapp.com/api/workflows-delete \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"id": "..."}'

Get a workflow by ID

Endpoint: workflows-get

Field	Type	Required	Description
id	string	Yes

curl -X POST https://api.driftwoodapp.com/api/workflows-get \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"id": "..."}'

List all workflows for the account

Endpoint: workflows-list

Replace the stages of a workflow

Endpoint: workflows-set-stages

Field	Type	Required	Description
id	string	Yes
stages	object[]	Yes

curl -X POST https://api.driftwoodapp.com/api/workflows-set-stages \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"id": "...", "stages": []}'

Update a workflow name

Endpoint: workflows-update

Field	Type	Required	Description
id	string	Yes
name	string	Yes

curl -X POST https://api.driftwoodapp.com/api/workflows-update \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"id": "...", "name": "..."}'