Update a task status

PUT /api/v1/task-status/{taskStatus_uuid}
Personal access token & O auth2

You cannot update a completed statuses details except it's position

application/json

Body

  • name string

    Name of the task status

  • colour string

    Colour of the task status

  • position integer

    Position of the task status

Responses

  • 201 application/json
    Hide response attributes Show response attributes object
PUT /api/v1/task-status/{taskStatus_uuid} 
curl \
 --request PUT 'https://api.plannrcrm.com/api/v1/task-status/taskStatus_uuid' \
 --header "Authorization: Bearer {OAUTH_ACCESS_TOKEN or PERSONAL_ACCESS_TOKEN}" \
 --header "Content-Type: application/json" \
 --header "Accept: application/json" \
 --header "X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}" \
 --data '{"name":"Incomplete","colour":"#ff0000","position":1}'
Request examples 
# Headers
Authorization: Bearer {OAUTH_ACCESS_TOKEN or PERSONAL_ACCESS_TOKEN}
Content-Type: application/json
Accept: application/json
X-PLANNR-ACCOUNT-UUID: {YOUR_PLANNR_ACCOUNT_UUID}

# Payload
{
  "name": "Incomplete",
  "colour": "#ff0000",
  "position": 1
}
Response examples (201) 
{
  "name": "Incomplete",
  "uuid": "a4eb5401-609f-476a-82b8-1e961c4a72ae",
  "colour": "#398898",
  "position": 1,
  "created_at": "2025-04-02T13:27:56+01:00",
  "updated_at": "2025-04-02T13:27:56+01:00",
  "is_archived": false,
  "is_not_started": false,
  "is_type_completed": false
}