AI-HR
  1. Job controller
AI-HR
  • Authentication Controller
    • POST /api/v1/auth/login
      POST
    • POST /api/v1/auth/register
      POST
    • POST /api/v1/auth/hr-register
      POST
  • Job controller
    • List jobs with pagination and filtering
      GET
    • Create new job (HR only)
      POST
    • Get job details
      GET
    • Update job (HR only)
      PATCH
    • Close job (HR only)
      POST
    • Re-open job (HR only)
      POST
    • Delete job (HR only)
      DELETE
  • Application - application controller
    • submitApplication
      POST
    • getApplications
      GET
    • getApplicationById
      GET
    • updateApplication
      PATCH
    • Get messages for application - only accessible by HR
      GET
    • createOrGetChatSession
      POST
    • completeChatSession
      POST
  • Application - chat controller
    • sendMessage
      POST
    • getMessages
      GET
  • Application - Resume File Controller
    • Download resume file by application ID
      GET
    • Get resume file information by application ID
      GET
  • Application - assessment controller
    • Trigger resume scoring for an application
      POST
    • Trigger interview scoring for an application
      POST
  • Internal application info endpoint (cluster-internal, no auth).
    • getApplicationWithAssessment
    • createOrGetChatSession
  • Internal user info endpoint (cluster-internal, no auth).
    • getUser
  • Internal job info endpoint (cluster-internal, no auth).
    • GET /internal/api/v1/jobs/{jobId} – fetch job details for internal services.
  • Test controller for developers
    • Test endpoint to extract text from uploaded document
  1. Job controller

Create new job (HR only)

POST
/api/v1/jobs

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params application/json

Example
{
    "title": "string",
    "description": "string",
    "requirements": "string"
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/api/v1/jobs' \
--header 'Content-Type: application/json' \
--data-raw '{
    "title": "string",
    "description": "string",
    "requirements": "string"
}'

Responses

🟒200Success
application/json
Body

Example
{
  "success": false,
  "message": "",
  "data": {
    "jobID": "",
    "title": "",
    "description": "",
    "requirements": "",
    "status": "",
    "createdAt": "",
    "updatedAt": "",
    "hrCreator": {
      "userID": "",
      "fullName": "",
      "email": "",
      "role": ""
    }
  },
  "timestamp": "",
  "code": 0
}
Modified atΒ 2025-06-28 21:46:41
Previous
List jobs with pagination and filtering
Next
Get job details
Built with