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"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.messari.io/llms.txt

Use this file to discover all available pages before exploring further.

​
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