Update a job
Apply a partial (dimension-scoped) update to a job. Submit any non-empty subset of the allowed dimensions — information, experience_preference, education_preference, hard_skills, soft_skills — and only those will be processed and persisted. Unspecified dimensions are left untouched. The candidate-shape aliases experience and education are also accepted and rewritten internally to the canonical Vacancy names. content_language is required on every patch (whether the body touches text or skills dimensions); it can also be supplied via the Accept-Language request header, which the API auto-forwards. The 200 response echoes the full merged Job entity (with created_at / updated_at populated from the local task row), so the caller does not need a follow-up GET /jobs/{id}.
Documentation Index
Fetch the complete documentation index at: https://docs.fribl.co/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
API key in UUID format. Include this header with every authenticated request.
Path Parameters
Unique identifier of the job to update.
Body
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
- Option 6
- Option 7
Partial (dimension-scoped) update for a job. Submit any non-empty subset of the allowed dimensions — information, experience_preference, education_preference, hard_skills, soft_skills — and only those will be processed and persisted. Unspecified dimensions are left untouched. The candidate-shape aliases experience and education are also accepted and rewritten internally to the canonical Vacancy names (experience_preference, education_preference) before validation. content_language is required on every patch (text or skills dimensions); it can also be supplied via the Accept-Language request header, in which case the body field can be omitted.
Core information about a job posting.
ISO 639-1 language code of the submitted update payload. Required on every patch unless the Accept-Language header is set — the API forwards that header automatically. Without either, the request is rejected with 400.
Preferred experience criteria for the job.
Preferred education criteria for the job.
Alias for experience_preference. Accepted for callers using the candidate-shape vocabulary; rewritten internally.
Alias for education_preference. Accepted for callers using the candidate-shape vocabulary; rewritten internally.
Updated hard skills. Skill IDs must already exist in the canonical taxonomy.
Updated soft skills. Skill IDs must already exist in the canonical taxonomy.
Response
Job updated successfully. data contains the full merged Job entity (the patch applied on top of the existing record), with created_at and updated_at populated from the local task row.