1. ZenTao API development guides
1.1 Configuration and FAQ
1.2 Examples of the calling SDK
1.3. Department interface
1.3.1 Get the department list
1.3.2 Batch create departments
1.4. User interface
1.4.1 Get patameters of adding users
1.4.2 Add a single user
1.4.3 Get the user list
1.5. Product interface
1.5.1 Get the product list
1.5.2 Optional information for adding a single product
1.5.3 Create a single product
1.6. Project interface
1.6.1 Get the project list
1.6.2 Optional information for adding a single project
1.6.3 Create a single project
1.7. Task interface
1.7.1 Get the task list
1.7.2 Optional information for adding a single task
1.7.3 Create a single task
1.7.4 Optional information for finishing a single task
1.7.5 Finish a single task
1.8. Bug interface
1.8.1 Get the bug list
1.8.2 Optional information for reporting a single bug
1.8.3 Report a single bug
1.8.4 Optional information for resolving a single bug
1.8.5 Resolve a single bug
2. ZenTao API documents (V1.0)
2.1. Token
2.1.1 Get Token
2.2. Department
2.2.1 Get the department list
2.2.2 Get department details
2.3. User
2.3.1 Access to my profile
2.3.2 Get the user list
2.3.3 Get user information
2.3.4 Edit user information
2.3.5 Delete users
2.3.6 Create users
2.4. Program
2.4.1 Get the program list
2.4.2 Edit programs
2.4.3 Access to program details
2.4.4 Delete programs
2.4.5 Create programs
2.5. Product
2.5.1 Get the product list
2.5.2 Create products
2.5.3 Get product details
2.5.4 Edit products
2.5.5 Delete products
2.6. Product plan
2.6.1 Get the list of product plans
2.6.2 Create plans
2.6.3 Get plan details
2.6.4 Edit plans
2.6.5 Delete plans
2.6.6 Link the stories to the product plan
2.6.7 Cancel the link between the product plans and stories
2.6.8 Link the bugs to the product plan
2.6.9 Cancel the link between the product plan and bugs
2.7. Release
2.7.1 Get the release list of product
2.7.2 Get the release list of project
2.8. Story
2.8.1 Get product story list
2.8.2 Get project story list
2.8.3 Get execution story list
2.8.4 Create story
2.8.5 Get story details
2.8.6 Change story
2.8.7 Change some other fileds of story
2.8.8 Delete story
2.9. Project
2.9.1 Get project list
2.9.2 Create project
2.9.3 Get project details
2.9.4 Modify project
2.9.5 Delete project
2.10. Build
2.10.1 Get the build list of project
2.10.2 Get the build list of execution
2.10.3 Create build
2.10.4 Get build details
2.10.5 Modify build
2.10.6 Delete build
2.11. Execution
2.11.1 Get the execution list of project
2.11.2 Create execution
2.11.3 Check the details of execution
2.11.4 Modify execution
2.11.5 Delete execution
2.12. Task
2.12.1 Get the task list of execution
2.12.2 Create task
2.12.3 Get task details
2.12.4 Modify task
2.12.5 Delete task
2.12.6 Start task
2.12.7 Suspend task
2.12.8 Continue task
2.12.9 Finish task
2.13. Bug
2.13.1 Get the bug list of product
2.13.2 Create bug
2.13.3 Get bug details
2.13.4 Modify bug
2.13.5 Delete bug
2.14. Use case
2.14.1 Get use case list of product
2.14.2 Create use case
2.14.3 Get use case details
2.14.4 Modify test case
2.14.5 Delete test case
2.14.6 Run test case
2.15. Test request
2.15.1 Get test request list
2.15.2 Get the test request of project
2.15.3 Get the details of test reuqest
2.16. Feedback
2.16.1 Create feedback
2.16.2 Assign feedback
2.16.3 Close feedback
2.16.4 Delete feedback
2.16.5 Modify feedback
2.16.6 Get feedback details
2.16.7 Get feedback list
3. Customized development
3.1 Secondary development mechanism
3.2 The directory structure of ZenTao
3.3 Find your target file to be modified
3.4 The database structure of ZenTao
3.5 Public module - common
3.6 How to register on menu
3.7 How to register on permission
3.8 Example: how to modify the prompt
3.9 Example: priority field setting when creating bugs
3.10 The online extension editor
3.11 Secondary development editor and translation function restrictions instructions
3.12 ZenTao project management software packaging specification (V1.1)

