Reorder the caller's board list

PATCH

/boards/order

curl --request PATCH \
  --url https://projects.work.optidata.cloud/api/boards/order \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "board_ids": [ 42, 51, 12 ] }'

• Optiwork Projects API

Persists the personal display order of the caller’s boards (the sidebar order). Affects only the authenticated user.

Authorizations

• bearerAuth

Request Body^required

Media typeapplication/json

object

board_ids

required

Board ids in the desired display order.

Array<integer>

>= 1 items

Example

{
  "board_ids": [
    42,
    51,
    12
  ]
}

Responses

204

Order saved. No content.

401

Missing, invalid or expired bearer passport.

Media typeapplication/json

object

error

string

Example

{
  "error": "JWT passport exception: Missing bearer token in request"
}

403

The authenticated user lacks the required board permission.

Media typeapplication/json

object

message

string

Example

{
  "message": "This action is unauthorized."
}

422

Validation failed.

Media typeapplication/json

object

message

First validation error message.

string

errors

Map of field name → list of error messages.

object

key

additional properties

Array<string>

Example

{
  "message": "The name field is required.",
  "errors": {
    "name": [
      "The name field is required."
    ]
  }
}