Update radar

Updates criteria, frequency and automation.

PATCH/monitors/{id}monitors:write

BEHAVIOR

The change is validated and persisted in the key account before responding. Query the returned resource as the source of truth.

EFFECT

It can change the resource and emit the corresponding domain event.

REPETITION

On network failure, confirm the resource status before retrying. Automatically redo only 429 and 5xx with backoff and jitter.

Request

idstring · pathResource identifier.minLength 2 · maxLength 100mandatory

namestring · bodyRule name.optional

querystring · bodyMonitored words.optional

sourcestring · bodySource or marketplace.optional

segment_idstring · bodyTarget segment.optional

min_pricenumber · bodyMinimum price.optional

max_pricenumber · bodyMaximum price.optional

min_commissionnumber · bodyMinimum commission.optional

min_discountnumber · bodyMinimum discount.optional

orderstring · bodyOrdering of results.optional

limitinteger · bodyMaximum per round.min 1 · max 100optional

interval_minutesinteger · bodyInterval between searches.min 15 · max 10080optional

auto_approveboolean · bodyAutomatically approves results.optional

activeboolean · bodyActivates monitoring.optional

AuthorizationBearer ach_live_...

Acceptapplication/json

Scopemonitors:write

Executable example

curl

curl -X PATCH 'https://achadu.com/api/v1/monitors/resource_id' \
  -H 'Authorization: Bearer ach_live_...' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  --data '{
  "name": "My integration",
  "query": "string",
  "source": "string"
}'

Response and errors

Every response includes request_id. Lists add pagination; mutable resources return the persisted state after the operation.

200 application/json

{
  "data": {
    "id": "mon_01J...",
    "name": "Air fryers under 350",
    "source": "amazon",
    "keywords": "air fryer",
    "maximum_price": 350,
    "active": 1
  },
  "request_id": "req_01J..."
}

200Operation completed.

400Invalid parameter, body or transition.

401Missing, invalid, expired or revoked key.

402The account plan does not release this interface.

403A chave precisa do escopo monitors:write.

404Feature does not exist in this account.

409The current state prevents this operation.

413The JSON body exceeds 128 KB.

429The 120 requests per minute window has been exceeded.

Update radar

Request

Executable example

Response and errors

Related operations