JobUpdateRequest

JSON body for PATCH /api/v1/jobs/{jobId} — all fields optional; only the provided fields change, each re-validated with the create-time rules.

position_idstringnullable

New client key for the job, or null to clear it. Must stay unique among your active jobs.

Possible values: non-empty and <= 28 characters, Value must match regular expression ^[A-Za-z0-9._-]{1,28}$

namestring

New display name (≤ 200 chars, non-empty when provided).

Possible values: non-empty and <= 200 characters

job_descriptionstring

New JD prose (non-empty when provided).

Possible values: non-empty

config object

The job's structured requirements config — the same position-config contract CV DeepMatch validates at submit: it must carry requirements.workExperience and requirements.skills, and every inner field must pass the per-field rules (the 1–5 importance scale, industry cardinality, language-config quirks — see the CvDeepMatchRequirements schema and the Position config reference).

Unlike an inline run submit, the contract is enforced at save time — an invalid config is rejected with per-field errors and nothing is stored. config must not contain a top-level job_description key (the JD is its own field; CV DeepSearch composes position_metadata as {...config, job_description}).

property name*any

The job's structured requirements config — the same position-config contract CV DeepMatch validates at submit: it must carry requirements.workExperience and requirements.skills, and every inner field must pass the per-field rules (the 1–5 importance scale, industry cardinality, language-config quirks — see the CvDeepMatchRequirements schema and the Position config reference).

Unlike an inline run submit, the contract is enforced at save time — an invalid config is rejected with per-field errors and nothing is stored. config must not contain a top-level job_description key (the JD is its own field; CV DeepSearch composes position_metadata as {...config, job_description}).

Example: {"name":"Senior Backend Engineer","requirements":{"workExperience":{"from":5,"to":10,"importance":5,"relevant_industries":["SaaS","Fintech"],"industries_config":[{"name":"SaaS","importance":5},{"name":"Fintech","importance":4}]},"skills":{"importance":5,"skills_config":{"hard_skills":[{"name":"Node.js","importance":5}],"requirements":{"minimal_qualifications":true,"preferable_qualifications":true}}}}}

JobUpdateRequest

{
  "position_id": "string",
  "name": "string",
  "job_description": "string",
  "config": {
    "name": "Senior Backend Engineer",
    "requirements": {
      "workExperience": {
        "from": 5,
        "to": 10,
        "importance": 5,
        "relevant_industries": [
          "SaaS",
          "Fintech"
        ],
        "industries_config": [
          {
            "name": "SaaS",
            "importance": 5
          },
          {
            "name": "Fintech",
            "importance": 4
          }
        ]
      },
      "skills": {
        "importance": 5,
        "skills_config": {
          "hard_skills": [
            {
              "name": "Node.js",
              "importance": 5
            }
          ],
          "requirements": {
            "minimal_qualifications": true,
            "preferable_qualifications": true
          }
        }
      }
    }
  }
}