{"openapi":"3.1.0","info":{"title":"jobsignal","version":"0.1.0"},"paths":{"/api/public/jobs":{"get":{"summary":"Public Jobs","operationId":"public_jobs_api_public_jobs_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Q"}},{"name":"company","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Company"}},{"name":"location","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location"}},{"name":"remote","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Remote"}},{"name":"employment_type","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Employment Type"}},{"name":"stage","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Stage"}},{"name":"employees","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Employees"}},{"name":"raised","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Raised"}},{"name":"investor","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Investor"}},{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Country"}},{"name":"metro","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Metro"}},{"name":"tag","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Tag"}},{"name":"role_family","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Role Family"}},{"name":"seniority","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Seniority"}},{"name":"comp_min","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Comp Min"}},{"name":"since_days","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":365,"minimum":1},{"type":"null"}],"title":"Since Days"}},{"name":"years_exp_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":40,"minimum":0},{"type":"null"}],"description":"roles whose known minimum experience is <= N years","title":"Years Exp Max"},"description":"roles whose known minimum experience is <= N years"},{"name":"equity","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"description":"true = only roles that mention equity","title":"Equity"},"description":"true = only roles that mention equity"},{"name":"remote_country","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"description":"ISO2/region code the role is remote-eligible in, e.g. US","title":"Remote Country"},"description":"ISO2/region code the role is remote-eligible in, e.g. US"},{"name":"work_mode","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Work Mode"}},{"name":"first_party_only","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"First Party Only"}},{"name":"exclude_reposted","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Exclude Reposted"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","pattern":"^(newest|comp|relevance|first_seen)$","default":"relevance","title":"Sort"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobSearchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/tags":{"get":{"summary":"Public Tags","operationId":"public_tags_api_public_tags_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/public/jobs/grouped":{"get":{"summary":"Public Jobs Grouped","description":"Wellfound-style: a page of companies, each with its top `roles` roles + total count.\n\n`sort`: relevance (best match, the default) | newest | roles (most open) | name.","operationId":"public_jobs_grouped_api_public_jobs_grouped_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Q"}},{"name":"company","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Company"}},{"name":"location","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location"}},{"name":"remote","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Remote"}},{"name":"employment_type","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Employment Type"}},{"name":"stage","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Stage"}},{"name":"employees","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Employees"}},{"name":"raised","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Raised"}},{"name":"investor","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Investor"}},{"name":"country","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Country"}},{"name":"metro","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Metro"}},{"name":"tag","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Tag"}},{"name":"role_family","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Role Family"}},{"name":"seniority","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Seniority"}},{"name":"comp_min","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Comp Min"}},{"name":"since_days","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":365,"minimum":1},{"type":"null"}],"title":"Since Days"}},{"name":"years_exp_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":40,"minimum":0},{"type":"null"}],"title":"Years Exp Max"}},{"name":"equity","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Equity"}},{"name":"remote_country","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Remote Country"}},{"name":"work_mode","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Work Mode"}},{"name":"first_party_only","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"First Party Only"}},{"name":"exclude_reposted","in":"query","required":false,"schema":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Exclude Reposted"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":20,"title":"Limit"}},{"name":"sort","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sort"}},{"name":"roles","in":"query","required":false,"schema":{"type":"integer","maximum":5,"minimum":1,"default":2,"title":"Roles"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GroupedJobsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/jobs/{job_id}":{"get":{"summary":"Public Job","operationId":"public_job_api_public_jobs__job_id__get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Job Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobDetailPublic"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/companies":{"get":{"summary":"Public Companies","operationId":"public_companies_api_public_companies_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Q"}},{"name":"stage","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Stage"}},{"name":"investor","in":"query","required":false,"schema":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Investor"}},{"name":"sort","in":"query","required":false,"schema":{"type":"string","pattern":"^(open_roles|name)$","default":"open_roles","title":"Sort"}},{"name":"state","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(listed|email_only|none)$"},{"type":"null"}],"title":"State"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/investors":{"get":{"summary":"Public Investors","description":"Investor index with query-time counts (tracked public companies, open roles, newest role). Sorted by tracked companies.","operationId":"public_investors_api_public_investors_get","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Q"}},{"name":"kind","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(vc|corporate|angel|other)$"},{"type":"null"}],"title":"Kind"}},{"name":"limit","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":500,"minimum":1},{"type":"null"}],"title":"Limit"}},{"name":"all","in":"query","required":false,"schema":{"type":"boolean","description":"include investors with no tracked companies","default":false,"title":"All"},"description":"include investors with no tracked companies"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvestorListResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/investors/{slug}":{"get":{"summary":"Public Investor","operationId":"public_investor_api_public_investors__slug__get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvestorDetailPublic"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/companies/{domain}":{"get":{"summary":"Public Company","description":"CompanyDetailPublic: CompanyPublic + signals (tags with evidence), headcount series, founders, hiring dynamics.","operationId":"public_company_api_public_companies__domain__get","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","title":"Domain"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/companies/{domain}/jobs":{"get":{"summary":"Public Company Jobs","operationId":"public_company_jobs_api_public_companies__domain__jobs_get","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","title":"Domain"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":100,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobSearchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/alerts":{"post":{"summary":"Create Alert Ep","description":"Create one pending alert and try to send its confirmation. `sent` is what SES actually did.\n\nThe client's success state is structurally unreachable unless this says a confirmation went out, and the\nbody is identical for a brand-new address and one that already has four confirmed alerts — in both cases a\nnew unconfirmed row exists and a confirmation was attempted, so the endpoint is not an existence oracle.\nRate limits are counted in memory against the address and the caller's IP; neither is stored.","operationId":"create_alert_ep_api_public_alerts_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlertRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/events":{"post":{"summary":"Public Event","description":"Anonymous job-view telemetry. Stores {job_id, opaque session key, dwell} only — no IP, no user agent.","operationId":"public_event_api_public_events_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ViewEventRequest"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/trending":{"get":{"summary":"Admin Trending","description":"Most-viewed jobs over the window, from the anonymous view events.","operationId":"admin_trending_api_admin_trending_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":90,"minimum":1,"default":7,"title":"Days"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-amzn-oidc-data","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Amzn-Oidc-Data"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/track":{"post":{"summary":"Admin Track","operationId":"admin_track_api_admin_track_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-amzn-oidc-data","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Amzn-Oidc-Data"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrackRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/companies/{domain}/sources":{"get":{"summary":"Admin Sources","operationId":"admin_sources_api_admin_companies__domain__sources_get","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","title":"Domain"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-amzn-oidc-data","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Amzn-Oidc-Data"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AdminSource"},"title":"Response Admin Sources Api Admin Companies  Domain  Sources Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/sources/{source_id}/run":{"post":{"summary":"Admin Run Source","operationId":"admin_run_source_api_admin_sources__source_id__run_post","parameters":[{"name":"source_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Source Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-amzn-oidc-data","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Amzn-Oidc-Data"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/runs":{"get":{"summary":"Admin Runs","operationId":"admin_runs_api_admin_runs_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-amzn-oidc-data","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Amzn-Oidc-Data"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/work":{"get":{"summary":"Admin Work","description":"Work-queue read for agent routines. (Leasing endpoint lands with the routine integration.)","operationId":"admin_work_api_admin_work_get","parameters":[{"name":"skill","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Skill"}},{"name":"status","in":"query","required":false,"schema":{"type":"string","default":"queued","title":"Status"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Limit"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-amzn-oidc-data","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Amzn-Oidc-Data"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/work/lease":{"post":{"summary":"Admin Work Lease","description":"Routine/worker hand-off: lease up to N queued items of a skill (expired leases are reclaimable).","operationId":"admin_work_lease_api_admin_work_lease_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-amzn-oidc-data","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Amzn-Oidc-Data"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LeaseRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/work/{work_id}/result":{"post":{"summary":"Admin Work Result","operationId":"admin_work_result_api_admin_work__work_id__result_post","parameters":[{"name":"work_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Work Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-amzn-oidc-data","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Amzn-Oidc-Data"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResultRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/candidates":{"get":{"summary":"Admin Candidates","operationId":"admin_candidates_api_admin_candidates_get","parameters":[{"name":"status","in":"query","required":false,"schema":{"type":"string","default":"new","title":"Status"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-amzn-oidc-data","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Amzn-Oidc-Data"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/candidates/{cand_id}/track":{"post":{"summary":"Admin Candidate Track","description":"Promote a candidate: track it (domain from the candidate or the override) and mark it tracked.","operationId":"admin_candidate_track_api_admin_candidates__cand_id__track_post","parameters":[{"name":"cand_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Cand Id"}},{"name":"domain","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-amzn-oidc-data","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Amzn-Oidc-Data"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/candidates/{cand_id}/dismiss":{"post":{"summary":"Admin Candidate Dismiss","operationId":"admin_candidate_dismiss_api_admin_candidates__cand_id__dismiss_post","parameters":[{"name":"cand_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Cand Id"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-amzn-oidc-data","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Amzn-Oidc-Data"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/llm-usage":{"get":{"summary":"Admin Llm Usage","operationId":"admin_llm_usage_api_admin_llm_usage_get","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","default":7,"title":"Days"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-amzn-oidc-data","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Amzn-Oidc-Data"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/admin/companies/{domain}/scraper-versions":{"get":{"summary":"Admin Scraper Versions","operationId":"admin_scraper_versions_api_admin_companies__domain__scraper_versions_get","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","title":"Domain"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}},{"name":"x-amzn-oidc-data","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Amzn-Oidc-Data"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/embed/company/{domain}":{"get":{"summary":"Embed Snippets","description":"The copy-paste snippets a third-party site needs (iframe or script tag).","operationId":"embed_snippets_api_public_embed_company__domain__get","parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","title":"Domain"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Embed Snippets Api Public Embed Company  Domain  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/public/digest/latest":{"get":{"tags":["public"],"summary":"Latest Digest","description":"{week, roles, companies, url} for the newest published issue, or nulls when there is none yet.","operationId":"latest_digest_api_public_digest_latest_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Latest Digest Api Public Digest Latest Get"}}}}}}}},"components":{"schemas":{"AdminSource":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"kind":{"type":"string","title":"Kind"},"ats_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ats Type"},"config":{"additionalProperties":true,"type":"object","title":"Config"},"board_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Board Url"},"status":{"type":"string","title":"Status"},"consecutive_failures":{"type":"integer","title":"Consecutive Failures"},"last_run_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Run At"},"last_success_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Success At"},"last_job_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Last Job Count"},"evidence":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Evidence"}},"type":"object","required":["id","kind","ats_type","config","board_url","status","consecutive_failures","last_run_at","last_success_at","last_job_count","evidence"],"title":"AdminSource"},"AlertRequest":{"properties":{"email":{"type":"string","title":"Email"},"params":{"additionalProperties":true,"type":"object","title":"Params","default":{}},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"cadence":{"type":"string","title":"Cadence","default":"weekly"},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"}},"type":"object","required":["email"],"title":"AlertRequest"},"CompanyGroup":{"properties":{"company":{"$ref":"#/components/schemas/CompanyPublic"},"roles":{"items":{"$ref":"#/components/schemas/JobPublic"},"type":"array","title":"Roles"},"total_roles":{"type":"integer","title":"Total Roles"},"newest_first_seen_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Newest First Seen At"}},"type":"object","required":["company","roles","total_roles"],"title":"CompanyGroup"},"CompanyListResponse":{"properties":{"total":{"type":"integer","title":"Total"},"items":{"items":{"$ref":"#/components/schemas/CompanyPublic"},"type":"array","title":"Items"}},"type":"object","required":["total","items"],"title":"CompanyListResponse"},"CompanyPublic":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"name":{"type":"string","title":"Name"},"domain":{"type":"string","title":"Domain"},"website":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Website"},"logo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logo Url"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"tagline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tagline"},"careers_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Careers Url"},"linkedin_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Linkedin Url"},"employees":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Employees"},"growth_yoy_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Growth Yoy Pct"},"total_raised_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Total Raised Usd"},"last_round_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Last Round Usd"},"last_round_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Round At"},"stage":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stage"},"investors":{"items":{"type":"string"},"type":"array","title":"Investors","default":[]},"hq":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hq"},"founded_year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Founded Year"},"open_roles":{"type":"integer","title":"Open Roles","default":0},"new_roles_30d":{"type":"integer","title":"New Roles 30D","default":0},"listing_state":{"type":"string","title":"Listing State","default":"none"},"hiring_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hiring Email"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags","default":[]}},"type":"object","required":["id","name","domain","website","logo_url","description","careers_url"],"title":"CompanyPublic"},"Facet":{"properties":{"value":{"type":"string","title":"Value"},"count":{"type":"integer","title":"Count"}},"type":"object","required":["value","count"],"title":"Facet"},"GroupedJobsResponse":{"properties":{"total_roles":{"type":"integer","title":"Total Roles"},"total_companies":{"type":"integer","title":"Total Companies"},"groups":{"items":{"$ref":"#/components/schemas/CompanyGroup"},"type":"array","title":"Groups"},"facets":{"additionalProperties":{"items":{"$ref":"#/components/schemas/Facet"},"type":"array"},"type":"object","title":"Facets"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"},"email_only_companies":{"type":"integer","title":"Email Only Companies","default":0},"investor_labels":{"additionalProperties":{"type":"string"},"type":"object","title":"Investor Labels","default":{}}},"type":"object","required":["total_roles","total_companies","groups","facets"],"title":"GroupedJobsResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"InvestorDetailPublic":{"properties":{"name":{"type":"string","title":"Name"},"slug":{"type":"string","title":"Slug"},"logo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logo Url"},"kind":{"type":"string","title":"Kind","default":"other"},"ai_focus":{"type":"boolean","title":"Ai Focus","default":false},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain"},"website":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Website"},"tracked_companies":{"type":"integer","title":"Tracked Companies","default":0},"open_roles":{"type":"integer","title":"Open Roles","default":0},"newest_role_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Newest Role At"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"companies":{"items":{"$ref":"#/components/schemas/CompanyPublic"},"type":"array","title":"Companies","default":[]}},"type":"object","required":["name","slug"],"title":"InvestorDetailPublic"},"InvestorListResponse":{"properties":{"total":{"type":"integer","title":"Total"},"items":{"items":{"$ref":"#/components/schemas/InvestorPublic"},"type":"array","title":"Items"}},"type":"object","required":["total","items"],"title":"InvestorListResponse"},"InvestorPublic":{"properties":{"name":{"type":"string","title":"Name"},"slug":{"type":"string","title":"Slug"},"logo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logo Url"},"kind":{"type":"string","title":"Kind","default":"other"},"ai_focus":{"type":"boolean","title":"Ai Focus","default":false},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain"},"website":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Website"},"tracked_companies":{"type":"integer","title":"Tracked Companies","default":0},"open_roles":{"type":"integer","title":"Open Roles","default":0},"newest_role_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Newest Role At"}},"type":"object","required":["name","slug"],"title":"InvestorPublic"},"JobDetailPublic":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"company_id":{"type":"string","format":"uuid","title":"Company Id"},"company_name":{"type":"string","title":"Company Name"},"company_domain":{"type":"string","title":"Company Domain"},"company_logo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Logo Url"},"title":{"type":"string","title":"Title"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"team":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Team"},"primary_location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Location"},"locations":{"items":{"type":"string"},"type":"array","title":"Locations"},"location_names":{"items":{"type":"string"},"type":"array","title":"Location Names","default":[]},"location_country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location Country"},"location_metro":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location Metro"},"is_remote":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Remote"},"workplace_type":{"type":"string","title":"Workplace Type"},"employment_type":{"type":"string","title":"Employment Type"},"role_family":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role Family"},"seniority":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Seniority"},"comp_min":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Comp Min"},"comp_max":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Comp Max"},"comp_currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Comp Currency"},"comp_period":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Comp Period"},"comp_equity":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Comp Equity"},"comp_equity_min_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Comp Equity Min Pct"},"comp_equity_max_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Comp Equity Max Pct"},"years_exp_min":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Years Exp Min"},"years_exp_max":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Years Exp Max"},"work_mode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Work Mode"},"remote_countries":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Remote Countries"},"visa_sponsorship":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Visa Sponsorship"},"clearance_required":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Clearance Required"},"ats_provider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ats Provider"},"apply_is_first_party":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Apply Is First Party"},"reposted_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Reposted Count"},"reposted_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Reposted At"},"date_posted":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Date Posted"},"first_seen_at":{"type":"string","format":"date-time","title":"First Seen At"},"is_active":{"type":"boolean","title":"Is Active"},"closed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Closed At"},"company_stage":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Stage"},"company_employees":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Company Employees"},"company_raised_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Company Raised Usd"},"company_metro":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Metro"},"company_tagline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Tagline"},"company_tags":{"items":{"type":"string"},"type":"array","title":"Company Tags","default":[]},"description_text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description Text"},"description_html":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description Html"},"apply_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apply Url"}},"type":"object","required":["id","company_id","company_name","company_domain","company_logo_url","title","url","team","primary_location","locations","is_remote","workplace_type","employment_type","comp_min","comp_max","comp_currency","comp_period","comp_equity","date_posted","first_seen_at","is_active","closed_at","description_text","apply_url"],"title":"JobDetailPublic"},"JobPublic":{"properties":{"id":{"type":"string","format":"uuid","title":"Id"},"company_id":{"type":"string","format":"uuid","title":"Company Id"},"company_name":{"type":"string","title":"Company Name"},"company_domain":{"type":"string","title":"Company Domain"},"company_logo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Logo Url"},"title":{"type":"string","title":"Title"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"team":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Team"},"primary_location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Location"},"locations":{"items":{"type":"string"},"type":"array","title":"Locations"},"location_names":{"items":{"type":"string"},"type":"array","title":"Location Names","default":[]},"location_country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location Country"},"location_metro":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location Metro"},"is_remote":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Remote"},"workplace_type":{"type":"string","title":"Workplace Type"},"employment_type":{"type":"string","title":"Employment Type"},"role_family":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role Family"},"seniority":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Seniority"},"comp_min":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Comp Min"},"comp_max":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Comp Max"},"comp_currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Comp Currency"},"comp_period":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Comp Period"},"comp_equity":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Comp Equity"},"comp_equity_min_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Comp Equity Min Pct"},"comp_equity_max_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Comp Equity Max Pct"},"years_exp_min":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Years Exp Min"},"years_exp_max":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Years Exp Max"},"work_mode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Work Mode"},"remote_countries":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Remote Countries"},"visa_sponsorship":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Visa Sponsorship"},"clearance_required":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Clearance Required"},"ats_provider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ats Provider"},"apply_is_first_party":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Apply Is First Party"},"reposted_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Reposted Count"},"reposted_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Reposted At"},"date_posted":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Date Posted"},"first_seen_at":{"type":"string","format":"date-time","title":"First Seen At"},"is_active":{"type":"boolean","title":"Is Active"},"closed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Closed At"},"company_stage":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Stage"},"company_employees":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Company Employees"},"company_raised_usd":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Company Raised Usd"},"company_metro":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Metro"},"company_tagline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Tagline"},"company_tags":{"items":{"type":"string"},"type":"array","title":"Company Tags","default":[]}},"type":"object","required":["id","company_id","company_name","company_domain","company_logo_url","title","url","team","primary_location","locations","is_remote","workplace_type","employment_type","comp_min","comp_max","comp_currency","comp_period","comp_equity","date_posted","first_seen_at","is_active","closed_at"],"title":"JobPublic"},"JobSearchResponse":{"properties":{"total":{"type":"integer","title":"Total"},"items":{"items":{"$ref":"#/components/schemas/JobPublic"},"type":"array","title":"Items"},"facets":{"additionalProperties":{"items":{"$ref":"#/components/schemas/Facet"},"type":"array"},"type":"object","title":"Facets"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"},"email_only_companies":{"type":"integer","title":"Email Only Companies","default":0},"investor_labels":{"additionalProperties":{"type":"string"},"type":"object","title":"Investor Labels","default":{}}},"type":"object","required":["total","items","facets"],"title":"JobSearchResponse"},"LeaseRequest":{"properties":{"skill":{"type":"string","title":"Skill"},"worker":{"type":"string","title":"Worker","default":"routine"},"limit":{"type":"integer","title":"Limit","default":1},"lease_minutes":{"type":"integer","title":"Lease Minutes","default":30}},"type":"object","required":["skill"],"title":"LeaseRequest"},"ResultRequest":{"properties":{"status":{"type":"string","title":"Status"},"result":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Result"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["status"],"title":"ResultRequest"},"TrackRequest":{"properties":{"url":{"type":"string","title":"Url"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Domain"}},"type":"object","required":["url"],"title":"TrackRequest"},"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"},"ViewEventRequest":{"properties":{"job_id":{"type":"string","format":"uuid","title":"Job Id"},"dwell_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Dwell Ms"},"session_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Key"}},"type":"object","required":["job_id"],"title":"ViewEventRequest"}}}}