Add explicit known stores to self-directed watch

POST/self-directed-watches

Requires scope: write:watch

Parameters

Parameter	In	Type	Description
`Idempotency-Key`required	header	string	Stable logical request ID required for every machine mutation; exact retries replay and changed inputs conflict.

Request body

Field	Type	Allowed values	Description
`store_ids`required	string[]	any string[]

Responses

Status	Description
`200`	Self-directed watch result, including monthly expected spend
`400`	Invalid or unknown explicit store ids
`401`	Missing or invalid watch credential
`403`	Credential lacks the required watch scope, budget subject, or human principal
`404`	The watch surface is dormant
`409`	The resize is unfunded or watch and meter counts disagree
`503`	Watch authorization is unavailable

Is this page helpful?

Request

curl -X POST "https://vergio.ai/api/v1/self-directed-watches" \
  -H "Authorization: Bearer $VERGIO_API_KEY" \
  -H "Idempotency-Key: replace-with-a-stable-request-id" \
  -H "Content-Type: application/json" \
  -d '{
  "store_ids": [
    "b7c9a2e1-0000-4000-8000-000000000000"
  ]
}'