{"openapi":"3.1.0","info":{"title":"CosmyDay API","version":"1.0.0"},"paths":{"/order/pricing":{"get":{"tags":["orders"],"summary":"Get Pricing","description":"Return pricing configuration for the frontend.","operationId":"get_pricing_order_pricing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/order/create-batch":{"post":{"tags":["orders"],"summary":"Create Batch","description":"Create batch orders with payment mode from config.\n\npayment_mode in config.json:\n- \"soft_launch\": Skip payment, mark as free, generate immediately\n- \"simulate\": Localhost test mode (admin/test-payment triggers pipeline)\n- \"paypal\": Production PayPal Smart Checkout\n\nFlow:\n1. Validate topics, check rate limit, calculate pricing\n2. Create orders in DB with group_id\n3. Handle payment based on payment_mode\n4. Return response for frontend","operationId":"create_batch_order_create_batch_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateBatchRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/order/event-reading":{"post":{"tags":["orders"],"summary":"Create Event Reading","description":"Create a single-item order for one event from the caller's own calendar.\n\nDeliberately NOT routed through create-batch. That endpoint is built for\nmulti-topic selection with bundle discounts — a $1.99 item bundled with a\n$29 report would apply the multi-item discount to both — and it accepts a\nclient-supplied birth_data blob, which for this SKU we already hold and\nshould not trust the client for.","operationId":"create_event_reading_order_event_reading_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateEventReadingRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/order/{group_id}/payment-status":{"get":{"tags":["orders"],"summary":"Get Payment Status","description":"Poll payment status for a batch. Frontend calls this every 2s.","operationId":"get_payment_status_order__group_id__payment_status_get","parameters":[{"name":"group_id","in":"path","required":true,"schema":{"type":"string","title":"Group Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/order/capture-payment":{"post":{"tags":["orders"],"summary":"Capture Payment","description":"Capture PayPal payment after frontend onApprove fires.\nThis is the PRIMARY payment confirmation — NOT webhooks.\n\nFlow: frontend SDK onApprove → calls this → backend captures → verifies → marks paid.","operationId":"capture_payment_order_capture_payment_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CapturePaymentRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/order/validate-coupon":{"post":{"tags":["orders"],"summary":"Validate Coupon Endpoint","description":"Validate a coupon without creating an order.\n\nThe discount must be computed on the SAME base calculate_pricing uses at\ncreate-batch: after the bundle and regional discounts, excluding entry\nSKUs. This used to take the percentage off the raw sum, so a five-report\nbasket with CAL15 showed $38.02 and PayPal then asked for $39.78.","operationId":"validate_coupon_endpoint_order_validate_coupon_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidateCouponRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/order/capture-intent":{"post":{"tags":["orders"],"summary":"Capture Intent","description":"Track checkout intent — user clicked pay but hasn't completed.\nSaves to email_subscribers for retargeting.","operationId":"capture_intent_order_capture_intent_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CaptureIntentRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/order/checkout-stage":{"post":{"tags":["orders"],"summary":"Checkout Stage","description":"Record how far a checkout got, and release the coupon if it died.\n\nFire-and-forget telemetry from the browser. Always returns 200, even for an\nunknown stage or a group that does not exist: this is called from PayPal\nerror handlers, and an exception here would replace a recoverable payment\nproblem with a broken page.\n\nSync `def` (FastAPI runs it in a threadpool) because it does blocking sqlite\nwork and this is called from an unloading page.","operationId":"checkout_stage_order_checkout_stage_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckoutStageRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/order/payment-help":{"post":{"tags":["orders"],"summary":"Payment Help","description":"A visitor says they cannot pay — alert the operator so they can close\nthe sale by hand.\n\nDeliberately tolerant: the whole point is that this fires when checkout is\nalready misbehaving, so it accepts a request with no group_id (the user hit\ntrouble before an order row existed) and never 500s.","operationId":"payment_help_order_payment_help_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentHelpRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/order/subscribe/calendar":{"post":{"tags":["orders"],"summary":"Subscribe Calendar","description":"Subscribe to free personalized calendar. Saves to email_subscribers, worker generates PDF.","operationId":"subscribe_calendar_order_subscribe_calendar_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscribeCalendarRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/login":{"post":{"tags":["admin"],"summary":"Login","operationId":"login_admin_login_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/logout":{"post":{"tags":["admin"],"summary":"Logout","operationId":"logout_admin_logout_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/dashboard":{"get":{"tags":["admin"],"summary":"Dashboard","operationId":"dashboard_admin_dashboard_get","parameters":[{"name":"period","in":"query","required":false,"schema":{"type":"string","default":"month","title":"Period"}},{"name":"date_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date From"}},{"name":"date_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date To"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/orders":{"get":{"tags":["admin"],"summary":"List Orders","operationId":"list_orders_admin_orders_get","parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"topic","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Topic"}},{"name":"email","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"}},{"name":"report_status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Report Status"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Per Page"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/orders/abandoned":{"get":{"tags":["admin"],"summary":"Abandoned Checkouts","description":"Pending checkouts grouped by the stage they died at.\n\nDeclared BEFORE /orders/{order_id} — FastAPI matches routes in definition\norder, so the parameterised route would otherwise swallow \"abandoned\" and\nreturn a 404 for a missing order.","operationId":"abandoned_checkouts_admin_orders_abandoned_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","default":30,"title":"Days"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/orders/{order_id}":{"get":{"tags":["admin"],"summary":"Order Detail","operationId":"order_detail_admin_orders__order_id__get","parameters":[{"name":"order_id","in":"path","required":true,"schema":{"type":"string","title":"Order Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/orders/{order_id}/retry":{"post":{"tags":["admin"],"summary":"Retry Order","operationId":"retry_order_admin_orders__order_id__retry_post","parameters":[{"name":"order_id","in":"path","required":true,"schema":{"type":"string","title":"Order Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/orders/{order_id}/resend":{"post":{"tags":["admin"],"summary":"Resend Order","operationId":"resend_order_admin_orders__order_id__resend_post","parameters":[{"name":"order_id","in":"path","required":true,"schema":{"type":"string","title":"Order Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/orders/{order_id}/pdf":{"get":{"tags":["admin"],"summary":"Download Pdf","operationId":"download_pdf_admin_orders__order_id__pdf_get","parameters":[{"name":"order_id","in":"path","required":true,"schema":{"type":"string","title":"Order Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/clients":{"get":{"tags":["admin"],"summary":"List Clients","operationId":"list_clients_admin_clients_get","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Per Page"}},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/clients/detail":{"get":{"tags":["admin"],"summary":"Client Detail","operationId":"client_detail_admin_clients_detail_get","parameters":[{"name":"email","in":"query","required":true,"schema":{"type":"string","title":"Email"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/email/health":{"get":{"tags":["admin"],"summary":"Email List Health","description":"List health: who can still be emailed, and why the rest cannot.\n\n/admin/subscribers shows a \"Status\" column that is the calendar DELIVERY\nstate, not list health — so unsubscribes, bounces and complaints were\ninvisible in the admin panel entirely. This is the view the operator needs\nto watch the effect of the top-of-email unsubscribe link.\n\nSync (`def`) on purpose: it runs sqlite aggregates, and a blocking query on\nthe event loop freezes the whole API — see the note in create_batch.","operationId":"email_list_health_admin_email_health_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/subscribers/breakdown":{"get":{"tags":["admin"],"summary":"Subscribers Breakdown","description":"Demographic + acquisition breakdown of email_subscribers.\n\nDimension filters arrive as plain query params named after the dimension\n(?sex=female&age=25-34). They are read off the raw query string rather than\ndeclared individually so adding a dimension in db/subscribers.py needs no\nsignature change here; anything not in DIMENSION_KEYS is ignored.","operationId":"subscribers_breakdown_admin_subscribers_breakdown_get","parameters":[{"name":"date_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date From"}},{"name":"date_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date To"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Per Page"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/engagement":{"get":{"tags":["admin"],"summary":"Engagement","description":"Per-subscriber: was the calendar opened, how often, when last — plus\nevery trigger and scheduled email for that person.","operationId":"engagement_admin_engagement_get","parameters":[{"name":"date_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date From"}},{"name":"date_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date To"}},{"name":"search","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Search"}},{"name":"only","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Only"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/visitors":{"get":{"tags":["admin"],"summary":"Visitors Report","description":"New vs returning visitors, visit cohorts, retention curve, return paths.","operationId":"visitors_report_admin_visitors_get","parameters":[{"name":"date_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date From"}},{"name":"date_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date To"}},{"name":"campaign","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign"}},{"name":"source","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"}},{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Per Page"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/widgets":{"get":{"tags":["admin"],"summary":"Widget Embeds Report","description":"Which external sites embed our widgets, and what each placement returns.\n\nSync `def` on purpose: this does blocking sqlite work, and an `async def`\nhandler would run it on the event loop and stall every other request.","operationId":"widget_embeds_report_admin_widgets_get","parameters":[{"name":"date_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date From"}},{"name":"date_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date To"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/coupons":{"get":{"tags":["admin"],"summary":"List Coupons","operationId":"list_coupons_admin_coupons_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["admin"],"summary":"Create Coupon Endpoint","operationId":"create_coupon_endpoint_admin_coupons_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCouponRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/coupons/{code}/toggle":{"patch":{"tags":["admin"],"summary":"Toggle Coupon Endpoint","operationId":"toggle_coupon_endpoint_admin_coupons__code__toggle_patch","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","title":"Code"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/coupons/{code}/usage":{"get":{"tags":["admin"],"summary":"Coupon Usage","operationId":"coupon_usage_admin_coupons__code__usage_get","parameters":[{"name":"code","in":"path","required":true,"schema":{"type":"string","title":"Code"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/test-payment":{"post":{"tags":["admin"],"summary":"Test Payment","description":"Simulate a successful payment for testing.\nMarks orders as paid, sets report_status to 'generating',\nsends confirmation email, and the worker picks it up.\n\nOnly allowed from localhost or when admin is authenticated.","operationId":"test_payment_admin_test_payment_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestPaymentRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/system":{"get":{"tags":["admin"],"summary":"System Status","operationId":"system_status_admin_system_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/pricing":{"get":{"tags":["admin"],"summary":"Get Pricing Admin","operationId":"get_pricing_admin_admin_pricing_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["admin"],"summary":"Save Pricing Admin","operationId":"save_pricing_admin_admin_pricing_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SavePricingRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/email/audiences":{"get":{"tags":["admin"],"summary":"Email Audiences","operationId":"email_audiences_admin_email_audiences_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/email/preview":{"post":{"tags":["admin"],"summary":"Email Preview","operationId":"email_preview_admin_email_preview_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignPreviewRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/email/test":{"post":{"tags":["admin"],"summary":"Email Test","operationId":"email_test_admin_email_test_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignTestRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/email/send":{"post":{"tags":["admin"],"summary":"Email Send","operationId":"email_send_admin_email_send_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CampaignSendRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/email/campaigns":{"get":{"tags":["admin"],"summary":"Email Campaigns","operationId":"email_campaigns_admin_email_campaigns_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":30,"title":"Limit"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/email/campaigns/{campaign_id}":{"get":{"tags":["admin"],"summary":"Email Campaign Detail","operationId":"email_campaign_detail_admin_email_campaigns__campaign_id__get","parameters":[{"name":"campaign_id","in":"path","required":true,"schema":{"type":"integer","title":"Campaign Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/hook":{"get":{"tags":["hooks"],"summary":"Get Hook","description":"Get personalized astrological hook for sticky bar.","operationId":"get_hook_hook_get","parameters":[{"name":"birth_date","in":"query","required":true,"schema":{"type":"string","description":"YYYY-MM-DD","title":"Birth Date"},"description":"YYYY-MM-DD"},{"name":"birth_time","in":"query","required":true,"schema":{"type":"string","description":"HH:MM","title":"Birth Time"},"description":"HH:MM"},{"name":"lat","in":"query","required":true,"schema":{"type":"number","title":"Lat"}},{"name":"lon","in":"query","required":true,"schema":{"type":"number","title":"Lon"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/analytics/event":{"post":{"tags":["analytics"],"summary":"Ingest Events","operationId":"ingest_events_analytics_event_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalyticsBatch"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/analytics/events":{"get":{"tags":["analytics"],"summary":"Admin Get Events","operationId":"admin_get_events_admin_analytics_events_get","parameters":[{"name":"date_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO UTC, inclusive","title":"Date From"},"description":"ISO UTC, inclusive"},{"name":"date_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO UTC, inclusive","title":"Date To"},"description":"ISO UTC, inclusive"},{"name":"event_name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event Name"}},{"name":"page","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"substring match on page_url","title":"Page"},"description":"substring match on page_url"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"default":100,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/analytics/campaigns":{"get":{"tags":["analytics"],"summary":"Admin Get Campaigns","operationId":"admin_get_campaigns_admin_analytics_campaigns_get","parameters":[{"name":"date_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO UTC, inclusive","title":"Date From"},"description":"ISO UTC, inclusive"},{"name":"date_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO UTC, inclusive","title":"Date To"},"description":"ISO UTC, inclusive"},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/analytics/funnel":{"get":{"tags":["analytics"],"summary":"Admin Get Funnel","operationId":"admin_get_funnel_admin_analytics_funnel_get","parameters":[{"name":"date_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO UTC, inclusive","title":"Date From"},"description":"ISO UTC, inclusive"},{"name":"date_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO UTC, inclusive","title":"Date To"},"description":"ISO UTC, inclusive"},{"name":"campaign","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign"}},{"name":"source","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"}},{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO-2, e.g. US","title":"Country"},"description":"ISO-2, e.g. US"},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/analytics/funnel/countries":{"get":{"tags":["analytics"],"summary":"Admin Get Funnel Countries","description":"Per-country funnel for the current scope. Lazily fetched by the admin UI\nwhen a campaign row is expanded, so it costs nothing on page load.","operationId":"admin_get_funnel_countries_admin_analytics_funnel_countries_get","parameters":[{"name":"date_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO UTC, inclusive","title":"Date From"},"description":"ISO UTC, inclusive"},{"name":"date_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO UTC, inclusive","title":"Date To"},"description":"ISO UTC, inclusive"},{"name":"campaign","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign"}},{"name":"source","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/ads/performance":{"get":{"tags":["analytics"],"summary":"Admin Ads Performance","operationId":"admin_ads_performance_admin_ads_performance_get","parameters":[{"name":"date_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO UTC, inclusive","title":"Date From"},"description":"ISO UTC, inclusive"},{"name":"date_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO UTC, inclusive","title":"Date To"},"description":"ISO UTC, inclusive"},{"name":"day_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"YYYY-MM-DD, Meta account days","title":"Day From"},"description":"YYYY-MM-DD, Meta account days"},{"name":"day_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"YYYY-MM-DD, Meta account days","title":"Day To"},"description":"YYYY-MM-DD, Meta account days"},{"name":"platform","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"default":"meta","title":"Platform"}},{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO-2, e.g. US","title":"Country"},"description":"ISO-2, e.g. US"},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/ads/meta/sync":{"post":{"tags":["analytics"],"summary":"Admin Meta Sync","operationId":"admin_meta_sync_admin_ads_meta_sync_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/ads/meta/token":{"post":{"tags":["analytics"],"summary":"Admin Meta Token","description":"Save (or with an empty string, remove) the read-only Marketing API token.\nIt is checked against the ad account before it replaces anything.","operationId":"admin_meta_token_admin_ads_meta_token_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetaTokenBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/analytics/depth":{"get":{"tags":["analytics"],"summary":"Admin Get Depth","description":"Scroll depth + section reach after the natal chart was revealed.","operationId":"admin_get_depth_admin_analytics_depth_get","parameters":[{"name":"date_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO UTC, inclusive","title":"Date From"},"description":"ISO UTC, inclusive"},{"name":"date_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO UTC, inclusive","title":"Date To"},"description":"ISO UTC, inclusive"},{"name":"campaign","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign"}},{"name":"source","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"}},{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO-2, e.g. US","title":"Country"},"description":"ISO-2, e.g. US"},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/analytics/email-crm":{"get":{"tags":["analytics"],"summary":"Admin Get Email Crm","description":"Lifecycle email programme: per-stream reach, list health, queue ahead.\n\nSync (`def`) on purpose — several sqlite aggregates.","operationId":"admin_get_email_crm_admin_analytics_email_crm_get","parameters":[{"name":"date_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO UTC, inclusive","title":"Date From"},"description":"ISO UTC, inclusive"},{"name":"date_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO UTC, inclusive","title":"Date To"},"description":"ISO UTC, inclusive"},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/analytics/bridges":{"get":{"tags":["analytics"],"summary":"Admin Get Bridge Funnel","description":"Sample-bridge and drawer efficiency, against chart-makers.\n\nSync (`def`) on purpose: it runs several sqlite aggregates, and blocking\nwork on the event loop freezes the whole API.","operationId":"admin_get_bridge_funnel_admin_analytics_bridges_get","parameters":[{"name":"date_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO UTC, inclusive","title":"Date From"},"description":"ISO UTC, inclusive"},{"name":"date_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO UTC, inclusive","title":"Date To"},"description":"ISO UTC, inclusive"},{"name":"campaign","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign"}},{"name":"source","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"}},{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO-2, e.g. US","title":"Country"},"description":"ISO-2, e.g. US"},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/analytics/natal":{"get":{"tags":["analytics"],"summary":"Admin Get Natal Funnel","description":"The /natal-chart page journey: form funnel, chart errors, and every\nengagement surface on the page. Scoped to that page only.","operationId":"admin_get_natal_funnel_admin_analytics_natal_get","parameters":[{"name":"date_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO UTC, inclusive","title":"Date From"},"description":"ISO UTC, inclusive"},{"name":"date_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO UTC, inclusive","title":"Date To"},"description":"ISO UTC, inclusive"},{"name":"campaign","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Campaign"}},{"name":"source","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"}},{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO-2, e.g. US","title":"Country"},"description":"ISO-2, e.g. US"},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/analytics/sales-funnel":{"get":{"tags":["analytics"],"summary":"Admin Get Sales Funnel","description":"Visitor-level sales funnel: each visitor is credited to the channel or\ncampaign that brought them, and every later step they take counts for it.\nSync def — it reads every event in the range in Python.","operationId":"admin_get_sales_funnel_admin_analytics_sales_funnel_get","parameters":[{"name":"date_from","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO UTC, inclusive","title":"Date From"},"description":"ISO UTC, inclusive"},{"name":"date_to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO UTC, inclusive","title":"Date To"},"description":"ISO UTC, inclusive"},{"name":"traffic","in":"query","required":false,"schema":{"type":"string","description":"all | paid | organic | a channel key, e.g. meta","default":"all","title":"Traffic"},"description":"all | paid | organic | a channel key, e.g. meta"},{"name":"by","in":"query","required":false,"schema":{"type":"string","description":"channel | campaign | ad | landing | country","default":"","title":"By"},"description":"channel | campaign | ad | landing | country"},{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO-2, e.g. US","title":"Country"},"description":"ISO-2, e.g. US"},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/experiments":{"get":{"tags":["analytics"],"summary":"Admin Get Experiment","description":"A/B/C report for one pre-registered test (db/experiments.py, step120).\nSync def — it reads every event since the test started in Python.","operationId":"admin_get_experiment_admin_experiments_get","parameters":[{"name":"test","in":"query","required":false,"schema":{"type":"string","description":"t1 | t3","default":"t1","title":"Test"},"description":"t1 | t3"},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/calendar/teaser-event":{"post":{"tags":["calendar"],"summary":"Teaser Event","description":"Pick the most relevant upcoming aspect event for this birth chart that\nalready has cached interpretation text. Cache-only.\n\nReturns `{event, skip_reason}` where skip_reason is one of:\n  - \"error\"               — chart calculation failed\n  - \"no_transits\"         — no future aspect events in the 12-month window\n  - \"no_cached_template\"  — candidates exist but none are cached yet","operationId":"teaser_event_calendar_teaser_event_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NatalRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TeaserEventResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/calendar/{token}":{"get":{"tags":["calendar"],"summary":"Get Calendar By Token","description":"Return the personal calendar JSON for a subscriber identified by token.\n\n`?trigger=` is set by a pre-event nudge link and counts the visit against\nthat trigger, giving the queued -> sent -> viewed -> purchased funnel its\nmiddle step.","operationId":"get_calendar_by_token_calendar__token__get","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}},{"name":"trigger","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trigger"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Get Calendar By Token Calendar  Token  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/calendar/{token}/feed.ics":{"get":{"tags":["calendar"],"summary":"Get Calendar Ics","operationId":"get_calendar_ics_calendar__token__feed_ics_get","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}},{"name":"download","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Download"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/calendar/{token}/coupon":{"post":{"tags":["calendar"],"summary":"Create Calendar Coupon","description":"Mint (or return) this subscriber's personal coupon.\n\nIdempotent. Called once from the calendar page after hydration; a re-open\nreturns the same code with the same deadline rather than restarting it.","operationId":"create_calendar_coupon_calendar__token__coupon_post","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Create Calendar Coupon Calendar  Token  Coupon Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/preview/personal-reveals":{"post":{"summary":"Get Personal Reveals","description":"Cache-aware reveals. Returns cached cells + an optional `in_progress` cell\nbeing organically warmed. At most one warm per chart per ORGANIC_WARM_TTL_S.","operationId":"get_personal_reveals_preview_personal_reveals_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PreviewRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Get Personal Reveals Preview Personal Reveals Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/unsubscribe/{token}":{"get":{"tags":["unsubscribe"],"summary":"Unsubscribe Status","description":"Read-only. Never mutates — see the module docstring.","operationId":"unsubscribe_status_unsubscribe__token__get","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Unsubscribe Status Unsubscribe  Token  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["unsubscribe"],"summary":"Do Unsubscribe","description":"Opt out. Idempotent.\n\nDoubles as the RFC 8058 one-click endpoint: providers POST\n`List-Unsubscribe=One-Click` as a form body straight here, with no browser\nand no session. We do not read the body at all — the token in the path is\nthe entire authorisation, which is what the RFC intends.","operationId":"do_unsubscribe_unsubscribe__token__post","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Do Unsubscribe Unsubscribe  Token  Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/unsubscribe/{token}/resubscribe":{"post":{"tags":["unsubscribe"],"summary":"Do Resubscribe","operationId":"do_resubscribe_unsubscribe__token__resubscribe_post","parameters":[{"name":"token","in":"path","required":true,"schema":{"type":"string","title":"Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Do Resubscribe Unsubscribe  Token  Resubscribe Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/reading/{result_token}":{"get":{"tags":["reading"],"summary":"Get Reading","operationId":"get_reading_reading__result_token__get","parameters":[{"name":"result_token","in":"path","required":true,"schema":{"type":"string","title":"Result Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Get Reading Reading  Result Token  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/reading/{result_token}/coupon":{"post":{"tags":["reading"],"summary":"Create Reading Coupon","description":"Mint (or return) the buyer's personal coupon for the upsell below.","operationId":"create_reading_coupon_reading__result_token__coupon_post","parameters":[{"name":"result_token","in":"path","required":true,"schema":{"type":"string","title":"Result Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","title":"Response Create Reading Coupon Reading  Result Token  Coupon Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/seo/agent/run":{"post":{"tags":["seo"],"summary":"Agent Run","operationId":"agent_run_seo_agent_run_post","parameters":[{"name":"x-seo-agent-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Seo-Agent-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/seo/agent/task":{"post":{"tags":["seo"],"summary":"Agent Task","operationId":"agent_task_seo_agent_task_post","parameters":[{"name":"x-seo-agent-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Seo-Agent-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/seo/agent/action":{"post":{"tags":["seo"],"summary":"Agent Action","operationId":"agent_action_seo_agent_action_post","parameters":[{"name":"x-seo-agent-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Seo-Agent-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActionIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/seo/agent/metric":{"post":{"tags":["seo"],"summary":"Agent Metric","operationId":"agent_metric_seo_agent_metric_post","parameters":[{"name":"x-seo-agent-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Seo-Agent-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MetricIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/seo/agent/tasks":{"get":{"tags":["seo"],"summary":"Agent Tasks","description":"Agents read their own recorded work so they can skip what is already\nqueued. They cannot use /admin/seo/tasks — that needs the operator session,\nand an agent silently getting a 401 there means no deduplication at all,\nwhich quietly burns weekly cap slots on work already done.","operationId":"agent_tasks_seo_agent_tasks_get","parameters":[{"name":"package","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Package"}},{"name":"x-seo-agent-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Seo-Agent-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/seo/agent/plan":{"get":{"tags":["seo"],"summary":"Agent Plan","description":"Agents read their own work list: which packages are live, enabled, and\nhow many tasks the pacing rule still allows this week.","operationId":"agent_plan_seo_agent_plan_get","parameters":[{"name":"x-seo-agent-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Seo-Agent-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/seo/overview":{"get":{"tags":["seo"],"summary":"Seo Overview","operationId":"seo_overview_admin_seo_overview_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/seo/briefings":{"get":{"tags":["seo"],"summary":"Seo Briefings","operationId":"seo_briefings_admin_seo_briefings_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":30,"title":"Limit"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/seo/briefing/refresh":{"post":{"tags":["seo"],"summary":"Seo Refresh Briefing","description":"Explicit refresh from the panel. Always regenerates.","operationId":"seo_refresh_briefing_admin_seo_briefing_refresh_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/seo/agent/briefing/refresh":{"post":{"tags":["seo"],"summary":"Agent Refresh Briefing","description":"Called by agents after meaningful work. Uses the staleness check so a\nburst of runs does not produce a burst of LLM calls.","operationId":"agent_refresh_briefing_seo_agent_briefing_refresh_post","parameters":[{"name":"x-seo-agent-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Seo-Agent-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/seo/actions/{action_id}":{"post":{"tags":["seo"],"summary":"Seo Resolve Action","operationId":"seo_resolve_action_admin_seo_actions__action_id__post","parameters":[{"name":"action_id","in":"path","required":true,"schema":{"type":"string","title":"Action Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResolveIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/seo/packages/{pkg_id}":{"post":{"tags":["seo"],"summary":"Seo Update Package","operationId":"seo_update_package_admin_seo_packages__pkg_id__post","parameters":[{"name":"pkg_id","in":"path","required":true,"schema":{"type":"string","title":"Pkg Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PackageIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/seo/proposals/{proposal_key}":{"post":{"tags":["seo"],"summary":"Seo Apply Proposal","description":"Accepting writes the cap override. Dismissing is remembered — a dismissed\nproposal must not reappear next week.","operationId":"seo_apply_proposal_admin_seo_proposals__proposal_key__post","parameters":[{"name":"proposal_key","in":"path","required":true,"schema":{"type":"string","title":"Proposal Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProposalIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/seo/tasks/{task_id}":{"post":{"tags":["seo"],"summary":"Seo Update Task","description":"Let the operator close the loop on a task an agent prepared.\n\nWithout this, a queued submission could never be marked done from the\npanel, the win rate would stay permanently zero, and the adaptation logic\nwould have nothing to measure.","operationId":"seo_update_task_admin_seo_tasks__task_id__post","parameters":[{"name":"task_id","in":"path","required":true,"schema":{"type":"string","title":"Task Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskUpdateIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/seo/tasks":{"get":{"tags":["seo"],"summary":"Seo Tasks","operationId":"seo_tasks_admin_seo_tasks_get","parameters":[{"name":"package","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Package"}},{"name":"channel","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Channel"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":200,"title":"Limit"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/seo/outreach/options":{"get":{"tags":["seo"],"summary":"Outreach Options","description":"Everything the composer form needs to render its selects.","operationId":"outreach_options_admin_seo_outreach_options_get","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/seo/outreach/render":{"post":{"tags":["seo"],"summary":"Outreach Render","description":"Assemble subject + message. Pure template work: instant, free, and the\nclaims stay exactly as verified in the listing kit.","operationId":"outreach_render_admin_seo_outreach_render_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutreachIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/seo/outreach/angle":{"post":{"tags":["seo"],"summary":"Outreach Angle","description":"Write the one sentence a template cannot: the observation about THEIR\narticle. Everything else in the message is fixed and verified, so the model\ngets exactly one job and is told not to invent facts.","operationId":"outreach_angle_admin_seo_outreach_angle_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AngleIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/seo/outreach/save":{"post":{"tags":["seo"],"summary":"Outreach Save","description":"Record a hand-sent pitch as a WP-11 task.\n\nWithout this, manual outreach is invisible to the win-rate maths and the\nadaptation logic has nothing to measure — the module would only ever see\nwhat the agent queued.","operationId":"outreach_save_admin_seo_outreach_save_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutreachSaveIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/events/upcoming":{"get":{"tags":["events"],"summary":"Upcoming","description":"Sky events in the next N days, soonest first.","operationId":"upcoming_events_upcoming_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":400,"minimum":1,"description":"How far ahead to look","default":30,"title":"Days"},"description":"How far ahead to look"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"min_importance","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":0,"description":"Filter out minor events; 60+ is roughly 'worth a post'","default":0,"title":"Min Importance"},"description":"Filter out minor events; 60+ is roughly 'worth a post'"},{"name":"kind","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Restrict to one event kind","title":"Kind"},"description":"Restrict to one event kind"},{"name":"from_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Override today, as YYYY-MM-DD","title":"From Date"},"description":"Override today, as YYYY-MM-DD"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/events/kinds":{"get":{"tags":["events"],"summary":"Kinds","description":"The event kinds present in the feed, with counts — so a client can build\na filter without hardcoding a list that drifts.","operationId":"kinds_events_kinds_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/social/catalog":{"get":{"tags":["social"],"summary":"Catalog Index","operationId":"catalog_index_social_catalog_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/social/catalog/{month}":{"get":{"tags":["social"],"summary":"Catalog Month","operationId":"catalog_month_social_catalog__month__get","parameters":[{"name":"month","in":"path","required":true,"schema":{"type":"string","title":"Month"}},{"name":"platform","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"x | reddit | pinterest | facebook — required","title":"Platform"},"description":"x | reddit | pinterest | facebook — required"},{"name":"pending_only","in":"query","required":false,"schema":{"type":"boolean","description":"drop posts already marked posted","default":false,"title":"Pending Only"},"description":"drop posts already marked posted"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/social/queue":{"get":{"tags":["social"],"summary":"Queue","description":"Everything due now and not yet posted, oldest first, across every month on disk.\n\nA pin about a full moon is useless a week after it, so overdue posts fall out of the\nqueue after `stale_days` instead of piling up. They stay visible in the month catalogue.","operationId":"queue_social_queue_get","parameters":[{"name":"platform","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"x | reddit | pinterest | facebook — required","title":"Platform"},"description":"x | reddit | pinterest | facebook — required"},{"name":"stale_days","in":"query","required":false,"schema":{"type":"integer","maximum":60,"minimum":0,"description":"a post due longer ago than this is skipped, not published late","default":3,"title":"Stale Days"},"description":"a post due longer ago than this is skipped, not published late"},{"name":"lookahead_hours","in":"query","required":false,"schema":{"type":"integer","maximum":168,"minimum":0,"description":"also include posts due within this many hours","default":0,"title":"Lookahead Hours"},"description":"also include posts due within this many hours"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/social/posted":{"post":{"tags":["social"],"summary":"Mark Posted","description":"Idempotent: marking the same ref twice keeps the first record and says so, so a\nretried request after a network blip cannot make a post look like two.","operationId":"mark_posted_social_posted_post","parameters":[{"name":"x-social-agent-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Social-Agent-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostedIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/social/skipped":{"post":{"tags":["social"],"summary":"Mark Skipped","description":"The poster could not post this ref. It leaves today's queue but is NOT used up: the\nscheduler offers it again later. Never use /posted for a skip — that burns it for good.","operationId":"mark_skipped_social_skipped_post","parameters":[{"name":"x-social-agent-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Social-Agent-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkippedIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/growth/summary":{"get":{"tags":["growth"],"summary":"Growth Summary","operationId":"growth_summary_internal_growth_summary_get","parameters":[{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"YYYY-MM-DD, inclusive","title":"From"},"description":"YYYY-MM-DD, inclusive"},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"YYYY-MM-DD, inclusive","title":"To"},"description":"YYYY-MM-DD, inclusive"},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/growth/changes":{"get":{"tags":["growth"],"summary":"Growth Changes","operationId":"growth_changes_internal_growth_changes_get","parameters":[{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"ISO-8601 timestamp; only strictly-newer entries are returned","title":"Since"},"description":"ISO-8601 timestamp; only strictly-newer entries are returned"},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/internal/growth/content":{"get":{"tags":["growth"],"summary":"Growth Content","operationId":"growth_content_internal_growth_content_get","parameters":[{"name":"from","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"YYYY-MM-DD, inclusive — filters by when content was PUBLISHED","title":"From"},"description":"YYYY-MM-DD, inclusive — filters by when content was PUBLISHED"},{"name":"to","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"YYYY-MM-DD, inclusive","title":"To"},"description":"YYYY-MM-DD, inclusive"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/health":{"get":{"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/natal":{"post":{"summary":"Natal","operationId":"natal_natal_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NatalRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NatalResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/search-location":{"get":{"summary":"Search Location","description":"Local GeoNames snapshot first, Nominatim only when it misses.\n\nBoth paths return the same Nominatim-shaped records, so the frontend does\nnot know or care which one answered.","operationId":"search_location_search_location_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2,"title":"Q"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/content/daily":{"get":{"summary":"Get Daily Content","operationId":"get_daily_content_content_daily_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/content/daily/{sign}":{"get":{"summary":"Get Daily Sign","operationId":"get_daily_sign_content_daily__sign__get","parameters":[{"name":"sign","in":"path","required":true,"schema":{"type":"string","title":"Sign"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/content/weekly":{"get":{"summary":"Get Weekly Content","operationId":"get_weekly_content_content_weekly_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/content/weekly/{sign}":{"get":{"summary":"Get Weekly Sign","operationId":"get_weekly_sign_content_weekly__sign__get","parameters":[{"name":"sign","in":"path","required":true,"schema":{"type":"string","title":"Sign"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/content/monthly":{"get":{"summary":"Get Monthly Content","operationId":"get_monthly_content_content_monthly_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/content/monthly/{sign}":{"get":{"summary":"Get Monthly Sign","operationId":"get_monthly_sign_content_monthly__sign__get","parameters":[{"name":"sign","in":"path","required":true,"schema":{"type":"string","title":"Sign"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/content/moon":{"get":{"summary":"Get Moon Content","operationId":"get_moon_content_content_moon_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/content/transit":{"get":{"summary":"Get Transit Content","operationId":"get_transit_content_content_transit_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/content/week-ahead":{"get":{"summary":"Get Week Ahead Content","operationId":"get_week_ahead_content_content_week_ahead_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/content/monthly-overview":{"get":{"summary":"Get Monthly Overview Content","operationId":"get_monthly_overview_content_content_monthly_overview_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/content/monthly-archive/list":{"get":{"summary":"List Monthly Archive","description":"Return every generated (sign, year, month) tuple with its generated_at.\nConsumed by the frontend sitemap at build time so newly-generated URLs\nappear in the sitemap without a code change.","operationId":"list_monthly_archive_content_monthly_archive_list_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/content/monthly-archive/{sign}/{yyyy_mm}":{"get":{"summary":"Get Monthly Archive","description":"Serve a single dated monthly archive file as-is.","operationId":"get_monthly_archive_content_monthly_archive__sign___yyyy_mm__get","parameters":[{"name":"sign","in":"path","required":true,"schema":{"type":"string","title":"Sign"}},{"name":"yyyy_mm","in":"path","required":true,"schema":{"type":"string","title":"Yyyy Mm"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/webhook/paypal":{"post":{"summary":"Paypal Webhook","description":"Handle PayPal webhook events (secondary signal).\nPrimary payment confirmation is via POST /order/capture-payment.\nThis webhook only handles refunds and chargebacks.","operationId":"paypal_webhook_webhook_paypal_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/webhook/resend":{"post":{"summary":"Resend Webhook","description":"Handle Resend delivery events. Always 200.","operationId":"resend_webhook_webhook_resend_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"ActionIn":{"properties":{"package":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}],"title":"Package"},"kind":{"type":"string","maxLength":30,"title":"Kind","default":"info"},"severity":{"type":"string","maxLength":20,"title":"Severity","default":"info"},"title":{"type":"string","maxLength":200,"title":"Title"},"detail":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Detail"},"cta_label":{"anyOf":[{"type":"string","maxLength":60},{"type":"null"}],"title":"Cta Label"},"cta_url":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Cta Url"}},"type":"object","required":["title"],"title":"ActionIn"},"AnalyticsBatch":{"properties":{"events":{"items":{"$ref":"#/components/schemas/AnalyticsEvent"},"type":"array","title":"Events"}},"type":"object","required":["events"],"title":"AnalyticsBatch"},"AnalyticsEvent":{"properties":{"event_type":{"type":"string","title":"Event Type","description":"'pageview' or 'event'"},"event_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event Name"},"page_url":{"type":"string","title":"Page Url"},"visitor_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Visitor Id"},"referrer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Referrer"},"params":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Params"},"utm_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Source"},"utm_medium":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Medium"},"utm_campaign":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Campaign"},"utm_content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Content"},"utm_term":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Term"},"utm_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Id"},"click_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Click Id"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"},"ab":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ab"}},"type":"object","required":["event_type","page_url"],"title":"AnalyticsEvent"},"AngleIn":{"properties":{"prospect":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Prospect"},"page_label":{"type":"string","maxLength":160,"title":"Page Label"},"page_url":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Page Url"},"widget":{"type":"string","maxLength":30,"title":"Widget","default":"horoscope"},"notes":{"anyOf":[{"type":"string","maxLength":600},{"type":"null"}],"title":"Notes"}},"type":"object","required":["page_label"],"title":"AngleIn"},"AspectData":{"properties":{"a":{"type":"string","title":"A"},"b":{"type":"string","title":"B"},"type":{"type":"string","title":"Type"},"angle":{"type":"number","title":"Angle"},"delta":{"type":"number","title":"Delta"},"applying":{"type":"boolean","title":"Applying"}},"type":"object","required":["a","b","type","angle","delta","applying"],"title":"AspectData"},"CampaignPreviewRequest":{"properties":{"subject":{"type":"string","title":"Subject"},"body":{"type":"string","title":"Body"},"audience":{"type":"string","title":"Audience","default":"all"},"coupon_code":{"type":"string","title":"Coupon Code","default":""},"preheader":{"type":"string","title":"Preheader","default":""},"cta_label":{"type":"string","title":"Cta Label","default":""},"cta_path":{"type":"string","title":"Cta Path","default":""}},"type":"object","required":["subject","body"],"title":"CampaignPreviewRequest"},"CampaignSendRequest":{"properties":{"subject":{"type":"string","title":"Subject"},"body":{"type":"string","title":"Body"},"audience":{"type":"string","title":"Audience","default":"all"},"coupon_code":{"type":"string","title":"Coupon Code","default":""},"preheader":{"type":"string","title":"Preheader","default":""},"cta_label":{"type":"string","title":"Cta Label","default":""},"cta_path":{"type":"string","title":"Cta Path","default":""},"confirm":{"type":"boolean","title":"Confirm","default":false}},"type":"object","required":["subject","body"],"title":"CampaignSendRequest"},"CampaignTestRequest":{"properties":{"subject":{"type":"string","title":"Subject"},"body":{"type":"string","title":"Body"},"audience":{"type":"string","title":"Audience","default":"all"},"coupon_code":{"type":"string","title":"Coupon Code","default":""},"preheader":{"type":"string","title":"Preheader","default":""},"cta_label":{"type":"string","title":"Cta Label","default":""},"cta_path":{"type":"string","title":"Cta Path","default":""},"to_email":{"type":"string","title":"To Email"}},"type":"object","required":["subject","body","to_email"],"title":"CampaignTestRequest"},"CaptureIntentRequest":{"properties":{"email":{"type":"string","title":"Email"},"birth_data":{"type":"string","title":"Birth Data"},"topics":{"items":{"type":"string"},"type":"array","title":"Topics"},"utm_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Source"},"utm_medium":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Medium"},"utm_campaign":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Campaign"},"utm_content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Content"},"utm_term":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Term"},"utm_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Id"},"landing_page":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Landing Page"},"landing_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Landing At"}},"type":"object","required":["email","birth_data","topics"],"title":"CaptureIntentRequest"},"CapturePaymentRequest":{"properties":{"group_id":{"type":"string","title":"Group Id"},"paypal_order_id":{"type":"string","title":"Paypal Order Id"},"fbp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fbp"},"fbc":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fbc"}},"type":"object","required":["group_id","paypal_order_id"],"title":"CapturePaymentRequest"},"CheckoutStageRequest":{"properties":{"group_id":{"type":"string","title":"Group Id"},"stage":{"type":"string","title":"Stage"}},"type":"object","required":["group_id","stage"],"title":"CheckoutStageRequest"},"CreateBatchRequest":{"properties":{"email":{"type":"string","title":"Email"},"name":{"type":"string","title":"Name"},"pronouns":{"type":"string","title":"Pronouns","default":"they"},"birth_data":{"type":"string","title":"Birth Data"},"topics":{"items":{"type":"string"},"type":"array","title":"Topics"},"chart_image":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Chart Image"},"coupon_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Coupon Code"},"utm_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Source"},"utm_medium":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Medium"},"utm_campaign":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Campaign"},"utm_content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Content"},"utm_term":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Term"},"utm_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Id"},"landing_page":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Landing Page"},"landing_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Landing At"}},"type":"object","required":["email","name","birth_data","topics"],"title":"CreateBatchRequest"},"CreateCouponRequest":{"properties":{"code":{"type":"string","title":"Code"},"type":{"type":"string","title":"Type","default":"percent"},"value":{"type":"number","title":"Value"},"valid_from":{"type":"string","title":"Valid From"},"valid_until":{"type":"string","title":"Valid Until"},"max_uses":{"type":"integer","title":"Max Uses","default":0},"max_uses_per_email":{"type":"integer","title":"Max Uses Per Email","default":1},"min_order_amount":{"type":"integer","title":"Min Order Amount","default":0},"min_topics":{"type":"integer","title":"Min Topics","default":0}},"type":"object","required":["code","value","valid_from","valid_until"],"title":"CreateCouponRequest"},"CreateEventReadingRequest":{"properties":{"event_key":{"type":"string","title":"Event Key"},"calendar_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Calendar Token"},"trigger_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trigger Token"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"pronouns":{"type":"string","title":"Pronouns","default":"they"},"fbp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fbp"},"fbc":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fbc"},"utm_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Source"},"utm_medium":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Medium"},"utm_campaign":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Campaign"},"utm_content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Content"},"utm_term":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Term"},"utm_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Id"},"landing_page":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Landing Page"},"landing_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Landing At"}},"type":"object","required":["event_key"],"title":"CreateEventReadingRequest","description":"One of calendar_token / trigger_token identifies the subscriber.\n\nNote what is NOT here: email, birth_data, or any reading content. The\nserver resolves all of that from the token. The client only says WHICH of\nthe subscriber's own events it wants — that boundary is the point."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"LoginRequest":{"properties":{"password":{"type":"string","title":"Password"}},"type":"object","required":["password"],"title":"LoginRequest"},"MetaTokenBody":{"properties":{"token":{"type":"string","maxLength":1000,"title":"Token","default":""}},"type":"object","title":"MetaTokenBody"},"MetricIn":{"properties":{"referring_domains":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Referring Domains"},"indexation_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Indexation Pct"},"widget_embeds":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Widget Embeds"},"ics_subscriptions":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Ics Subscriptions"},"bing_clicks_28d":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Bing Clicks 28D"},"google_clicks_28d":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Google Clicks 28D"},"note":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Note"}},"type":"object","title":"MetricIn"},"NatalRequest":{"properties":{"year":{"type":"integer","maximum":2100.0,"minimum":1900.0,"title":"Year"},"month":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Month"},"day":{"type":"integer","maximum":31.0,"minimum":1.0,"title":"Day"},"hour":{"type":"integer","maximum":23.0,"minimum":0.0,"title":"Hour"},"minute":{"type":"integer","maximum":59.0,"minimum":0.0,"title":"Minute"},"lat":{"type":"number","maximum":90.0,"minimum":-90.0,"title":"Lat"},"lon":{"type":"number","maximum":180.0,"minimum":-180.0,"title":"Lon"}},"type":"object","required":["year","month","day","hour","minute","lat","lon"],"title":"NatalRequest"},"NatalResponse":{"properties":{"houseSystem":{"type":"string","title":"Housesystem"},"ascendant":{"type":"number","title":"Ascendant"},"midheaven":{"type":"number","title":"Midheaven"},"cusps":{"items":{"type":"number"},"type":"array","title":"Cusps"},"planets":{"additionalProperties":{"$ref":"#/components/schemas/PlanetData"},"type":"object","title":"Planets"},"aspects":{"items":{"$ref":"#/components/schemas/AspectData"},"type":"array","title":"Aspects"},"partOfFortune":{"$ref":"#/components/schemas/PartOfFortuneData"}},"type":"object","required":["houseSystem","ascendant","midheaven","cusps","planets","aspects","partOfFortune"],"title":"NatalResponse"},"OutreachIn":{"properties":{"prospect":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Prospect"},"site_url":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Site Url"},"page_label":{"type":"string","maxLength":160,"title":"Page Label"},"page_url":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Page Url"},"widget":{"type":"string","maxLength":30,"title":"Widget","default":"horoscope"},"vertical":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Vertical"},"angle":{"type":"string","maxLength":1200,"title":"Angle"}},"type":"object","required":["page_label","angle"],"title":"OutreachIn"},"OutreachSaveIn":{"properties":{"prospect":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Prospect"},"site_url":{"anyOf":[{"type":"string","maxLength":300},{"type":"null"}],"title":"Site Url"},"page_label":{"type":"string","maxLength":160,"title":"Page Label"},"page_url":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Page Url"},"widget":{"type":"string","maxLength":30,"title":"Widget","default":"horoscope"},"vertical":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Vertical"},"angle":{"type":"string","maxLength":1200,"title":"Angle"},"subject":{"type":"string","maxLength":300,"title":"Subject"},"body":{"type":"string","maxLength":8000,"title":"Body"},"status":{"type":"string","maxLength":30,"title":"Status","default":"submitted"}},"type":"object","required":["page_label","angle","subject","body"],"title":"OutreachSaveIn"},"PackageIn":{"properties":{"status":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}],"title":"Status"},"enabled":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Enabled"},"weekly_cap_override":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Weekly Cap Override"},"note":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Note"}},"type":"object","title":"PackageIn"},"PartOfFortuneData":{"properties":{"lon":{"type":"number","title":"Lon"},"signIndex":{"type":"integer","title":"Signindex"},"sign":{"type":"string","title":"Sign"},"degInSign":{"type":"number","title":"Deginsign"},"house":{"type":"integer","title":"House"}},"type":"object","required":["lon","signIndex","sign","degInSign","house"],"title":"PartOfFortuneData"},"PaymentHelpRequest":{"properties":{"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"group_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Group Id"},"topics":{"items":{"type":"string"},"type":"array","title":"Topics","default":[]},"total_cents":{"type":"integer","title":"Total Cents","default":0},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"},"page_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Page Url"}},"type":"object","title":"PaymentHelpRequest"},"PlanetData":{"properties":{"lon":{"type":"number","title":"Lon"},"lat":{"type":"number","title":"Lat"},"dist":{"type":"number","title":"Dist"},"speed_lon":{"type":"number","title":"Speed Lon"},"retrograde":{"type":"boolean","title":"Retrograde"},"signIndex":{"type":"integer","title":"Signindex"},"sign":{"type":"string","title":"Sign"},"degInSign":{"type":"number","title":"Deginsign"},"house":{"type":"integer","title":"House"},"dignity":{"type":"string","title":"Dignity"}},"type":"object","required":["lon","lat","dist","speed_lon","retrograde","signIndex","sign","degInSign","house","dignity"],"title":"PlanetData"},"PostedIn":{"properties":{"ref":{"type":"string","maxLength":120,"minLength":5,"title":"Ref","description":"the post's ref from the catalogue, e.g. days-leo-october-2026::pinterest"},"url":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Url","description":"where the post lives on the platform"},"external_id":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"External Id"},"note":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Note"}},"type":"object","required":["ref"],"title":"PostedIn"},"PreviewRequest":{"properties":{"birth_data":{"type":"string","maxLength":20000,"minLength":1,"title":"Birth Data"}},"type":"object","required":["birth_data"],"title":"PreviewRequest"},"PricingTopicIn":{"properties":{"price_before":{"type":"integer","title":"Price Before"},"price_after":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Price After"},"enabled":{"type":"boolean","title":"Enabled","default":true}},"type":"object","required":["price_before"],"title":"PricingTopicIn"},"ProposalIn":{"properties":{"accept":{"type":"boolean","title":"Accept"}},"type":"object","required":["accept"],"title":"ProposalIn"},"ResolveIn":{"properties":{"status":{"type":"string","maxLength":20,"title":"Status","default":"resolved"},"note":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Note"}},"type":"object","title":"ResolveIn"},"RunIn":{"properties":{"agent":{"type":"string","maxLength":60,"title":"Agent"},"package":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}],"title":"Package"},"action":{"type":"string","maxLength":200,"title":"Action"},"outcome":{"type":"string","maxLength":20,"title":"Outcome","default":"ok"},"detail":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Detail"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Ms"}},"type":"object","required":["agent","action"],"title":"RunIn"},"SavePricingRequest":{"properties":{"topics":{"additionalProperties":{"$ref":"#/components/schemas/PricingTopicIn"},"type":"object","title":"Topics"},"bundle_discounts":{"anyOf":[{"additionalProperties":{"type":"integer"},"type":"object"},{"type":"null"}],"title":"Bundle Discounts"},"regional_discount":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Regional Discount"}},"type":"object","required":["topics"],"title":"SavePricingRequest"},"SkippedIn":{"properties":{"ref":{"type":"string","maxLength":120,"minLength":5,"title":"Ref"},"reason":{"type":"string","maxLength":500,"minLength":3,"title":"Reason","description":"what was wrong, e.g. 'image did not load' or 'page 404'"}},"type":"object","required":["ref","reason"],"title":"SkippedIn"},"SubscribeCalendarRequest":{"properties":{"email":{"type":"string","title":"Email"},"birth_data":{"type":"string","title":"Birth Data"},"visitor_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Visitor Id"},"event_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Event Id"},"fbp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fbp"},"fbc":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fbc"},"utm_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Source"},"utm_medium":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Medium"},"utm_campaign":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Campaign"},"utm_content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Content"},"utm_term":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Term"},"utm_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Utm Id"},"landing_page":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Landing Page"},"landing_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Landing At"}},"type":"object","required":["email","birth_data"],"title":"SubscribeCalendarRequest"},"TaskIn":{"properties":{"id":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Id"},"package":{"anyOf":[{"type":"string","maxLength":20},{"type":"null"}],"title":"Package"},"channel":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Channel"},"target":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Target"},"target_url":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Target Url"},"status":{"anyOf":[{"type":"string","maxLength":30},{"type":"null"}],"title":"Status"},"result_url":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Result Url"},"human_minutes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Human Minutes"},"last_error":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Last Error"},"detail":{"anyOf":[{"type":"string","maxLength":8000},{"type":"null"}],"title":"Detail"}},"type":"object","title":"TaskIn"},"TaskUpdateIn":{"properties":{"status":{"anyOf":[{"type":"string","maxLength":30},{"type":"null"}],"title":"Status"},"result_url":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Result Url"},"human_minutes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Human Minutes"},"note":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Note"}},"type":"object","title":"TaskUpdateIn"},"TeaserEvent":{"properties":{"date_iso":{"type":"string","title":"Date Iso"},"headline_date":{"type":"string","title":"Headline Date"},"preview_text":{"type":"string","title":"Preview Text"},"short_label":{"type":"string","title":"Short Label","default":""}},"type":"object","required":["date_iso","headline_date","preview_text"],"title":"TeaserEvent"},"TeaserEventResponse":{"properties":{"event":{"anyOf":[{"$ref":"#/components/schemas/TeaserEvent"},{"type":"null"}]},"skip_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Skip Reason"}},"type":"object","title":"TeaserEventResponse"},"TestPaymentRequest":{"properties":{"group_id":{"type":"string","title":"Group Id"}},"type":"object","required":["group_id"],"title":"TestPaymentRequest"},"ValidateCouponRequest":{"properties":{"code":{"type":"string","title":"Code"},"email":{"type":"string","title":"Email"},"topics":{"items":{"type":"string"},"type":"array","title":"Topics"}},"type":"object","required":["code","email","topics"],"title":"ValidateCouponRequest"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}