Renew Entity Monitoring
renew_entity_monitoringRenews monitoring for up to 25 entities for another 12 months. Requires an idempotency key and returns order details; dry_run defaults to true to preview the charge.
Instructions
Renew monitoring for up to 25 entities for another 12 months. LIVE cost $18.00 per entity; sandbox $0.
Monitoring never auto-renews: act on monitoring.expiring webhooks (30 and 7 days before expiry) or list_monitored_entities with expires_before. idempotency_key is REQUIRED by the API (400 without it): your unique string per renewal batch, reused on retries so a timed-out retry never buys a second year. Active entities: the new term starts at the current expiry; expired: today. Expiry can't go more than 2 years ahead (renewal_too_far_ahead). A stopped entity with time left must be resumed, not renewed. Deregistered companies / cancelled ABNs can't be renewed. Any id not yours -> whole request 404, nothing charged. Response has the order shape {unitPrice, total, entities}. dry_run=true (default) returns the payload only.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"entity_ids": "<entity_ids>",
"idempotency_key": "<idempotency_key>"
},
"name": "renew_entity_monitoring"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | ||
| entity_ids | Yes | ||
| idempotency_key | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||