Update Task
Developing
Testing Env
Testing Env
POST
/api/v1/tasks/update/6
Last modified:2025-05-14 19:28:57
API Documentation
Update Task [POST]
URL
/api/v1/tasks/update/{id}
Request Headers
Key | Value | Required |
---|---|---|
Accept | application/json | Yes |
user-token | {{user_token}} | Yes |
secure-business-key | {{secure_business_key}} | Yes |
Accept-Language | en/ar | No |
Content-Type | string | Should be multipart/form-data |
URL Parameters
Parameter | Type | Description | Required |
---|---|---|---|
id | integer | ID of task to update | Yes |
Request Body Parameters
Parameter | Type | Required | Example Value | Description |
---|---|---|---|---|
name | string | false | "Updated proposal" | Task name |
group_name | string | false | "Marketing" | Group name |
owner_id | integer | false | 45 | Owner user ID |
reviewed_by | integer | false | 52 | Reviewer user ID |
status | string | false | "in_progress" | Task status |
due_date | date | false | "2023-12-31" | Due date |
priority | string | false | "high" | Priority level |
duration_days | integer | false | 7 | Duration in days |
description | string | false | "Final draft" | Description |
note | string | false | "Urgent" | Internal notes |
budget | numeric | false | 5500.00 | Updated budget |
dependent_on | integer | false | 12 | Dependent task ID |
timeline_start | date | false | "2023-11-05" | New timeline start |
timeline_end | date | false | "2023-12-15" | New timeline end |
project_id | integer | false | 16 | Project ID |
board_id | integer | false | 4 | Board ID |
assignments[] | array | false | [{"id":1,"user_id":5}] | Updated assignments |
files[] | file | false | (binary) | New file uploads |
deleted_file_ids[] | array | false | [3,5] | File IDs to delete |
timeTracking[] | array | false | [{"id":2,"user_id":5}] | Updated time entries |
Response
Success (200)
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/v1/tasks/update/6' \
--header 'Accept: application/json' \
--header 'Accept-Language: en' \
--header 'user-token: ' \
--header 'secure-business-key: 4765066450c0bd66325.48403130' \
--form 'name="Task Title";type=text/plain' \
--form 'group_name="Development";type=text/plain' \
--form 'owner_id="123";type=text/plain' \
--form 'reviewed_by="456";type=text/plain' \
--form 'status="Not Started";type=text/plain' \
--form 'due_date="2025-05-20";type=text/plain' \
--form 'priority="High";type=text/plain' \
--form 'duration_days="5";type=text/plain' \
--form 'description="Implement feature X";type=text/plain' \
--form 'note="Requires review";type=text/plain' \
--form 'budget="1500.00";type=text/plain' \
--form 'dependent_on="1";type=text/plain' \
--form 'timeline_start="2025-05-15";type=text/plain' \
--form 'timeline_end="2025-05-25";type=text/plain' \
--form 'project_id="1";type=text/plain' \
--form 'board_id="5";type=text/plain' \
--form 'assignments[0][user_id]="101";type=text/plain' \
--form 'assignments[0][id]="3";type=text/plain' \
--form 'files[0]=@"C:\\Users\\Se7a\\Downloads\\download.jpg"' \
--form 'deleted_file_ids[0]="6";type=text/plain' \
--form 'timeTracking[0][user_id]="102";type=text/plain' \
--form 'timeTracking[0][started_at]="2025-05-14 09:00:00";type=text/plain' \
--form 'timeTracking[0][ended_at]="2025-05-14 17:00:00";type=text/plain' \
--form 'timeTracking[0][duration_minutes]="50";type=text/plain'
Response Response Example
{
"status_code": 200,
"code": 1020,
"hint": "Processed Successfully",
"success": true,
"data": {
"task": {
"id": 6,
"business_id": 259,
"group_name": "Development",
"name": "Task Title",
"task_code": "T00005",
"owner_id": "123",
"reviewed_by": "456",
"status": "Not Started",
"due_date": "2025-05-20",
"duration_days": "5",
"timeline_start": "2025-05-15",
"timeline_end": "2025-05-25",
"description": "Implement feature X",
"note": "Requires review",
"budget": "1500.00",
"dependent_on": "1",
"project_id": "1",
"board_id": null,
"created_at": "2025-05-14 16:45:03",
"updated_at": "2025-05-14 19:23:37",
"deleted_at": null,
"dependent_task": {
"id": 1,
"business_id": 259,
"group_name": "To-Do",
"name": "task1",
"task_code": "T00001",
"owner_id": 123,
"reviewed_by": 456,
"status": "In Progress",
"due_date": "2023-12-31",
"duration_days": 5,
"timeline_start": null,
"timeline_end": null,
"description": "Important task",
"note": null,
"budget": null,
"dependent_on": null,
"project_id": 1,
"board_id": null,
"created_at": "2025-05-14 15:13:24",
"updated_at": "2025-05-14 15:13:24",
"deleted_at": null
},
"dependent_tasks": [
{
"id": 7,
"business_id": 259,
"group_name": "To-Do",
"name": "New Task Example",
"task_code": "T00007",
"owner_id": 3,
"reviewed_by": 2,
"status": "In Progress",
"due_date": "2025-06-10",
"duration_days": 7,
"timeline_start": "2025-06-01",
"timeline_end": "2025-06-08",
"description": "Detailed task info",
"note": "Needs follow-up",
"budget": "5000.00",
"dependent_on": 6,
"project_id": 1,
"board_id": null,
"created_at": "2025-05-14 20:21:07",
"updated_at": "2025-05-14 20:21:07",
"deleted_at": null
}
],
"assignments": [
{
"id": 3,
"task_id": 6,
"assign_to": 101,
"assigned_at": "2025-05-14 16:45:04"
}
],
"files": [
{
"id": 3,
"task_id": 6,
"file_name": "Eng_Marco_Milad_Monthly_Report.pdf",
"file_path": "uploads/tasks/files/TASK_FILES_6_259_221416563.pdf",
"file_type": "document",
"file_size": 508,
"uploaded_at": "2025-05-14 16:45:06"
},
{
"id": 8,
"task_id": 6,
"file_name": "download.jpg",
"file_path": "uploads/tasks/files/TASK_FILES_6_259_1439096887.jpg",
"file_type": "image",
"file_size": 8,
"uploaded_at": "2025-05-14 20:23:15"
}
],
"time_tracking": [
{
"id": 1,
"task_id": 6,
"assign_to": 5,
"started_at": "2025-06-01 09:00:00",
"ended_at": "2025-06-01 11:00:00",
"duration_minutes": 120
},
{
"id": 2,
"task_id": 6,
"assign_to": 6,
"started_at": "2025-06-02 13:00:00",
"ended_at": "2025-06-02 14:30:00",
"duration_minutes": 90
},
{
"id": 4,
"task_id": 6,
"assign_to": 102,
"started_at": "2025-05-14 09:00:00",
"ended_at": "2025-05-14 17:00:00",
"duration_minutes": 50
},
{
"id": 5,
"task_id": 6,
"assign_to": 102,
"started_at": "2025-05-14 09:00:00",
"ended_at": "2025-05-14 17:00:00",
"duration_minutes": 50
},
{
"id": 8,
"task_id": 6,
"assign_to": 102,
"started_at": "2025-05-14 09:00:00",
"ended_at": "2025-05-14 17:00:00",
"duration_minutes": 50
}
]
},
"message": "Task updated successfully"
}
}
Request
Header Params
Accept
stringÂ
optional
Example:
application/json
Accept-Language
stringÂ
optional
Example:
en
Content-Type
stringÂ
optional
Example:
application/json
user-token
stringÂ
optional
Example:
{{user_token}}
secure-business-key
stringÂ
optional
Example:
{{secure_business_key}}
Body Params multipart/form-data
name
stringÂ
required
Example:
Task Title
group_name
stringÂ
optional
Example:
Development
owner_id
integerÂ
optional
Example:
123
reviewed_by
integerÂ
optional
Example:
456
status
stringÂ
optional
Example:
Not Started
due_date
stringÂ
optional
Example:
2025-05-20
priority
stringÂ
optional
Example:
High
duration_days
integerÂ
optional
Example:
5
description
stringÂ
optional
Example:
Implement feature X
note
stringÂ
optional
Example:
Requires review
budget
stringÂ
optional
Example:
1500.00
dependent_on
integerÂ
optional
Example:
1
timeline_start
stringÂ
optional
Example:
2025-05-15
timeline_end
stringÂ
optional
Example:
2025-05-25
project_id
integerÂ
optional
Example:
1
board_id
integerÂ
optional
Example:
5
assignments[0][user_id]
integerÂ
required
Example:
101
assignments[0][id]
integerÂ
optional
Example:
3
files[0]
fileÂ
optional
Example:
file://C:\Users\Se7a\Downloads\download.jpg
deleted_file_ids[0]
integerÂ
optional
Example:
6
timeTracking[0][user_id]
integerÂ
required
Example:
102
timeTracking[0][started_at]
stringÂ
required
Example:
2025-05-14 09:00:00
timeTracking[0][ended_at]
stringÂ
optional
Example:
2025-05-14 17:00:00
timeTracking[0][duration_minutes]
integerÂ
optional
Example:
50