Update a job

curl --request PATCH \
  --url https://www.sorce.jobs/api/external/v1/jobs/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "Senior Product Designer",
  "description": "<string>",
  "remoteCountry": "<string>",
  "locations": [
    {
      "locationId": 17024,
      "city": "San Francisco",
      "stateProvince": "California",
      "country": "United States"
    }
  ],
  "salaryMin": 123,
  "salaryMax": 123,
  "bidPerQualifiedApplicantCents": 123,
  "qualifications": [
    {
      "text": "5+ years of product design experience",
      "order": 0
    }
  ],
  "questions": [
    {
      "prompt": "Why do you want to work here?",
      "order": 123,
      "options": [
        "<string>"
      ]
    }
  ],
  "budgets": [
    {
      "budgetCents": 50000,
      "notes": "<string>"
    }
  ]
}
'

{
  "id": "<string>",
  "title": "<string>",
  "description": "<string>",
  "remoteCountry": "<string>",
  "salaryMin": 123,
  "salaryMax": 123,
  "bidPerQualifiedApplicantCents": 123,
  "companyId": "<string>",
  "locations": [
    {
      "locationId": 17024,
      "displayName": "San Francisco, California, United States",
      "city": "San Francisco",
      "stateProvince": "California",
      "country": "United States"
    }
  ],
  "qualifications": [
    {
      "text": "5+ years of product design experience",
      "order": 0,
      "id": "<string>"
    }
  ],
  "questions": [
    {
      "prompt": "Why do you want to work here?",
      "order": 123,
      "options": [
        "<string>"
      ],
      "id": "<string>"
    }
  ],
  "budgets": [
    {
      "budgetCents": 50000,
      "notes": "<string>"
    }
  ],
  "applicationCounts": {
    "pending": 123,
    "accepted": 123,
    "rejected": 123
  },
  "isFrozen": true,
  "newApplicantCount": 123,
  "publishedAt": "2023-11-07T05:31:56Z",
  "expiresAt": "2023-11-07T05:31:56Z",
  "closedAt": "2023-11-07T05:31:56Z"
}

PATCH

jobs

{id}

Update a job

curl --request PATCH \
  --url https://www.sorce.jobs/api/external/v1/jobs/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "Senior Product Designer",
  "description": "<string>",
  "remoteCountry": "<string>",
  "locations": [
    {
      "locationId": 17024,
      "city": "San Francisco",
      "stateProvince": "California",
      "country": "United States"
    }
  ],
  "salaryMin": 123,
  "salaryMax": 123,
  "bidPerQualifiedApplicantCents": 123,
  "qualifications": [
    {
      "text": "5+ years of product design experience",
      "order": 0
    }
  ],
  "questions": [
    {
      "prompt": "Why do you want to work here?",
      "order": 123,
      "options": [
        "<string>"
      ]
    }
  ],
  "budgets": [
    {
      "budgetCents": 50000,
      "notes": "<string>"
    }
  ]
}
'

{
  "id": "<string>",
  "title": "<string>",
  "description": "<string>",
  "remoteCountry": "<string>",
  "salaryMin": 123,
  "salaryMax": 123,
  "bidPerQualifiedApplicantCents": 123,
  "companyId": "<string>",
  "locations": [
    {
      "locationId": 17024,
      "displayName": "San Francisco, California, United States",
      "city": "San Francisco",
      "stateProvince": "California",
      "country": "United States"
    }
  ],
  "qualifications": [
    {
      "text": "5+ years of product design experience",
      "order": 0,
      "id": "<string>"
    }
  ],
  "questions": [
    {
      "prompt": "Why do you want to work here?",
      "order": 123,
      "options": [
        "<string>"
      ],
      "id": "<string>"
    }
  ],
  "budgets": [
    {
      "budgetCents": 50000,
      "notes": "<string>"
    }
  ],
  "applicationCounts": {
    "pending": 123,
    "accepted": 123,
    "rejected": 123
  },
  "isFrozen": true,
  "newApplicantCount": 123,
  "publishedAt": "2023-11-07T05:31:56Z",
  "expiresAt": "2023-11-07T05:31:56Z",
  "closedAt": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization

string

header

required

Partner key (sk_ext_…) bound to your company.

Path Parameters

string

required

Body

application/json

All fields optional; arrays use replace semantics (the set you send becomes the entire new set).

title

string

Example:

"Senior Product Designer"

description

string

remoteOption

enum<string> | null

Available options:

REMOTE,

HYBRID,

IN_PERSON,

null

remoteCountry

string | null

Where remote employees may work (REMOTE jobs).

jobType

enum<string> | null

Available options:

FULL_TIME,

PART_TIME,

CONTRACT,

INTERNSHIP,

null

jobLevel

enum<string> | null

Available options:

ENTRY,

MID,

SENIOR,

null

locations

object[]

Show child attributes

salaryMin

integer | null

Whole dollars

salaryMax

integer | null

salaryPeriod

enum<string> | null

Available options:

ANNUAL,

HOURLY,

null

bidPerQualifiedApplicantCents

integer | null

What you pay per qualified applicant, in cents.

qualifications

object[]

Show child attributes

questions

object[]

Custom screening questions only. The applicant basics - first and last name, email, phone, location, and resume - are collected automatically on every application; never send them as questions.

Show child attributes

budgets

object[]

Show child attributes

Response

The updated job.

The full job, as the dashboard sees it.

string

title

string

status

enum<string>

Available options:

DRAFT,

ACTIVE,

PAUSED,

CLOSED,

EXPIRED

description

string

remoteOption

enum<string> | null

Available options:

REMOTE,

HYBRID,

IN_PERSON,

null

remoteCountry

string | null

jobType

enum<string> | null

Available options:

FULL_TIME,

PART_TIME,

CONTRACT,

INTERNSHIP,

null

jobLevel

enum<string> | null

Available options:

ENTRY,

MID,

SENIOR,

null

salaryMin

integer | null

salaryMax

integer | null

salaryPeriod

enum<string> | null

Available options:

ANNUAL,

HOURLY,

null

bidPerQualifiedApplicantCents

integer | null

companyId

string

locations

object[]

Show child attributes

qualifications

object[]

Show child attributes

questions

object[]

Show child attributes

budgets

object[]

Show child attributes

applicationCounts

object

Show child attributes

isFrozen

boolean

True once the job has applications. Qualifications/questions locked.

newApplicantCount

integer

publishedAt

string<date-time> | null

expiresAt

string<date-time> | null

closedAt

string<date-time> | null

Get a job Publish a draft