Introduction

The WorkComposer Projects API enables you to programmatically manage projects within your workspace. Use these endpoints to create, retrieve, update, and delete projects, as well as manage team and user assignments.

Projects are a core organizational unit in WorkComposer, allowing you to group related tasks and track progress across specific initiatives. This API is particularly useful for integrating with project management tools, automating project creation, and synchronizing project data across systems.

This endpoint returns a list of all projects in your workspace. The response includes basic project information such as ID, title, and creation/update timestamps.

{
  "status": 1,
  "projects": [
    {
      "_id": "60a90der1dcbff17c8ca51fe",
      "title": "Test project",
      "createdAt": "2021-05-22T13:58:06.867Z",
      "updatedAt": "2021-05-22T14:38:34.769Z"
    },
    {
      "_id": "61f537809a6f13f5189cc587",
      "title": "Another test project",
      "createdAt": "2022-01-29T12:48:13.166Z",
      "updatedAt": "2022-01-29T12:53:52.735Z"
    }
  ]
}

This endpoint allows you to create a new project in your workspace. You can specify the project title and optionally assign team members and teams during creation.

{
  "status": 1,
  "projectId": "63e38c76e7e26f86bdfdb693"
}

This endpoint allows you to update an existing project's details, including its title and team/member assignments. You only need to include the fields you want to update.

{
  "status": 1
}

This endpoint allows you to permanently delete a project from your workspace. Use with caution as this action cannot be undone.

{
  "status": 1
}