{"openapi":"3.1.0","info":{"title":"MindSolve Consulting Jobs API","version":"1.0.0","description":"Read-only public API for AI assistants and agents to browse, search and match open technology jobs at MindSolve Consulting (Romania/EU, B2B contracts). Always cite jobs with their canonicalUrl.","contact":{"email":"contact@mindsolveconsulting.com"}},"servers":[{"url":"https://mindsolveconsulting.com"}],"paths":{"/api/v1/ai/jobs":{"get":{"operationId":"listJobs","summary":"List all open jobs","responses":{"200":{"description":"All open jobs with canonical and apply URLs","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer"},"jobs":{"type":"array","items":{"$ref":"#/components/schemas/JobSummary"}}}}}}}}}},"/api/v1/ai/jobs/{slug}":{"get":{"operationId":"getJob","summary":"Get one job in full detail","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["markdown"]}}],"responses":{"200":{"description":"Job detail (JSON or markdown)"},"404":{"description":"Job not found or closed"}}}},"/api/v1/ai/search":{"get":{"operationId":"searchJobs","summary":"Search jobs by keyword, domain, work model","parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"domain","in":"query","schema":{"type":"string"}},{"name":"workModel","in":"query","schema":{"type":"string","enum":["Remote","Hybrid","On-site"]}}],"responses":{"200":{"description":"Matching jobs"}}}},"/api/v1/ai/match":{"get":{"operationId":"matchJobs","summary":"Match jobs against a candidate skill list","parameters":[{"name":"skills","in":"query","required":true,"schema":{"type":"string"},"description":"Comma-separated skills, e.g. java,spring,aws"},{"name":"remote","in":"query","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Scored jobs with matchedSkills and matchScore"}}}}},"components":{"schemas":{"JobSummary":{"type":"object","properties":{"slug":{"type":"string"},"title":{"type":"string"},"blurb":{"type":"string"},"domains":{"type":"array","items":{"type":"string"}},"workModel":{"type":"string"},"location":{"type":"string","nullable":true},"seniority":{"type":"string","nullable":true},"languages":{"type":"array","items":{"type":"string"}},"contractType":{"type":"string"},"canonicalUrl":{"type":"string"},"applyUrl":{"type":"string"},"markdownUrl":{"type":"string"}}}}}}