Skip to main content
PATCH
/
user-management
/
v1
/
watchlists
/
{id}
Update a watchlist
curl --request PATCH \
  --url https://api.messari.io/user-management/v1/watchlists/{id} \
  --header 'Content-Type: */*' \
  --header 'X-Messari-API-Key: <api-key>' \
  --data '
{
  "assetIds": [
    "<string>"
  ],
  "title": "<string>"
}
'
{
  "error": null,
  "data": {
    "id": "BA3FDA7B",
    "title": "Updated Portfolio Name",
    "assetIds": [
      "1e31218a-e44e-4285-820c-8282ee222035",
      "21c795f5-1bfd-40c3-858e-e9d7e820c6d0"
    ],
    "createdAt": "2026-03-27T14:11:02.612968Z",
    "updatedAt": "2026-03-27T14:11:08.052905Z"
  }
}

​
Overview

Updates a watchlist’s metadata such as its title. Only the fields provided in the request body will be updated — omitted fields remain unchanged. If assetIds is provided, it replaces the entire asset list. If omitted, assets remain unchanged. If an empty array is provided, all assets are removed.
To add or remove individual assets without replacing the full list, use the Update Watchlist Assets endpoint instead.

Authorizations

​
X-Messari-API-Key
string
header
required

Path Parameters

​
id
string
required

Body

*/*
​
assetIds
string[]

If not provided, the watchlist assets will not be updated. If empty, all assets will be removed.

​
title
string

If not provided, the watchlist title will not be updated

Response

Default response

​
data
object
required
​
error
string