manage_schedule
Account HTTPS interval jobs. action=create writes a schedule and returns it plus the delivery contract (ACL schedule_create). Requires an active plan. This call does not meter. Each later attempt meters outbound_http. Success actions store_kvp meter kvp_ops, store_rag meters rag_index, and notify_webhook meters another outbound_http. Contract: 10 second timeout, up to 3 attempts, exponential backoff capped at 300 seconds, success is HTTP 2xx, auto-disable after 5 consecutive exhausted failures. Minimum interval is 5 minutes. action=list returns schedules (ACL schedule_list). action=get returns one schedule and the contract (ACL schedule_get). action=delete sets enabled off and disabled_reason deleted, which stops future runs and keeps the row (ACL schedule_delete). action=runs lists attempts (ACL schedule_runs_list). No email from this call. Use get_usage to see outbound_http remaining.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | HTTPS URL to call. Required for action=create. Omit otherwise. | |
| name | No | Display name for action=create, up to 120 characters. Default empty. Ignored by other actions. | |
| limit | No | Page size for action=runs. Default 50, maximum 100. Ignored by create, list, get, and delete. | |
| action | Yes | create checks ACL schedule_create and writes a schedule. list checks schedule_list. get checks schedule_get. delete checks schedule_delete and disables future runs. runs checks schedule_runs_list. Required. No default. | |
| method | No | HTTP method for action=create. Default GET. POST may send bodyTemplate. Ignored by other actions. | |
| offset | No | Row offset for action=runs. Default 0. Ignored by create, list, get, and delete. | |
| status | No | Filter for action=runs. failed means retries are exhausted. Omit for every status. Ignored by other actions. | |
| authMode | No | How action=create authenticates the outbound call. Default none. bearer and header require authSecret. Ignored by other actions. | |
| timezone | No | Timezone label stored on the schedule. Default UTC. Used when action=create. Ignored by other actions. | |
| onFailure | No | Actions after retries are exhausted, for action=create. Same object shapes as onSuccess. Omit for none. | |
| onSuccess | No | Actions after a 2xx response, for action=create. Each item is {type:store_kvp, namespace, key}, {type:store_rag, namespace}, or {type:notify_webhook, url}. Omit for none. store_kvp meters kvp_ops, store_rag meters rag_index, notify_webhook meters outbound_http when the run happens. | |
| authSecret | No | Secret for authMode=bearer or header on action=create. Stored encrypted. Required for those modes. Omit for authMode=none. | |
| scheduleId | No | Schedule id. Required for get and delete. Optional filter for runs. Omit for create and list. | |
| bodyTemplate | No | POST body for action=create when method=POST. Omit for an empty body. Ignored for GET and for other actions. | |
| authHeaderName | No | Header name when authMode=header. Default authorization. Ignored unless action=create and authMode=header. | |
| intervalMinutes | No | Minutes between runs. Required for action=create. Minimum 5. Ignored by other actions. |