Record and List Ordering

Use rank instead of position for the manual order of records and lists.

Records and lists use rank for manual order. The older position field is retired for these two resources.

ResourceRank scopeDisplay order
RecordOne listSort rank descending for the board’s top-to-bottom order.
ListOne workspaceSort rank ascending for the board’s left-to-right order.

Treat a rank as an opaque string. Do not parse it, convert it to a number, or generate a new value. Compare ranks only inside their scope: records in the same list or lists in the same workspace.

The REST record and list responses return rank instead of position. This includes list-records, get-record, create-record, list-lists, and create-list.

The REST list-records operation uses skip and limit. It does not accept a sort or rank cursor. If you need indexed rank pagination for a large single list, use the GraphQL rankBefore cursor.