Skip to main content
POST
/
v1
/
watches
/
bulk
curl -X POST "https://api.signa.so/v1/watches/bulk" \
  -H "Authorization: Bearer $SIGNA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: bulk-apple-class9-2026-06-12" \
  -d '{
    "watches": [
      { "name": "Apple US class 9", "watch_type": "class",
        "query": { "version": "v1", "filters": { "niceClasses": [9], "jurisdictions": ["US"] } } },
      { "name": "Apple EU class 9", "watch_type": "class",
        "query": { "version": "v1", "filters": { "niceClasses": [9], "jurisdictions": ["EU"] } } }
    ]
  }'

{
  "object": "<string>",
  "data": [
    {}
  ],
  "request_id": "<string>"
}

​
Overview

Bulk-create variant of Create Watch. The full set is validated upfront — no partial inserts. Counts against the per-plan watches.maxResources quota.

​
Body Parameters

​
watches
object[]
required
1—100 watch specifications. Each item has the same shape as the body of Create Watch.

​
Response

​
object
string
Always "list".
​
data
object[]
Array of created Watch objects in input order.
​
request_id
string
Request identifier.

​
Errors

  • 400 — any item fails validation (whole batch rejected).
  • 409 — quota exceeded.
  • 413 — combined payload exceeds the per-request limit.
curl -X POST "https://api.signa.so/v1/watches/bulk" \
  -H "Authorization: Bearer $SIGNA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: bulk-apple-class9-2026-06-12" \
  -d '{
    "watches": [
      { "name": "Apple US class 9", "watch_type": "class",
        "query": { "version": "v1", "filters": { "niceClasses": [9], "jurisdictions": ["US"] } } },
      { "name": "Apple EU class 9", "watch_type": "class",
        "query": { "version": "v1", "filters": { "niceClasses": [9], "jurisdictions": ["EU"] } } }
    ]
  }'
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.