Skip to main content
PUT
Reorder Watchlist Members

Authorizations

X-River-Key-Id
string
header
required

UUID of your API key (from Settings → API Keys).

X-River-Timestamp
string
header
required

Current unix seconds. Must be within 30s of server time.

X-River-Signature
string
header
required

Base64 Ed25519 signature over the canonical request: METHOD\nPATH\nSORTED_QUERY\nTIMESTAMP\nSHA256(body) hex. See /api-reference/authentication for the full recipe.

Path Parameters

watchlist_id
string<uuid>
required

Body

application/json

Request schema for reordering a watchlist.

The body is the full ordered list of river_ids; the server rewrites position to match. Sending the whole array avoids partial-reorder races and keeps it to one round-trip.

river_ids
integer[]
required
Minimum array length: 1

Response

Successful Response

Response schema for a watchlist with its resolved members (detail view).

members are ordered by position; river_ids is the same ordering as a convenience for handing straight to the multibook handoff.

watchlist_id
string<uuid>
required
owner_subaccount_id
string<uuid>
required
name
string
required
river_ids
integer[]
required
members
MarketSearchResult · object[]
required
created_at
string
required

Creation timestamp (UTC)

description
string | null