Moves a connection to a new position within its channel. Requires sort permission on the channel.
Authentication required.
Path Params
id
string
required
The Connection ID or slug
Body Params
movement
enum
Movement action for repositioning a connection within a channel. "Top" refers to the visually first position (newest items appear at the top). - `insert_at`: Move to a specific position (requires `position` parameter) - `move_to_top`: Move to the visually first position - `move_to_bottom`: Move to the visually last position - `move_up`: Move one position up (towards the top) - `move_down`: Move one position down (towards the bottom)
position
integer
Target position (required when movement is insert_at)
POST
https://api.are.na/v3/connections/{id}/move
Full connection resource with abilities and links.
id
integer!
Unique identifier for the connection
position
integer!
Position of the item within the channel
pinned
boolean!
Whether the item is pinned
connected_at
string (date-time)!
When the item was connected
connected_by
EmbeddedUser!
User who created this connection
EmbeddedUser
EmbeddedUser
Embedded user representation (used when user is nested in other resources)
id
integer!
Unique identifier for the user
type
string!
User type
User
name
string!
User's display name
slug
string!
URL-safe identifier (use this in API paths)
avatar
string | null (uri)!
URL to user's avatar image
initials
string!
User's initials
unknown
null
can
ConnectionAbilities!
Actions the current user can perform on this connection
remove
boolean!
Whether the user can remove this connection
_links
Links!
HATEOAS links for navigation and discovery.
self
Link!
A hypermedia link containing the URL of a linked resource.
href
string (uri)!
The URL of the linked resource