Update task

PUT

admin

api

projects

tasks

{id}

Update task

curl --request PUT \
  --url https://erp.arukz.com/admin/api/v1/projects/tasks/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "Prepare homepage wireframe",
  "description": "Create initial wireframe and review notes.",
  "state": "in_progress",
  "stage_id": 1,
  "project_id": 1,
  "milestone_id": 1,
  "partner_id": 1,
  "parent_id": 10,
  "deadline": "2026-03-10 18:00:00",
  "allocated_hours": 12,
  "priority": false,
  "users": [
    16
  ],
  "tags": [
    16
  ]
}
'

import requests

url = "https://erp.arukz.com/admin/api/v1/projects/tasks/{id}"

payload = {
    "title": "Prepare homepage wireframe",
    "description": "Create initial wireframe and review notes.",
    "state": "in_progress",
    "stage_id": 1,
    "project_id": 1,
    "milestone_id": 1,
    "partner_id": 1,
    "parent_id": 10,
    "deadline": "2026-03-10 18:00:00",
    "allocated_hours": 12,
    "priority": False,
    "users": [16],
    "tags": [16]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    title: 'Prepare homepage wireframe',
    description: 'Create initial wireframe and review notes.',
    state: 'in_progress',
    stage_id: 1,
    project_id: 1,
    milestone_id: 1,
    partner_id: 1,
    parent_id: 10,
    deadline: '2026-03-10 18:00:00',
    allocated_hours: 12,
    priority: false,
    users: [16],
    tags: [16]
  })
};

fetch('https://erp.arukz.com/admin/api/v1/projects/tasks/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://erp.arukz.com/admin/api/v1/projects/tasks/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'title' => 'Prepare homepage wireframe',
    'description' => 'Create initial wireframe and review notes.',
    'state' => 'in_progress',
    'stage_id' => 1,
    'project_id' => 1,
    'milestone_id' => 1,
    'partner_id' => 1,
    'parent_id' => 10,
    'deadline' => '2026-03-10 18:00:00',
    'allocated_hours' => 12,
    'priority' => false,
    'users' => [
        16
    ],
    'tags' => [
        16
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "data": {
    "id": 1,
    "title": "Frontend Development",
    "description": "<p>Implement the new UI using modern frameworks (e.g., React, Vue).</p>",
    "color": null,
    "priority": false,
    "state": "in_progress",
    "sort": 1,
    "is_active": true,
    "is_recurring": false,
    "deadline": "2026-09-24T00:00:00.000000Z",
    "working_hours_open": 0,
    "working_hours_close": 0,
    "allocated_hours": 150,
    "remaining_hours": 0,
    "effective_hours": 0,
    "total_hours_spent": 0,
    "subtask_effective_hours": 0,
    "overtime": 0,
    "progress": 0,
    "stage_id": 1,
    "project_id": 4,
    "partner_id": 39,
    "parent_id": null,
    "company_id": null,
    "creator_id": 1,
    "created_at": "2025-09-23T12:55:10.000000Z",
    "updated_at": "2025-09-23T12:55:10.000000Z",
    "deleted_at": null
  },
  "message": "Task updated successfully."
}

{
  "message": "Unauthenticated."
}

{
  "message": "Resource not found."
}

{
  "message": "The given data was invalid.",
  "errors": {
    "title": [
      "The title field is required."
    ]
  }
}

Authorizations

Authorization

string

header

required

An API token from Sign in, sent as Authorization: Bearer <token>. Tokens last 30 days.

Path Parameters

integer

required

The task ID

Example:

1

Body

application/json

title

string

Task title. Must not be greater than 255 characters.

Example:

"Prepare homepage wireframe"

description

string | null

Task description.

Example:

"Create initial wireframe and review notes."

state

enum<string>

Task state.

Available options:

in_progress,

change_requested,

approved,

cancelled,

done

Example:

"in_progress"

stage_id

integer

Task stage ID. The id of an existing record in the projects_task_stages table.

Example:

1

project_id

integer | null

Project ID. The id of an existing record in the projects_projects table.

Example:

1

milestone_id

integer | null

Milestone ID. The id of an existing record in the projects_milestones table.

Example:

1

partner_id

integer | null

Customer ID. The id of an existing record in the partners_partners table.

Example:

1

parent_id

integer | null

Parent task ID for sub-task. The id of an existing record in the projects_tasks table.

Example:

10

deadline

string | null

Task deadline date-time. Must be a valid date.

Example:

"2026-03-10 18:00:00"

allocated_hours

number | null

Allocated effort in hours. Must be at least 0.

Example:

12

priority

boolean | null

Priority flag.

Example:

false

users

integer[]

The id of an existing record in the users table.

Example:

[16]

Response

Success

⌘I

Update task

curl --request PUT \
  --url https://erp.arukz.com/admin/api/v1/projects/tasks/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "Prepare homepage wireframe",
  "description": "Create initial wireframe and review notes.",
  "state": "in_progress",
  "stage_id": 1,
  "project_id": 1,
  "milestone_id": 1,
  "partner_id": 1,
  "parent_id": 10,
  "deadline": "2026-03-10 18:00:00",
  "allocated_hours": 12,
  "priority": false,
  "users": [
    16
  ],
  "tags": [
    16
  ]
}
'

