{"openapi":"3.1.0","info":{"title":"WithMira public API","version":"2026-05-01","description":"Read-only public endpoints for inspecting active remote IT jobs and country eligibility. Private candidate, resume, application, recruiter, and admin data is intentionally excluded."},"servers":[{"url":"http://localhost:3000"}],"paths":{"/api/jobs":{"get":{"summary":"List active public jobs","description":"Returns active job summaries with canonical URLs, technologies, and accepted candidate countries.","parameters":[{"name":"q","in":"query","schema":{"type":"string"},"description":"Optional case-insensitive search across title, technologies, and description."},{"name":"country","in":"query","schema":{"type":"string","minLength":2,"maxLength":2},"description":"Optional ISO 3166-1 alpha-2 candidate country filter."},{"name":"technology","in":"query","schema":{"type":"string"},"description":"Optional exact technology tag filter."},{"name":"take","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":80},"description":"Maximum number of jobs to return."}],"responses":{"200":{"description":"Active public job summaries.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicJobsResponse"}}}}}}},"/api/jobs/{slug}":{"get":{"summary":"Get one active public job","description":"Returns a single public job, including full description text.","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Public job detail.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicJobDetailResponse"}}}},"404":{"description":"No active job exists for the slug."}}}},"/llms.txt":{"get":{"summary":"Read the site guide for assistant tools","responses":{"200":{"description":"Plain-text site guide."}}}},"/llms-full.txt":{"get":{"summary":"Read a full public text snapshot","responses":{"200":{"description":"Plain-text public job snapshot."}}}}},"components":{"schemas":{"PublicJob":{"type":"object","required":["id","slug","title","organization","applicantCountries","canonicalUrl","apiUrl"],"properties":{"id":{"type":"string"},"slug":{"type":"string"},"title":{"type":"string"},"organization":{"type":"string"},"client":{"type":["string","null"]},"department":{"type":["string","null"]},"specialization":{"type":["string","null"]},"seniority":{"type":"array","items":{"type":"string"}},"technologies":{"type":"array","items":{"type":"string"}},"applicantCountries":{"type":"array","items":{"type":"object","required":["code","name"],"properties":{"code":{"type":"string"},"name":{"type":"string"}}}},"descriptionSnippet":{"type":"string"},"descriptionText":{"type":"string"},"canonicalUrl":{"type":"string","format":"uri"},"apiUrl":{"type":"string","format":"uri"},"datePosted":{"type":["string","null"],"format":"date-time"},"modifiedAt":{"type":"string","format":"date-time"},"remote":{"type":"boolean"},"directApply":{"type":"boolean"}}},"PublicJobsResponse":{"type":"object","properties":{"schemaVersion":{"type":"string"},"generatedAt":{"type":"string","format":"date-time"},"count":{"type":"integer"},"jobs":{"type":"array","items":{"$ref":"#/components/schemas/PublicJob"}}}},"PublicJobDetailResponse":{"type":"object","properties":{"schemaVersion":{"type":"string"},"generatedAt":{"type":"string","format":"date-time"},"job":{"$ref":"#/components/schemas/PublicJob"}}}}}}