The complete workflow
1. Search and filter
Query a bounded UTC interval for Moon phases, ingresses, stations, aspects, or exact-hit-anchored aspect windows. Narrow Moon results to selected phase sectors.
2. Save and schedule
Create and edit strict event-calendar criteria in the dashboard, or create event-rule-search criteria through the API. The dashboard safely displays both saved-operation types and can schedule either one; event-rule-search criteria remain API-managed.
3. Export
Request deterministic iCalendar or CSV text inside the response, including stable event identifiers and explicit interval conventions.
4. Deliver
Each due schedule enqueues a durable job for its saved operation: event-calendar or event-rule-search. Completion flows through the existing signed webhook delivery path.
Operational guarantees and limits
- Scheduled runs reuse the selected API key's scope, environment policy, monthly quota, per-key budget, and account entitlement.
- Every scheduled result is a normal durable job result; the scheduler never calculates inside the scheduler process.
- Jobs remain globally serial. A schedule does not create customer-selectable parallelism or bypass the queue.
- One saved event search can have one schedule; each account can hold at most ten schedules.
- Ambiguous interpretation, ranking, notification prose, and astrological advice remain application responsibilities.
APIs in the workflow
POST /api/astro/event-calendar and POST /api/astro/event-rule-search perform synchronous searches. POST /api/jobs submits either operation as a durable calculation. Dashboard-session routes under /api/saved-event-searches and /api/event-search-schedules manage reusable criteria and schedules; the dashboard creates and edits event-calendar criteria while API-created event-rule-search criteria remain visible and schedulable. Signed webhook delivery remains tied to job completion.
Schedule timestamps and windows are UTC. Search boundaries are start-inclusive and end-exclusive. Consult the endpoint schema for the exact supported bodies, aspects, limits, and exports.