Finish task

2022-12-21 11:17:51
Jing Wang
Last edited by WANG JING on 2023-01-04 19:17:30
Share links

Finish Task

1. Request Header

Name Type Required Description
Token String Yes Authentication Token

2. Request Payload

Name Type Required Description
assignedTo string No

Assigned to, if this field is not filled in,

the current assignor of the task 

will be selected.

currentConsumed int Yes Present consumption
realStarted date No

Actual start time, if this field is not filled in,

the actual start time filled in at the 

beginning of the task (continue) will be selected.

finishedDate date Yes Complete time
comment string No Notes

3. Request Example

    "realStarted":"2022-12-02 14:04:59",
    "finishedDate":"2022-12-02 15:45:27",
    "comment":"finish task"

4. Request Response

Name Type Required Description
id int Yes Task ID
project int Yes Affiliated Task
parent int Yes Parent Task
execution int Yes Affiliated Execution
module int Yes Affiliated Module
story int Yes Related Stories
fromBug int Yes From the Bug
name string Yes Task Name
type string Yes Task Type (design | devel | request | test | study | discuss | ui | affair | misc)
pri int Yes Priority
estimate float Yes Estimated Work Hours
consumed float Yes Consumed Work Hours
left float Yes Remaining Work Hours
deadline date Yes Estimated End Date
status string Yes Status (Not Started | In Progress | Completed | Closed | Canceled)
desc string Yes Task Description
openedBy   Yes Created by
openedDate datetime Yes Creation Date
assignedTo   Yes Assigned to
assignedDate datetime Yes Assigned Time
estStarted date Yes Estimated Start Date
realStarted datetime No Actual Start Time
finishedBy string No Finished by
finishedDate datetime No Finished at
closedBy   No Closed by
closedDate datetime No Closed at
team array Yes Teams, applied to multi-person tasks

5. Response Example

    "id": 2,
    "project": 1,
    "parent": 0,
    "execution": 2,
    "module": 0,
    "design": 0,
    "story": 0,
    "storyVersion": 1,
    "designVersion": 0,
    "fromBug": 0,
    "feedback": 0,
    "fromIssue": 0,
    "name": "testtt",
    "type": "devel",
    "mode": "",
    "pri": 0,
    "estimate": 0,
    "consumed": 4,
    "left": 0,
    "deadline": "2022-12-31",
    "status": "done",
    "subStatus": "",
    "color": "",
    "mailto": null,
    "desc": "",
    "version": 1,
    "openedBy": "admin",
    "openedDate": "2022-12-02T05:08:49Z",
    "assignedTo": "admin",
    "assignedDate": "2022-12-02T07:55:26Z",
    "estStarted": "2022-12-01",
    "realStarted": "2022-12-02T06:04:59Z",
    "finishedBy": "admin",
    "finishedDate": "2022-12-02T07:45:27Z",
    "finishedList": "",
    "canceledBy": "",
    "canceledDate": null,
    "closedBy": "",
    "closedDate": null,
    "planDuration": 0,
    "realDuration": 1,
    "closedReason": "",
    "lastEditedBy": "admin",
    "lastEditedDate": "2022-12-02T07:55:26Z",
    "activatedDate": "",
    "order": 0,
    "repo": 0,
    "mr": 0,
    "entry": "",
    "lines": "",
    "v1": "",
    "v2": "",
    "deleted": "0",
    "vision": "rnd",
    "storyID": null,
    "storyTitle": null,
    "latestStoryVersion": null,
    "storyStatus": null,
    "assignedToRealName": "admin",
    "children": [],
    "members": [],
    "team": [],
    "files": [],
    "needConfirm": false,
    "progress": 100
Write a Comment
Comment will be posted after it is reviewed.