Update watchlist item

curl --request PATCH \
  --url https://api.eventory.ai/watchlist/{id} \
  --header 'Content-Type: application/json' \
  --header 'apikey: <api-key>' \
  --data '
{
  "seat_quantity": 4,
  "task_active": true
}
'

import requests

url = "https://api.eventory.ai/watchlist/{id}"

payload = {
    "seat_quantity": 4,
    "task_active": True
}
headers = {
    "apikey": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {apikey: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({seat_quantity: 4, task_active: true})
};

fetch('https://api.eventory.ai/watchlist/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "item": {
    "id": 123,
    "client_id": 42,
    "website": "ticketmaster",
    "event": "0200642CF18CAA24",
    "region": "US",
    "min_price_filter": null,
    "max_price_filter": 250,
    "min_avg_price_threshold": null,
    "max_avg_price_threshold": null,
    "stock_threshold_filter": 1,
    "stock_threshold_filter_max": null,
    "min_stock_increase_filter": 4,
    "min_stock_decrease_filter": null,
    "seat_quantity": 2,
    "priority": 0,
    "section": null,
    "keywords": null,
    "date_filter": null,
    "row_filter": null,
    "change_type": "stock_increase",
    "standard_tickets": true,
    "resale_tickets": false,
    "general_admission_tickets": false,
    "platinum_tickets": false,
    "vip_tickets": false,
    "no_restricted_view": false,
    "no_accessibility": false,
    "no_presale": false,
    "auto_add_to_watchlist": false,
    "task_active": true,
    "muted_until": null,
    "notes": null,
    "tm_did": null,
    "roles_json": null,
    "webhook_setting_id": null,
    "role_id": null,
    "website_id": null,
    "created_at": "2026-06-18T09:20:00.123456",
    "updated_at": "2026-06-18T09:20:00.123456",
    "deleted": false
  },
  "ignored_fields": [
    "platinum_tickets",
    "row_filter"
  ],
  "warning": "Not supported on this website/region and reset: platinum_tickets, row_filter"
}

Watchlist

Update watchlist item

Partial update. Send only the fields you want to change; omitted fields are left untouched. To clear a nullable field, send it explicitly as null; null on a boolean field or on priority is ignored.

Unknown keys are rejected with 400 rather than ignored. The read-only fields returned by GET (id, client_id, created_at, updated_at, deleted, website_id) are accepted and ignored, so you can send back an item you read.

A filter that the target website / region does not support is dropped and listed in ignored_fields; the update still succeeds.

An update that would take your account past your plan’s limit of active events, such as setting task_active to true or moving an active item to another event, is rejected with 403.

Changes, including change_type, reach active stream connections within 60 seconds without a reconnect.

Cost: free.

PATCH

watchlist

{id}

Update watchlist item

curl --request PATCH \
  --url https://api.eventory.ai/watchlist/{id} \
  --header 'Content-Type: application/json' \
  --header 'apikey: <api-key>' \
  --data '
{
  "seat_quantity": 4,
  "task_active": true
}
'

import requests

url = "https://api.eventory.ai/watchlist/{id}"

payload = {
    "seat_quantity": 4,
    "task_active": True
}
headers = {
    "apikey": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {apikey: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({seat_quantity: 4, task_active: true})
};

fetch('https://api.eventory.ai/watchlist/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "item": {
    "id": 123,
    "client_id": 42,
    "website": "ticketmaster",
    "event": "0200642CF18CAA24",
    "region": "US",
    "min_price_filter": null,
    "max_price_filter": 250,
    "min_avg_price_threshold": null,
    "max_avg_price_threshold": null,
    "stock_threshold_filter": 1,
    "stock_threshold_filter_max": null,
    "min_stock_increase_filter": 4,
    "min_stock_decrease_filter": null,
    "seat_quantity": 2,
    "priority": 0,
    "section": null,
    "keywords": null,
    "date_filter": null,
    "row_filter": null,
    "change_type": "stock_increase",
    "standard_tickets": true,
    "resale_tickets": false,
    "general_admission_tickets": false,
    "platinum_tickets": false,
    "vip_tickets": false,
    "no_restricted_view": false,
    "no_accessibility": false,
    "no_presale": false,
    "auto_add_to_watchlist": false,
    "task_active": true,
    "muted_until": null,
    "notes": null,
    "tm_did": null,
    "roles_json": null,
    "webhook_setting_id": null,
    "role_id": null,
    "website_id": null,
    "created_at": "2026-06-18T09:20:00.123456",
    "updated_at": "2026-06-18T09:20:00.123456",
    "deleted": false
  },
  "ignored_fields": [
    "platinum_tickets",
    "row_filter"
  ],
  "warning": "Not supported on this website/region and reset: platinum_tickets, row_filter"
}

