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

List jobs with pagination and filtering

GET
/api/v1/jobs

Request

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

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 GET '/api/v1/jobs?page=0&size=10'

Responses

🟒200Success
application/json
Body

Example
{
  "success": false,
  "message": "",
  "data": {
    "content": [
      {
        "jobID": "",
        "title": "",
        "description": "",
        "requirements": "",
        "status": "",
        "createdAt": "",
        "updatedAt": "",
        "hrCreator": {
          "userID": "",
          "fullName": "",
          "email": "",
          "role": ""
        }
      }
    ],
    "pageInfo": {
      "page": 0,
      "size": 0,
      "totalElements": 0,
      "totalPages": 0,
      "sortBy": "",
      "sortOrder": ""
    }
  },
  "timestamp": "",
  "code": 0
}
Modified atΒ 2025-06-28 21:46:41
Previous
POST /api/v1/auth/hr-register
Next
Create new job (HR only)
Built with