{"openapi":"3.1.0","info":{"title":"Snoki API","version":"0.2.0"},"paths":{"/v1/auth/email-link":{"post":{"summary":"Email Link","operationId":"email_link_v1_auth_email_link_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailLinkIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/password":{"post":{"summary":"Sign In Password","operationId":"sign_in_password_v1_auth_password_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PasswordIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/sign-up":{"post":{"summary":"Sign Up","operationId":"sign_up_v1_auth_sign_up_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignUpIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/oauth":{"post":{"summary":"Oauth Start","operationId":"oauth_start_v1_auth_oauth_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/session":{"post":{"summary":"Create Session","operationId":"create_session_v1_auth_session_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/refresh":{"post":{"summary":"Refresh Session","operationId":"refresh_session_v1_auth_refresh_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefreshIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/sign-out":{"post":{"summary":"Sign Out","operationId":"sign_out_v1_auth_sign_out_post","responses":{"204":{"description":"Successful Response"}}}},"/v1/me":{"get":{"summary":"Me","operationId":"me_v1_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/entities":{"get":{"summary":"Search Entities","operationId":"search_entities_v1_entities_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":60,"default":"","title":"Q"}},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"enum":["filings","economy","housing"],"type":"string"},{"type":"null"}],"title":"Category"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/entities/{kind}/{slug}":{"get":{"summary":"Entity Page","operationId":"entity_page_v1_entities__kind___slug__get","parameters":[{"name":"kind","in":"path","required":true,"schema":{"enum":["company","indicator","metro","topic"],"type":"string","title":"Kind"}},{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/events/{event_id}":{"get":{"summary":"Event Page","operationId":"event_page_v1_events__event_id__get","parameters":[{"name":"event_id","in":"path","required":true,"schema":{"type":"integer","title":"Event Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/posts":{"get":{"summary":"Latest Posts","operationId":"latest_posts_v1_posts_get","parameters":[{"name":"before","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"title":"Before"}},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"enum":["filings","economy","housing"],"type":"string"},{"type":"null"}],"title":"Category"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/follows":{"get":{"summary":"List Follows","operationId":"list_follows_v1_follows_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"summary":"Add Follow","operationId":"add_follow_v1_follows_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FollowIn"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/follows/{entity_id}":{"delete":{"summary":"Remove Follow","operationId":"remove_follow_v1_follows__entity_id__delete","parameters":[{"name":"entity_id","in":"path","required":true,"schema":{"type":"integer","title":"Entity Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/feed":{"get":{"summary":"Feed","operationId":"feed_v1_feed_get","parameters":[{"name":"before","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":1},{"type":"null"}],"title":"Before"}},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"enum":["filings","economy","housing"],"type":"string"},{"type":"null"}],"title":"Category"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":20,"title":"Limit"}},{"name":"client","in":"query","required":false,"schema":{"enum":["web","mcp","api"],"type":"string","default":"web","title":"Client"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/me/profile":{"get":{"summary":"My Profile","operationId":"my_profile_v1_me_profile_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/mfa":{"get":{"summary":"Mfa Status","operationId":"mfa_status_v1_mfa_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/mfa/totp":{"post":{"summary":"Start Setup","operationId":"start_setup_v1_mfa_totp_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"delete":{"summary":"Turn Off","operationId":"turn_off_v1_mfa_totp_delete","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TurnOffIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/mfa/verify":{"post":{"summary":"Verify Code","operationId":"verify_code_v1_mfa_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CodeIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/me/digest":{"get":{"summary":"Get Digest","operationId":"get_digest_v1_me_digest_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"put":{"summary":"Put Digest","operationId":"put_digest_v1_me_digest_put","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DigestIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/digest/unsubscribe":{"get":{"summary":"Check Unsubscribe","operationId":"check_unsubscribe_v1_digest_unsubscribe_get","parameters":[{"name":"token","in":"query","required":false,"schema":{"type":"string","maxLength":400,"default":"","title":"Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"summary":"Unsubscribe","operationId":"unsubscribe_v1_digest_unsubscribe_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/oauth/authorize":{"post":{"summary":"Check Authorization","operationId":"check_authorization_v1_oauth_authorize_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuthorizeIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/oauth/authorize/decision":{"post":{"summary":"Decide","operationId":"decide_v1_oauth_authorize_decision_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DecisionIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/oauth/connections":{"get":{"summary":"List Connections","operationId":"list_connections_v1_oauth_connections_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/oauth/connections/{grant_id}":{"delete":{"summary":"Disconnect","operationId":"disconnect_v1_oauth_connections__grant_id__delete","parameters":[{"name":"grant_id","in":"path","required":true,"schema":{"type":"string","title":"Grant Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/tutor/status":{"get":{"summary":"Tutor Status","operationId":"tutor_status_v1_tutor_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/events/{event_id}/ask":{"post":{"summary":"Ask","operationId":"ask_v1_events__event_id__ask_post","parameters":[{"name":"event_id","in":"path","required":true,"schema":{"type":"integer","minimum":1,"title":"Event Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AskIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/plans":{"get":{"summary":"Plans","operationId":"plans_v1_plans_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/me/plan":{"get":{"summary":"My Plan","operationId":"my_plan_v1_me_plan_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/me/alerts":{"get":{"summary":"My Alerts","operationId":"my_alerts_v1_me_alerts_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/follows/{entity_id}/alerts":{"put":{"summary":"Set Alerts","operationId":"set_alerts_v1_follows__entity_id__alerts_put","parameters":[{"name":"entity_id","in":"path","required":true,"schema":{"type":"integer","title":"Entity Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertsIn"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/me/export/follows.csv":{"get":{"summary":"Export Follows","operationId":"export_follows_v1_me_export_follows_csv_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/me/export/feed.csv":{"get":{"summary":"Export Feed","operationId":"export_feed_v1_me_export_feed_csv_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/billing/checkout":{"post":{"summary":"Checkout","operationId":"checkout_v1_billing_checkout_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/billing/portal":{"post":{"summary":"Portal","operationId":"portal_v1_billing_portal_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/me/export":{"get":{"summary":"Export My Data","operationId":"export_my_data_v1_me_export_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/me/delete":{"post":{"summary":"Delete My Account","operationId":"delete_my_account_v1_me_delete_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteIn"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/push/key":{"get":{"summary":"Push Key","operationId":"push_key_v1_push_key_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/me/push":{"get":{"summary":"My Devices","operationId":"my_devices_v1_me_push_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"summary":"Subscribe","operationId":"subscribe_v1_me_push_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"delete":{"summary":"Unsubscribe","operationId":"unsubscribe_v1_me_push_delete","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health":{"get":{"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/waitlist":{"post":{"summary":"Join Waitlist","operationId":"join_waitlist_waitlist_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WaitlistIn"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/contact":{"post":{"summary":"Contact","operationId":"contact_v1_contact_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactIn"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"AlertsIn":{"properties":{"alerts":{"type":"boolean","title":"Alerts"}},"type":"object","required":["alerts"],"title":"AlertsIn"},"AskIn":{"properties":{"question":{"type":"string","maxLength":4000,"title":"Question","default":""}},"type":"object","title":"AskIn"},"AuthorizeIn":{"properties":{"params":{"additionalProperties":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"type":"object","maxProperties":20,"title":"Params"}},"type":"object","required":["params"],"title":"AuthorizeIn"},"CodeIn":{"properties":{"code":{"type":"string","pattern":"^[0-9]{6}$","title":"Code"},"factor_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"title":"Factor Id"}},"type":"object","required":["code"],"title":"CodeIn"},"ContactIn":{"properties":{"email":{"type":"string","maxLength":254,"format":"email","title":"Email"},"topic":{"type":"string","enum":["privacy","general"],"title":"Topic","default":"general"},"message":{"type":"string","maxLength":4000,"minLength":5,"title":"Message"}},"type":"object","required":["email","message"],"title":"ContactIn"},"DecisionIn":{"properties":{"params":{"additionalProperties":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"type":"object","maxProperties":20,"title":"Params"},"decision":{"type":"string","enum":["allow","deny"],"title":"Decision"}},"type":"object","required":["params","decision"],"title":"DecisionIn"},"DeleteIn":{"properties":{"email":{"type":"string","maxLength":320,"minLength":1,"title":"Email"},"code":{"anyOf":[{"type":"string","pattern":"^[0-9]{6}$"},{"type":"null"}],"title":"Code"}},"type":"object","required":["email"],"title":"DeleteIn"},"DigestIn":{"properties":{"frequency":{"type":"string","enum":["weekly","daily","off"],"title":"Frequency"},"hour":{"anyOf":[{"type":"integer","maximum":23.0,"minimum":0.0},{"type":"null"}],"title":"Hour"}},"type":"object","required":["frequency"],"title":"DigestIn"},"EmailLinkIn":{"properties":{"email":{"type":"string","maxLength":254,"format":"email","title":"Email"},"redirect_to":{"type":"string","maxLength":200,"title":"Redirect To"}},"type":"object","required":["email","redirect_to"],"title":"EmailLinkIn"},"FollowIn":{"properties":{"entity_id":{"anyOf":[{"type":"integer","minimum":1.0},{"type":"null"}],"title":"Entity Id"},"kind":{"anyOf":[{"type":"string","enum":["company","indicator","metro","topic"]},{"type":"null"}],"title":"Kind"},"slug":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}],"title":"Slug"}},"type":"object","title":"FollowIn"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"OAuthIn":{"properties":{"provider":{"type":"string","maxLength":20,"title":"Provider"},"redirect_to":{"type":"string","maxLength":200,"title":"Redirect To"}},"type":"object","required":["provider","redirect_to"],"title":"OAuthIn"},"PasswordIn":{"properties":{"email":{"type":"string","maxLength":254,"format":"email","title":"Email"},"password":{"type":"string","maxLength":200,"minLength":1,"title":"Password"}},"type":"object","required":["email","password"],"title":"PasswordIn"},"RefreshIn":{"properties":{"refresh_token":{"type":"string","maxLength":512,"minLength":1,"title":"Refresh Token"}},"type":"object","required":["refresh_token"],"title":"RefreshIn"},"SessionIn":{"properties":{"code":{"anyOf":[{"type":"string","maxLength":200,"minLength":1},{"type":"null"}],"title":"Code"},"code_verifier":{"anyOf":[{"type":"string","maxLength":128,"minLength":43},{"type":"null"}],"title":"Code Verifier"},"token_hash":{"anyOf":[{"type":"string","maxLength":200,"minLength":1},{"type":"null"}],"title":"Token Hash"},"type":{"anyOf":[{"type":"string","enum":["magiclink","email"]},{"type":"null"}],"title":"Type"}},"type":"object","title":"SessionIn","description":"Either a PKCE code and its verifier, or a token_hash and its type."},"SignUpIn":{"properties":{"first_name":{"type":"string","maxLength":60,"minLength":1,"title":"First Name"},"last_name":{"type":"string","maxLength":60,"minLength":1,"title":"Last Name"},"email":{"type":"string","maxLength":254,"format":"email","title":"Email"},"phone":{"anyOf":[{"type":"string","maxLength":30},{"type":"null"}],"title":"Phone"},"password":{"type":"string","maxLength":72,"minLength":8,"title":"Password"},"redirect_to":{"type":"string","maxLength":200,"title":"Redirect To"}},"type":"object","required":["first_name","last_name","email","password","redirect_to"],"title":"SignUpIn"},"TurnOffIn":{"properties":{"code":{"type":"string","pattern":"^[0-9]{6}$","title":"Code"}},"type":"object","required":["code"],"title":"TurnOffIn"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"WaitlistIn":{"properties":{"email":{"type":"string","maxLength":254,"format":"email","title":"Email"},"source":{"type":"string","pattern":"^[a-z0-9_-]{1,32}$","title":"Source","default":"home"}},"type":"object","required":["email"],"title":"WaitlistIn"}}}}