Create Education

Add a new education entry for the authenticated job seeker

POST /api/v1/job-seekers/me/educations

Create Education

cURL

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

import requests

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

response = requests.post(url)

print(response.text)

const options = {method: 'POST'};

fetch('https://api.example.com/api/v1/job-seekers/me/educations', 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/educations",
  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/educations"

	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/educations")
  .asString();

require 'uri'
require 'net/http'

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

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/educations

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 education entry for the authenticated job seeker.

Request Body

Field	Type	Required	Description
institutionName	string	Yes	Name of the institution
degreeType	enum	Yes	Type of degree obtained
fieldOfStudy	string	Yes	Field of study
description	string	No	Additional education details
gpa	number	No	GPA (0-4 scale)
startDate	string	Yes	Start date (ISO 8601 format)
endDate	string	No	End date (ISO 8601 format)
isCurrent	boolean	Yes	Currently studying here

Degree Type Values

Value	Description
HIGH_SCHOOL	High school diploma
ASSOCIATE	Associate degree
BACHELOR	Bachelor’s degree
MASTER	Master’s degree
PHD	Doctorate/PhD
BOOTCAMP	Coding bootcamp certificate
CERTIFICATION	Professional certification
OTHER	Other type of education

Example Request Body

{
  "institutionName": "Cairo University",
  "degreeType": "BACHELOR",
  "fieldOfStudy": "Computer Science",
  "description": "Focus on software engineering and algorithms",
  "gpa": 3.8,
  "startDate": "2017-09-01",
  "endDate": "2021-06-30",
  "isCurrent": false
}

Or for currently studying:

{
  "institutionName": "Tech Academy",
  "degreeType": "CERTIFICATION",
  "fieldOfStudy": "Full Stack Web Development",
  "description": "Intensive coding bootcamp",
  "startDate": "2021-07-01",
  "isCurrent": true
}

Response

Success Response (201 Created)

{
  "success": true,
  "data": {
    "id": "edu-123-uuid",
    "institutionName": "Cairo University",
    "degreeType": "BACHELOR",
    "fieldOfStudy": "Computer Science",
    "description": "Focus on software engineering and algorithms",
    "gpa": 3.8,
    "startDate": "2017-09-01T00:00:00.000Z",
    "endDate": "2021-06-30T00:00:00.000Z",
    "isCurrent": false,
    "jobSeekerId": "js-456-uuid"
  },
  "message": "Success",
  "meta": {
    "timestamp": "2026-04-23T20:00:00.000Z",
    "path": "/job-seekers/me/educations",
    "method": "POST"
  }
}

Response Fields

id · string

Unique identifier for the created education entry.

Error Responses

401 Unauthorized

{
  "success": false,
  "error": {
    "message": "Unauthorized",
    "statusCode": 401,
    "timestamp": "2026-04-23T20:00:00.000Z",
    "path": "/job-seekers/me/educations",
    "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/educations",
    "method": "POST",
    "details": "Forbidden"
  }
}

400 Bad Request - Validation Error

{
  "success": false,
  "error": {
    "message": [
      "institutionName must be a string",
      "degreeType must be one of: HIGH_SCHOOL, ASSOCIATE, BACHELOR, MASTER, PHD, BOOTCAMP, CERTIFICATION, OTHER",
      "fieldOfStudy must be a string",
      "startDate must be a valid date string"
    ],
    "statusCode": 400,
    "timestamp": "2026-04-23T20:00:00.000Z",
    "path": "/job-seekers/me/educations",
    "method": "POST",
    "details": "Bad Request"
  }
}

Example Request

curl -X POST http://localhost:3000/api/v1/job-seekers/me/educations \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "institutionName": "Cairo University",
    "degreeType": "BACHELOR",
    "fieldOfStudy": "Computer Science",
    "description": "Focus on software engineering and algorithms",
    "gpa": 3.8,
    "startDate": "2017-09-01",
    "endDate": "2021-06-30",
    "isCurrent": false
  }'

Notes

Current Study: 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).

GPA: GPA must be between 0 and 4.