{"openapi":"3.1.0","info":{"title":"CannaMatch job posting","version":"1.0.0","description":"Submit employer-authorized jobs for human review. Free, 30-day listings. Read /agents before submitting. No API key is required; bot checks and rate limits still apply."},"servers":[{"url":"https://www.cannamatch.xyz"}],"externalDocs":{"url":"https://www.cannamatch.xyz/agents"},"paths":{"/api/jobs":{"post":{"operationId":"submitJobForReview","summary":"Submit one job for human review","description":"Creates a pending posting and sends employer confirmation/edit emails. Does not publish immediately. Limit: 3 valid submissions/hour/IP. No idempotency support: do not blindly retry an uncertain result. On a bot-check error, use /post and ask the user to complete any challenge.","security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["title","company","description","url","state","contactEmail"],"properties":{"title":{"type":"string","minLength":1,"maxLength":200},"company":{"type":"string","minLength":1,"maxLength":200},"description":{"type":"string","minLength":50,"maxLength":15000,"description":"Plain text from the actual job posting."},"url":{"type":"string","format":"uri","pattern":"^https?://","maxLength":2048,"description":"Original job/application URL."},"state":{"type":"string","enum":["AL","AK","AZ","AR","CA","CO","CT","DE","DC","FL","GA","HI","ID","IL","IN","IA","KS","KY","LA","ME","MD","MA","MI","MN","MS","MO","MT","NE","NV","NH","NJ","NM","NY","NC","ND","OH","OK","OR","PA","RI","SC","SD","TN","TX","UT","VT","VA","WA","WV","WI","WY"],"description":"US state code; focus: MA, CT, RI, NH, VT, ME."},"contactEmail":{"type":"string","format":"email","maxLength":254,"description":"Employer-authorized hiring email; private in public listings."},"location":{"type":"string","maxLength":120},"workMode":{"type":"string","enum":["remote","hybrid","onsite"]},"jobType":{"type":"string","enum":["full-time","part-time","contract"]}}},"example":{"title":"Cannabis Retail Associate","company":"Example Cannabis Company","location":"Worcester, MA","state":"MA","description":"Help customers understand cannabis products, maintain accurate inventory, and follow state retail regulations. See the original posting for full requirements and application instructions.","url":"https://example.com/careers/retail-associate","contactEmail":"hiring@example.test","workMode":"onsite","jobType":"full-time"}}}},"responses":{"201":{"description":"Accepted for human review; not yet public. Save the id and avoid duplicate submissions.","content":{"application/json":{"schema":{"type":"object","required":["id","pending"],"properties":{"id":{"type":"string"},"pending":{"type":"boolean","const":true}}},"example":{"id":"<job id>","pending":true}}}},"400":{"description":"Invalid fields/JSON or failed bot check. Response: {error: string}. Correct details, or use the browser form for a bot challenge."},"429":{"description":"Hourly IP limit reached. Wait; do not loop or rotate IPs.","headers":{"Retry-After":{"description":"Seconds until retry is allowed.","schema":{"type":"string"}}}},"default":{"description":"Unexpected error; submission may have been saved. Report uncertainty instead of blindly retrying."}}}}}}