Skip to content
Optiwork API Docs

Reorder global custom field definitions

PATCH
/custom-fields/definitions/global/reorder
curl --request PATCH \
  --url https://projects.work.optidata.cloud/api/custom-fields/definitions/global/reorder \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "definition_ids": [ 152, 95 ] }'

Persists the display order of the tenant’s global definitions. Restricted to administrators.

Authorizations

Section titled “Authorizations”

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
definition_ids
required
Array<integer>
>= 1 items
Example
{
  "definition_ids": [
    152,
    95
  ]
}

Responses

Section titled “Responses”

204

Section titled “204”

Order saved. No content.

401

Section titled “401”

Missing, invalid or expired bearer passport.

Media typeapplication/json
object
error
string
Example
{
  "error": "JWT passport exception: Missing bearer token in request"
}

403

Section titled “403”

The authenticated user lacks the required board permission.

Media typeapplication/json
object
message
string
Example
{
  "message": "This action is unauthorized."
}

422

Section titled “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."
    ]
  }
}