Authorizations

apikey

string

header

required

Your Eventory API key. Sent as the apikey request header.

Path Parameters

integer

required

Watchlist item id, as returned on create. 0 or a negative id is rejected with 400.

Example:

123

Body

application/json

Optional filters and options. Omit a field to keep the server default. Boolean fields and priority are never null; sending null for one is ignored.

website

string

event

string

region

string

min_price_filter

number | null

Ignore tickets priced below this.

max_price_filter

number | null

Ignore tickets priced above this.

min_avg_price_threshold

number | null

max_avg_price_threshold

number | null

stock_threshold_filter

integer | null

Minimum available stock to notify on.

stock_threshold_filter_max

integer | null

Maximum available stock to notify on.

min_stock_increase_filter

integer | null

Only notify when the stock increase is at least this many tickets. Must be a positive integer; null turns the filter off. 0 or a negative value is rejected with 400.

Example:

4

min_stock_decrease_filter

integer | null

Only notify when the stock decrease is at least this many tickets. Must be a positive integer; null turns the filter off. 0 or a negative value is rejected with 400.

Example:

4

vip_tickets

boolean

Include VIP tickets.

seat_quantity

integer | null

Number of contiguous seats wanted.

priority

integer | null

section

string | null

Restrict to a section name.

keywords

string | null

date_filter

string | null

row_filter

string | null

change_type

enum<string> | null

default:stock_increase

Which change triggers a notification. The stream enforces this server-side. Any value outside this list is rejected with 400.

Available options:

stock_increase,

stock_decrease,

price_decrease,

price_increase,

null

standard_tickets

boolean

resale_tickets

boolean

general_admission_tickets

boolean

platinum_tickets

boolean

no_restricted_view

boolean

no_accessibility

boolean

no_presale

boolean

auto_add_to_watchlist

boolean

task_active

boolean

Whether monitoring for this item is active.

muted_until

string<date-time> | null

Suppress notifications until this time.

notes

string | null

tm_did

string | null

Ticketmaster device id.

roles_json

Pass-through JSON; treat as opaque.

webhook_setting_id

integer | null

role_id

integer | null

Response

The full updated item under item, plus ignored_fields and warning when a filter was reset.

item

object

required

Optional filters and options. Omit a field to keep the server default. Boolean fields and priority are never null; sending null for one is ignored.

Show child attributes

Example:

{
  "id": 123,
  "client_id": 42,
  "website": "ticketmaster",
  "event": "0200642CF18CAA24",
  "region": "US",
  "min_price_filter": null,
  "max_price_filter": 250,
  "min_avg_price_threshold": null,
  "max_avg_price_threshold": null,
  "stock_threshold_filter": 1,
  "stock_threshold_filter_max": null,
  "min_stock_increase_filter": 4,
  "min_stock_decrease_filter": null,
  "seat_quantity": 2,
  "priority": 0,
  "section": null,
  "keywords": null,
  "date_filter": null,
  "row_filter": null,
  "change_type": "stock_increase",
  "standard_tickets": true,
  "resale_tickets": false,
  "general_admission_tickets": false,
  "platinum_tickets": false,
  "vip_tickets": false,
  "no_restricted_view": false,
  "no_accessibility": false,
  "no_presale": false,
  "auto_add_to_watchlist": false,
  "task_active": true,
  "muted_until": null,
  "notes": null,
  "tm_did": null,
  "roles_json": null,
  "webhook_setting_id": null,
  "role_id": null,
  "website_id": null,
  "created_at": "2026-06-18T09:20:00.123456",
  "updated_at": "2026-06-18T09:20:00.123456",
  "deleted": false
}

ignored_fields

string[]

Filters that were reset because the target website / region does not support them. Only seat_quantity, row_filter, tm_did, platinum_tickets and vip_tickets are checked. The request still succeeds; the stored item has those filters switched off: null, or true for platinum_tickets and vip_tickets. Absent when nothing was reset.

Example:

["platinum_tickets", "row_filter"]

warning

string

Human-readable summary of ignored_fields. Present only when ignored_fields is.

Example:

"Not supported on this website/region and reset: platinum_tickets, row_filter"

Overview

Market Data

Live Availability

Watchlist

Account

Update watchlist item

Authorizations

Path Parameters

Body

Response