put
https://api.seismic.com/programs/v2/spaces//rank
Updates the display order (rank) of a task, request, or program by repositioning it relative to another item.
The rank determines the default sort order when viewing items in lists. This endpoint uses a lexicographic
ranking system that efficiently handles reordering without requiring updates to all other items in the list.
Key Features:
- Reorder tasks, requests, or programs within their parent container or list view
- Position items before the first item or after any specific item using nodeIdAfter
- Uses efficient lexicographic ranking that doesn't require updating all items
- Updates are immediately reflected in list views sorted by rank
- Maintains rank consistency across all users viewing the same space
Authorization Logic:
- User must have a valid JWT token with management scopes
- Token must be valid for this operation (tenant tokens are not supported)
- User must have permission to update the entity being reordered
Usage Example:
Drag and drop a task to reorder it in a task list, move a program to prioritize it in the program view,
or reposition a request to organize workflow priorities.