Logo

Dyzo API

v2.0.0

Projects

Complete Dyzo API Documentation - Project Management, Team Collaboration & Time Tracking Platform

API Overview

Capabilities and features

Complete project lifecycle management including creation, updates, team assignment, sections, templates, and analytics.

Key Features

Create and manage projects with metadata
Assign team members and leaders
Track project status and progress
Organize tasks with sections
Duplicate projects and create templates
Generate project reports
POST
/project-v2/{user_id}/
200 OK

Create Project V2

Enhanced project creation API with automatic assignee addition, access level management, project journey tracking, default section creation, and email notifications. The creator is automatically added as an assignee with admin access. Creates a 'Recently Assigned' section by default.

JSONRequest Body
1{
2 "name": "Mobile App Development",
3 "companyId": 100,
4 "description": "iOS and Android app development project",
5 "client": 15,
6 "priority": "high",
7 "project_leader": 5,
8 "assignee": [
9 5,
10 10,
11 15
12 ],
13 "clientAssignee": [
14 12,
15 18
16 ],
17 "budget": 50000,
18 "currencyType": "USD",
19 "dueDate": "2025-06-30T23:59:59Z",
20 "stagingServerURL": "https://staging.example.com",
21 "liveServerURL": "https://live.example.com",
22 "allocated_hours": 500,
23 "accessLevels": {
24 "5": "admin",
25 "10": "editor",
26 "15": "viewer"
27 },
28 "status": [
29 {
30 "id": "1",
31 "name": "To Do",
32 "value": "todo",
33 "color": "#94A3B8"
34 },
35 {
36 "id": "2",
37 "name": "In Progress",
38 "value": "in_progress",
39 "color": "#3B82F6"
40 },
41 {
42 "id": "3",
43 "name": "Completed",
44 "value": "completed",
45 "color": "#10B981"
46 }
47 ]
48}
GET
/project/company/{company_id}/
200 OK

List All Projects

Retrieve all projects for a company.

GET
/project/company/{company_id}/{employee_id}/?isCompleted=&name=&start_date=&end_date=&project_leader=&page=
200 OK

List Projects by Employee

Get all projects accessible to a specific employee. Returns projects based on employee role - admins see all company projects, regular employees see only assigned projects. Automatically excludes other employees' default projects and includes the employee's own default project. Supports filtering, searching, and smart sorting by recent task activity. Query Parameters: • isCompleted (optional): Filter by completion status - 'true' (completed only), 'false' (active only), or omit for all • name (optional): Search projects by name (case-insensitive partial match) • start_date (optional): Filter projects created on/after this date (YYYY-MM-DD). Use with end_date • end_date (optional): Filter projects created on/before this date (YYYY-MM-DD). Use with start_date • project_leader (optional): Filter by project leader ID or assignee ID • page (optional): Page number for pagination. If omitted, returns all results without pagination

GET
/project-timer/company/{company_id}/{employee_id}/?isCompleted=&name=&start_date=&end_date=&project_leader=&page=
200 OK

List Projects by Employee (Desktop/Timer)

Get all projects for desktop timer application. Similar to mobile endpoint but uses ProjectSerializerForDesktop. Includes role-based filtering where admins see all projects and regular employees see only assigned projects. Query Parameters: • isCompleted (optional): Filter by completion status - 'true', 'false', or omit for all • name (optional): Search projects by name (case-insensitive) • start_date (optional): Filter by creation date start (YYYY-MM-DD). Use with end_date • end_date (optional): Filter by creation date end (YYYY-MM-DD). Use with start_date • project_leader (optional): Filter by project leader or assignee ID • page (optional): Page number for pagination

GET
/projects/detail/{project_id}/
200 OK

Get Project Details

Get detailed project information with stats.

PUT
/project-v2/{project_id}/{user_id}/
200 OK

Update Project V2 (Enhanced with Journey Tracking)

Enhanced project update API with comprehensive change tracking, project journey logging, role-based access management, and automatic notifications. Tracks all changes including name, due date, color, completion status, allocated hours, assignee additions/removals, and access level updates. Sends notifications to affected users.

JSONRequest Body
1{
2 "name": "Mobile App - Updated",
3 "description": "Updated description",
4 "priority": "high",
5 "dueDate": "2025-12-31T23:59:59Z",
6 "project_leader": 5,
7 "isActive": true,
8 "isCompleted": false,
9 "assignee": [
10 5,
11 10,
12 15,
13 20
14 ],
15 "clientAssignee": [
16 12
17 ],
18 "budget": 75000,
19 "currencyType": "USD",
20 "projectColor": "#FF5733",
21 "stagingServerURL": "https://staging-new.example.com",
22 "liveServerURL": "https://live-new.example.com",
23 "allocated_hours": 600,
24 "accessLevels": {
25 "5": "admin",
26 "10": "editor",
27 "15": "viewer",
28 "20": "editor"
29 },
30 "status": [
31 {
32 "id": "1",
33 "name": "To Do",
34 "value": "todo",
35 "color": "#94A3B8"
36 },
37 {
38 "id": "2",
39 "name": "In Progress",
40 "value": "in_progress",
41 "color": "#3B82F6"
42 },
43 {
44 "id": "3",
45 "name": "Review",
46 "value": "review",
47 "color": "#F59E0B"
48 },
49 {
50 "id": "4",
51 "name": "Completed",
52 "value": "completed",
53 "color": "#10B981"
54 }
55 ]
56}
DELETE
/api/project/delete/{_id}/
200 OK

Delete Project

Soft delete a project.

POST
/api/project-duplicate/{project_id}/{user_id}/
200 OK

Duplicate Project

Create a copy of an existing project with all tasks.

GET
/projects/{project_id}/journey/
200 OK

Get Project Journey

Get project activity history/timeline.

GET
/projects/{project_id}/sections/
200 OK

Get Project Sections

List all task sections in a project.

GET
/task-statistics/{company_id}/
200 OK

Get Company Project Statistics

Get aggregated project statistics.