API endpoint reference

Projects

Every projects endpoint in the WorkBOS API: parameters, request and response shape, and curl, Node and Python samples generated from the spec.

GET/projects

List projects

Parameters
NameInTypeRequired
limitqueryintegerNo
offsetqueryintegerNo
Responses
StatusDescription
200OK
401Missing/invalid API key
Example request
curl -X GET "https://dkjdtyzjdkumnpdyezbs.supabase.co/functions/v1/api-v1/projects?limit=20&offset=20" \
  -H "Authorization: Bearer YOUR_API_KEY"
POST/projects

Create project

Request body (required)
FieldType
namestring
statusstring
company_idstring (uuid)
pm_idstring (uuid)
descriptionstring
Responses
StatusDescription
201OK
401Missing/invalid API key
403Read-only key
Example request
curl -X POST "https://dkjdtyzjdkumnpdyezbs.supabase.co/functions/v1/api-v1/projects" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"string","status":"string","company_id":"00000000-0000-0000-0000-000000000000","pm_id":"00000000-0000-0000-0000-000000000000","description":"string"}'
GET/projects/{id}

Get a project by id

Parameters
NameInTypeRequired
idpathstringYes
Responses
StatusDescription
200OK
401Missing/invalid API key
404Not found
Example request
curl -X GET "https://dkjdtyzjdkumnpdyezbs.supabase.co/functions/v1/api-v1/projects/REPLACE_WITH_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"
PATCH/projects/{id}

Update a project

Parameters
NameInTypeRequired
idpathstringYes
Request body (required)
FieldType
namestring
statusstring
company_idstring (uuid)
pm_idstring (uuid)
descriptionstring
Responses
StatusDescription
200OK
401Missing/invalid API key
403Read-only key
404Not found
Example request
curl -X PATCH "https://dkjdtyzjdkumnpdyezbs.supabase.co/functions/v1/api-v1/projects/REPLACE_WITH_ID" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"string","status":"string","company_id":"00000000-0000-0000-0000-000000000000","pm_id":"00000000-0000-0000-0000-000000000000","description":"string"}'
DELETE/projects/{id}

Delete a project

Parameters
NameInTypeRequired
idpathstringYes
Responses
StatusDescription
200OK
401Missing/invalid API key
403Read-only key
Example request
curl -X DELETE "https://dkjdtyzjdkumnpdyezbs.supabase.co/functions/v1/api-v1/projects/REPLACE_WITH_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"