Update Work Experience

Update an existing work experience entry

PATCH /api/v1/job-seekers/me/work-experiences/:expId

Update Work Experience

cURL

curl --request PATCH \
  --url https://api.example.com/api/v1/job-seekers/me/work-experiences/:expId

import requests

url = "https://api.example.com/api/v1/job-seekers/me/work-experiences/:expId"

response = requests.patch(url)

print(response.text)

const options = {method: 'PATCH'};

fetch('https://api.example.com/api/v1/job-seekers/me/work-experiences/:expId', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/v1/job-seekers/me/work-experiences/:expId",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/v1/job-seekers/me/work-experiences/:expId"

	req, _ := http.NewRequest("PATCH", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://api.example.com/api/v1/job-seekers/me/work-experiences/:expId")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/v1/job-seekers/me/work-experiences/:expId")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)

response = http.request(request)
puts response.read_body

200

{
  "id": "<string>"
}

Endpoint

PATCH /api/v1/job-seekers/me/work-experiences/:expId

Base URL: http://localhost:3000/api/v1

This endpoint requires authentication and Job Seeker role.

URL Parameters

Parameter	Type	Required	Description
expId	string	Yes	The work experience ID

Authentication

Include the access token in the Authorization header:

Authorization: Bearer YOUR_ACCESS_TOKEN

Description

Update an existing work experience entry. Only fields provided in the request body will be updated (partial update).

Request Body

All fields are optional for updates:

Field	Type	Description
companyName	string	Name of the company
jobTitle	string	Title of the position
description	string	Job description and responsibilities
location	string	Work location
startDate	string	Start date (ISO 8601 format)
endDate	string	End date (ISO 8601 format)
isCurrent	boolean	Currently working here

Example Request Body

{
  "jobTitle": "Lead Software Engineer",
  "description": "Led team of 5 developers and microservices architecture"
}

Response

Success Response (200 OK)

{
  "success": true,
  "data": {
    "id": "exp-123-uuid",
    "companyName": "Tech Corp",
    "jobTitle": "Lead Software Engineer",
    "description": "Led team of 5 developers and microservices architecture",
    "location": "Cairo, Egypt",
    "startDate": "2023-01-15T00:00:00.000Z",
    "endDate": null,
    "isCurrent": true,
    "jobSeekerId": "js-456-uuid",
    "createdAt": "2024-01-10T10:30:00.000Z",
    "updatedAt": "2024-01-15T14:20:00.000Z"
  },
  "message": "Success",
  "meta": {
    "timestamp": "2026-04-23T20:00:00.000Z",
    "path": "/job-seekers/me/work-experiences/exp-123-uuid",
    "method": "PATCH"
  }
}

Response Fields

id · string

Unique identifier for the work experience entry.

Error Responses

401 Unauthorized

{
  "success": false,
  "error": {
    "message": "Unauthorized",
    "statusCode": 401,
    "timestamp": "2026-04-23T20:00:00.000Z",
    "path": "/job-seekers/me/work-experiences/exp-123-uuid",
    "method": "PATCH",
    "details": "Unauthorized"
  }
}

403 Forbidden

{
  "success": false,
  "error": {
    "message": "Forbidden resource",
    "statusCode": 403,
    "timestamp": "2026-04-23T20:00:00.000Z",
    "path": "/job-seekers/me/work-experiences/exp-123-uuid",
    "method": "PATCH",
    "details": "Forbidden"
  }
}

404 Not Found

{
  "success": false,
  "error": {
    "message": "Work experience not found",
    "statusCode": 404,
    "timestamp": "2026-04-23T20:00:00.000Z",
    "path": "/job-seekers/me/work-experiences/exp-123-uuid",
    "method": "PATCH",
    "details": "Not Found"
  }
}

400 Bad Request - Validation Error

{
  "success": false,
  "error": {
    "message": ["companyName must be a string", "startDate must be a valid date string"],
    "statusCode": 400,
    "timestamp": "2026-04-23T20:00:00.000Z",
    "path": "/job-seekers/me/work-experiences/exp-123-uuid",
    "method": "PATCH",
    "details": "Bad Request"
  }
}

Example Request

curl -X PATCH http://localhost:3000/api/v1/job-seekers/me/work-experiences/exp-123-uuid \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "jobTitle": "Lead Software Engineer",
    "description": "Led team of 5 developers"
  }'

Notes

Partial Update: Only provide the fields you want to update. All other fields will remain unchanged.

Updating Current Job: To mark a past job as current, set isCurrent to true and remove endDate.