> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bluprynt.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update a watched asset

> Required scope: `watchlist:write`.



## OpenAPI

````yaml /openapi/explorer.json patch /me/watchlist/{id}
openapi: 3.0.0
info:
  title: Explorer API
  version: 0.0.1
  description: Key-callable routes of the Bluprynt Compliance Explorer registry API.
servers:
  - url: https://explorer-api.bluprynt.com
security:
  - apiKey: []
tags:
  - name: Disclosure monitoring
  - name: Tokenomics
paths:
  /me/watchlist/{id}:
    patch:
      tags:
        - Disclosure monitoring
      summary: Update a watched asset
      description: 'Required scope: `watchlist:write`.'
      operationId: Watchlist.update
      parameters:
        - name: id
          required: true
          in: path
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateWatchlistItemDto'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WatchlistItemDto'
        '401':
          description: Unknown or revoked key (`api_key_invalid`).
        '403':
          description: The key does not hold the required scope (`api_key_scope_missing`).
      security:
        - apiKey: []
components:
  schemas:
    UpdateWatchlistItemDto:
      type: object
      properties:
        monitoringEnabled:
          type: boolean
          description: Monitoring on (default) or paused for this asset.
        note:
          type: string
          nullable: true
          maxLength: 500
          description: Private note; null clears it.
    WatchlistItemDto:
      type: object
      properties:
        id:
          type: string
          format: uuid
        asset:
          $ref: '#/components/schemas/WatchedAssetDto'
        state:
          type: string
          enum:
            - ready
            - gathering
            - unresolved
          description: >-
            `gathering` — intake running ("gathering information"); `unresolved`
            — intake could not add it.
        stateReason:
          type: string
          nullable: true
          description: The intake worker reason when `unresolved`.
        intakeStatus:
          type: string
          nullable: true
          description: The `asset_intake` status while gathering.
        monitoringEnabled:
          type: boolean
        note:
          type: string
          nullable: true
        addedAt:
          type: string
          format: date-time
          description: '"Watched since" — kept across remove/re-add.'
      required:
        - id
        - asset
        - state
        - stateReason
        - intakeStatus
        - monitoringEnabled
        - note
        - addedAt
    WatchedAssetDto:
      type: object
      properties:
        id:
          type: string
          nullable: true
          format: uuid
        name:
          type: string
          nullable: true
        symbol:
          type: string
          nullable: true
        issuerName:
          type: string
          nullable: true
        chain:
          type: string
          nullable: true
          description: CAIP-2 network id.
        chainId:
          type: number
        contractAddress:
          type: string
      required:
        - id
        - name
        - symbol
        - issuerName
        - chain
        - chainId
        - contractAddress
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      bearerFormat: bx_live_…
      description: >-
        Exchange API key issued by Bluprynt, sent as `Authorization: Bearer
        bx_live_<key>`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.