Nurama Developers

reorder_columns

Bulk-assign new sort orders to columns on a board.

Mutating tool: it changes data in Nurama. Available only when the key carries the matching scope.

Bulk-assign new sort orders to columns on a board. Pass every column you want to position; columns omitted from the array keep their current order. Use after add_column when the new column should not land at the end, or when reorganizing a board's flow.

Input

PropertyTypeRequiredDescription
boardIdstringyesUUID of the board.
columnsobject[]yesColumns and their new sort positions. min items 1

columns (items)

PropertyTypeRequiredDescription
idstringyesUUID of the column.
sortOrdernumberyesNew position (lower = earlier).

JSON Schema

{
  "type": "object",
  "properties": {
    "boardId": {
      "type": "string",
      "description": "UUID of the board."
    },
    "columns": {
      "type": "array",
      "minItems": 1,
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "UUID of the column."
          },
          "sortOrder": {
            "type": "number",
            "description": "New position (lower = earlier)."
          }
        },
        "required": [
          "id",
          "sortOrder"
        ],
        "additionalProperties": false
      },
      "description": "Columns and their new sort positions."
    }
  },
  "required": [
    "boardId",
    "columns"
  ],
  "additionalProperties": false
}

On this page