# Sorce API

> Partner API for managing your company's jobs on Sorce.

## Docs

- [Close a job](https://docs.sorce.jobs/api-reference/jobs/close-a-job.md): ACTIVE/PAUSED → CLOSED. Terminal. Closed jobs can't reopen or be edited.
- [Create a job](https://docs.sorce.jobs/api-reference/jobs/create-a-job.md): Creates a job for your company. Any subset of fields is accepted; omitted fields stay empty and the job is saved as a DRAFT. With `"publish": true` the job goes live in the same transaction, provided it passes the publish gates (completeness, terms accepted in the dashboard, card on file); if any ga…
- [Get a job](https://docs.sorce.jobs/api-reference/jobs/get-a-job.md)
- [Pause a job](https://docs.sorce.jobs/api-reference/jobs/pause-a-job.md): ACTIVE → PAUSED. The listing is hidden until resumed.
- [Publish a draft](https://docs.sorce.jobs/api-reference/jobs/publish-a-draft.md): DRAFT → ACTIVE. Runs the three publish gates: completeness (422 with a field map), terms accepted in the dashboard (409 AGREEMENT_OUTDATED), and a card on file (402). The listing runs for 30 days.
- [Resume a paused job](https://docs.sorce.jobs/api-reference/jobs/resume-a-paused-job.md): PAUSED → ACTIVE.
- [Update a job](https://docs.sorce.jobs/api-reference/jobs/update-a-job.md): Partial update; only the fields you send change. The arrays (`locations`, `qualifications`, `questions`, `budgets`) are replace-sets: what you send becomes the entire new set. Live (ACTIVE/PAUSED) jobs are re-validated after the patch and the whole change is rejected if it would leave the listing in…
- [Search locations](https://docs.sorce.jobs/api-reference/locations/search-locations.md): Canonical place autocomplete. Job locations must reference a suggestion's `locationId`. Free-typed places are rejected.
- [Authentication](https://docs.sorce.jobs/authentication.md): Every request carries a partner key.
- [Errors](https://docs.sorce.jobs/errors.md): One envelope, stable codes, per-field detail.
- [Budgets](https://docs.sorce.jobs/guides/budgets.md): Cap spend per job or across your whole company, and never get billed past a cap.
- [Locations](https://docs.sorce.jobs/guides/locations.md): Search first, then reference by id. Never free-type a place.
- [Publishing](https://docs.sorce.jobs/guides/publishing.md): What it takes for a job to go live, and the three gates in your way.
- [Introduction](https://docs.sorce.jobs/index.md): Manage your company's jobs on Sorce programmatically.

## OpenAPI Specs

- [openapi](https://docs.sorce.jobs/openapi.yaml)