Create Work Experience

Add a new work experience entry for the authenticated job seeker

POST /api/v1/job-seekers/me/work-experiences

Create Work Experience

cURL

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

import requests

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

response = requests.post(url)

print(response.text)

const options = {method: 'POST'};

fetch('https://api.example.com/api/v1/job-seekers/me/work-experiences', 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",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
]);

$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"

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

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

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

	fmt.Println(string(body))

}

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

require 'uri'
require 'net/http'

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

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

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

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

200

{
  "id": "<string>"
}

Endpoint

POST /api/v1/job-seekers/me/work-experiences

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

This endpoint requires authentication and Job Seeker role.

Authentication

Include the access token in the Authorization header:

Authorization: Bearer YOUR_ACCESS_TOKEN

Description

Create a new work experience entry for the authenticated job seeker.

Request Body

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

Example Request Body

{
  "companyName": "Tech Corp",
  "jobTitle": "Senior Software Engineer",
  "description": "Led development of microservices architecture",
  "location": "Cairo, Egypt",
  "startDate": "2023-01-15",
  "isCurrent": true
}

Or for a past job:

{
  "companyName": "Startup Inc",
  "jobTitle": "Software Developer",
  "description": "Built REST APIs and frontend components",
  "location": "Remote",
  "startDate": "2021-06-01",
  "endDate": "2022-12-31",
  "isCurrent": false
}

Response

Success Response (201 Created)

{
  "success": true,
  "data": {
    "id": "exp-123-uuid",
    "companyName": "Tech Corp",
    "jobTitle": "Senior Software Engineer",
    "description": "Led development of 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-10T10:30:00.000Z"
  },
  "message": "Success",
  "meta": {
    "timestamp": "2026-04-23T20:00:00.000Z",
    "path": "/job-seekers/me/work-experiences",
    "method": "POST"
  }
}

Response Fields

id · string

Unique identifier for the created 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",
    "method": "POST",
    "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",
    "method": "POST",
    "details": "Forbidden"
  }
}

400 Bad Request - Validation Error

{
  "success": false,
  "error": {
    "message": [
      "companyName must be a string",
      "jobTitle 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",
    "method": "POST",
    "details": "Bad Request"
  }
}

Example Request

curl -X POST http://localhost:3000/api/v1/job-seekers/me/work-experiences \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "companyName": "Tech Corp",
    "jobTitle": "Senior Software Engineer",
    "description": "Led development of microservices architecture",
    "location": "Cairo, Egypt",
    "startDate": "2023-01-15",
    "isCurrent": true
  }'

Notes

Current Job: When setting isCurrent to true, you can omit endDate or set it to null.

Date Format: Dates must be in ISO 8601 format (YYYY-MM-DD).