Skip to main content
POST
Bulk Create Watches
Credits: 1 per mark per day (free during beta). Management requests cost 0 credits; the daily monitoring meter is separate.

Overview

Bulk-create variant of Create Watch. The full set is validated upfront; there are no partial inserts. When items fail validation, the 400 lists every failing item, and each errors[].field starts with the item’s index (watches[2].query.q). Counts against your plan’s watch limit. Requires the portfolios:manage scope.

Body Parameters

object[]
required
1-100 watch specifications. Each item has the same shape as the body of Create Watch and is stored the same way: as a v3 watch, unless its query uses the deprecated strategies / min_match_tier keys.

Response

string
Always "list".
object[]
Array of created Watch objects, in input order. An item whose query used a deprecated key (strategies, min_match_tier) carries its own deprecations array, as on Create Watch.
string
Request identifier.
Filter keys inside query.filters are camelCase (niceClasses, jurisdictions, ownerId, …). Unknown keys, including snake_case typos like nice_classes, are rejected with 400, as is query.match in any form. See the canonical query reference.

Code Examples