Projects
- Get all projects
- Get project
- Create project
- Update project
- Delete project
- Get project status
- Create project status
- Update project status
- Delete project status
Get all projects
Section titled “ Get all 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 project
Section titled “ Get project ” 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
}
} Create project
Section titled “ Create project ” 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.
Update project
Section titled “ Update project ” 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 project
Section titled “ Delete project ” 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 project status
Section titled “ Get project status ” 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"
} Create project status
Section titled “ Create project status ” POST
v3/projectstatus
creates a new project status.
{
"title": "Status name"
} 201 Created is returned along with the created project status.
Update project status
Section titled “ Update 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 project status
Section titled “ Delete project status ” 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.