Change status

Developing

PUT

task/{taskId}/change-status

This API allows clients to update the status of a task while enforcing business workflow rules. A task can only transition between specific statuses depending on its current state.

Allowed Status Transitions

If current status = new
Allowed transitions:

in-progress

canceled

declined

If current status = in-progress
Allowed transitions:

done

canceled

declined

If current status = done
Allowed transition:

new (re-open)

If current status = declined
Allowed transition:

new (re-open)

If current status = canceled
Allowed transition:

re-open (new)

Request

Path Params

Header Params

Body Params application/json

Example

{
    "actor": 0,
    "old": "new",
    "new": "new",
    "reason": "string"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'https://api.einpix.com/public/v1/task//change-status' \
--header 'x-api-key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "actor": 0,
    "old": "new",
    "new": "new",
    "reason": "string"
}'

Responses

🟢200Success

application/json

Body

Example

{}

Modified at 2025-09-18 07:19:36

Detail

By task