Skip to content

Projects

GET v3/projects returns all projects in the account.
[
  {
    "id": 23423233,
    "title": "PH Marketing",
    "description": "Project description goes here",
    "status": 12345678,
    "category": {
      "id": 65707070
    },
    "manager": {
      "id": 11679192
    }
  },
  {
    "id": 23423234,
    "title": "Rockwall Phase II",
    "description": "Develop and execute the 2016 plan",
    "status": 12345678,
    "category": {
      "id": 65707070
    },
    "manager": {
      "id": 11679192
    }
  }
]
GET v3/projects/23423233 returns the specified project.
{
  "id": 23423233,
  "title": "PH Marketing",
  "description": "Project description goes here",
  "status": 12345678,
  "color": "#41236D",
  "start_date": "2016-12-10",
  "end_date": "2016-12-15",
  "manager": {
    "id": 11679192
  }
}
POST v3/projects creates a new project.
{
  "title": "To the moon",
  "description": "DBX's campaign",
  "category": 651073331,
  "status": 12345678,
  "start_date": "2016-12-10",
  "end_date": "2016-12-15",
  "assigned": [
    12009183,
    11679192
  ],
  "manager": 11679192
}

Category IDs can be retrieved from the Categories API.

201 Created is returned along with the created project.

If the account has reached its project limit, the response will return You have reached the project limit.

PUT v3/projects/23423233 updates an existing project.
{
  "title": "To the moon 2014",
  "description": "DBX's campaign",
  "archived": false,
  "status": 12345678,
  "category": 651073331,
  "start_date": "2016-12-10",
  "end_date": "2016-12-15",
  "assigned": [
    12009183,
    11679192
  ],
  "manager": 11679192
}
200 OK is returned along with the updated project JSON. 403 Forbidden is returned if access is denied.
DELETE v3/projects/23423233 deletes the specified project.
204 No Content is returned if the project is deleted successfully. 403 Forbidden is returned if access is denied.
GET v3/projectstatus/12345678 returns project status details.
{
  "id": 12345678,
  "title": "Active",
  "is_default": true,
  "created_at": "2016-06-24T12:18:26+00:00",
  "updated_at": "2016-06-24T12:18:26+00:00"
}
POST v3/projectstatus creates a new project status.
{
  "title": "Status name"
}
201 Created is returned along with the created project status.
PUT v3/projectstatus/12345678 updates an existing project status.
{
  "title": "Status updated name"
}
200 OK is returned along with the updated project status JSON. 403 Forbidden is returned if access is denied.
DELETE v3/projectstatus/12345678 deletes the specified project status.
204 No Content is returned if the project status is deleted successfully. 403 Forbidden is returned if access is denied.