AI-HR
  1. Application - assessment 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. Application - assessment controller

Trigger interview scoring for an application

POST
/api/v1/assessments/applications/{applicationId}/score-interview

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Path 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 POST '/api/v1/assessments/applications/aa7a6dbb-ddc5-42c7-a578-9ce783fcdedb/score-interview'

Responses

🟢200Success
application/json
Body

Example
{
  "success": false,
  "message": "",
  "data": {
    "assessmentId": "",
    "application": {
      "applicationId": "",
      "submittedAt": "",
      "status": "",
      "resumeText": "",
      "resumeFilePath": "",
      "updatedAt": "",
      "candidateId": "",
      "jobId": "",
      "hrDecision": "",
      "hrComments": "",
      "assessment": {
        "assessmentId": "",
        "application": {
          "applicationId": "",
          "submittedAt": "",
          "status": "",
          "resumeText": "",
          "resumeFilePath": "",
          "updatedAt": "",
          "candidateId": "",
          "jobId": "",
          "hrDecision": "",
          "hrComments": "",
          "assessment": {},
          "chatSession": {
            "sessionId": "",
            "application": {},
            "messages": [
              {
                "messageId": "",
                "session": {},
                "sender": "",
                "content": "",
                "sentAt": ""
              }
            ],
            "status": "",
            "startedAt": "",
            "completedAt": "",
            "messageCount": 0
          }
        },
        "resumeScore": 0.0,
        "interviewScore": 0.0,
        "resumeComment": "",
        "interviewComment": "",
        "recommendation": "",
        "createdAt": "",
        "updatedAt": ""
      },
      "chatSession": {
        "sessionId": "",
        "application": {
          "applicationId": "",
          "submittedAt": "",
          "status": "",
          "resumeText": "",
          "resumeFilePath": "",
          "updatedAt": "",
          "candidateId": "",
          "jobId": "",
          "hrDecision": "",
          "hrComments": "",
          "assessment": {
            "assessmentId": "",
            "application": {},
            "resumeScore": 0.0,
            "interviewScore": 0.0,
            "resumeComment": "",
            "interviewComment": "",
            "recommendation": "",
            "createdAt": "",
            "updatedAt": ""
          },
          "chatSession": {
            "sessionId": "",
            "application": {},
            "messages": [
              {
                "messageId": "",
                "session": {},
                "sender": "",
                "content": "",
                "sentAt": ""
              }
            ],
            "status": "",
            "startedAt": "",
            "completedAt": "",
            "messageCount": 0
          }
        },
        "messages": [
          {
            "messageId": "",
            "session": {
              "sessionId": "",
              "application": {
                "applicationId": "",
                "submittedAt": "",
                "status": "",
                "resumeText": "",
                "resumeFilePath": "",
                "updatedAt": "",
                "candidateId": "",
                "jobId": "",
                "hrDecision": "",
                "hrComments": "",
                "assessment": {
                  "assessmentId": "",
                  "application": {},
                  "resumeScore": 0.0,
                  "interviewScore": 0.0,
                  "resumeComment": "",
                  "interviewComment": "",
                  "recommendation": "",
                  "createdAt": "",
                  "updatedAt": ""
                },
                "chatSession": {}
              },
              "messages": [
                {
                  "messageId": "",
                  "session": {},
                  "sender": "",
                  "content": "",
                  "sentAt": ""
                }
              ],
              "status": "",
              "startedAt": "",
              "completedAt": "",
              "messageCount": 0
            },
            "sender": "",
            "content": "",
            "sentAt": ""
          }
        ],
        "status": "",
        "startedAt": "",
        "completedAt": "",
        "messageCount": 0
      }
    },
    "resumeScore": 0.0,
    "interviewScore": 0.0,
    "resumeComment": "",
    "interviewComment": "",
    "recommendation": "",
    "createdAt": "",
    "updatedAt": ""
  },
  "timestamp": "",
  "code": 0
}
Modified at 2025-06-29 23:45:17
Previous
Trigger resume scoring for an application
Next
getApplicationWithAssessment
Built with