import requests

url = "https://erp.arukz.com/admin/api/v1/projects/tasks/{id}"

payload = {
    "title": "Prepare homepage wireframe",
    "description": "Create initial wireframe and review notes.",
    "state": "in_progress",
    "stage_id": 1,
    "project_id": 1,
    "milestone_id": 1,
    "partner_id": 1,
    "parent_id": 10,
    "deadline": "2026-03-10 18:00:00",
    "allocated_hours": 12,
    "priority": False,
    "users": [16],
    "tags": [16]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    title: 'Prepare homepage wireframe',
    description: 'Create initial wireframe and review notes.',
    state: 'in_progress',
    stage_id: 1,
    project_id: 1,
    milestone_id: 1,
    partner_id: 1,
    parent_id: 10,
    deadline: '2026-03-10 18:00:00',
    allocated_hours: 12,
    priority: false,
    users: [16],
    tags: [16]
  })
};

fetch('https://erp.arukz.com/admin/api/v1/projects/tasks/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://erp.arukz.com/admin/api/v1/projects/tasks/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'title' => 'Prepare homepage wireframe',
    'description' => 'Create initial wireframe and review notes.',
    'state' => 'in_progress',
    'stage_id' => 1,
    'project_id' => 1,
    'milestone_id' => 1,
    'partner_id' => 1,
    'parent_id' => 10,
    'deadline' => '2026-03-10 18:00:00',
    'allocated_hours' => 12,
    'priority' => false,
    'users' => [
        16
    ],
    'tags' => [
        16
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "data": {
    "id": 1,
    "title": "Frontend Development",
    "description": "<p>Implement the new UI using modern frameworks (e.g., React, Vue).</p>",
    "color": null,
    "priority": false,
    "state": "in_progress",
    "sort": 1,
    "is_active": true,
    "is_recurring": false,
    "deadline": "2026-09-24T00:00:00.000000Z",
    "working_hours_open": 0,
    "working_hours_close": 0,
    "allocated_hours": 150,
    "remaining_hours": 0,
    "effective_hours": 0,
    "total_hours_spent": 0,
    "subtask_effective_hours": 0,
    "overtime": 0,
    "progress": 0,
    "stage_id": 1,
    "project_id": 4,
    "partner_id": 39,
    "parent_id": null,
    "company_id": null,
    "creator_id": 1,
    "created_at": "2025-09-23T12:55:10.000000Z",
    "updated_at": "2025-09-23T12:55:10.000000Z",
    "deleted_at": null
  },
  "message": "Task updated successfully."
}

{
  "message": "Unauthenticated."
}

{
  "message": "Resource not found."
}

{
  "message": "The given data was invalid.",
  "errors": {
    "title": [
      "The title field is required."
    ]
  }
}

Get started

Endpoints

Authorizations

Path Parameters

Body

Response