{
 "openapi": "3.1.0",
 "info": {
  "title": "Interviews (HRMS)",
  "version": "20261030b",
  "description": "Who is being seen, by whom, when, and what came of it. A round with no feedback is a meeting nobody can act on, which is why the outcome sits on the row."
 },
 "servers": [
  {
   "url": "https://{tenant}.tranxact.ai",
   "variables": {
    "tenant": {
     "default": "demo"
    }
   }
  }
 ],
 "components": {
  "securitySchemes": {
   "bearer": {
    "type": "http",
    "scheme": "bearer"
   }
  },
  "schemas": {
   "interviews": {
    "type": "object",
    "required": [
     "application_id"
    ],
    "properties": {
     "id": {
      "type": "string",
      "format": "uuid",
      "description": "Id",
      "readOnly": true
     },
     "org_id": {
      "type": "string",
      "format": "uuid",
      "description": "Org id",
      "readOnly": true
     },
     "application_id": {
      "type": "string",
      "format": "uuid",
      "description": "Application"
     },
     "round_no": {
      "type": "integer",
      "description": "Round"
     },
     "interview_type": {
      "type": "string",
      "description": "Kind",
      "enum": [
       "screening",
       "phone",
       "technical",
       "panel",
       "behavioral",
       "case_study",
       "final",
       "informal",
       "assessment"
      ]
     },
     "scheduled_at": {
      "type": "string",
      "format": "date-time",
      "description": "When"
     },
     "duration_minutes": {
      "type": "integer",
      "description": "Minutes"
     },
     "location": {
      "type": "string",
      "description": "Where"
     },
     "meeting_url": {
      "type": "string",
      "description": "Meeting link"
     },
     "status": {
      "type": "string",
      "description": "Status",
      "enum": [
       "scheduled",
       "completed",
       "cancelled",
       "no_show"
      ]
     },
     "outcome": {
      "type": "string",
      "description": "Outcome",
      "enum": [
       "strong_yes",
       "yes",
       "no",
       "strong_no",
       "no_decision"
      ]
     },
     "average_score": {
      "type": "string",
      "format": "decimal",
      "description": "Average score",
      "readOnly": true
     },
     "created_at": {
      "type": "string",
      "format": "date-time",
      "description": "Created at",
      "readOnly": true
     },
     "created_by": {
      "type": "string",
      "format": "uuid",
      "description": "Created by",
      "readOnly": true
     },
     "org_unit_id": {
      "type": "string",
      "format": "uuid",
      "description": "Org unit id",
      "readOnly": true
     },
     "xf_text_1": {
      "type": "string",
      "description": "Xf text 1",
      "readOnly": true
     },
     "xf_text_2": {
      "type": "string",
      "description": "Xf text 2",
      "readOnly": true
     },
     "xf_text_3": {
      "type": "string",
      "description": "Xf text 3",
      "readOnly": true
     },
     "xf_text_4": {
      "type": "string",
      "description": "Xf text 4",
      "readOnly": true
     },
     "xf_text_5": {
      "type": "string",
      "description": "Xf text 5",
      "readOnly": true
     },
     "xf_num_1": {
      "type": "string",
      "format": "decimal",
      "description": "Xf num 1",
      "readOnly": true
     },
     "xf_num_2": {
      "type": "string",
      "format": "decimal",
      "description": "Xf num 2",
      "readOnly": true
     },
     "xf_num_3": {
      "type": "string",
      "format": "decimal",
      "description": "Xf num 3",
      "readOnly": true
     },
     "xf_date_1": {
      "type": "string",
      "format": "date",
      "description": "Xf date 1",
      "readOnly": true
     },
     "xf_date_2": {
      "type": "string",
      "format": "date",
      "description": "Xf date 2",
      "readOnly": true
     },
     "updated_at": {
      "type": "string",
      "format": "date-time",
      "description": "Updated at",
      "readOnly": true
     },
     "updated_by": {
      "type": "string",
      "format": "uuid",
      "description": "Updated by",
      "readOnly": true
     },
     "scorecard_id": {
      "type": "string",
      "format": "uuid",
      "description": "Scorecard id",
      "readOnly": true
     },
     "aggregation_rule": {
      "type": "string",
      "description": "Aggregation rule",
      "readOnly": true
     },
     "pass_score": {
      "type": "string",
      "format": "decimal",
      "description": "Pass score",
      "readOnly": true
     },
     "tie_rule": {
      "type": "string",
      "description": "Tie rule",
      "readOnly": true
     },
     "panel_score": {
      "type": "string",
      "format": "decimal",
      "description": "Panel score",
      "readOnly": true
     },
     "panel_size": {
      "type": "integer",
      "description": "Panel size",
      "readOnly": true
     },
     "panel_submitted": {
      "type": "integer",
      "description": "Panel submitted",
      "readOnly": true
     },
     "votes_for": {
      "type": "integer",
      "description": "Votes for",
      "readOnly": true
     },
     "votes_against": {
      "type": "integer",
      "description": "Votes against",
      "readOnly": true
     },
     "derived_outcome": {
      "type": "string",
      "description": "Derived outcome",
      "readOnly": true
     },
     "outcome_basis": {
      "type": "string",
      "description": "Outcome basis",
      "readOnly": true
     },
     "outcome_overridden": {
      "type": "boolean",
      "description": "Outcome overridden",
      "readOnly": true
     },
     "outcome_override_reason": {
      "type": "string",
      "description": "Outcome override reason",
      "readOnly": true
     },
     "outcome_overridden_by": {
      "type": "string",
      "format": "uuid",
      "description": "Outcome overridden by",
      "readOnly": true
     },
     "outcome_overridden_at": {
      "type": "string",
      "format": "date-time",
      "description": "Outcome overridden at",
      "readOnly": true
     }
    }
   }
  }
 },
 "security": [
  {
   "bearer": []
  }
 ],
 "paths": {
  "/api/hrms/interviews": {
   "get": {
    "summary": "list interviews",
    "operationId": "list_interviews_0_4",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   },
   "post": {
    "summary": "create interviews",
    "operationId": "create_interviews_1_4",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/hrms/interviews/{id}": {
   "get": {
    "summary": "get interviews",
    "operationId": "get_interviews_0_5",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   },
   "put": {
    "summary": "change interviews",
    "operationId": "change_interviews_1_5",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   },
   "delete": {
    "summary": "delete interviews",
    "operationId": "delete_interviews_2_5",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/hrms/interviews/{id}/calendar-invite": {
   "post": {
    "summary": "Calendar invite",
    "operationId": "action_interviews_0_6",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/hrms/interviews/{id}/calendar-invite/cancel": {
   "post": {
    "summary": "Calendar invite cancel",
    "operationId": "action_interviews_0_7",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/hrms/interviews/{id}/set-panel": {
   "post": {
    "summary": "Set panel",
    "operationId": "action_interviews_0_6",
    "description": "Body keys: aggregationRule, aggregation_rule, tieRule, tie_rule, passScore, pass_score, scorecardId, scorecard_id, replace; aggregationRule one of weighted_average|majority_recommendation|unanimous|min_score; tieRule one of chair_casting_vote|weighted_average|no_decision|reject; members: [{ employeeId, employee_id, userId, user_id, name, panelist_name, role, panel_role, weight, voting, isVoting, is_voting }]",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/hrms/interviews/{id}/scorecard": {
   "get": {
    "summary": "Scorecard",
    "operationId": "action_interviews_0_6",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/hrms/interviews/{id}/score": {
   "post": {
    "summary": "Score",
    "operationId": "action_interviews_0_6",
    "description": "Body keys: panelistId, panelist_id, scores, recommendation, strengths, concerns, comments; recommendation one of strong_yes|yes|no|strong_no|no_decision; marks: [{ mark, criterionId, criterion_id, comment }]",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/hrms/interviews/{id}/outcome": {
   "post": {
    "summary": "Outcome",
    "operationId": "action_interviews_0_6",
    "description": "Body keys: reason, outcome; outcome one of strong_yes|yes|no|strong_no|no_decision",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/hrms/interviews/{id}/feedback": {
   "get": {
    "summary": "Feedback",
    "operationId": "action_interviews_0_6",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   },
   "post": {
    "summary": "Feedback",
    "operationId": "action_interviews_1_6",
    "description": "Body keys: interviewerId, interviewerName, competency, score, recommendation*, strengths, concerns, comments; recommendation one of strong_yes|yes|no|strong_no|no_decision",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/hrms/interviews/{id}/copy": {
   "post": {
    "summary": "Copy",
    "operationId": "action_interviews_0_6",
    "description": "Body keys: overrides, preview, withLines",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/hrms/interviews/{parentId}/panel": {
   "get": {
    "summary": "Panel",
    "operationId": "action_interviews_0_6",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   },
   "post": {
    "summary": "Panel",
    "operationId": "action_interviews_1_6",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/hrms/interviews/{parentId}/panel/{lineId}": {
   "put": {
    "summary": "Panel",
    "operationId": "action_interviews_0_7",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   },
   "delete": {
    "summary": "Panel",
    "operationId": "action_interviews_1_7",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/hrms/interviews/{parentId}/criteria": {
   "get": {
    "summary": "Criteria",
    "operationId": "action_interviews_0_6",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   },
   "post": {
    "summary": "Criteria",
    "operationId": "action_interviews_1_6",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  },
  "/api/hrms/interviews/{parentId}/criteria/{lineId}": {
   "put": {
    "summary": "Criteria",
    "operationId": "action_interviews_0_7",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   },
   "delete": {
    "summary": "Criteria",
    "operationId": "action_interviews_1_7",
    "responses": {
     "200": {
      "description": "OK"
     },
     "401": {
      "description": "No or bad credential"
     },
     "403": {
      "description": "Not granted"
     },
     "422": {
      "description": "Refused by validation"
     }
    }
   }
  }
 }
}