{ "openapi": "3.1.0", "info": { "title": "AI Interviewer Pro — AI Intelligence Gateway", "description": "Full OpenAPI for every AI Intelligence Gateway endpoint.\n\nInternal API for the Platform Team (NestJS). Base path: `/api/v1`.\nAuth: `X-Internal-Token` (except `/health` and `/ready`).\n\nLive interactive Swagger UI: `http://localhost:8000/docs`\nOpenAPI JSON (runtime): `http://localhost:8000/openapi.json`\nReDoc: `http://localhost:8000/redoc`\n\nThis file is the static export of the same schema FastAPI serves at runtime.\nTotal operations: 62.", "version": "0.2.0", "contact": { "name": "AI Team" } }, "paths": { "/api/v1/health": { "get": { "tags": [ "Health" ], "summary": "Health", "operationId": "health_api_v1_health_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": { "type": "string" }, "type": "object", "title": "Response Health Api V1 Health Get" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Unprocessable Entity", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/api/v1/ready": { "get": { "tags": [ "Health" ], "summary": "Ready", "operationId": "ready_api_v1_ready_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": { "type": "string" }, "type": "object", "title": "Response Ready Api V1 Ready Get" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Unprocessable Entity", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Internal Server Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } }, "/api/v1/personas": { "get": { "tags": [ "Personas" ], "summary": "List interviewer personas", "description": "SOW persona selector catalog for interview + drafting flows.", "operationId": "list_interviewer_personas_api_v1_personas_get", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PersonaListResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/personas/custom": { "post": { "tags": [ "Personas" ], "summary": "Create custom company persona", "operationId": "create_custom_persona_api_v1_personas_custom_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CustomPersonaRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CustomPersonaResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/scorecards/generate": { "post": { "tags": [ "Scorecards" ], "summary": "Interview Scorecard Generator", "operationId": "generate_scorecard_api_v1_scorecards_generate_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScorecardGenerateRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScorecardGenerateResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/questions/generate": { "post": { "tags": [ "Questions" ], "summary": "Generate practice questions", "operationId": "generate_questions_api_v1_questions_generate_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuestionGenRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuestionGenResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/questions/from-role": { "post": { "tags": [ "Questions" ], "summary": "Generate role interview questions", "operationId": "generate_from_role_api_v1_questions_from_role_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RoleQuestionGenRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RoleQuestionGenResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/job-descriptions/draft": { "post": { "tags": [ "Job Descriptions" ], "summary": "Inclusive Job Description Draft", "operationId": "draft_job_description_api_v1_job_descriptions_draft_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JobDescriptionDraftRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JobDescriptionDraftResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/job-descriptions/rewrite": { "post": { "tags": [ "Job Descriptions" ], "summary": "Inclusive Job Description Rewrite", "operationId": "inclusivity_rewrite_api_v1_job_descriptions_rewrite_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JdInclusivityRewriteRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JdInclusivityRewriteResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/documents/parse": { "post": { "tags": [ "Documents" ], "summary": "Resume / JD Document Parser", "operationId": "parse_document_api_v1_documents_parse_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DocumentParseRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DocumentParseResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/resume-match/score": { "post": { "tags": [ "Resume Match" ], "summary": "Resume vs Job Description Screening Score", "operationId": "score_resume_api_v1_resume_match_score_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResumeMatchRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResumeMatchResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/prep-plans/generate": { "post": { "tags": [ "Prep Plans" ], "summary": "Personalized Interview Prep Plan", "operationId": "generate_prep_plan_api_v1_prep_plans_generate_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PrepPlanRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PrepPlanResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/job-matching/recommend": { "post": { "tags": [ "Job Matching" ], "summary": "AI Job Recommendations", "operationId": "recommend_jobs_api_v1_job_matching_recommend_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JobMatchingRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JobMatchingResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/assessments/generate": { "post": { "tags": [ "Assessments" ], "summary": "Assessment Builder (Generate)", "operationId": "generate_assessment_api_v1_assessments_generate_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AssessmentGenerateRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AssessmentGenerateResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/assessments/grade": { "post": { "tags": [ "Assessments" ], "summary": "Assessment Grading", "operationId": "grade_assessment_api_v1_assessments_grade_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AssessmentGradeRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AssessmentGradeResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/aptitude/generate": { "post": { "tags": [ "Aptitude" ], "summary": "Timed Aptitude / Reasoning Test Generator", "operationId": "generate_aptitude_api_v1_aptitude_generate_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AptitudeGenerateRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AptitudeGenerateResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/aptitude/grade": { "post": { "tags": [ "Aptitude" ], "summary": "Aptitude Test Grading", "operationId": "grade_aptitude_api_v1_aptitude_grade_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AptitudeGradeRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AptitudeGradeResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/coding/judge": { "post": { "tags": [ "Coding" ], "summary": "Coding Challenge AI Judge", "operationId": "judge_code_api_v1_coding_judge_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CodingJudgeRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CodingJudgeResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/case-studies/generate": { "post": { "tags": [ "Case Studies" ], "summary": "Case Study Simulator (Generate)", "operationId": "generate_case_study_api_v1_case_studies_generate_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CaseStudyGenerateRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CaseStudyGenerateResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/case-studies/grade": { "post": { "tags": [ "Case Studies" ], "summary": "Case Study Grading", "operationId": "grade_case_study_api_v1_case_studies_grade_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CaseStudyGradeRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CaseStudyGradeResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/scenarios/generate": { "post": { "tags": [ "Scenarios" ], "summary": "Role Scenario Evaluation (Generate)", "operationId": "generate_scenarios_api_v1_scenarios_generate_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScenarioGenerateRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScenarioGenerateResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/scenarios/grade": { "post": { "tags": [ "Scenarios" ], "summary": "Role Scenario Grading", "operationId": "grade_scenarios_api_v1_scenarios_grade_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScenarioGradeRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScenarioGradeResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/puzzles/generate": { "post": { "tags": [ "Puzzles" ], "summary": "Timed Puzzle Challenge Generator", "operationId": "generate_puzzles_api_v1_puzzles_generate_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PuzzleGenerateRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PuzzleGenerateResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/puzzles/grade": { "post": { "tags": [ "Puzzles" ], "summary": "Puzzle Challenge Grading", "operationId": "grade_puzzles_api_v1_puzzles_grade_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PuzzleGradeRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PuzzleGradeResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/interview-preview/generate": { "post": { "tags": [ "Interview Preview" ], "summary": "Interview Preview Pack Generator", "operationId": "generate_preview_api_v1_interview_preview_generate_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InterviewPreviewRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InterviewPreviewResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/interview-preview/regenerate-question": { "post": { "tags": [ "Interview Preview" ], "summary": "Interview Question Regenerator", "operationId": "regenerate_question_api_v1_interview_preview_regenerate_question_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RegenerateQuestionRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RegenerateQuestionResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/interview-preview/validate-lock": { "post": { "tags": [ "Interview Preview" ], "summary": "Interview Lock / Publish Validator", "operationId": "validate_lock_api_v1_interview_preview_validate_lock_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InterviewValidateLockRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InterviewValidateLockResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/interview-preview/define-follow-up-logic": { "post": { "tags": [ "Interview Preview" ], "summary": "Interview Follow-up Logic Builder", "operationId": "define_follow_up_logic_api_v1_interview_preview_define_follow_up_logic_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FollowUpLogicRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FollowUpLogicResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/interview-preview/merge-custom-questions": { "post": { "tags": [ "Interview Preview" ], "summary": "Custom Company Questions Merger", "operationId": "merge_custom_questions_api_v1_interview_preview_merge_custom_questions_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MergeCustomQuestionsRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MergeCustomQuestionsResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/interview-tracks/generate": { "post": { "tags": [ "Interview Tracks" ], "summary": "Level-Based Interview Tracks", "operationId": "generate_track_api_v1_interview_tracks_generate_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InterviewTrackRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InterviewTrackResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/badges/recommend": { "post": { "tags": [ "Badges" ], "summary": "Achievement Badge Recommendations", "operationId": "recommend_badges_api_v1_badges_recommend_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BadgeRecommendRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BadgeRecommendResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/talent-scouting/rank": { "post": { "tags": [ "Talent Scouting" ], "summary": "Talent Scouting / Candidate Ranking", "operationId": "rank_candidates_api_v1_talent_scouting_rank_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TalentScoutRankRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TalentScoutRankResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/candidate-profiles/summarize": { "post": { "tags": [ "Candidate Profiles" ], "summary": "AI Candidate Profile Summary", "operationId": "summarize_profile_api_v1_candidate_profiles_summarize_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CandidateProfileSummarizeRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CandidateProfileSummarizeResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/translate": { "post": { "tags": [ "Translate" ], "summary": "Multi-Language Content Translator", "operationId": "translate_api_v1_translate_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/I18nTranslateRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/I18nTranslateResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/interviews/follow-up": { "post": { "tags": [ "Interviews" ], "summary": "Adaptive Interview Follow-up Questions", "operationId": "generate_follow_up_api_v1_interviews_follow_up_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FollowUpRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FollowUpResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/interviews/evaluate-answer": { "post": { "tags": [ "Interviews" ], "summary": "Real-Time Answer Evaluation", "operationId": "evaluate_answer_api_v1_interviews_evaluate_answer_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EvaluateAnswerRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EvaluateAnswerResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/interviews/next-question": { "post": { "tags": [ "Interviews" ], "summary": "Adaptive Next Interview Question", "operationId": "next_question_api_v1_interviews_next_question_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NextQuestionRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NextQuestionResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/interviews/summarize": { "post": { "tags": [ "Interviews" ], "summary": "End-of-Interview AI Summary", "operationId": "summarize_interview_api_v1_interviews_summarize_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InterviewSummarizeRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InterviewSummarizeResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/transcription": { "post": { "tags": [ "Transcription" ], "summary": "Voice Transcription", "operationId": "transcribe_api_v1_transcription_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TranscriptionRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TranscriptionResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/tts/synthesize": { "post": { "tags": [ "TTS" ], "summary": "AI Interviewer Text-to-Speech", "operationId": "synthesize_api_v1_tts_synthesize_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TtsSynthesizeRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TtsSynthesizeResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/video-intelligence": { "post": { "tags": [ "Video Intelligence" ], "summary": "Video Intelligence Analysis", "operationId": "analyze_video_api_v1_video_intelligence_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoIntelligenceRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VideoIntelligenceResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/behavioral-analysis": { "post": { "tags": [ "Behavioral Analysis" ], "summary": "Behavioral Analysis (Tone / Confidence)", "operationId": "analyze_behavior_api_v1_behavioral_analysis_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BehavioralAnalysisRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BehavioralAnalysisResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/confidence-scoring/evaluate": { "post": { "tags": [ "Confidence Scoring" ], "summary": "Interview Confidence Score", "operationId": "evaluate_confidence_api_v1_confidence_scoring_evaluate_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfidenceScoringRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfidenceScoringResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/answers/evaluate": { "post": { "tags": [ "Answers" ], "summary": "Answer Feedback Evaluation", "operationId": "evaluate_answers_api_v1_answers_evaluate_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AnswerEvaluationRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AnswerEvaluationResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/candidate-scoring": { "post": { "tags": [ "Candidate Scoring" ], "summary": "Combined Candidate Scoring", "operationId": "score_candidate_api_v1_candidate_scoring_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CandidateScoringRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CandidateScoringResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/skill-gap/analyze": { "post": { "tags": [ "Skill Gap" ], "summary": "Skill Gap Analysis", "operationId": "analyze_skill_gap_api_v1_skill_gap_analyze_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SkillGapAnalyzeRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SkillGapAnalyzeResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/hiring-fit/predict": { "post": { "tags": [ "Hiring Fit" ], "summary": "Hiring Fit Prediction", "operationId": "predict_hiring_fit_api_v1_hiring_fit_predict_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HiringFitRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HiringFitResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/bias-detection/analyze": { "post": { "tags": [ "Bias Detection" ], "summary": "Bias Detection", "operationId": "analyze_bias_api_v1_bias_detection_analyze_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BiasDetectionRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BiasDetectionResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/interview-highlights/generate": { "post": { "tags": [ "Interview Highlights" ], "summary": "Interview Replay Highlights", "operationId": "generate_highlights_api_v1_interview_highlights_generate_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InterviewHighlightsRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InterviewHighlightsResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/reports/panelist-notes": { "post": { "tags": [ "Reports" ], "summary": "AI Panelist Notes", "operationId": "panelist_notes_api_v1_reports_panelist_notes_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PanelistNotesRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PanelistNotesResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/reports/evaluation-pdf": { "post": { "tags": [ "Reports" ], "summary": "PDF Evaluation Report", "operationId": "evaluation_pdf_api_v1_reports_evaluation_pdf_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EvaluationReportRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EvaluationReportResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/reference-checks/questionnaire": { "post": { "tags": [ "Reference Checks" ], "summary": "Reference Check Questionnaire", "operationId": "create_questionnaire_api_v1_reference_checks_questionnaire_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReferenceQuestionnaireRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReferenceQuestionnaireResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/reference-checks/report": { "post": { "tags": [ "Reference Checks" ], "summary": "Reference Check Report", "operationId": "create_report_api_v1_reference_checks_report_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReferenceReportRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReferenceReportResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/progress-analytics/analyze": { "post": { "tags": [ "Progress Analytics" ], "summary": "Progress / Improvement Analytics", "operationId": "analyze_progress_api_v1_progress_analytics_analyze_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProgressAnalyticsRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProgressAnalyticsResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/cultural-sensitivity/adapt": { "post": { "tags": [ "Cultural Sensitivity" ], "summary": "Cultural Sensitivity Adaptation", "operationId": "adapt_content_api_v1_cultural_sensitivity_adapt_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CulturalAdaptRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CulturalAdaptResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/face-verification/verify": { "post": { "tags": [ "Face Verification" ], "summary": "Face Verification", "operationId": "verify_face_api_v1_face_verification_verify_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FaceVerificationRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FaceVerificationResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/id-verification/verify": { "post": { "tags": [ "ID Verification" ], "summary": "Government ID Verification", "operationId": "verify_id_api_v1_id_verification_verify_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IdVerificationRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IdVerificationResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/proctoring/analyze": { "post": { "tags": [ "Proctoring" ], "summary": "Browser Proctoring / Anti-Cheat", "operationId": "analyze_proctoring_api_v1_proctoring_analyze_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProctoringAnalyzeRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProctoringAnalyzeResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/dei-analytics/analyze": { "post": { "tags": [ "DEI Analytics" ], "summary": "DEI Analytics", "operationId": "analyze_dei_api_v1_dei_analytics_analyze_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeiAnalyticsRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeiAnalyticsResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/manager-clone": { "post": { "tags": [ "Enterprise" ], "summary": "AI Manager Clone", "operationId": "manager_clone_api_v1_manager_clone_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManagerCloneRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManagerCloneResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/market-research/questions": { "post": { "tags": [ "Enterprise" ], "summary": "Market Research Interview Questions", "operationId": "market_research_questions_api_v1_market_research_questions_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MarketResearchRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MarketResearchResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } }, "/api/v1/voice-cloning": { "post": { "tags": [ "Enterprise" ], "summary": "Branded Voice Cloning", "operationId": "voice_cloning_api_v1_voice_cloning_post", "parameters": [ { "name": "X-Internal-Token", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Internal-Token" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VoiceCloneRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VoiceCloneResponse" } } } }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthorized" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unprocessable Entity" }, "500": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Internal Server Error" } } } } }, "components": { "schemas": { "AnswerEvaluationRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "assessment_id": { "type": "string", "minLength": 1, "title": "Assessment Id" }, "mode": { "$ref": "#/components/schemas/EvaluationMode", "default": "auto" }, "answers": { "items": { "$ref": "#/components/schemas/AnswerItem" }, "type": "array", "minItems": 1, "title": "Answers" }, "language": { "type": "string", "maxLength": 10, "minLength": 2, "title": "Language", "default": "en" }, "options": { "additionalProperties": true, "type": "object", "title": "Options", "description": "Platform options (strictness, return_feedback, etc.)" } }, "type": "object", "required": [ "assessment_id", "answers" ], "title": "AnswerEvaluationRequest", "description": "POST /api/v1/answers/evaluate" }, "AnswerEvaluationResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "assessment_id": { "type": "string", "title": "Assessment Id" }, "total_score": { "type": "number", "title": "Total Score", "default": 0.0 }, "max_total_score": { "type": "number", "title": "Max Total Score", "default": 0.0 }, "results": { "items": { "$ref": "#/components/schemas/EvaluatedAnswer" }, "type": "array", "title": "Results" } }, "type": "object", "required": [ "assessment_id" ], "title": "AnswerEvaluationResponse" }, "AnswerItem": { "properties": { "question_id": { "type": "string", "title": "Question Id" }, "question_text": { "type": "string", "title": "Question Text" }, "expected_answer": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Expected Answer" }, "student_answer": { "type": "string", "title": "Student Answer" }, "max_score": { "type": "number", "minimum": 0.0, "title": "Max Score", "default": 1.0 }, "rubric": { "items": { "type": "string" }, "type": "array", "title": "Rubric" } }, "type": "object", "required": [ "question_id", "question_text", "student_answer" ], "title": "AnswerItem" }, "AptitudeGenerateRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "domain": { "type": "string", "title": "Domain", "default": "logical_reasoning" }, "role_title": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Role Title" }, "difficulty": { "$ref": "#/components/schemas/Difficulty", "default": "medium" }, "count": { "type": "integer", "maximum": 50.0, "minimum": 1.0, "title": "Count", "default": 10 }, "time_limit_minutes": { "type": "integer", "maximum": 180.0, "minimum": 5.0, "title": "Time Limit Minutes", "default": 30 }, "language": { "type": "string", "maxLength": 10, "minLength": 2, "title": "Language", "default": "en" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "title": "AptitudeGenerateRequest", "description": "POST /api/v1/aptitude/generate" }, "AptitudeGenerateResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "aptitude_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Aptitude Id" }, "domain": { "type": "string", "title": "Domain" }, "time_limit_minutes": { "type": "integer", "title": "Time Limit Minutes" }, "questions": { "items": { "$ref": "#/components/schemas/GeneratedQuestion" }, "type": "array", "title": "Questions" } }, "type": "object", "required": [ "domain", "time_limit_minutes" ], "title": "AptitudeGenerateResponse" }, "AptitudeGradeRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "aptitude_id": { "type": "string", "title": "Aptitude Id" }, "answers": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "minItems": 1, "title": "Answers" }, "time_taken_seconds": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Time Taken Seconds" }, "language": { "type": "string", "maxLength": 10, "minLength": 2, "title": "Language", "default": "en" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "aptitude_id", "answers" ], "title": "AptitudeGradeRequest", "description": "POST /api/v1/aptitude/grade" }, "AptitudeGradeResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "aptitude_id": { "type": "string", "title": "Aptitude Id" }, "total_score": { "type": "number", "title": "Total Score", "default": 0.0 }, "max_total_score": { "type": "number", "title": "Max Total Score", "default": 0.0 }, "passed": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Passed" }, "percentile_estimate": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Percentile Estimate" }, "feedback_markdown": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Feedback Markdown" }, "item_results": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Item Results" } }, "type": "object", "required": [ "aptitude_id" ], "title": "AptitudeGradeResponse" }, "AssessmentGenerateRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "role_title": { "type": "string", "title": "Role Title" }, "job_description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Job Description" }, "kind": { "$ref": "#/components/schemas/AssessmentKind", "default": "mcq" }, "difficulty": { "$ref": "#/components/schemas/Difficulty", "default": "medium" }, "question_types": { "items": { "$ref": "#/components/schemas/QuestionType" }, "type": "array", "title": "Question Types" }, "count": { "type": "integer", "maximum": 50.0, "minimum": 1.0, "title": "Count", "default": 10 }, "time_limit_minutes": { "anyOf": [ { "type": "integer", "maximum": 480.0, "minimum": 1.0 }, { "type": "null" } ], "title": "Time Limit Minutes" }, "skills": { "items": { "type": "string" }, "type": "array", "title": "Skills" }, "language": { "type": "string", "maxLength": 10, "minLength": 2, "title": "Language", "default": "en" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "role_title" ], "title": "AssessmentGenerateRequest", "description": "POST /api/v1/assessments/generate" }, "AssessmentGenerateResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "assessment_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Assessment Id" }, "kind": { "$ref": "#/components/schemas/AssessmentKind" }, "role_title": { "type": "string", "title": "Role Title" }, "questions": { "items": { "$ref": "#/components/schemas/GeneratedQuestion" }, "type": "array", "title": "Questions" }, "rubric": { "additionalProperties": true, "type": "object", "title": "Rubric" } }, "type": "object", "required": [ "kind", "role_title" ], "title": "AssessmentGenerateResponse" }, "AssessmentGradeRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "assessment_id": { "type": "string", "title": "Assessment Id" }, "kind": { "$ref": "#/components/schemas/AssessmentKind", "default": "mcq" }, "answers": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "minItems": 1, "title": "Answers" }, "rubric": { "additionalProperties": true, "type": "object", "title": "Rubric" }, "language": { "type": "string", "maxLength": 10, "minLength": 2, "title": "Language", "default": "en" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "assessment_id", "answers" ], "title": "AssessmentGradeRequest", "description": "POST /api/v1/assessments/grade" }, "AssessmentGradeResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "assessment_id": { "type": "string", "title": "Assessment Id" }, "total_score": { "type": "number", "title": "Total Score", "default": 0.0 }, "max_total_score": { "type": "number", "title": "Max Total Score", "default": 0.0 }, "passed": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Passed" }, "feedback_markdown": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Feedback Markdown" }, "item_results": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Item Results" } }, "type": "object", "required": [ "assessment_id" ], "title": "AssessmentGradeResponse" }, "AssessmentKind": { "type": "string", "enum": [ "coding", "mcq", "case_study", "aptitude", "scenario", "essay", "video_response", "file_upload", "puzzle", "custom" ], "title": "AssessmentKind" }, "BadgeItem": { "properties": { "badge_id": { "type": "string", "title": "Badge Id" }, "name": { "type": "string", "title": "Name" }, "level": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Level" }, "reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Reason" } }, "type": "object", "required": [ "badge_id", "name" ], "title": "BadgeItem" }, "BadgeRecommendRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "candidate_id": { "type": "string", "title": "Candidate Id" }, "track_results": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Track Results" }, "assessment_results": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Assessment Results" }, "interview_scores": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Interview Scores" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "candidate_id" ], "title": "BadgeRecommendRequest", "description": "POST /api/v1/badges/recommend" }, "BadgeRecommendResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "candidate_id": { "type": "string", "title": "Candidate Id" }, "earned": { "items": { "$ref": "#/components/schemas/BadgeItem" }, "type": "array", "title": "Earned" }, "next_badges": { "items": { "$ref": "#/components/schemas/BadgeItem" }, "type": "array", "title": "Next Badges" } }, "type": "object", "required": [ "candidate_id" ], "title": "BadgeRecommendResponse" }, "BehavioralAnalysisRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "interview_id": { "type": "string", "title": "Interview Id" }, "candidate_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Candidate Id" }, "mode": { "$ref": "#/components/schemas/InterviewMode", "default": "voice" }, "transcript": { "items": { "$ref": "#/components/schemas/TranscriptTurn" }, "type": "array", "title": "Transcript" }, "audio_features": { "additionalProperties": true, "type": "object", "title": "Audio Features", "description": "Optional acoustic features from media pipeline" }, "video_signals": { "additionalProperties": true, "type": "object", "title": "Video Signals" }, "language": { "type": "string", "maxLength": 10, "minLength": 2, "title": "Language", "default": "en" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "interview_id" ], "title": "BehavioralAnalysisRequest", "description": "POST /api/v1/behavioral-analysis" }, "BehavioralAnalysisResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "interview_id": { "type": "string", "title": "Interview Id" }, "overall_confidence": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Overall Confidence" }, "tone_summary": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Tone Summary" }, "cues": { "items": { "$ref": "#/components/schemas/BehavioralCue" }, "type": "array", "title": "Cues" }, "flags": { "items": { "type": "string" }, "type": "array", "title": "Flags" } }, "type": "object", "required": [ "interview_id" ], "title": "BehavioralAnalysisResponse" }, "BehavioralCue": { "properties": { "name": { "type": "string", "title": "Name" }, "score": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Score" }, "evidence": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Evidence" } }, "type": "object", "required": [ "name" ], "title": "BehavioralCue" }, "BiasDetectionRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "content_type": { "type": "string", "title": "Content Type", "description": "questions | evaluation | job_description | transcript", "default": "questions" }, "content": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Content" }, "questions": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Questions" }, "evaluation_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Evaluation Text" }, "job_description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Job Description" }, "language": { "type": "string", "maxLength": 10, "minLength": 2, "title": "Language", "default": "en" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "title": "BiasDetectionRequest", "description": "POST /api/v1/bias-detection/analyze" }, "BiasDetectionResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "content_type": { "type": "string", "title": "Content Type" }, "passed": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Passed" }, "risk_score": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Risk Score" }, "flags": { "items": { "$ref": "#/components/schemas/BiasFlagItem" }, "type": "array", "title": "Flags" }, "rewritten_suggestions": { "items": { "type": "string" }, "type": "array", "title": "Rewritten Suggestions" } }, "type": "object", "required": [ "content_type" ], "title": "BiasDetectionResponse" }, "BiasFlag": { "properties": { "category": { "type": "string", "title": "Category" }, "severity": { "type": "string", "title": "Severity", "default": "low" }, "description": { "type": "string", "title": "Description" }, "recommendation": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Recommendation" } }, "type": "object", "required": [ "category", "description" ], "title": "BiasFlag" }, "BiasFlagItem": { "properties": { "category": { "type": "string", "title": "Category" }, "severity": { "type": "string", "title": "Severity", "default": "low" }, "excerpt": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Excerpt" }, "description": { "type": "string", "title": "Description" }, "recommendation": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Recommendation" } }, "type": "object", "required": [ "category", "description" ], "title": "BiasFlagItem" }, "CandidateProfileSummarizeRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "candidate_id": { "type": "string", "title": "Candidate Id" }, "resume_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Resume Text" }, "interview_history": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Interview History" }, "assessment_records": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Assessment Records" }, "badges": { "items": { "type": "string" }, "type": "array", "title": "Badges" }, "reports": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Reports" }, "target_role": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Target Role" }, "language": { "type": "string", "maxLength": 10, "minLength": 2, "title": "Language", "default": "en" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "candidate_id" ], "title": "CandidateProfileSummarizeRequest", "description": "POST /api/v1/candidate-profiles/summarize" }, "CandidateProfileSummarizeResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "candidate_id": { "type": "string", "title": "Candidate Id" }, "headline": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Headline" }, "summary_markdown": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Summary Markdown" }, "strengths": { "items": { "type": "string" }, "type": "array", "title": "Strengths" }, "growth_areas": { "items": { "type": "string" }, "type": "array", "title": "Growth Areas" }, "readiness_score": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Readiness Score" }, "badge_highlights": { "items": { "type": "string" }, "type": "array", "title": "Badge Highlights" }, "recommended_next_steps": { "items": { "type": "string" }, "type": "array", "title": "Recommended Next Steps" } }, "type": "object", "required": [ "candidate_id" ], "title": "CandidateProfileSummarizeResponse" }, "CandidateScoringRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "interview_id": { "type": "string", "title": "Interview Id" }, "candidate_id": { "type": "string", "title": "Candidate Id" }, "role_title": { "type": "string", "title": "Role Title" }, "job_description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Job Description" }, "mode": { "$ref": "#/components/schemas/InterviewMode", "default": "chat" }, "transcript": { "items": { "$ref": "#/components/schemas/TranscriptTurn" }, "type": "array", "title": "Transcript" }, "answers": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Answers", "description": "Structured Q/A pairs if available" }, "required_skills": { "items": { "type": "string" }, "type": "array", "title": "Required Skills" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "interview_id", "candidate_id", "role_title" ], "title": "CandidateScoringRequest", "description": "POST /api/v1/candidate-scoring" }, "CandidateScoringResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "interview_id": { "type": "string", "title": "Interview Id" }, "candidate_id": { "type": "string", "title": "Candidate Id" }, "confidence_score": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Confidence Score" }, "hiring_fit_score": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Hiring Fit Score" }, "hiring_fit_label": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Hiring Fit Label" }, "skill_gaps": { "items": { "$ref": "#/components/schemas/app__schemas__candidate_scoring__SkillGapItem" }, "type": "array", "title": "Skill Gaps" }, "bias_flags": { "items": { "$ref": "#/components/schemas/BiasFlag" }, "type": "array", "title": "Bias Flags" }, "behavioral_summary": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Behavioral Summary" }, "scorecard": { "additionalProperties": true, "type": "object", "title": "Scorecard" } }, "type": "object", "required": [ "interview_id", "candidate_id" ], "title": "CandidateScoringResponse" }, "CaseStudyGenerateRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "role_title": { "type": "string", "title": "Role Title" }, "industry": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Industry" }, "job_description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Job Description" }, "difficulty": { "$ref": "#/components/schemas/Difficulty", "default": "medium" }, "time_limit_minutes": { "type": "integer", "maximum": 240.0, "minimum": 10.0, "title": "Time Limit Minutes", "default": 45 }, "language": { "type": "string", "maxLength": 10, "minLength": 2, "title": "Language", "default": "en" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "role_title" ], "title": "CaseStudyGenerateRequest", "description": "POST /api/v1/case-studies/generate" }, "CaseStudyGenerateResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "case_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Case Id" }, "title": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Title" }, "scenario_markdown": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Scenario Markdown" }, "tasks": { "items": { "type": "string" }, "type": "array", "title": "Tasks" }, "rubric": { "additionalProperties": true, "type": "object", "title": "Rubric" } }, "type": "object", "title": "CaseStudyGenerateResponse" }, "CaseStudyGradeRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "case_id": { "type": "string", "title": "Case Id" }, "role_title": { "type": "string", "title": "Role Title" }, "candidate_submission": { "type": "string", "minLength": 1, "title": "Candidate Submission" }, "rubric": { "additionalProperties": true, "type": "object", "title": "Rubric" }, "language": { "type": "string", "maxLength": 10, "minLength": 2, "title": "Language", "default": "en" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "case_id", "role_title", "candidate_submission" ], "title": "CaseStudyGradeRequest", "description": "POST /api/v1/case-studies/grade" }, "CaseStudyGradeResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "case_id": { "type": "string", "title": "Case Id" }, "total_score": { "type": "number", "title": "Total Score", "default": 0.0 }, "max_total_score": { "type": "number", "title": "Max Total Score", "default": 100.0 }, "passed": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Passed" }, "feedback_markdown": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Feedback Markdown" }, "rubric_scores": { "additionalProperties": true, "type": "object", "title": "Rubric Scores" } }, "type": "object", "required": [ "case_id" ], "title": "CaseStudyGradeResponse" }, "CodingJudgeRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "challenge_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Challenge Id" }, "language": { "type": "string", "title": "Language", "examples": [ "python", "javascript", "java", "go" ] }, "problem_statement": { "type": "string", "minLength": 10, "title": "Problem Statement" }, "starter_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Starter Code" }, "candidate_code": { "type": "string", "minLength": 1, "title": "Candidate Code" }, "test_cases": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Test Cases" }, "rubric": { "additionalProperties": true, "type": "object", "title": "Rubric" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "language", "problem_statement", "candidate_code" ], "title": "CodingJudgeRequest", "description": "POST /api/v1/coding/judge" }, "CodingJudgeResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "challenge_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Challenge Id" }, "total_score": { "type": "number", "title": "Total Score", "default": 0.0 }, "max_total_score": { "type": "number", "title": "Max Total Score", "default": 100.0 }, "passed": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Passed" }, "correctness": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Correctness" }, "code_quality": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Code Quality" }, "efficiency": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Efficiency" }, "feedback_markdown": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Feedback Markdown" }, "failing_tests": { "items": { "type": "string" }, "type": "array", "title": "Failing Tests" } }, "type": "object", "title": "CodingJudgeResponse" }, "ConfidenceScoringRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "interview_id": { "type": "string", "title": "Interview Id" }, "candidate_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Candidate Id" }, "mode": { "$ref": "#/components/schemas/InterviewMode", "default": "chat" }, "transcript": { "items": { "$ref": "#/components/schemas/TranscriptTurn" }, "type": "array", "title": "Transcript" }, "audio_features": { "additionalProperties": true, "type": "object", "title": "Audio Features" }, "language": { "type": "string", "maxLength": 10, "minLength": 2, "title": "Language", "default": "en" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "interview_id" ], "title": "ConfidenceScoringRequest", "description": "POST /api/v1/confidence-scoring/evaluate" }, "ConfidenceScoringResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "interview_id": { "type": "string", "title": "Interview Id" }, "confidence_score": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Confidence Score" }, "certainty_band": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Certainty Band" }, "cues": { "items": { "type": "string" }, "type": "array", "title": "Cues" }, "summary": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Summary" } }, "type": "object", "required": [ "interview_id" ], "title": "ConfidenceScoringResponse" }, "CulturalAdaptRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "target_language": { "type": "string", "maxLength": 10, "minLength": 2, "title": "Target Language" }, "region": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Region" }, "content_type": { "type": "string", "title": "Content Type", "description": "interview_questions | feedback | prep_plan | job_description", "default": "interview_questions" }, "content": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Content" }, "questions": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Questions" }, "cultural_sensitivity": { "type": "boolean", "title": "Cultural Sensitivity", "default": true }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "target_language" ], "title": "CulturalAdaptRequest", "description": "POST /api/v1/cultural-sensitivity/adapt" }, "CulturalAdaptResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "target_language": { "type": "string", "title": "Target Language" }, "region": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Region" }, "adapted_content": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Adapted Content" }, "adapted_questions": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Adapted Questions" }, "notes": { "items": { "type": "string" }, "type": "array", "title": "Notes" } }, "type": "object", "required": [ "target_language" ], "title": "CulturalAdaptResponse" }, "CustomPersonaRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "company_id": { "type": "string", "title": "Company Id" }, "name": { "type": "string", "title": "Name" }, "interview_style": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Interview Style" }, "company_values": { "items": { "type": "string" }, "type": "array", "title": "Company Values" }, "sample_questions": { "items": { "type": "string" }, "type": "array", "title": "Sample Questions" }, "evaluation_criteria": { "items": { "type": "string" }, "type": "array", "title": "Evaluation Criteria" }, "tone_notes": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Tone Notes" }, "language": { "type": "string", "maxLength": 10, "minLength": 2, "title": "Language", "default": "en" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "company_id", "name" ], "title": "CustomPersonaRequest", "description": "POST /api/v1/interviewer-personas/custom" }, "CustomPersonaResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "company_id": { "type": "string", "title": "Company Id" }, "persona_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Persona Id" }, "name": { "type": "string", "title": "Name" }, "system_prompt": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "System Prompt" }, "style_summary": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Style Summary" } }, "type": "object", "required": [ "company_id", "name" ], "title": "CustomPersonaResponse" }, "DeiAnalyticsRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "dataset": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Dataset", "description": "Anonymized evaluation rows for DEI insight generation" }, "role_title": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Role Title" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "title": "DeiAnalyticsRequest", "description": "POST /api/v1/dei-analytics/analyze" }, "DeiAnalyticsResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "fairness_score": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Fairness Score" }, "insights": { "items": { "type": "string" }, "type": "array", "title": "Insights" }, "risks": { "items": { "type": "string" }, "type": "array", "title": "Risks" }, "recommendations": { "items": { "type": "string" }, "type": "array", "title": "Recommendations" } }, "type": "object", "title": "DeiAnalyticsResponse" }, "Difficulty": { "type": "string", "enum": [ "easy", "medium", "hard" ], "title": "Difficulty" }, "DocumentParseRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "document_type": { "$ref": "#/components/schemas/DocumentType" }, "parse_target": { "$ref": "#/components/schemas/ParseTarget", "default": "raw_text" }, "content_base64": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Content Base64", "description": "Base64-encoded document bytes" }, "source_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source Url", "description": "Internal/presigned URL the Gateway may fetch" }, "filename": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Filename" }, "language": { "type": "string", "maxLength": 10, "minLength": 2, "title": "Language", "default": "en" }, "options": { "additionalProperties": true, "type": "object", "title": "Options", "description": "OCR, page range, extract_tables, etc." } }, "type": "object", "required": [ "document_type" ], "title": "DocumentParseRequest", "description": "POST /api/v1/documents/parse\n\nProvide either `content_base64` or `source_url` (exactly one)." }, "DocumentParseResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "document_type": { "$ref": "#/components/schemas/DocumentType" }, "parse_target": { "$ref": "#/components/schemas/ParseTarget" }, "raw_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Raw Text" }, "blocks": { "items": { "$ref": "#/components/schemas/ParsedBlock" }, "type": "array", "title": "Blocks" }, "structured": { "additionalProperties": true, "type": "object", "title": "Structured" } }, "type": "object", "required": [ "document_type", "parse_target" ], "title": "DocumentParseResponse" }, "DocumentType": { "type": "string", "enum": [ "pdf", "docx", "txt", "html", "image", "markdown" ], "title": "DocumentType" }, "EmploymentType": { "type": "string", "enum": [ "full_time", "part_time", "contract", "internship", "temporary" ], "title": "EmploymentType" }, "ErrorDetail": { "properties": { "code": { "type": "string", "title": "Code" }, "message": { "type": "string", "title": "Message" }, "details": { "additionalProperties": true, "type": "object", "title": "Details" } }, "type": "object", "required": [ "code", "message" ], "title": "ErrorDetail" }, "ErrorResponse": { "properties": { "error": { "$ref": "#/components/schemas/ErrorDetail" } }, "type": "object", "required": [ "error" ], "title": "ErrorResponse" }, "EvaluateAnswerRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "interview_id": { "type": "string", "minLength": 1, "title": "Interview Id" }, "mode": { "$ref": "#/components/schemas/InterviewMode", "default": "chat" }, "persona": { "$ref": "#/components/schemas/Persona", "default": "technical" }, "role_title": { "type": "string", "title": "Role Title" }, "job_description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Job Description" }, "question": { "type": "string", "minLength": 1, "title": "Question" }, "candidate_answer": { "type": "string", "minLength": 1, "title": "Candidate Answer" }, "skills_focus": { "items": { "type": "string" }, "type": "array", "title": "Skills Focus" }, "language": { "type": "string", "maxLength": 10, "minLength": 2, "title": "Language", "default": "en" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "interview_id", "role_title", "question", "candidate_answer" ], "title": "EvaluateAnswerRequest", "description": "POST /api/v1/interviews/evaluate-answer — real-time turn evaluation." }, "EvaluateAnswerResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "interview_id": { "type": "string", "title": "Interview Id" }, "score": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Score" }, "max_score": { "type": "number", "title": "Max Score", "default": 1.0 }, "feedback": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Feedback" }, "strengths": { "items": { "type": "string" }, "type": "array", "title": "Strengths" }, "gaps": { "items": { "type": "string" }, "type": "array", "title": "Gaps" }, "next_action": { "type": "string", "title": "Next Action", "default": "continue" } }, "type": "object", "required": [ "interview_id" ], "title": "EvaluateAnswerResponse" }, "EvaluatedAnswer": { "properties": { "question_id": { "type": "string", "title": "Question Id" }, "score": { "type": "number", "title": "Score" }, "max_score": { "type": "number", "title": "Max Score" }, "is_correct": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Is Correct" }, "feedback": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Feedback" }, "breakdown": { "items": { "$ref": "#/components/schemas/ScoreBreakdown" }, "type": "array", "title": "Breakdown" }, "metadata": { "additionalProperties": true, "type": "object", "title": "Metadata" } }, "type": "object", "required": [ "question_id", "score", "max_score" ], "title": "EvaluatedAnswer" }, "EvaluationMode": { "type": "string", "enum": [ "auto", "rubric", "comparative" ], "title": "EvaluationMode" }, "EvaluationReportRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "interview_id": { "type": "string", "title": "Interview Id" }, "candidate_id": { "type": "string", "title": "Candidate Id" }, "candidate_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Candidate Name" }, "role_title": { "type": "string", "title": "Role Title" }, "company_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Company Name" }, "scoring_payload": { "additionalProperties": true, "type": "object", "title": "Scoring Payload" }, "panelist_notes": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Panelist Notes" }, "include_transcript": { "type": "boolean", "title": "Include Transcript", "default": false }, "branding": { "additionalProperties": true, "type": "object", "title": "Branding" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "interview_id", "candidate_id", "role_title" ], "title": "EvaluationReportRequest", "description": "POST /api/v1/reports/evaluation-pdf" }, "EvaluationReportResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "interview_id": { "type": "string", "title": "Interview Id" }, "report_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Report Id" }, "pdf_base64": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Pdf Base64" }, "download_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Download Url" }, "summary_markdown": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Summary Markdown" } }, "type": "object", "required": [ "interview_id" ], "title": "EvaluationReportResponse" }, "FaceVerificationRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "interview_id": { "type": "string", "title": "Interview Id" }, "candidate_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Candidate Id" }, "idle_image_base64": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Idle Image Base64" }, "live_image_base64": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Live Image Base64" }, "id_image_base64": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Id Image Base64" }, "source_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source Url" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "interview_id" ], "title": "FaceVerificationRequest", "description": "POST /api/v1/face-verification/verify" }, "FaceVerificationResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "interview_id": { "type": "string", "title": "Interview Id" }, "verified": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Verified" }, "match_score": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Match Score" }, "liveness_score": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Liveness Score" }, "warnings": { "items": { "type": "string" }, "type": "array", "title": "Warnings" } }, "type": "object", "required": [ "interview_id" ], "title": "FaceVerificationResponse" }, "FollowUpLogicRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "role_title": { "type": "string", "title": "Role Title" }, "questions": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "minItems": 1, "title": "Questions" }, "persona": { "$ref": "#/components/schemas/Persona", "default": "technical" }, "language": { "type": "string", "maxLength": 10, "minLength": 2, "title": "Language", "default": "en" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "role_title", "questions" ], "title": "FollowUpLogicRequest", "description": "POST /api/v1/interview-preview/define-follow-up-logic" }, "FollowUpLogicResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "rules": { "items": { "$ref": "#/components/schemas/FollowUpRule" }, "type": "array", "title": "Rules" }, "logic_markdown": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Logic Markdown" } }, "type": "object", "title": "FollowUpLogicResponse" }, "FollowUpQuestion": { "properties": { "id": { "type": "string", "title": "Id" }, "text": { "type": "string", "title": "Text" }, "rationale": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Rationale" }, "skill_tags": { "items": { "type": "string" }, "type": "array", "title": "Skill Tags" } }, "type": "object", "required": [ "id", "text" ], "title": "FollowUpQuestion" }, "FollowUpRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "interview_id": { "type": "string", "minLength": 1, "title": "Interview Id" }, "mode": { "$ref": "#/components/schemas/InterviewMode", "default": "chat" }, "persona": { "$ref": "#/components/schemas/Persona", "default": "technical" }, "role_title": { "type": "string", "title": "Role Title" }, "job_description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Job Description" }, "planned_question": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Planned Question", "description": "Current planned question being asked" }, "candidate_answer": { "type": "string", "minLength": 1, "title": "Candidate Answer" }, "transcript": { "items": { "$ref": "#/components/schemas/TranscriptTurn" }, "type": "array", "title": "Transcript" }, "skills_focus": { "items": { "type": "string" }, "type": "array", "title": "Skills Focus" }, "max_follow_ups": { "type": "integer", "maximum": 5.0, "minimum": 1.0, "title": "Max Follow Ups", "default": 1 }, "language": { "type": "string", "maxLength": 10, "minLength": 2, "title": "Language", "default": "en" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "interview_id", "role_title", "candidate_answer" ], "title": "FollowUpRequest", "description": "POST /api/v1/interviews/follow-up" }, "FollowUpResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "interview_id": { "type": "string", "title": "Interview Id" }, "should_follow_up": { "type": "boolean", "title": "Should Follow Up", "default": false }, "follow_ups": { "items": { "$ref": "#/components/schemas/FollowUpQuestion" }, "type": "array", "title": "Follow Ups" }, "next_action": { "type": "string", "title": "Next Action", "default": "continue" } }, "type": "object", "required": [ "interview_id" ], "title": "FollowUpResponse" }, "FollowUpRule": { "properties": { "question_id": { "type": "string", "title": "Question Id" }, "trigger": { "type": "string", "title": "Trigger" }, "follow_up_prompt": { "type": "string", "title": "Follow Up Prompt" }, "max_depth": { "type": "integer", "title": "Max Depth", "default": 1 } }, "type": "object", "required": [ "question_id", "trigger", "follow_up_prompt" ], "title": "FollowUpRule" }, "GeneratedOption": { "properties": { "key": { "type": "string", "title": "Key" }, "text": { "type": "string", "title": "Text" }, "is_correct": { "type": "boolean", "title": "Is Correct", "default": false } }, "type": "object", "required": [ "key", "text" ], "title": "GeneratedOption" }, "GeneratedQuestion": { "properties": { "id": { "type": "string", "title": "Id" }, "question_type": { "$ref": "#/components/schemas/QuestionType" }, "difficulty": { "$ref": "#/components/schemas/Difficulty" }, "stem": { "type": "string", "title": "Stem" }, "options": { "items": { "$ref": "#/components/schemas/GeneratedOption" }, "type": "array", "title": "Options" }, "answer": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Answer" }, "explanation": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Explanation" }, "metadata": { "additionalProperties": true, "type": "object", "title": "Metadata" } }, "type": "object", "required": [ "id", "question_type", "difficulty", "stem" ], "title": "GeneratedQuestion" }, "HighlightItem": { "properties": { "kind": { "type": "string", "title": "Kind" }, "text": { "type": "string", "title": "Text" }, "timestamp_ms": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Timestamp Ms" }, "turn_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Turn Id" } }, "type": "object", "required": [ "kind", "text" ], "title": "HighlightItem" }, "HiringFitRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "candidate_id": { "type": "string", "title": "Candidate Id" }, "role_title": { "type": "string", "title": "Role Title" }, "job_description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Job Description" }, "required_skills": { "items": { "type": "string" }, "type": "array", "title": "Required Skills" }, "resume_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Resume Text" }, "transcript": { "items": { "$ref": "#/components/schemas/TranscriptTurn" }, "type": "array", "title": "Transcript" }, "scorecard": { "additionalProperties": true, "type": "object", "title": "Scorecard" }, "language": { "type": "string", "maxLength": 10, "minLength": 2, "title": "Language", "default": "en" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "candidate_id", "role_title" ], "title": "HiringFitRequest", "description": "POST /api/v1/hiring-fit/predict" }, "HiringFitResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "candidate_id": { "type": "string", "title": "Candidate Id" }, "role_title": { "type": "string", "title": "Role Title" }, "hiring_fit_score": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Hiring Fit Score" }, "hiring_fit_label": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Hiring Fit Label" }, "passed": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Passed" }, "reasons": { "items": { "type": "string" }, "type": "array", "title": "Reasons" }, "risks": { "items": { "type": "string" }, "type": "array", "title": "Risks" }, "next_step": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Next Step" } }, "type": "object", "required": [ "candidate_id", "role_title" ], "title": "HiringFitResponse" }, "I18nTranslateRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "source_language": { "type": "string", "maxLength": 10, "minLength": 2, "title": "Source Language", "default": "en" }, "target_language": { "type": "string", "maxLength": 10, "minLength": 2, "title": "Target Language" }, "content_type": { "type": "string", "title": "Content Type", "description": "interview | questions | feedback | prep | assessment | ui_snippet", "default": "interview" }, "texts": { "items": { "type": "string" }, "type": "array", "minItems": 1, "title": "Texts" }, "cultural_sensitivity": { "type": "boolean", "title": "Cultural Sensitivity", "default": true }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "target_language", "texts" ], "title": "I18nTranslateRequest", "description": "POST /api/v1/i18n/translate" }, "I18nTranslateResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "source_language": { "type": "string", "title": "Source Language" }, "target_language": { "type": "string", "title": "Target Language" }, "translations": { "items": { "$ref": "#/components/schemas/TranslatedItem" }, "type": "array", "title": "Translations" } }, "type": "object", "required": [ "source_language", "target_language" ], "title": "I18nTranslateResponse" }, "IdVerificationRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "interview_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Interview Id" }, "candidate_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Candidate Id" }, "expected_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Expected Name" }, "id_image_base64": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Id Image Base64" }, "id_source_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Id Source Url" }, "id_country": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Id Country" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "title": "IdVerificationRequest", "description": "POST /api/v1/id-verification/verify" }, "IdVerificationResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "verified": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Verified" }, "extracted_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Extracted Name" }, "extracted_id_number": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Extracted Id Number" }, "document_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Document Type" }, "match_score": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Match Score" }, "warnings": { "items": { "type": "string" }, "type": "array", "title": "Warnings" } }, "type": "object", "title": "IdVerificationResponse" }, "InterviewHighlightsRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "interview_id": { "type": "string", "title": "Interview Id" }, "candidate_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Candidate Id" }, "role_title": { "type": "string", "title": "Role Title" }, "transcript": { "items": { "$ref": "#/components/schemas/TranscriptTurn" }, "type": "array", "title": "Transcript" }, "scorecard": { "additionalProperties": true, "type": "object", "title": "Scorecard" }, "language": { "type": "string", "maxLength": 10, "minLength": 2, "title": "Language", "default": "en" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "interview_id", "role_title" ], "title": "InterviewHighlightsRequest", "description": "POST /api/v1/interview-highlights/generate" }, "InterviewHighlightsResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "interview_id": { "type": "string", "title": "Interview Id" }, "strengths": { "items": { "$ref": "#/components/schemas/HighlightItem" }, "type": "array", "title": "Strengths" }, "weaknesses": { "items": { "$ref": "#/components/schemas/HighlightItem" }, "type": "array", "title": "Weaknesses" }, "flagged_responses": { "items": { "$ref": "#/components/schemas/HighlightItem" }, "type": "array", "title": "Flagged Responses" }, "summary_markdown": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Summary Markdown" } }, "type": "object", "required": [ "interview_id" ], "title": "InterviewHighlightsResponse" }, "InterviewMode": { "type": "string", "enum": [ "chat", "voice", "video" ], "title": "InterviewMode" }, "InterviewPreviewRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "role_title": { "type": "string", "title": "Role Title" }, "job_description": { "type": "string", "minLength": 20, "title": "Job Description" }, "persona": { "$ref": "#/components/schemas/Persona", "default": "technical" }, "count": { "type": "integer", "maximum": 40.0, "minimum": 1.0, "title": "Count", "default": 8 }, "question_types": { "items": { "$ref": "#/components/schemas/QuestionType" }, "type": "array", "title": "Question Types" }, "difficulty": { "$ref": "#/components/schemas/Difficulty", "default": "medium" }, "mandatory_topics": { "items": { "type": "string" }, "type": "array", "title": "Mandatory Topics" }, "custom_questions": { "items": { "type": "string" }, "type": "array", "title": "Custom Questions" }, "language": { "type": "string", "maxLength": 10, "minLength": 2, "title": "Language", "default": "en" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "role_title", "job_description" ], "title": "InterviewPreviewRequest", "description": "POST /api/v1/interview-preview/generate" }, "InterviewPreviewResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "preview_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Preview Id" }, "role_title": { "type": "string", "title": "Role Title" }, "persona": { "$ref": "#/components/schemas/Persona" }, "questions": { "items": { "$ref": "#/components/schemas/GeneratedQuestion" }, "type": "array", "title": "Questions" }, "follow_up_logic": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Follow Up Logic" }, "locked": { "type": "boolean", "title": "Locked", "default": false } }, "type": "object", "required": [ "role_title", "persona" ], "title": "InterviewPreviewResponse" }, "InterviewSummarizeRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "interview_id": { "type": "string", "title": "Interview Id" }, "role_title": { "type": "string", "title": "Role Title" }, "transcript": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Transcript" }, "scorecard": { "additionalProperties": true, "type": "object", "title": "Scorecard" }, "language": { "type": "string", "maxLength": 10, "minLength": 2, "title": "Language", "default": "en" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "interview_id", "role_title" ], "title": "InterviewSummarizeRequest", "description": "POST /api/v1/interviews/summarize" }, "InterviewSummarizeResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "interview_id": { "type": "string", "title": "Interview Id" }, "summary_markdown": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Summary Markdown" }, "key_takeaways": { "items": { "type": "string" }, "type": "array", "title": "Key Takeaways" }, "recommendation": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Recommendation" } }, "type": "object", "required": [ "interview_id" ], "title": "InterviewSummarizeResponse" }, "InterviewTrackRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "role_title": { "type": "string", "title": "Role Title" }, "niche": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Niche" }, "job_description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Job Description" }, "persona": { "$ref": "#/components/schemas/Persona", "default": "friendly_coach" }, "levels": { "items": { "type": "string" }, "type": "array", "title": "Levels" }, "questions_per_level": { "type": "integer", "maximum": 20.0, "minimum": 1.0, "title": "Questions Per Level", "default": 5 }, "language": { "type": "string", "maxLength": 10, "minLength": 2, "title": "Language", "default": "en" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "role_title" ], "title": "InterviewTrackRequest", "description": "POST /api/v1/interview-tracks/generate" }, "InterviewTrackResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "track_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Track Id" }, "role_title": { "type": "string", "title": "Role Title" }, "levels": { "items": { "$ref": "#/components/schemas/TrackLevel" }, "type": "array", "title": "Levels" } }, "type": "object", "required": [ "role_title" ], "title": "InterviewTrackResponse" }, "InterviewValidateLockRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "role_title": { "type": "string", "title": "Role Title" }, "questions": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "minItems": 1, "title": "Questions" }, "mandatory_question_ids": { "items": { "type": "string" }, "type": "array", "title": "Mandatory Question Ids" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "role_title", "questions" ], "title": "InterviewValidateLockRequest", "description": "POST /api/v1/interview-preview/validate-lock" }, "InterviewValidateLockResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "ready_to_lock": { "type": "boolean", "title": "Ready To Lock", "default": false }, "issues": { "items": { "type": "string" }, "type": "array", "title": "Issues" }, "warnings": { "items": { "type": "string" }, "type": "array", "title": "Warnings" } }, "type": "object", "title": "InterviewValidateLockResponse" }, "JdInclusivityRewriteRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "job_description": { "type": "string", "minLength": 20, "title": "Job Description" }, "role_title": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Role Title" }, "language": { "type": "string", "maxLength": 10, "minLength": 2, "title": "Language", "default": "en" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "job_description" ], "title": "JdInclusivityRewriteRequest", "description": "POST /api/v1/job-descriptions/inclusivity-rewrite" }, "JdInclusivityRewriteResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "original": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Original" }, "rewritten_markdown": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Rewritten Markdown" }, "removed_bias_phrases": { "items": { "type": "string" }, "type": "array", "title": "Removed Bias Phrases" }, "notes": { "items": { "type": "string" }, "type": "array", "title": "Notes" } }, "type": "object", "title": "JdInclusivityRewriteResponse" }, "JobDescriptionDraftRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "role_title": { "type": "string", "minLength": 1, "title": "Role Title", "examples": [ "Product Manager" ] }, "persona": { "$ref": "#/components/schemas/Persona", "default": "hr_behavioral" }, "seniority": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Seniority" }, "department": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Department" }, "employment_type": { "$ref": "#/components/schemas/EmploymentType", "default": "full_time" }, "location": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Location", "examples": [ "Remote - India" ] }, "must_have_skills": { "items": { "type": "string" }, "type": "array", "title": "Must Have Skills" }, "nice_to_have_skills": { "items": { "type": "string" }, "type": "array", "title": "Nice To Have Skills" }, "responsibilities": { "items": { "type": "string" }, "type": "array", "title": "Responsibilities", "description": "Optional seed bullets the draft should cover" }, "company_context": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Company Context", "description": "Company / team context for tone and scope" }, "tone_notes": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Tone Notes" }, "language": { "type": "string", "maxLength": 10, "minLength": 2, "title": "Language", "default": "en" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "role_title" ], "title": "JobDescriptionDraftRequest", "description": "POST /api/v1/job-descriptions/draft" }, "JobDescriptionDraftResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "role_title": { "type": "string", "title": "Role Title" }, "persona": { "$ref": "#/components/schemas/Persona" }, "prompt_preview": { "additionalProperties": { "type": "string" }, "type": "object", "title": "Prompt Preview" }, "title": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Title" }, "markdown": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Markdown" }, "sections": { "$ref": "#/components/schemas/JobDescriptionSections" } }, "type": "object", "required": [ "role_title", "persona" ], "title": "JobDescriptionDraftResponse" }, "JobDescriptionSections": { "properties": { "summary": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Summary" }, "responsibilities": { "items": { "type": "string" }, "type": "array", "title": "Responsibilities" }, "requirements": { "items": { "type": "string" }, "type": "array", "title": "Requirements" }, "nice_to_have": { "items": { "type": "string" }, "type": "array", "title": "Nice To Have" }, "benefits": { "items": { "type": "string" }, "type": "array", "title": "Benefits" } }, "type": "object", "title": "JobDescriptionSections" }, "JobMatchItem": { "properties": { "job_id": { "type": "string", "title": "Job Id" }, "title": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Title" }, "match_score": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Match Score" }, "reasons": { "items": { "type": "string" }, "type": "array", "title": "Reasons" }, "skill_overlap": { "items": { "type": "string" }, "type": "array", "title": "Skill Overlap" }, "gaps": { "items": { "type": "string" }, "type": "array", "title": "Gaps" } }, "type": "object", "required": [ "job_id" ], "title": "JobMatchItem" }, "JobMatchingRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "candidate_id": { "type": "string", "title": "Candidate Id" }, "resume_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Resume Text" }, "resume_structured": { "additionalProperties": true, "type": "object", "title": "Resume Structured" }, "skills": { "items": { "type": "string" }, "type": "array", "title": "Skills" }, "experience_years": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Experience Years" }, "interests": { "items": { "type": "string" }, "type": "array", "title": "Interests" }, "career_goals": { "items": { "type": "string" }, "type": "array", "title": "Career Goals" }, "preparation_history": { "additionalProperties": true, "type": "object", "title": "Preparation History" }, "job_catalog": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Job Catalog", "description": "Candidate job pool from Platform (id, title, jd, skills, ...)" }, "limit": { "type": "integer", "maximum": 50.0, "minimum": 1.0, "title": "Limit", "default": 10 }, "language": { "type": "string", "maxLength": 10, "minLength": 2, "title": "Language", "default": "en" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "candidate_id" ], "title": "JobMatchingRequest", "description": "POST /api/v1/job-matching/recommend" }, "JobMatchingResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "candidate_id": { "type": "string", "title": "Candidate Id" }, "recommendations": { "items": { "$ref": "#/components/schemas/JobMatchItem" }, "type": "array", "title": "Recommendations" } }, "type": "object", "required": [ "candidate_id" ], "title": "JobMatchingResponse" }, "JobStatus": { "type": "string", "enum": [ "accepted", "processing", "succeeded", "failed" ], "title": "JobStatus" }, "ManagerCloneRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "company_id": { "type": "string", "title": "Company Id" }, "manager_profile": { "additionalProperties": true, "type": "object", "title": "Manager Profile" }, "sample_questions": { "items": { "type": "string" }, "type": "array", "title": "Sample Questions" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "company_id" ], "title": "ManagerCloneRequest", "description": "POST /api/v1/manager-clone" }, "ManagerCloneResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "company_id": { "type": "string", "title": "Company Id" }, "clone_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Clone Id" }, "style_summary": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Style Summary" } }, "type": "object", "required": [ "company_id" ], "title": "ManagerCloneResponse" }, "MarketResearchRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "role_title": { "type": "string", "title": "Role Title" }, "industry": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Industry" }, "region": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Region" }, "count": { "type": "integer", "maximum": 20.0, "minimum": 1.0, "title": "Count", "default": 5 }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "role_title" ], "title": "MarketResearchRequest", "description": "POST /api/v1/market-research/questions" }, "MarketResearchResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "role_title": { "type": "string", "title": "Role Title" }, "questions": { "items": { "type": "string" }, "type": "array", "title": "Questions" }, "sources": { "items": { "type": "string" }, "type": "array", "title": "Sources" } }, "type": "object", "required": [ "role_title" ], "title": "MarketResearchResponse" }, "MergeCustomQuestionsRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "role_title": { "type": "string", "title": "Role Title" }, "existing_questions": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Existing Questions" }, "custom_questions": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "minItems": 1, "title": "Custom Questions" }, "mandatory_question_ids": { "items": { "type": "string" }, "type": "array", "title": "Mandatory Question Ids" }, "language": { "type": "string", "maxLength": 10, "minLength": 2, "title": "Language", "default": "en" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "role_title", "custom_questions" ], "title": "MergeCustomQuestionsRequest", "description": "POST /api/v1/interview-preview/merge-custom-questions" }, "MergeCustomQuestionsResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "questions": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Questions" }, "mandatory_question_ids": { "items": { "type": "string" }, "type": "array", "title": "Mandatory Question Ids" }, "added_count": { "type": "integer", "title": "Added Count", "default": 0 } }, "type": "object", "title": "MergeCustomQuestionsResponse" }, "NextQuestionRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "interview_id": { "type": "string", "title": "Interview Id" }, "role_title": { "type": "string", "title": "Role Title" }, "job_description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Job Description" }, "persona": { "$ref": "#/components/schemas/Persona", "default": "technical" }, "planned_questions": { "items": { "type": "string" }, "type": "array", "title": "Planned Questions" }, "asked_question_ids": { "items": { "type": "string" }, "type": "array", "title": "Asked Question Ids" }, "transcript": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Transcript" }, "last_score": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Last Score" }, "language": { "type": "string", "maxLength": 10, "minLength": 2, "title": "Language", "default": "en" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "interview_id", "role_title" ], "title": "NextQuestionRequest", "description": "POST /api/v1/interviews/next-question" }, "NextQuestionResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "interview_id": { "type": "string", "title": "Interview Id" }, "question_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Question Id" }, "question_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Question Text" }, "rationale": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Rationale" }, "done": { "type": "boolean", "title": "Done", "default": false } }, "type": "object", "required": [ "interview_id" ], "title": "NextQuestionResponse" }, "PanelistNotesRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "interview_id": { "type": "string", "title": "Interview Id" }, "candidate_id": { "type": "string", "title": "Candidate Id" }, "role_title": { "type": "string", "title": "Role Title" }, "scorecard": { "additionalProperties": true, "type": "object", "title": "Scorecard" }, "transcript_excerpt": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Transcript Excerpt" }, "recruiter_annotations": { "items": { "type": "string" }, "type": "array", "title": "Recruiter Annotations" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "interview_id", "candidate_id", "role_title" ], "title": "PanelistNotesRequest", "description": "POST /api/v1/reports/panelist-notes" }, "PanelistNotesResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "interview_id": { "type": "string", "title": "Interview Id" }, "notes_markdown": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Notes Markdown" }, "highlights": { "items": { "type": "string" }, "type": "array", "title": "Highlights" }, "risks": { "items": { "type": "string" }, "type": "array", "title": "Risks" }, "recommendation": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Recommendation" } }, "type": "object", "required": [ "interview_id" ], "title": "PanelistNotesResponse" }, "ParseTarget": { "type": "string", "enum": [ "raw_text", "structured_qa", "rubric", "syllabus", "resume", "job_description" ], "title": "ParseTarget" }, "ParsedBlock": { "properties": { "block_id": { "type": "string", "title": "Block Id" }, "block_type": { "type": "string", "title": "Block Type", "default": "paragraph" }, "text": { "type": "string", "title": "Text" }, "page": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Page" }, "metadata": { "additionalProperties": true, "type": "object", "title": "Metadata" } }, "type": "object", "required": [ "block_id", "text" ], "title": "ParsedBlock" }, "Persona": { "type": "string", "enum": [ "technical", "hr_behavioral", "friendly_coach", "executive", "sales", "healthcare", "finance", "custom" ], "title": "Persona", "description": "AI interviewer personas from the SOW." }, "PersonaInfo": { "properties": { "id": { "$ref": "#/components/schemas/Persona" }, "label": { "type": "string", "title": "Label" }, "description": { "type": "string", "title": "Description" } }, "type": "object", "required": [ "id", "label", "description" ], "title": "PersonaInfo" }, "PersonaListResponse": { "properties": { "personas": { "items": { "$ref": "#/components/schemas/PersonaInfo" }, "type": "array", "title": "Personas" } }, "type": "object", "title": "PersonaListResponse" }, "PrepPlanRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "candidate_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Candidate Id" }, "role_title": { "type": "string", "minLength": 1, "title": "Role Title" }, "job_description": { "type": "string", "minLength": 20, "title": "Job Description" }, "resume_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Resume Text" }, "resume_structured": { "additionalProperties": true, "type": "object", "title": "Resume Structured" }, "target_level": { "type": "string", "title": "Target Level", "default": "intermediate" }, "focus_skills": { "items": { "type": "string" }, "type": "array", "title": "Focus Skills" }, "language": { "type": "string", "maxLength": 10, "minLength": 2, "title": "Language", "default": "en" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "role_title", "job_description" ], "title": "PrepPlanRequest", "description": "POST /api/v1/prep-plans/generate" }, "PrepPlanResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "candidate_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Candidate Id" }, "role_title": { "type": "string", "title": "Role Title" }, "plan_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Plan Id" }, "summary": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Summary" }, "skill_gaps": { "items": { "type": "string" }, "type": "array", "title": "Skill Gaps" }, "sections": { "items": { "$ref": "#/components/schemas/PrepPlanSection" }, "type": "array", "title": "Sections" }, "suggested_tracks": { "items": { "type": "string" }, "type": "array", "title": "Suggested Tracks" } }, "type": "object", "required": [ "role_title" ], "title": "PrepPlanResponse" }, "PrepPlanSection": { "properties": { "title": { "type": "string", "title": "Title" }, "items": { "items": { "type": "string" }, "type": "array", "title": "Items" }, "estimated_hours": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Estimated Hours" } }, "type": "object", "required": [ "title" ], "title": "PrepPlanSection" }, "ProctoringAnalyzeRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "interview_id": { "type": "string", "title": "Interview Id" }, "candidate_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Candidate Id" }, "events": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Events", "description": "tab_switch, blur, multi_face, copy_paste, idle, etc." }, "duration_seconds": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Duration Seconds" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "interview_id" ], "title": "ProctoringAnalyzeRequest", "description": "POST /api/v1/proctoring/analyze" }, "ProctoringAnalyzeResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "interview_id": { "type": "string", "title": "Interview Id" }, "risk_score": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Risk Score" }, "integrity_passed": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Integrity Passed" }, "flags": { "items": { "$ref": "#/components/schemas/ProctoringFlag" }, "type": "array", "title": "Flags" }, "recommendation": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Recommendation" } }, "type": "object", "required": [ "interview_id" ], "title": "ProctoringAnalyzeResponse" }, "ProctoringFlag": { "properties": { "event_type": { "type": "string", "title": "Event Type" }, "severity": { "type": "string", "title": "Severity", "default": "low" }, "count": { "type": "integer", "title": "Count", "default": 1 }, "notes": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Notes" } }, "type": "object", "required": [ "event_type" ], "title": "ProctoringFlag" }, "ProgressAnalyticsRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "candidate_id": { "type": "string", "title": "Candidate Id" }, "role_title": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Role Title" }, "mock_history": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Mock History", "description": "Prior mock sessions: score, date, skills, mode" }, "assessment_history": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Assessment History" }, "prep_history": { "additionalProperties": true, "type": "object", "title": "Prep History" }, "language": { "type": "string", "maxLength": 10, "minLength": 2, "title": "Language", "default": "en" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "candidate_id" ], "title": "ProgressAnalyticsRequest", "description": "POST /api/v1/progress-analytics/analyze" }, "ProgressAnalyticsResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "candidate_id": { "type": "string", "title": "Candidate Id" }, "readiness_score": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Readiness Score" }, "trend": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Trend" }, "skill_trends": { "additionalProperties": true, "type": "object", "title": "Skill Trends" }, "strengths": { "items": { "type": "string" }, "type": "array", "title": "Strengths" }, "focus_areas": { "items": { "type": "string" }, "type": "array", "title": "Focus Areas" }, "summary_markdown": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Summary Markdown" } }, "type": "object", "required": [ "candidate_id" ], "title": "ProgressAnalyticsResponse" }, "PuzzleGenerateRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "puzzle_type": { "type": "string", "title": "Puzzle Type", "description": "logic | pattern | riddle | spatial | numerical", "default": "logic" }, "role_title": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Role Title" }, "difficulty": { "$ref": "#/components/schemas/Difficulty", "default": "medium" }, "count": { "type": "integer", "maximum": 30.0, "minimum": 1.0, "title": "Count", "default": 5 }, "time_limit_minutes": { "type": "integer", "maximum": 120.0, "minimum": 5.0, "title": "Time Limit Minutes", "default": 20 }, "language": { "type": "string", "maxLength": 10, "minLength": 2, "title": "Language", "default": "en" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "title": "PuzzleGenerateRequest", "description": "POST /api/v1/puzzles/generate" }, "PuzzleGenerateResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "puzzle_set_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Puzzle Set Id" }, "puzzle_type": { "type": "string", "title": "Puzzle Type" }, "time_limit_minutes": { "type": "integer", "title": "Time Limit Minutes" }, "puzzles": { "items": { "$ref": "#/components/schemas/GeneratedQuestion" }, "type": "array", "title": "Puzzles" } }, "type": "object", "required": [ "puzzle_type", "time_limit_minutes" ], "title": "PuzzleGenerateResponse" }, "PuzzleGradeRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "puzzle_set_id": { "type": "string", "title": "Puzzle Set Id" }, "answers": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "minItems": 1, "title": "Answers" }, "time_taken_seconds": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Time Taken Seconds" }, "language": { "type": "string", "maxLength": 10, "minLength": 2, "title": "Language", "default": "en" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "puzzle_set_id", "answers" ], "title": "PuzzleGradeRequest", "description": "POST /api/v1/puzzles/grade" }, "PuzzleGradeResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "puzzle_set_id": { "type": "string", "title": "Puzzle Set Id" }, "total_score": { "type": "number", "title": "Total Score", "default": 0.0 }, "max_total_score": { "type": "number", "title": "Max Total Score", "default": 0.0 }, "passed": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Passed" }, "feedback_markdown": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Feedback Markdown" }, "item_results": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Item Results" } }, "type": "object", "required": [ "puzzle_set_id" ], "title": "PuzzleGradeResponse" }, "QuestionGenRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id", "description": "Caller correlation id for tracing across Platform services" }, "subject": { "type": "string", "minLength": 1, "title": "Subject", "examples": [ "Mathematics" ] }, "topic": { "type": "string", "minLength": 1, "title": "Topic", "examples": [ "Algebra" ] }, "question_type": { "$ref": "#/components/schemas/QuestionType", "default": "mcq" }, "difficulty": { "$ref": "#/components/schemas/Difficulty", "default": "medium" }, "count": { "type": "integer", "maximum": 50.0, "minimum": 1.0, "title": "Count", "default": 5 }, "language": { "type": "string", "maxLength": 10, "minLength": 2, "title": "Language", "default": "en" }, "context": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Context", "description": "Optional source text / syllabus excerpt to ground generation" }, "constraints": { "additionalProperties": true, "type": "object", "title": "Constraints", "description": "Platform-specific knobs (bloom_level, include_explanation, etc.)" } }, "type": "object", "required": [ "subject", "topic" ], "title": "QuestionGenRequest", "description": "POST /api/v1/questions/generate" }, "QuestionGenResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "questions": { "items": { "$ref": "#/components/schemas/GeneratedQuestion" }, "type": "array", "title": "Questions" } }, "type": "object", "title": "QuestionGenResponse" }, "QuestionType": { "type": "string", "enum": [ "mcq", "short_answer", "long_answer", "true_false", "coding" ], "title": "QuestionType" }, "RankedCandidate": { "properties": { "candidate_id": { "type": "string", "title": "Candidate Id" }, "rank": { "type": "integer", "title": "Rank" }, "scout_score": { "type": "number", "title": "Scout Score" }, "rationale": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Rationale" }, "matched_skills": { "items": { "type": "string" }, "type": "array", "title": "Matched Skills" } }, "type": "object", "required": [ "candidate_id", "rank", "scout_score" ], "title": "RankedCandidate" }, "ReferenceQuestion": { "properties": { "id": { "type": "string", "title": "Id" }, "text": { "type": "string", "title": "Text" }, "category": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Category" } }, "type": "object", "required": [ "id", "text" ], "title": "ReferenceQuestion" }, "ReferenceQuestionnaireRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "candidate_id": { "type": "string", "title": "Candidate Id" }, "role_title": { "type": "string", "title": "Role Title" }, "job_description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Job Description" }, "referee_relationship": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Referee Relationship", "description": "manager | peer | report | client" }, "count": { "type": "integer", "maximum": 20.0, "minimum": 3.0, "title": "Count", "default": 8 }, "language": { "type": "string", "maxLength": 10, "minLength": 2, "title": "Language", "default": "en" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "candidate_id", "role_title" ], "title": "ReferenceQuestionnaireRequest", "description": "POST /api/v1/reference-checks/questionnaire" }, "ReferenceQuestionnaireResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "candidate_id": { "type": "string", "title": "Candidate Id" }, "questionnaire_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Questionnaire Id" }, "questions": { "items": { "$ref": "#/components/schemas/ReferenceQuestion" }, "type": "array", "title": "Questions" } }, "type": "object", "required": [ "candidate_id" ], "title": "ReferenceQuestionnaireResponse" }, "ReferenceReportRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "candidate_id": { "type": "string", "title": "Candidate Id" }, "role_title": { "type": "string", "title": "Role Title" }, "referee_responses": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "minItems": 1, "title": "Referee Responses" }, "language": { "type": "string", "maxLength": 10, "minLength": 2, "title": "Language", "default": "en" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "candidate_id", "role_title", "referee_responses" ], "title": "ReferenceReportRequest", "description": "POST /api/v1/reference-checks/report" }, "ReferenceReportResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "candidate_id": { "type": "string", "title": "Candidate Id" }, "report_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Report Id" }, "sentiment_summary": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Sentiment Summary" }, "strengths": { "items": { "type": "string" }, "type": "array", "title": "Strengths" }, "concerns": { "items": { "type": "string" }, "type": "array", "title": "Concerns" }, "recommendation": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Recommendation" }, "report_markdown": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Report Markdown" } }, "type": "object", "required": [ "candidate_id" ], "title": "ReferenceReportResponse" }, "RegenerateQuestionRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "preview_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Preview Id" }, "role_title": { "type": "string", "title": "Role Title" }, "job_description": { "type": "string", "minLength": 20, "title": "Job Description" }, "persona": { "$ref": "#/components/schemas/Persona", "default": "technical" }, "question_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Question Id" }, "previous_stem": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Previous Stem" }, "question_type": { "$ref": "#/components/schemas/QuestionType", "default": "short_answer" }, "difficulty": { "$ref": "#/components/schemas/Difficulty", "default": "medium" }, "instructions": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Instructions" }, "language": { "type": "string", "maxLength": 10, "minLength": 2, "title": "Language", "default": "en" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "role_title", "job_description" ], "title": "RegenerateQuestionRequest", "description": "POST /api/v1/interview-preview/regenerate-question" }, "RegenerateQuestionResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "question": { "anyOf": [ { "$ref": "#/components/schemas/GeneratedQuestion" }, { "type": "null" } ] } }, "type": "object", "title": "RegenerateQuestionResponse" }, "ResumeMatchRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "candidate_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Candidate Id" }, "role_title": { "type": "string", "title": "Role Title" }, "job_description": { "type": "string", "minLength": 20, "title": "Job Description" }, "resume_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Resume Text" }, "resume_structured": { "additionalProperties": true, "type": "object", "title": "Resume Structured" }, "required_skills": { "items": { "type": "string" }, "type": "array", "title": "Required Skills" }, "language": { "type": "string", "maxLength": 10, "minLength": 2, "title": "Language", "default": "en" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "role_title", "job_description" ], "title": "ResumeMatchRequest", "description": "POST /api/v1/resume-match/score" }, "ResumeMatchResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "candidate_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Candidate Id" }, "role_title": { "type": "string", "title": "Role Title" }, "match_score": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Match Score" }, "screen_passed": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Screen Passed" }, "matched_skills": { "items": { "type": "string" }, "type": "array", "title": "Matched Skills" }, "missing_skills": { "items": { "type": "string" }, "type": "array", "title": "Missing Skills" }, "summary": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Summary" } }, "type": "object", "required": [ "role_title" ], "title": "ResumeMatchResponse" }, "RoleQuestionGenRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "role_title": { "type": "string", "minLength": 1, "title": "Role Title", "examples": [ "Senior Backend Engineer" ] }, "job_description": { "type": "string", "minLength": 20, "title": "Job Description", "description": "Full or partial JD used to ground question generation" }, "persona": { "$ref": "#/components/schemas/Persona", "default": "technical" }, "seniority": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Seniority", "examples": [ "senior" ] }, "department": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Department", "examples": [ "Engineering" ] }, "skills": { "items": { "type": "string" }, "type": "array", "title": "Skills", "description": "Optional skill focus list; derived from JD when empty" }, "question_types": { "items": { "$ref": "#/components/schemas/QuestionType" }, "type": "array", "title": "Question Types" }, "difficulty": { "$ref": "#/components/schemas/Difficulty", "default": "medium" }, "count": { "type": "integer", "maximum": 50.0, "minimum": 1.0, "title": "Count", "default": 8 }, "language": { "type": "string", "maxLength": 10, "minLength": 2, "title": "Language", "default": "en" }, "instructions": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Instructions", "description": "Extra interviewer guidance (e.g. include system-design deep dive)" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "role_title", "job_description" ], "title": "RoleQuestionGenRequest", "description": "POST /api/v1/questions/from-role" }, "RoleQuestionGenResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "role_title": { "type": "string", "title": "Role Title" }, "persona": { "$ref": "#/components/schemas/Persona" }, "prompt_preview": { "additionalProperties": { "type": "string" }, "type": "object", "title": "Prompt Preview", "description": "Rendered persona prompt templates used for this request" }, "questions": { "items": { "$ref": "#/components/schemas/GeneratedQuestion" }, "type": "array", "title": "Questions" } }, "type": "object", "required": [ "role_title", "persona" ], "title": "RoleQuestionGenResponse" }, "ScenarioGenerateRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "role_title": { "type": "string", "title": "Role Title" }, "job_description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Job Description" }, "difficulty": { "$ref": "#/components/schemas/Difficulty", "default": "medium" }, "count": { "type": "integer", "maximum": 10.0, "minimum": 1.0, "title": "Count", "default": 3 }, "language": { "type": "string", "maxLength": 10, "minLength": 2, "title": "Language", "default": "en" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "role_title" ], "title": "ScenarioGenerateRequest", "description": "POST /api/v1/scenarios/generate" }, "ScenarioGenerateResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "scenario_set_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Scenario Set Id" }, "scenarios": { "items": { "$ref": "#/components/schemas/GeneratedQuestion" }, "type": "array", "title": "Scenarios" } }, "type": "object", "title": "ScenarioGenerateResponse" }, "ScenarioGradeRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "scenario_set_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Scenario Set Id" }, "role_title": { "type": "string", "title": "Role Title" }, "answers": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "minItems": 1, "title": "Answers" }, "language": { "type": "string", "maxLength": 10, "minLength": 2, "title": "Language", "default": "en" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "role_title", "answers" ], "title": "ScenarioGradeRequest", "description": "POST /api/v1/scenarios/grade" }, "ScenarioGradeResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "total_score": { "type": "number", "title": "Total Score", "default": 0.0 }, "max_total_score": { "type": "number", "title": "Max Total Score", "default": 100.0 }, "passed": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Passed" }, "feedback_markdown": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Feedback Markdown" } }, "type": "object", "title": "ScenarioGradeResponse" }, "ScoreBreakdown": { "properties": { "criterion": { "type": "string", "title": "Criterion" }, "score": { "type": "number", "title": "Score" }, "max_score": { "type": "number", "title": "Max Score" }, "comment": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Comment" } }, "type": "object", "required": [ "criterion", "score", "max_score" ], "title": "ScoreBreakdown" }, "ScorecardCriterion": { "properties": { "id": { "type": "string", "title": "Id" }, "name": { "type": "string", "title": "Name" }, "weight": { "type": "number", "title": "Weight", "default": 1.0 }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description" } }, "type": "object", "required": [ "id", "name" ], "title": "ScorecardCriterion" }, "ScorecardGenerateRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "role_title": { "type": "string", "title": "Role Title" }, "job_description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Job Description" }, "persona": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Persona" }, "criteria_hints": { "items": { "type": "string" }, "type": "array", "title": "Criteria Hints" }, "language": { "type": "string", "maxLength": 10, "minLength": 2, "title": "Language", "default": "en" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "role_title" ], "title": "ScorecardGenerateRequest", "description": "POST /api/v1/scorecards/generate" }, "ScorecardGenerateResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "role_title": { "type": "string", "title": "Role Title" }, "scorecard_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Scorecard Id" }, "criteria": { "items": { "$ref": "#/components/schemas/ScorecardCriterion" }, "type": "array", "title": "Criteria" } }, "type": "object", "required": [ "role_title" ], "title": "ScorecardGenerateResponse" }, "ScoutCandidate": { "properties": { "candidate_id": { "type": "string", "title": "Candidate Id" }, "skills": { "items": { "type": "string" }, "type": "array", "title": "Skills" }, "niche": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Niche" }, "interview_pass_rate": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Interview Pass Rate" }, "task_score": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Task Score" }, "badge_count": { "type": "integer", "title": "Badge Count", "default": 0 }, "assessment_scores": { "additionalProperties": { "type": "number" }, "type": "object", "title": "Assessment Scores" }, "metadata": { "additionalProperties": true, "type": "object", "title": "Metadata" } }, "type": "object", "required": [ "candidate_id" ], "title": "ScoutCandidate" }, "SkillGapAnalyzeRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "candidate_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Candidate Id" }, "role_title": { "type": "string", "title": "Role Title" }, "job_description": { "type": "string", "minLength": 20, "title": "Job Description" }, "resume_text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Resume Text" }, "resume_structured": { "additionalProperties": true, "type": "object", "title": "Resume Structured" }, "required_skills": { "items": { "type": "string" }, "type": "array", "title": "Required Skills" }, "demonstrated_skills": { "items": { "type": "string" }, "type": "array", "title": "Demonstrated Skills" }, "interview_answers": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Interview Answers" }, "language": { "type": "string", "maxLength": 10, "minLength": 2, "title": "Language", "default": "en" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "role_title", "job_description" ], "title": "SkillGapAnalyzeRequest", "description": "POST /api/v1/skill-gap/analyze" }, "SkillGapAnalyzeResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "candidate_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Candidate Id" }, "role_title": { "type": "string", "title": "Role Title" }, "overall_readiness": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Overall Readiness" }, "gaps": { "items": { "$ref": "#/components/schemas/app__schemas__skill_gap__SkillGapItem" }, "type": "array", "title": "Gaps" }, "strengths": { "items": { "type": "string" }, "type": "array", "title": "Strengths" }, "recommended_prep_focus": { "items": { "type": "string" }, "type": "array", "title": "Recommended Prep Focus" } }, "type": "object", "required": [ "role_title" ], "title": "SkillGapAnalyzeResponse" }, "TalentScoutRankRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "role_title": { "type": "string", "title": "Role Title" }, "job_description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Job Description" }, "required_skills": { "items": { "type": "string" }, "type": "array", "title": "Required Skills" }, "niche": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Niche" }, "candidates": { "items": { "$ref": "#/components/schemas/ScoutCandidate" }, "type": "array", "minItems": 1, "title": "Candidates" }, "top_k": { "type": "integer", "maximum": 100.0, "minimum": 1.0, "title": "Top K", "default": 20 }, "language": { "type": "string", "maxLength": 10, "minLength": 2, "title": "Language", "default": "en" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "role_title", "candidates" ], "title": "TalentScoutRankRequest", "description": "POST /api/v1/talent-scouting/rank" }, "TalentScoutRankResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "role_title": { "type": "string", "title": "Role Title" }, "ranked": { "items": { "$ref": "#/components/schemas/RankedCandidate" }, "type": "array", "title": "Ranked" } }, "type": "object", "required": [ "role_title" ], "title": "TalentScoutRankResponse" }, "TrackLevel": { "properties": { "level": { "type": "string", "title": "Level" }, "badge_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Badge Name" }, "questions": { "items": { "$ref": "#/components/schemas/GeneratedQuestion" }, "type": "array", "title": "Questions" }, "passing_score": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Passing Score", "default": 0.7 } }, "type": "object", "required": [ "level" ], "title": "TrackLevel" }, "TranscriptSegment": { "properties": { "start_ms": { "type": "integer", "title": "Start Ms" }, "end_ms": { "type": "integer", "title": "End Ms" }, "speaker": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Speaker" }, "text": { "type": "string", "title": "Text" }, "confidence": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Confidence" } }, "type": "object", "required": [ "start_ms", "end_ms", "text" ], "title": "TranscriptSegment" }, "TranscriptTurn": { "properties": { "turn_id": { "type": "string", "title": "Turn Id" }, "role": { "type": "string", "title": "Role", "description": "interviewer | candidate" }, "text": { "type": "string", "title": "Text" }, "timestamp_ms": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Timestamp Ms" } }, "type": "object", "required": [ "turn_id", "role", "text" ], "title": "TranscriptTurn" }, "TranscriptionProvider": { "type": "string", "enum": [ "whisper", "stub" ], "title": "TranscriptionProvider" }, "TranscriptionRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "interview_id": { "type": "string", "title": "Interview Id" }, "provider": { "$ref": "#/components/schemas/TranscriptionProvider", "default": "whisper" }, "audio_base64": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Audio Base64" }, "source_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source Url" }, "language": { "type": "string", "maxLength": 10, "minLength": 2, "title": "Language", "default": "en" }, "diarize": { "type": "boolean", "title": "Diarize", "default": false }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "interview_id" ], "title": "TranscriptionRequest", "description": "POST /api/v1/transcription" }, "TranscriptionResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "interview_id": { "type": "string", "title": "Interview Id" }, "provider": { "$ref": "#/components/schemas/TranscriptionProvider" }, "text": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Text" }, "segments": { "items": { "$ref": "#/components/schemas/TranscriptSegment" }, "type": "array", "title": "Segments" } }, "type": "object", "required": [ "interview_id", "provider" ], "title": "TranscriptionResponse" }, "TranslatedItem": { "properties": { "source": { "type": "string", "title": "Source" }, "translated": { "type": "string", "title": "Translated" }, "notes": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Notes" } }, "type": "object", "required": [ "source", "translated" ], "title": "TranslatedItem" }, "TtsSynthesizeRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "text": { "type": "string", "maxLength": 4000, "minLength": 1, "title": "Text" }, "voice_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Voice Id" }, "voice_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Voice Name" }, "language": { "type": "string", "maxLength": 10, "minLength": 2, "title": "Language", "default": "en" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "text" ], "title": "TtsSynthesizeRequest", "description": "POST /api/v1/tts/synthesize — AI interviewer speech." }, "TtsSynthesizeResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "audio_base64": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Audio Base64" }, "mime_type": { "type": "string", "title": "Mime Type", "default": "audio/mpeg" }, "voice_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Voice Id" }, "provider": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Provider" } }, "type": "object", "title": "TtsSynthesizeResponse" }, "VideoIntelligenceRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "interview_id": { "type": "string", "title": "Interview Id" }, "video_base64": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Video Base64" }, "source_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source Url" }, "sample_fps": { "type": "number", "maximum": 5.0, "minimum": 0.1, "title": "Sample Fps", "default": 1.0 }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "interview_id" ], "title": "VideoIntelligenceRequest", "description": "POST /api/v1/video-intelligence" }, "VideoIntelligenceResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "interview_id": { "type": "string", "title": "Interview Id" }, "engagement_score": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Engagement Score" }, "signals": { "items": { "$ref": "#/components/schemas/VideoSignal" }, "type": "array", "title": "Signals" }, "warnings": { "items": { "type": "string" }, "type": "array", "title": "Warnings" } }, "type": "object", "required": [ "interview_id" ], "title": "VideoIntelligenceResponse" }, "VideoSignal": { "properties": { "name": { "type": "string", "title": "Name" }, "score": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Score" }, "notes": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Notes" } }, "type": "object", "required": [ "name" ], "title": "VideoSignal" }, "VoiceCloneRequest": { "properties": { "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "company_id": { "type": "string", "title": "Company Id" }, "voice_name": { "type": "string", "title": "Voice Name" }, "sample_audio_base64": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Sample Audio Base64" }, "sample_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Sample Url" }, "options": { "additionalProperties": true, "type": "object", "title": "Options" } }, "type": "object", "required": [ "company_id", "voice_name" ], "title": "VoiceCloneRequest", "description": "POST /api/v1/voice-cloning" }, "VoiceCloneResponse": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "status": { "$ref": "#/components/schemas/JobStatus", "default": "succeeded" }, "stub": { "type": "boolean", "title": "Stub", "default": false }, "message": { "type": "string", "title": "Message", "default": "OK" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "correlation_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Correlation Id" }, "company_id": { "type": "string", "title": "Company Id" }, "voice_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Voice Id" }, "status_detail": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Status Detail" } }, "type": "object", "required": [ "company_id" ], "title": "VoiceCloneResponse" }, "app__schemas__candidate_scoring__SkillGapItem": { "properties": { "skill": { "type": "string", "title": "Skill" }, "required_level": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Required Level" }, "demonstrated_level": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Demonstrated Level" }, "gap": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Gap" }, "evidence": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Evidence" } }, "type": "object", "required": [ "skill" ], "title": "SkillGapItem" }, "app__schemas__skill_gap__SkillGapItem": { "properties": { "skill": { "type": "string", "title": "Skill" }, "required_level": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Required Level" }, "demonstrated_level": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Demonstrated Level" }, "gap": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Gap" }, "priority": { "type": "string", "title": "Priority", "default": "medium" }, "learning_suggestions": { "items": { "type": "string" }, "type": "array", "title": "Learning Suggestions" }, "evidence": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Evidence" } }, "type": "object", "required": [ "skill" ], "title": "SkillGapItem" } }, "securitySchemes": { "InternalToken": { "type": "apiKey", "in": "header", "name": "X-Internal-Token", "description": "Shared secret from `.env` → INTERNAL_API_TOKEN. Required on all routes except /health and /ready." } } }, "servers": [ { "url": "http://localhost:8000", "description": "Local AI Gateway (default README port)" }, { "url": "http://localhost:8001", "description": "Local AI Gateway (alternate port)" } ], "security": [ { "InternalToken": [] } ] }