{"openapi":"3.0.3","info":{"title":"InsightHire API","version":"1.0.0","description":"Read and write recruiting data, publish your open jobs on your own site, and push candidates in from partner systems.\n\nSend `Authorization: Bearer <API key>`. Create keys in Settings → API keys (organization admins). A key sees what the person who created it can see.\n\nLists use cursor pagination (`limit`, `cursor`) and `updated_after`. Dates are ISO 8601 in UTC. Each key can make 300 requests a minute."},"servers":[{"url":"https://api.insighthire.com/v1"}],"tags":[{"name":"Jobs"},{"name":"Candidates"},{"name":"Applications"},{"name":"Organization"},{"name":"Job board","description":"Public. No API key. Only jobs published on your careers page."},{"name":"Ingestion","description":"For partners that send candidates to you."}],"components":{"securitySchemes":{"ApiKey":{"type":"http","scheme":"bearer","description":"`jobs:read`: List jobs, departments and offices.\n`candidates:read`: List and fetch candidate profiles.\n`candidates:write`: Create and update candidate profiles.\n`applications:read`: List and fetch applications.\n`applications:write`: Create applications, move them between stages and reject them.\n`users:read`: List the people on your team.\n`ingestion`: For partners: push candidates onto a job with source attribution."}},"responses":{"Error":{"description":"Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"RateLimited":{"description":"Too many requests. Wait `Retry-After` seconds.","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"details":{"type":"array","items":{"type":"object"}}},"required":["code","message"]}},"required":["error"]},"Job":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"code":{"type":"string","nullable":true},"status":{"type":"string","enum":["draft","open","posted","on_hold","closed","filled"]},"description":{"type":"string","nullable":true},"requirements":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"employment_type":{"type":"string","nullable":true},"department":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"nullable":true},"office":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"nullable":true},"hiring_manager_id":{"type":"string","nullable":true},"salary":{"type":"object","properties":{"min":{"type":"number","nullable":true},"max":{"type":"number","nullable":true},"currency":{"type":"string","nullable":true}},"nullable":true},"openings":{"type":"integer","nullable":true},"hires":{"type":"integer","nullable":true},"published_on_careers_page":{"type":"boolean"},"external_id":{"type":"string","nullable":true},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"closed_at":{"type":"string","format":"date-time","nullable":true}}},"Candidate":{"type":"object","properties":{"id":{"type":"string"},"first_name":{"type":"string","nullable":true},"last_name":{"type":"string","nullable":true},"phone":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"linkedin_url":{"type":"string","nullable":true},"current_title":{"type":"string","nullable":true},"current_company":{"type":"string","nullable":true},"tags":{"type":"array","items":{"type":"string"}},"external_id":{"type":"string","description":"Your own id for this person. Use it to match records on your side.","nullable":true},"email":{"type":"string","format":"email"},"source":{"type":"string","nullable":true},"kind":{"type":"string","enum":["applicant","prospect"]},"status":{"type":"string"},"do_not_contact":{"type":"boolean"},"application_ids":{"type":"array","items":{"type":"string"}},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}}},"CandidateCreate":{"type":"object","properties":{"first_name":{"type":"string","nullable":true},"last_name":{"type":"string","nullable":true},"phone":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"linkedin_url":{"type":"string","nullable":true},"current_title":{"type":"string","nullable":true},"current_company":{"type":"string","nullable":true},"tags":{"type":"array","items":{"type":"string"}},"external_id":{"type":"string","description":"Your own id for this person. Use it to match records on your side.","nullable":true},"email":{"type":"string","description":"If a candidate with this email already exists, that candidate is returned (200) instead of a new one (201).","format":"email"},"source":{"type":"string","nullable":true},"job_id":{"type":"string","description":"Also add the candidate to this job."}},"required":["email"]},"CandidateUpdate":{"type":"object","properties":{"first_name":{"type":"string","nullable":true},"last_name":{"type":"string","nullable":true},"phone":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"linkedin_url":{"type":"string","nullable":true},"current_title":{"type":"string","nullable":true},"current_company":{"type":"string","nullable":true},"tags":{"type":"array","items":{"type":"string"}},"external_id":{"type":"string","description":"Your own id for this person. Use it to match records on your side.","nullable":true},"email":{"type":"string","format":"email"}}},"Application":{"type":"object","properties":{"id":{"type":"string"},"candidate_id":{"type":"string"},"job_id":{"type":"string"},"job_post_id":{"type":"string","nullable":true},"status":{"type":"string","enum":["new","reviewing","screening","interviewing","reference_check","offer_pending","offer_rejected","offer_sent","offer_accepted","offer_declined","hired","rejected","withdrawn"]},"stage":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}},"nullable":true},"source":{"type":"string","nullable":true},"applied_at":{"type":"string","format":"date-time"},"rejected_at":{"type":"string","format":"date-time","nullable":true},"rejection_reason":{"type":"string","nullable":true},"hired_at":{"type":"string","format":"date-time","nullable":true},"withdrawn_at":{"type":"string","format":"date-time","nullable":true},"external_id":{"type":"string","nullable":true},"external_source":{"type":"string","nullable":true},"updated_at":{"type":"string","format":"date-time"}}},"ApplicationCreate":{"type":"object","properties":{"candidate_id":{"type":"string"},"job_id":{"type":"string"},"source":{"type":"string","nullable":true},"notes":{"type":"string","nullable":true},"external_id":{"type":"string","nullable":true}},"required":["candidate_id","job_id"]},"ApplicationMove":{"type":"object","properties":{"status":{"type":"string","description":"Send this or `stage_id`, not both.","enum":["new","reviewing","screening","interviewing","reference_check","offer_pending","offer_sent","offer_accepted","offer_declined","hired"]},"stage_id":{"type":"string","description":"A stage of the job's pipeline."},"notes":{"type":"string","nullable":true}}},"ApplicationReject":{"type":"object","properties":{"reason":{"type":"string","nullable":true},"notes":{"type":"string","nullable":true}}},"Department":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"parent_id":{"type":"string","nullable":true},"external_id":{"type":"string","nullable":true},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}}},"Office":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"parent_id":{"type":"string","nullable":true},"type":{"type":"string","nullable":true},"external_id":{"type":"string","nullable":true},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}}},"User":{"type":"object","properties":{"id":{"type":"string"},"first_name":{"type":"string","nullable":true},"last_name":{"type":"string","nullable":true},"email":{"type":"string"},"role":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}}},"BoardJob":{"type":"object","properties":{"id":{"type":"string"},"job_post_id":{"type":"string","nullable":true},"title":{"type":"string"},"summary":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"employment_type":{"type":"string","nullable":true},"department":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string","nullable":true}},"nullable":true},"client_name":{"type":"string","nullable":true},"listed_at":{"type":"string","format":"date-time","nullable":true},"url":{"type":"string","description":"The job on your careers page, where candidates apply."}}},"BoardJobDetail":{"type":"object","properties":{"id":{"type":"string"},"job_post_id":{"type":"string","nullable":true},"title":{"type":"string"},"summary":{"type":"string","nullable":true},"description":{"type":"string"},"sections":{"type":"object","nullable":true,"description":"The job post broken into role summary, responsibilities, qualifications, benefits and pay."},"company_description":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"employment_type":{"type":"string","nullable":true},"client_name":{"type":"string","nullable":true},"listed_at":{"type":"string","format":"date-time","nullable":true},"url":{"type":"string"},"attachments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"file_name":{"type":"string"},"mime_type":{"type":"string","nullable":true},"size":{"type":"integer","nullable":true},"url":{"type":"string","description":"Temporary link, good for about an hour."}}}}}},"IngestionRequest":{"type":"object","properties":{"source":{"type":"string","description":"The partner or channel name. Shown as the source on the candidate and application."},"external_id":{"type":"string","description":"Your id for this candidate. Sending the same id again returns the first result and creates nothing new."},"job_id":{"type":"string"},"candidate":{"type":"object","properties":{"first_name":{"type":"string","nullable":true},"last_name":{"type":"string","nullable":true},"phone":{"type":"string","nullable":true},"location":{"type":"string","nullable":true},"linkedin_url":{"type":"string","nullable":true},"current_title":{"type":"string","nullable":true},"current_company":{"type":"string","nullable":true},"tags":{"type":"array","items":{"type":"string"}},"external_id":{"type":"string","description":"Your own id for this person. Use it to match records on your side.","nullable":true},"email":{"type":"string","format":"email"}},"required":["email"]},"notes":{"type":"string","nullable":true}},"required":["source","external_id","job_id","candidate"]},"IngestionResult":{"type":"object","properties":{"candidate_id":{"type":"string"},"application_id":{"type":"string"},"created_candidate":{"type":"boolean","description":"False when this person was already a candidate."},"created_application":{"type":"boolean","description":"False when this source and external_id was already received."}},"required":["candidate_id","application_id","created_candidate","created_application"]}}},"paths":{"/jobs":{"get":{"tags":["Jobs"],"summary":"List jobs","security":[{"ApiKey":["jobs:read"]}],"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"From `next_cursor` of the previous page."},{"name":"updated_after","in":"query","schema":{"type":"string","format":"date-time"},"description":"Only records changed after this time."},{"name":"status","in":"query","schema":{"type":"string"},"description":"Filter by status."},{"name":"department_id","in":"query","schema":{"type":"string"},"description":"Only this department and the ones under it."},{"name":"office_id","in":"query","schema":{"type":"string"},"description":"Only this office."}],"responses":{"200":{"description":"A page of jobs","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Job"}},"next_cursor":{"type":"string","description":"Pass as `cursor` to get the next page. Null on the last page.","nullable":true}},"required":["data","next_cursor"]}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/jobs/{id}":{"get":{"tags":["Jobs"],"summary":"Get a job","security":[{"ApiKey":["jobs:read"]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The job","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Job"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/candidates":{"get":{"tags":["Candidates"],"summary":"List candidates","security":[{"ApiKey":["candidates:read"]}],"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"From `next_cursor` of the previous page."},{"name":"updated_after","in":"query","schema":{"type":"string","format":"date-time"},"description":"Only records changed after this time."},{"name":"email","in":"query","schema":{"type":"string"},"description":"Find a candidate by email."},{"name":"job_id","in":"query","schema":{"type":"string"},"description":"Only candidates on this job."},{"name":"kind","in":"query","schema":{"type":"string"},"description":"applicant or prospect."}],"responses":{"200":{"description":"A page of candidates","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Candidate"}},"next_cursor":{"type":"string","description":"Pass as `cursor` to get the next page. Null on the last page.","nullable":true}},"required":["data","next_cursor"]}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/RateLimited"}}},"post":{"tags":["Candidates"],"summary":"Create a candidate","security":[{"ApiKey":["candidates:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CandidateCreate"}}}},"responses":{"200":{"description":"A candidate with this email already existed. With `job_id`, the response also has `application_id`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Candidate"}}}},"201":{"description":"Created. With `job_id`, the response also has `application_id`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Candidate"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/candidates/{id}":{"get":{"tags":["Candidates"],"summary":"Get a candidate","security":[{"ApiKey":["candidates:read"]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The candidate","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Candidate"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/RateLimited"}}},"patch":{"tags":["Candidates"],"summary":"Update a candidate","security":[{"ApiKey":["candidates:write"]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CandidateUpdate"}}}},"responses":{"200":{"description":"The updated candidate","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Candidate"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/applications":{"get":{"tags":["Applications"],"summary":"List applications","security":[{"ApiKey":["applications:read"]}],"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"From `next_cursor` of the previous page."},{"name":"updated_after","in":"query","schema":{"type":"string","format":"date-time"},"description":"Only records changed after this time."},{"name":"job_id","in":"query","schema":{"type":"string"},"description":"Only this job."},{"name":"candidate_id","in":"query","schema":{"type":"string"},"description":"Only this candidate."},{"name":"status","in":"query","schema":{"type":"string"},"description":"Filter by status."}],"responses":{"200":{"description":"A page of applications","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Application"}},"next_cursor":{"type":"string","description":"Pass as `cursor` to get the next page. Null on the last page.","nullable":true}},"required":["data","next_cursor"]}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/RateLimited"}}},"post":{"tags":["Applications"],"summary":"Create an application","security":[{"ApiKey":["applications:write"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplicationCreate"}}}},"responses":{"200":{"description":"The candidate already applied to this job","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Application"}}}},"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Application"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/applications/{id}":{"get":{"tags":["Applications"],"summary":"Get an application","security":[{"ApiKey":["applications:read"]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The application","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Application"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/applications/{id}/move":{"post":{"tags":["Applications"],"summary":"Move an application to a status or pipeline stage","security":[{"ApiKey":["applications:write"]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplicationMove"}}}},"responses":{"200":{"description":"The updated application","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Application"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/applications/{id}/reject":{"post":{"tags":["Applications"],"summary":"Reject an application","security":[{"ApiKey":["applications:write"]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApplicationReject"}}}},"responses":{"200":{"description":"The updated application","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Application"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/users":{"get":{"tags":["Organization"],"summary":"List users","security":[{"ApiKey":["users:read"]}],"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"From `next_cursor` of the previous page."},{"name":"updated_after","in":"query","schema":{"type":"string","format":"date-time"},"description":"Only records changed after this time."}],"responses":{"200":{"description":"A page of users","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/User"}},"next_cursor":{"type":"string","description":"Pass as `cursor` to get the next page. Null on the last page.","nullable":true}},"required":["data","next_cursor"]}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/departments":{"get":{"tags":["Organization"],"summary":"List departments","security":[{"ApiKey":["jobs:read"]}],"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"From `next_cursor` of the previous page."},{"name":"updated_after","in":"query","schema":{"type":"string","format":"date-time"},"description":"Only records changed after this time."}],"responses":{"200":{"description":"A page of departments","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Department"}},"next_cursor":{"type":"string","description":"Pass as `cursor` to get the next page. Null on the last page.","nullable":true}},"required":["data","next_cursor"]}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/offices":{"get":{"tags":["Organization"],"summary":"List offices","security":[{"ApiKey":["jobs:read"]}],"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"From `next_cursor` of the previous page."},{"name":"updated_after","in":"query","schema":{"type":"string","format":"date-time"},"description":"Only records changed after this time."}],"responses":{"200":{"description":"A page of offices","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Office"}},"next_cursor":{"type":"string","description":"Pass as `cursor` to get the next page. Null on the last page.","nullable":true}},"required":["data","next_cursor"]}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/boards/{orgSlug}/jobs":{"get":{"tags":["Job board"],"summary":"List published jobs","security":[],"parameters":[{"name":"orgSlug","in":"path","required":true,"schema":{"type":"string"},"description":"Your careers page name, as in /careers/{orgSlug}."},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"department_id","in":"query","schema":{"type":"string"},"description":"Only this department and the ones under it."}],"responses":{"200":{"description":"A page of published jobs","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/BoardJob"}},"next_cursor":{"type":"string","description":"Pass as `cursor` to get the next page. Null on the last page.","nullable":true}},"required":["data","next_cursor"]}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/boards/{orgSlug}/jobs/{id}":{"get":{"tags":["Job board"],"summary":"Get a published job","security":[],"parameters":[{"name":"orgSlug","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"post","in":"query","schema":{"type":"string"},"description":"The job post (`job_post_id`) the listing came from."}],"responses":{"200":{"description":"The job","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BoardJobDetail"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/ingestion/candidates":{"post":{"tags":["Ingestion"],"summary":"Send a candidate for a job","security":[{"ApiKey":["ingestion"]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IngestionRequest"}}}},"responses":{"200":{"description":"Already received (same source and external_id)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IngestionResult"}}}},"201":{"description":"Received","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IngestionResult"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/RateLimited"}}}}}}