{"openapi":"3.1.0","info":{"title":"TeamStation AI Engineering Careers Agent API","version":"1.0.0","summary":"Public discovery contract for TeamStation AI engineering careers, job feeds, social cards, and agent-readable role data.","description":"Use this document to discover crawlable TeamStation AI engineering career pages, structured job feeds, direct-apply URLs, social card images, and LLM-readable role inventory. The public job detail pages remain the canonical application URLs."},"servers":[{"url":"https://jobs.teamstation.dev"}],"tags":[{"name":"Discovery","description":"Agent and crawler discovery endpoints."},{"name":"Jobs","description":"Open engineering role pages and feeds."},{"name":"Social Cards","description":"OpenGraph image generation endpoints."}],"paths":{"/":{"get":{"tags":["Discovery"],"summary":"Engineering careers homepage","description":"Crawlable homepage for TeamStation AI engineering careers and open roles.","responses":{"200":{"description":"HTML homepage.","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/jobs":{"get":{"tags":["Jobs"],"summary":"Open engineering roles directory","description":"Crawlable role directory grouped by TeamStation AI role taxonomy.","responses":{"200":{"description":"HTML role directory.","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/jobs/{id}/{slug}":{"get":{"tags":["Jobs"],"summary":"Canonical job detail page","description":"Crawlable job detail page with canonical URL, JobPosting schema, BreadcrumbList schema, OpenGraph metadata, and direct apply support.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"integer"},"description":"TeamStation AI job ID."},{"name":"slug","in":"path","required":true,"schema":{"type":"string"},"description":"Canonical job slug."},{"name":"apply","in":"query","required":false,"schema":{"type":"string","enum":["1"]},"description":"When set to 1, opens the Apply Globally flow."}],"responses":{"200":{"description":"HTML job detail page.","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/feeds/jobs.json":{"get":{"tags":["Jobs"],"summary":"Public JSON jobs feed","description":"Machine-readable feed of open engineering roles with canonical URLs and direct apply URLs.","responses":{"200":{"description":"JSON jobs feed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobsFeed"}}}}}}},"/feeds/jobs.xml":{"get":{"tags":["Jobs"],"summary":"Generic XML jobs feed","responses":{"200":{"description":"XML jobs feed.","content":{"application/xml":{"schema":{"type":"string"}}}}}}},"/feeds/indeed.xml":{"get":{"tags":["Jobs"],"summary":"Indeed-compatible XML jobs feed","responses":{"200":{"description":"Indeed-compatible XML jobs feed.","content":{"application/xml":{"schema":{"type":"string"}}}}}}},"/feeds/linkedin.xml":{"get":{"tags":["Jobs"],"summary":"LinkedIn-compatible XML jobs feed","responses":{"200":{"description":"LinkedIn-compatible XML jobs feed.","content":{"application/xml":{"schema":{"type":"string"}}}}}}},"/feeds/ziprecruiter.xml":{"get":{"tags":["Jobs"],"summary":"ZipRecruiter-compatible XML jobs feed","responses":{"200":{"description":"ZipRecruiter-compatible XML jobs feed.","content":{"application/xml":{"schema":{"type":"string"}}}}}}},"/llms.txt":{"get":{"tags":["Discovery"],"summary":"LLM discovery summary","responses":{"200":{"description":"LLM-readable site summary.","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/llms-full.txt":{"get":{"tags":["Discovery","Jobs"],"summary":"Live LLM-readable role inventory","description":"Markdown text inventory of open roles, categories, canonical URLs, and direct apply URLs.","responses":{"200":{"description":"LLM-readable live jobs inventory.","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/openapi.json":{"get":{"tags":["Discovery"],"summary":"OpenAPI discovery document","responses":{"200":{"description":"OpenAPI 3.1 document.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/og/careers":{"get":{"tags":["Social Cards"],"summary":"Homepage social image","responses":{"200":{"description":"PNG OpenGraph image.","content":{"image/png":{"schema":{"type":"string","contentEncoding":"base64"}}}}}}},"/api/og/job":{"get":{"tags":["Social Cards"],"summary":"Job social image","parameters":[{"name":"id","in":"query","required":false,"schema":{"type":"integer"},"description":"TeamStation AI job ID. When omitted, returns a generic careers social image."}],"responses":{"200":{"description":"PNG OpenGraph image.","content":{"image/png":{"schema":{"type":"string","contentEncoding":"base64"}}}}}}},"/sitemap.xml":{"get":{"tags":["Discovery"],"summary":"Sitemap","responses":{"200":{"description":"XML sitemap.","content":{"application/xml":{"schema":{"type":"string"}}}}}}},"/robots.txt":{"get":{"tags":["Discovery"],"summary":"Robots policy","responses":{"200":{"description":"Robots.txt.","content":{"text/plain":{"schema":{"type":"string"}}}}}}}},"components":{"schemas":{"JobsFeed":{"type":"object","required":["publisher","publisherUrl","generatedAt","count","jobs"],"properties":{"publisher":{"type":"string","example":"TeamStation AI"},"publisherUrl":{"type":"string","format":"uri"},"generatedAt":{"type":"string","format":"date-time"},"count":{"type":"integer"},"jobs":{"type":"array","items":{"$ref":"#/components/schemas/JobFeedItem"}}}},"JobFeedItem":{"type":"object","required":["id","reqId","title","category","location","type","compensation","postedAt","url","applyUrl","description"],"properties":{"id":{"type":"integer"},"reqId":{"type":"string","example":"REQ-0840"},"title":{"type":"string"},"category":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"location":{"type":"string","example":"100% Remote — Latin America"},"type":{"type":"string","example":"Full Time Engineering Role"},"compensation":{"type":"string","example":"Top Compensation"},"postedAt":{"type":"string","format":"date-time"},"url":{"type":"string","format":"uri"},"applyUrl":{"type":"string","format":"uri"},"description":{"type":"string"}}}}}}