Skip to main content
PUT
/
jobs
/
{id}
Update a job
curl --request PUT \
  --url https://api-service.fribl.co/api/v1/jobs/{id} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "content_language": "<string>",
  "information": {
    "title": "Senior Software Engineer",
    "company": "Tech Corp",
    "description": "We are looking for...",
    "activity_sector": "Technology",
    "locations": [
      {
        "city": "Amsterdam",
        "country": "Netherlands"
      }
    ],
    "job_type": "Full-time",
    "contract_type": "Permanent"
  },
  "experience_preference": {
    "title": "Software Engineer",
    "activity_sector": "Technology",
    "description": "Experience in backend development",
    "duration": 60
  },
  "education_preference": {
    "degree": "Master of Science",
    "major": "Computer Science",
    "score": ""
  },
  "job_requirements": [
    "<string>"
  ],
  "hard_skills": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "skill": "JavaScript",
      "type": "hard-skill",
      "relationship": "required",
      "explanation": "Candidate demonstrates strong JavaScript proficiency"
    }
  ],
  "soft_skills": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "skill": "JavaScript",
      "type": "hard-skill",
      "relationship": "required",
      "explanation": "Candidate demonstrates strong JavaScript proficiency"
    }
  ]
}
'
{
  "message": "Successfully updated Job with ID: 550e8400-e29b-41d4-a716-446655440000",
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "information": {
      "title": "Senior Software Engineer",
      "company": "Tech Corp",
      "description": "We are looking for...",
      "activity_sector": "Technology",
      "locations": [
        {
          "city": "Amsterdam",
          "country": "Netherlands"
        }
      ],
      "job_type": "Full-time",
      "contract_type": "Permanent"
    },
    "experience_preference": {
      "title": "Software Engineer",
      "activity_sector": "Technology",
      "description": "Experience in backend development",
      "duration": 60
    },
    "education_preference": {
      "degree": "Master of Science",
      "major": "Computer Science",
      "score": ""
    },
    "job_requirements": [
      "5+ years experience",
      "Strong communication"
    ],
    "source_language": "<string>",
    "hard_skills": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "skill": "JavaScript",
        "type": "hard-skill",
        "relationship": "required",
        "explanation": "Candidate demonstrates strong JavaScript proficiency"
      }
    ],
    "soft_skills": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "skill": "JavaScript",
        "type": "hard-skill",
        "relationship": "required",
        "explanation": "Candidate demonstrates strong JavaScript proficiency"
      }
    ],
    "created_at": "2024-01-01T00:00:00.000Z",
    "updated_at": "2024-01-01T00:00:00.000Z"
  }
}

Authorizations

​
x-api-key
string
header
required

API key in UUID format. Include this header with every authenticated request.

Path Parameters

​
id
string<uuid>
required

Unique identifier of the job to update.

Body

application/json

Request body for updating a job.

​
content_language
string
required

Required ISO 639-1 language code for the submitted update payload.

​
information
object
required

Core information about a job posting.

​
experience_preference
object
required

Preferred experience criteria for the job.

​
education_preference
object
required

Preferred education criteria for the job.

​
job_requirements
string[]
required

Updated list of job requirements.

​
hard_skills
object[]

Updated hard skills. Skill IDs must already exist in the canonical taxonomy.

​
soft_skills
object[]

Updated soft skills. Skill IDs must already exist in the canonical taxonomy.

Response

Job updated successfully.

​
message
string
required
Example:

"Successfully updated Job with ID: 550e8400-e29b-41d4-a716-446655440000"

​
data
object
required

A fully analyzed job description with extracted structured data.