{"openapi":"3.1.1","info":{"title":"Niuro Public Jobs API","version":"1.0.0","description":"Versioned, unauthenticated, read-only discovery of roles currently published by Niuro. Applications continue through each job's publicUrl; this API does not accept applications or expose private candidate data.","x-versioning-policy":{"current":"v1","strategy":"URL path","breakingChanges":"Breaking changes use a new major path such as /api/v2/. Additive fields can be introduced within v1.","deprecationNotice":"Niuro documents deprecation before emitting the Deprecation header and provides at least 90 days before any Sunset date.","policy":"https://niuro.io/docs/api-lifecycle.md"}},"security":[],"paths":{"/api/v1/jobs/":{"get":{"operationId":"listPublicJobs","summary":"List currently published jobs","description":"Returns roles currently available for public discovery. Use each job's publicUrl to open the canonical application flow. No authentication is required.","tags":["Public jobs"],"parameters":[{"name":"limit","in":"query","required":false,"description":"Maximum number of jobs to return.","schema":{"type":"integer","minimum":1,"maximum":100,"default":100}}],"responses":{"200":{"description":"Published jobs returned successfully.","headers":{"RateLimit-Policy":{"description":"Applied public-jobs quota policy.","schema":{"type":"string"}},"RateLimit-Limit":{"description":"Maximum requests in the active window.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","$ref":"#/components/schemas/PublicJobsResponse"}}}},"400":{"description":"A query parameter is invalid.","content":{"application/problem+json":{"schema":{"type":"object","$ref":"#/components/schemas/ProblemDetails"}}}},"405":{"description":"The route supports GET requests only.","content":{"application/problem+json":{"schema":{"type":"object","$ref":"#/components/schemas/ProblemDetails"}}}},"429":{"description":"The enforced public quota was exceeded.","headers":{"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer","minimum":1}},"RateLimit-Policy":{"description":"Applied public-jobs quota policy.","schema":{"type":"string"}},"RateLimit":{"description":"Current exhausted quota state.","schema":{"type":"string"}},"RateLimit-Limit":{"description":"Maximum requests in the active window.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Zero when the request is rejected by the quota.","schema":{"type":"integer","const":0}}},"content":{"application/problem+json":{"schema":{"type":"object","$ref":"#/components/schemas/ProblemDetails"}}}},"503":{"description":"The upstream public jobs service is unavailable or returned an invalid response.","headers":{"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer","minimum":1}}},"content":{"application/problem+json":{"schema":{"type":"object","$ref":"#/components/schemas/ProblemDetails"}}}}}}}},"components":{"schemas":{"PublicJobsResponse":{"type":"object","additionalProperties":true,"required":["success","jobs","hasMore"],"properties":{"success":{"type":"boolean","const":true,"description":"Indicates that the jobs collection was returned."},"jobs":{"type":"array","items":{"type":"object","$ref":"#/components/schemas/PublicJob"}},"hasMore":{"type":"boolean","description":"Whether additional published jobs exist beyond this response."}}},"PublicJob":{"type":"object","additionalProperties":true,"required":["title","slug"],"properties":{"title":{"type":"string","minLength":1,"description":"Public role title."},"description":{"type":"string","description":"Public role description when supplied."},"slug":{"type":"string","minLength":1,"description":"Stable public identifier for the role."},"publicUrl":{"type":"string","format":"uri","description":"Canonical application URL for the role."},"seniority":{"type":["string","null"],"description":"Published seniority label when supplied."},"requiredSkills":{"type":"array","items":{"type":"string"},"description":"Published skill names."},"modality":{"type":"string","description":"Published working model, such as remote."},"location":{"type":"string","description":"Published location or eligibility label."},"publishedAt":{"type":"string","format":"date-time","description":"Publication timestamp when supplied."},"compensation":{"type":["object","null"],"additionalProperties":true,"properties":{"min":{"type":"number"},"max":{"type":"number"},"currency":{"type":"string","pattern":"^[A-Za-z]{3}$"},"period":{"type":"string","enum":["hourly","daily","weekly","monthly","yearly"]}},"description":"Public compensation details when the role publishes them."}}},"ProblemDetails":{"type":"object","additionalProperties":true,"required":["type","title","status","detail","instance","code","resolution"],"properties":{"type":{"type":"string","format":"uri-reference"},"title":{"type":"string"},"status":{"type":"integer","minimum":400,"maximum":599},"detail":{"type":"string"},"instance":{"type":"string","format":"uri-reference"},"code":{"type":"string","description":"Stable machine-readable error code."},"resolution":{"type":"string","format":"uri-reference","description":"Documentation or recovery route for the caller."}}}}},"tags":[{"name":"Public jobs","description":"Unauthenticated, read-only role discovery."}],"externalDocs":{"description":"Niuro developer documentation, versioning, and deprecation policy","url":"https://niuro.io/developers/"},"servers":[{"description":"Current Niuro site origin","url":"https://45230b4b-niuro-landing-page.wispy-math-f75b.workers.dev"}]}