{"openapi":"3.1.0","info":{"title":"FastAPI","version":"0.1.0"},"paths":{"/parse-resume/fast/v2":{"post":{"summary":"Parse Resume Fast V2","description":"Parse a resume without an LLM: the /parse-resume response, from the\nresume's layout. The next version of /resume-parse/fast, built and\nchanged on its own; for now it parses as /resume-parse/fast does.","operationId":"parse_resume_fast_v2_parse_resume_fast_v2_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_parse_resume_fast_v2_parse_resume_fast_v2_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/resume-parse/fast/v2":{"post":{"summary":"Parse Resume Fast V2","description":"Parse a resume without an LLM: the /parse-resume response, from the\nresume's layout. The next version of /resume-parse/fast, built and\nchanged on its own; for now it parses as /resume-parse/fast does.","operationId":"parse_resume_fast_v2_resume_parse_fast_v2_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_parse_resume_fast_v2_resume_parse_fast_v2_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/parse-resume/layout":{"post":{"summary":"Parse Resume Layout","description":"Parse a resume from its layout, without an LLM: candidate (name, emails, phones),\nexperience, education and skills, each with its boxes on the page, plus the\nsections and every tagged field. type=tallite returns it in /parse-resume's shape.","operationId":"parse_resume_layout_parse_resume_layout_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_parse_resume_layout_parse_resume_layout_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/resume-parse/layout":{"post":{"summary":"Parse Resume Layout","description":"Parse a resume from its layout, without an LLM: candidate (name, emails, phones),\nexperience, education and skills, each with its boxes on the page, plus the\nsections and every tagged field. type=tallite returns it in /parse-resume's shape.","operationId":"parse_resume_layout_resume_parse_layout_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_parse_resume_layout_resume_parse_layout_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/resume-redact/layout":{"post":{"summary":"Redact Resume Layout","description":"The resume with the requested fields blacked out, as a PDF. The layout parser finds\neach value and its place on the page; every other place the same value is written is\nfound too. The text under each box is removed from the file (not just covered), image\npixels under it are blanked, and the file's metadata is cleared. Word, RTF, ODT and\ntext files are converted to PDF first and the PDF is returned.","operationId":"redact_resume_layout_resume_redact_layout_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_redact_resume_layout_resume_redact_layout_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/redact-resume/layout":{"post":{"summary":"Redact Resume Layout","description":"The resume with the requested fields blacked out, as a PDF. The layout parser finds\neach value and its place on the page; every other place the same value is written is\nfound too. The text under each box is removed from the file (not just covered), image\npixels under it are blanked, and the file's metadata is cleared. Word, RTF, ODT and\ntext files are converted to PDF first and the PDF is returned.","operationId":"redact_resume_layout_redact_resume_layout_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_redact_resume_layout_redact_resume_layout_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/document-triage":{"post":{"summary":"Document Triage One","description":"Classify a document before parsing it: difficulty (easy/medium/hard),\nlayout (single_column/double_column/image), language and page count.\n\nSort a batch ascending by difficulty_score to run the cheap files first.\n\"signals\" carries every number the score was built from.","operationId":"document_triage_one_api_document_triage_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_document_triage_one_api_document_triage_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/document-triage":{"post":{"summary":"Document Triage One","description":"Classify a document before parsing it: difficulty (easy/medium/hard),\nlayout (single_column/double_column/image), language and page count.\n\nSort a batch ascending by difficulty_score to run the cheap files first.\n\"signals\" carries every number the score was built from.","operationId":"document_triage_one_document_triage_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_document_triage_one_document_triage_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/document-triage/batch":{"post":{"summary":"Document Triage Batch","description":"Triage a folder of documents in one call and get them back sorted easiest\nfirst -- the order to parse them in.\n\n\"results\" is sorted ascending by difficulty_score; \"counts\" totals the\ndifficulties, layouts and languages seen. A file that cannot be read comes\nback \"hard\" with the reason, so one bad file never fails the batch.","operationId":"document_triage_batch_api_document_triage_batch_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_document_triage_batch_api_document_triage_batch_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/document-triage/batch":{"post":{"summary":"Document Triage Batch","description":"Triage a folder of documents in one call and get them back sorted easiest\nfirst -- the order to parse them in.\n\n\"results\" is sorted ascending by difficulty_score; \"counts\" totals the\ndifficulties, layouts and languages seen. A file that cannot be read comes\nback \"hard\" with the reason, so one bad file never fails the batch.","operationId":"document_triage_batch_document_triage_batch_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_document_triage_batch_document_triage_batch_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/":{"get":{"summary":"Root","operationId":"root__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/auth/fileconversion":{"post":{"summary":"Fileconversion Function","operationId":"fileconversion_function_auth_fileconversion_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_fileconversion_function_auth_fileconversion_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v2/fileupload":{"post":{"summary":"Fileupload","operationId":"fileupload_v2_fileupload_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_fileupload_v2_fileupload_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v3/fileupload/max":{"post":{"summary":"Fileupload V3 Max","operationId":"fileupload_v3_max_v3_fileupload_max_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_fileupload_v3_max_v3_fileupload_max_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v3/fileupload/min":{"post":{"summary":"Fileupload V3 Max","operationId":"fileupload_v3_max_v3_fileupload_min_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_fileupload_v3_max_v3_fileupload_min_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/generate-resume-document-type/":{"post":{"summary":"Generate Document Type","operationId":"generate_document_type_generate_resume_document_type__post","parameters":[{"name":"type","in":"query","required":true,"schema":{"type":"integer","title":"Type"}},{"name":"docFormat","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Docformat"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Profile"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/refit-resume-generate-type/":{"post":{"summary":"Refit Generate Document Type","description":"Generate a resume with optional image URL as query parameter.\n\nArgs:\n    profile (dict): The profile data\n    type (int): Resume type (1-8)\n    background_tasks: FastAPI BackgroundTasks for cleanup","operationId":"refit_generate_document_type_refit_resume_generate_type__post","parameters":[{"name":"type","in":"query","required":true,"schema":{"type":"integer","title":"Type"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Profile"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/generate_career_summary/":{"post":{"summary":"Generate Career Summary","operationId":"generate_career_summary_generate_career_summary__post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Profile"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/generate_work_experience/":{"post":{"summary":"Generate Work Experience","operationId":"generate_work_experience_generate_work_experience__post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"String Input"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/llm_generate/":{"post":{"summary":"Generate Career Summary","operationId":"generate_career_summary_llm_generate__post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StringInput"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/generate_project_description/":{"post":{"summary":"Generate Project Description","operationId":"generate_project_description_generate_project_description__post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"String Input"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/refit-resume-parser/":{"post":{"summary":"Refit Resume File Upload","operationId":"refit_resume_file_upload_refit_resume_parser__post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_refit_resume_file_upload_refit_resume_parser__post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/llm/generate_job_description":{"post":{"summary":"Generate Job Description Route","operationId":"generate_job_description_route_llm_generate_job_description_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"client","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"default":{},"title":"Query"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/llm/generate_questions_answers":{"post":{"summary":"Llm Generate Questions Answers","operationId":"llm_generate_questions_answers_llm_generate_questions_answers_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Query","default":{}}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/llm/verify_answer":{"post":{"summary":"Llm Verify Answer","operationId":"llm_verify_answer_llm_verify_answer_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Query","default":{}}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/email/send":{"post":{"summary":"Send Email","operationId":"send_email_email_send_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/main__EmailRequest__1"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/learning/generate-structure":{"post":{"summary":"Generate Structure","operationId":"generate_structure_learning_generate_structure_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"job_description","in":"query","required":true,"schema":{"type":"string","description":"Job description text to generate learning structure for","title":"Job Description"},"description":"Job description text to generate learning structure for"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/learning/generate-content":{"post":{"summary":"Generate Content","operationId":"generate_content_learning_generate_content_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Request","default":{}}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/learning/generate-questions":{"post":{"summary":"Generate Questions","operationId":"generate_questions_learning_generate_questions_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Request","default":{}}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/learning/verify-answer":{"post":{"summary":"Verify Answer Endpoint","operationId":"verify_answer_endpoint_learning_verify_answer_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Request","default":{}}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/learning/complete-path":{"post":{"summary":"Create Learning Path","operationId":"create_learning_path_learning_complete_path_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Request","default":{}}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/llm/parsing/job-description":{"post":{"summary":"Parse Job Description Endpoint","operationId":"parse_job_description_endpoint_llm_parsing_job_description_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobDescriptionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobDescriptionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/chat":{"post":{"summary":"Chat Endpoint","description":"Endpoint to interact with the chat model via streaming responses.\n- messages: List of messages in the conversation.\n- language: Language for the assistant's response.","operationId":"chat_endpoint_api_chat_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/analyze-cv":{"post":{"summary":"Analyze Cv","description":"Analyze a CV against a job description.\n\nArgs:\n    resume_file: The CV file to analyze\n    job_description: Job description text. Parsed into a rubric by the model\n        on every call unless ``jd_requirements`` is supplied.\n    jd_requirements: Accepted and ignored. It used to hold the ``rubric``\n        field of an earlier response and skip the JD parse, so every CV for a\n        job was scored against one list. That carried three ways to be wrong\n        -- a rubric saved while the parse had failed described nothing and\n        disabled skills scoring for the whole job, one saved before the\n        description was rewritten described the old job, and one belonging to\n        another job could not be told apart from a valid one without\n        re-reading the description being skipped. The job description is now\n        parsed on every call. The field stays in the contract so callers need\n        no change.\n    job_context: Optional JSON object the caller already holds for this job:\n        ``industry``, ``primary_skills``, ``keywords``, ``clientName``, and\n        optionally ``min_experience`` and ``qualification``. The primary\n        skills are pinned to the front of the rubric so they are measured on\n        every call whatever the JD parse extracts. ``min_experience`` (a\n        number of years, where 0 means \"no minimum\") and ``qualification``\n        (a level such as \"Graduate\") replace the two bars the scorer\n        otherwise reads out of the JD text -- the years floor, which is also\n        the floor for the only check that can reject a candidate, and the\n        education requirement. ``keywords`` are accepted but not scored:\n        they are search terms rather than requirements, and the column\n        arrives truncated (see ``context.USE_JOB_KEYWORDS``).\n    candidate_context: Optional JSON object the caller already holds for this\n        candidate: ``years_of_experience``, ``skills``, ``present_location``\n        (printed as recorded, never scored) and a structured ``education`` list. These are records rather than\n        readings, so they are used in place of the model's reading of the\n        same quantities -- which is what makes the experience component and\n        the minimum-experience check stop depending on the model\n        transcribing every employment date correctly.\n    applicant_id: Optional stable id for the candidate. Used as the key for\n        the reported-score band pick, which otherwise hashes the\n        model-transcribed name.\n    include_executive_summary: If True, includes an executive summary in the analysis\n    auth_token: Authentication token\n\nEvery context field is optional and degrades on its own: whatever is absent\nfalls back to the model's reading of the documents, exactly as before.","operationId":"analyze_cv_analyze_cv_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_analyze_cv_analyze_cv_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Analyze Cv Analyze Cv Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/email-generate-response/":{"post":{"summary":"Generate Email Response","description":"Generate an email response based on the provided email thread","operationId":"generate_email_response_email_generate_response__post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/main__EmailRequest__2"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/generate-goals":{"post":{"summary":"Generate Goals and KPIs","description":"Generate performance goals and KPIs based on job details.\n\nParameters:\n- title: Job title\n- grade: Grade level or job level\n- description: Detailed job description\n- location: Job location\n- num_goals: Number of goals to generate (default: 3, min: 2, max: 5)\n- kpis_per_goal: Number of KPIs per goal (default: 2, min: 1, max: 4)\n\nReturns:\n- JSON object containing generated goals and KPIs","operationId":"generate_goals_api_generate_goals_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobInput"}}},"required":true},"responses":{"200":{"description":"Generated performance goals and KPIs","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GoalsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/extract-keywords":{"post":{"summary":"Extract Keywords","description":"Endpoint to extract keywords from a job description.\nAccepts raw text input and optional all_mandatory query parameter.\n\nArgs:\n    description: Job description text\n    all_mandatory: Flag to indicate if all keywords are mandatory (0 or 1, default 0)\n    auth_token: Authentication token","operationId":"extract_keywords_extract_keywords_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"all_mandatory","in":"query","required":false,"schema":{"type":"integer","maximum":1,"minimum":0,"description":"Flag to indicate if all keywords are mandatory (0 or 1)","default":0,"title":"All Mandatory"},"description":"Flag to indicate if all keywords are mandatory (0 or 1)"}],"requestBody":{"required":true,"content":{"text/plain":{"schema":{"type":"string","title":"Description"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/parse-resume":{"post":{"summary":"Parse Resume","description":"Parse a resume file and extract structured information.\n\nThis endpoint extracts detailed information from a resume, including:\n- Personal information (name, contact details, etc.)\n- Education history\n- Work experience\n- Skills assessment\n- Industry exposure analysis (years of experience per industry and expertise level)\n- Potential roles evaluation (with relevance scores and reasoning)\n- Overall experience level\n\nOptional features can be enabled/disabled using form parameters.\n\nReturns:\n    A JSON object containing the structured resume data.","operationId":"parse_resume_parse_resume_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_parse_resume_parse_resume_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/parse-resume":{"post":{"summary":"Parse Resume","description":"Parse a resume file and extract structured information.\n\nThis endpoint extracts detailed information from a resume, including:\n- Personal information (name, contact details, etc.)\n- Education history\n- Work experience\n- Skills assessment\n- Industry exposure analysis (years of experience per industry and expertise level)\n- Potential roles evaluation (with relevance scores and reasoning)\n- Overall experience level\n\nOptional features can be enabled/disabled using form parameters.\n\nReturns:\n    A JSON object containing the structured resume data.","operationId":"parse_resume_api_parse_resume_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_parse_resume_api_parse_resume_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/v1/resumes/parse":{"post":{"tags":["Resumes"],"summary":"Parse a resume","description":"Parse a resume into structured JSON: the full response, including the\nsummary.\n\nSend the file as `multipart/form-data` in a field named `file`, with\n`Authorization: Bearer <api key>`. There are no options. This is\n`/parse-resume` with its defaults and `mode=full`: the same pipeline and the\nsame response, plus the profile `summary` (the resume's own summary, or a\nshort one written from its content when it has none). The resume's\nlanguage is detected automatically and every field is returned in English.\n\nErrors are JSON `{\"detail\": \"...\"}`. Quote the `X-Request-ID` response\nheader when reporting a problem.","operationId":"parse_resume_v1_v1_resumes_parse_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_parse_resume_v1_v1_resumes_parse_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"400":{"description":"Unsupported file type."},"401":{"description":"Invalid, revoked or expired API key."},"403":{"description":"No Authorization header."},"422":{"description":"No `file` field, or the file has no readable text (blank, corrupt or malformed)."}},"security":[{"APIKeyHeader":[]}]}},"/parse-resume/fast":{"post":{"summary":"Parse Resume Fast","description":"Parse a resume with rules instead of an LLM: the /parse-resume response,\nin tens of milliseconds and at no model cost.\n\nA digital PDF or DOCX is read with its layout (font size, bold, columns),\nwhich finds the sections, jobs and degrees; a scan or image goes through\nthe same OCR text pipeline as /parse-resume. Every field is read from the\nresume as written. The response has the /parse-resume shape key for key;\nwhat rules cannot read is left empty: summary (classic mode),\nindustry_exposure, potential_roles, experience_level, profile_scoring,\nand assumed gender. skills[].level is 1 (only listed) or 3 (named in a\njob), never higher. Text is not translated.","operationId":"parse_resume_fast_parse_resume_fast_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_parse_resume_fast_parse_resume_fast_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/resume-parse/fast":{"post":{"summary":"Parse Resume Fast","description":"Parse a resume with rules instead of an LLM: the /parse-resume response,\nin tens of milliseconds and at no model cost.\n\nA digital PDF or DOCX is read with its layout (font size, bold, columns),\nwhich finds the sections, jobs and degrees; a scan or image goes through\nthe same OCR text pipeline as /parse-resume. Every field is read from the\nresume as written. The response has the /parse-resume shape key for key;\nwhat rules cannot read is left empty: summary (classic mode),\nindustry_exposure, potential_roles, experience_level, profile_scoring,\nand assumed gender. skills[].level is 1 (only listed) or 3 (named in a\njob), never higher. Text is not translated.","operationId":"parse_resume_fast_resume_parse_fast_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_parse_resume_fast_resume_parse_fast_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/parse-resume-v2":{"post":{"summary":"Parse Resume V2","description":"Token-efficient variant of /parse-resume.\n\nIdentical input contract, identical output (same parsed_data schema for\noption 1 and same Naukri format for option 2) and identical logic gates as\n/parse-resume. It uses a compact prompt + deterministic expansion to reduce\ntoken usage on the SAME LLM provider/model. See controllers/resumeParse_v2.","operationId":"parse_resume_v2_parse_resume_v2_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_parse_resume_v2_parse_resume_v2_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/parse-resume-v2":{"post":{"summary":"Parse Resume V2","description":"Token-efficient variant of /parse-resume.\n\nIdentical input contract, identical output (same parsed_data schema for\noption 1 and same Naukri format for option 2) and identical logic gates as\n/parse-resume. It uses a compact prompt + deterministic expansion to reduce\ntoken usage on the SAME LLM provider/model. See controllers/resumeParse_v2.","operationId":"parse_resume_v2_api_parse_resume_v2_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_parse_resume_v2_api_parse_resume_v2_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/parse-resume/encrypted":{"post":{"summary":"Parse Resume Encrypted","description":"Parse a resume file with end-to-end AES-256 encryption for iBank.\n\nThis endpoint provides the same functionality as /parse-resume but with:\n- AES-256-CBC encryption for request payload\n- AES-256-CBC encryption for response data\n- Enhanced security for sensitive financial industry requirements\n\n**Authentication:**\n- **ROTATIONAL TOKENS ONLY**: This endpoint requires rotational authentication tokens\n- Legacy static API keys are NOT accepted for security reasons\n- Use `/auth/token/current` to obtain a valid rotational token\n- Token format: `Authorization: Bearer ROT_xxxxx...`\n\n**Security Features:**\n- **ROTATIONAL AES-256 ENCRYPTION** - Data encryption keys rotate automatically\n- End-to-end encryption using time-based rotational encryption keys\n- Unique initialization vector (IV) for each request/response\n- All sensitive data encrypted during transmission\n- **Rotational token authentication ONLY** - Legacy static tokens are not accepted\n- **Enhanced Security**: Both auth tokens AND encryption keys rotate every 3 hours\n\n**Request Format:**\n```json\n{\n    \"encrypted_payload\": \"base64_encoded_encrypted_data\",\n    \"iv\": \"base64_encoded_initialization_vector\",\n    \"key_marker\": \"base64_encoded_key_marker_optional\"\n}\n```\n\n**Encrypted Payload Structure (before encryption):**\n```json\n{\n    \"file_data\": \"base64_encoded_file_content\",\n    \"filename\": \"resume.pdf\",\n    \"detailed_passport\": false,\n    \"detailed_driving_license\": false,\n    \"assume_gender\": false,\n    \"include_industry_analysis\": true,\n    \"option\": 1\n}\n```\n\n**Response:** Same structure as regular /parse-resume but encrypted\n\n**Environment Setup:**\nRequires IBANK_ENCRYPTION_KEY environment variable (64-character hex string)\n\nReturns:\n    Encrypted JSON response containing structured resume data","operationId":"parse_resume_encrypted_parse_resume_encrypted_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EncryptedRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EncryptedResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/id-card-parser":{"post":{"summary":"Id Card Parser","operationId":"id_card_parser_id_card_parser_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_id_card_parser_id_card_parser_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/resume-redactor":{"post":{"summary":"Redact Resume","description":"Process resume file with redaction and generate formatted output\n\nParameters:\n- resume_file: Resume file to process\n- settings: RedactionSettings containing redaction fields and template\n- auth_token: Authentication token\n- output_format: Desired output format (pdf or json or html)","operationId":"redact_resume_resume_redactor_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"output_format","in":"query","required":false,"schema":{"type":"string","description":"Output format (pdf or json or html)","default":"pdf","title":"Output Format"},"description":"Output format (pdf or json or html)"},{"name":"template","in":"query","required":false,"schema":{"type":"string","default":"template1","title":"Template"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_redact_resume_resume_redactor_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/llm/failures":{"get":{"summary":"Llm Failures","description":"Recent requests whose LLM calls failed, newest first.\n\nReads an in-process ring buffer, so it works even when the log pipeline is\nnot running. Each entry names the service, vendor and model that failed and\nwhy — enough to decide what to repoint.\n\nFilter with ?service=job_description_parser or ?error=rate_limit.","operationId":"llm_failures_admin_llm_failures_get","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}},{"name":"service","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Service"}},{"name":"error","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/admin/llm/health":{"get":{"summary":"Llm Health","description":"Failure counts by service, model and error over the recent window.\n\nAnswers \"what is failing right now, and on which model\" in one call.\nAlso reports each model's remaining output-token budget for the current\nminute (`otpm`), which is what decides whether the next resume parse stays\non its primary model or rotates to the next one, and the state of the\nTelegram alerting queue.","operationId":"llm_health_admin_llm_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/admin/alerts/test":{"post":{"summary":"Alerts Test","description":"Send one Telegram message immediately, to verify alerting is wired up.","operationId":"alerts_test_admin_alerts_test_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/redactable-fields":{"get":{"summary":"Get Redactable Fields","description":"Get comprehensive list of fields that can be redacted","operationId":"get_redactable_fields_redactable_fields_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/redact-pdf":{"post":{"summary":"Redact Pdf","description":"Redact sensitive information from a PDF file.\n\nParameters:\n- file: PDF, DOC, or DOCX file to redact\n- words: Comma-separated list of specific words or phrases to redact (e.g. \"John,Smith,123-456-7890\")\n- auto_redact: Whether to use LLM to automatically identify and redact fields\n- custom_fields: Comma-separated list of field types to redact (e.g. \"First Name,Email ID,Phone Numbers\")\n                Supported fields include: First Name, Last Name, Middle Name, Phone Numbers, \n                Email ID, Current Residential Address, Passport Number, Driving License Number","operationId":"redact_pdf_redact_pdf_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_redact_pdf_redact_pdf_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/redact-pdf-v2":{"post":{"summary":"Redact Pdf V2","description":"Layout-aware PII redaction. Blacks out the text in place, at the coordinates\nwhere the text actually sits, and removes the underlying characters so the\nredaction survives copy-paste and re-extraction.\n\nWord source is chosen per file: the layout-aware digital extractor first\n(reading-order correct on 2-column resumes), PyMuPDF for malformed PDFs the\nformer cannot open, and ocrs for scanned pages with no text layer.\n\nGranularity is hybrid -- the contact block is redacted line-by-line (nothing\nthere but PII, and a whole-line box also covers detector misses), the body\nword-by-word (so a false positive costs one token, not a whole job title).\n\nAny name found in the contact block is swept across the whole document,\nbecause the model identifies a name reliably once but not reliably every\ntime. Pass known_names to seed that sweep from your parser output.\n\nSupported labels: GIVENNAME, SURNAME, MIDDLENAME, EMAIL, TELEPHONENUM, URL,\nSALARY, plus every other Piiranha class (ACCOUNTNUM, CITY, STREET, ZIPCODE,\nDATEOFBIRTH, IDCARDNUM, SOCIALNUM, TAXNUM, DRIVERLICENSENUM, USERNAME,\nPASSWORD, CREDITCARDNUMBER, BUILDINGNUM).","operationId":"redact_pdf_v2_redact_pdf_v2_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_redact_pdf_v2_redact_pdf_v2_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/extract-skills/":{"post":{"summary":"Extract Skills Endpoint","description":"Extract skills from input text (resume or job description)","operationId":"extract_skills_endpoint_extract_skills__post","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_extract_skills_endpoint_extract_skills__post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SkillsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/generate-synopsis/text/":{"post":{"summary":"Generate Synopsis Text","description":"Generate an executive summary from resume text\n\nArgs:\n    text: The resume text to analyze\n    length: The desired length of the response - \"short\", \"medium\", or \"long\"\n    fullname: Optional. Used verbatim instead of the name the LLM extracts\n    gender: Optional. Passed to the LLM as context for pronoun choice instead of\n        it inferring gender from the resume. Never appears in the output.\n    auth_token: Authentication token","operationId":"generate_synopsis_text_generate_synopsis_text__post","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_generate_synopsis_text_generate_synopsis_text__post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SynopsisResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/generate-synopsis/file/":{"post":{"summary":"Generate Synopsis File","description":"Generate an executive summary from resume file\n\nArgs:\n    resume_file: The resume file to analyze\n    length: The desired length of the response - \"short\", \"medium\", or \"long\"\n    fullname: Optional. Used verbatim instead of the name the LLM extracts\n    gender: Optional. Passed to the LLM as context for pronoun choice instead of\n        it inferring gender from the resume. Never appears in the output.\n    auth_token: Authentication token","operationId":"generate_synopsis_file_generate_synopsis_file__post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_generate_synopsis_file_generate_synopsis_file__post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SynopsisResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/detect-language/text/":{"post":{"summary":"Detect Language Text","description":"Detect the language of a piece of text.","operationId":"detect_language_text_detect_language_text__post","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_detect_language_text_detect_language_text__post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LanguageDetectionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/detect-language/file/":{"post":{"summary":"Detect Language File","description":"Detect the language of a document or image.\n\nImages run through a quick PaddleOCR pass; documents go through the\nstandard text-extraction pipeline before script analysis.","operationId":"detect_language_file_detect_language_file__post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_detect_language_file_detect_language_file__post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LanguageDetectionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/translate/text/":{"post":{"summary":"Translate Text","description":"Translate text between languages using Llama 3.3 70B.\n\nAuto-detects the source language unless `source_language` is supplied.\nInput already in the target language is returned as-is without an LLM call.\nHTML input is auto-detected; the response preserves the original tag structure\nand translates only visible text content (and user-visible attributes like\n`alt`, `title`, `placeholder`, `aria-label`).","operationId":"translate_text_translate_text__post","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_translate_text_translate_text__post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TranslationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/cv-analysis-document/":{"post":{"summary":"Cv Analysis Document","description":"Generate a PDF CV analysis report from the provided analysis data (JSON body).\nThis is the existing endpoint — fully backward compatible.","operationId":"cv_analysis_document_cv_analysis_document__post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Profile"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/cv-analysis-document-branded/":{"post":{"summary":"Cv Analysis Document Branded","description":"Generate a branded PDF CV analysis report with optional company logo and watermark.\n\nSend profile as a JSON string in form field, and optionally attach a logo image file.","operationId":"cv_analysis_document_branded_cv_analysis_document_branded__post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_cv_analysis_document_branded_cv_analysis_document_branded__post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/generate-executive-summary-pdf/":{"post":{"summary":"Generate Executive Summary Pdf","description":"Generate an executive summary PDF from the provided synopsis data.\n\nArgs:\n    synopsis_data: Dictionary containing the executive summary data with fullname field\n    \nReturns:\n    Dictionary with paths to the generated HTML and PDF files","operationId":"generate_executive_summary_pdf_generate_executive_summary_pdf__post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Synopsis Data"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Generate Executive Summary Pdf Generate Executive Summary Pdf  Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/analyze-career-path":{"post":{"summary":"Analyze Career Path","description":"Analyze a resume for industry exposure, potential roles, and career growth trajectory.\n\nThis endpoint provides detailed analysis of:\n- Industry exposure with years of experience and expertise level per industry\n- Potential roles the candidate could fill with relevance scores\n- Overall experience level assessment\n- Career growth trajectory and recommendations\n- Job match score (if job description is provided)\n\nParameters:\n- resume_file: The resume file to analyze\n- job_description: Optional job description to match against\n- target_role: Optional target role to analyze career path for\n\nReturns:\n    A detailed career analysis report","operationId":"analyze_career_path_analyze_career_path_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_analyze_career_path_analyze_career_path_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CareerAnalysisResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/email/parse-job-description-v1":{"post":{"summary":"Parse Job Description Route","description":"Parse a job description from a file and/or text input and extract structured information.\n\nThis endpoint extracts detailed information from a job description, including:\n- Job title and company name\n- Location and work arrangement\n- Experience requirements\n- Required and preferred skills\n- Salary information\n- Other job details\n\nEither a file or text input (or both) can be provided.\n\nThe optional ``client`` field controls how ``job_description_written`` is\ngenerated. When ``client`` refers to Manpower (e.g. \"Manpower\",\n\"ManpowerGroup\", \"Manpower Middle East\"), the written job description is\nproduced in the official Manpower Job Posting Template format (About the\nRole / About the Requirements / About You / About the Recruiter / Job Scams\nNotice / About ManpowerGroup) instead of the generic structured format.\n\nThe response also includes ``htmlJobDescription``: the uploaded attachment\nconverted to HTML with the original document's formatting preserved\n(headings, bold, lists, tables). Images in the document are ignored. When\nno file is uploaded, it is a simple HTML rendering of ``email_body``.\n\nReturns:\n    A JSON object containing the structured job description data.","operationId":"parse_job_description_route_api_email_parse_job_description_v1_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_parse_job_description_route_api_email_parse_job_description_v1_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/email/parse-job-description-v2":{"post":{"summary":"Parse Job Description One Call Route","description":"Parse a job description (file and/or email text) into structured fields\nplus job_description_written - the Manpower Job Posting Template when\n``client`` refers to Manpower, the generic posting otherwise.\n\nSame request and response as the original two-call flow (now at\n/api/email/parse-job-description-v1), with the fields and the posting\nproduced by ONE LLM call (controllers/jobDescriptionOneCall).","operationId":"parse_job_description_one_call_route_api_email_parse_job_description_v2_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_parse_job_description_one_call_route_api_email_parse_job_description_v2_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/email/parse-job-description":{"post":{"summary":"Parse Job Description One Call Route","description":"Parse a job description (file and/or email text) into structured fields\nplus job_description_written - the Manpower Job Posting Template when\n``client`` refers to Manpower, the generic posting otherwise.\n\nSame request and response as the original two-call flow (now at\n/api/email/parse-job-description-v1), with the fields and the posting\nproduced by ONE LLM call (controllers/jobDescriptionOneCall).","operationId":"parse_job_description_one_call_route_api_email_parse_job_description_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_parse_job_description_one_call_route_api_email_parse_job_description_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/contract-parser/text":{"post":{"summary":"Parse Contract Text","description":"Parse contract text and extract structured information.\n\nThis endpoint extracts detailed information from contracts, purchase orders, and addendums, including:\n- Basic contract information (title, reference number, type, dates)\n- Parties and duration details\n- Financial information (currency, budget, conversion type)\n- Services array with payment terms and billing details\n\n**Supported Document Types:**\n- Contracts: Full service agreements with multiple parties\n- Purchase Orders: Simple procurement documents  \n- Addendums: Contract modifications and amendments\n\n**Request Body:**\n```json\n{\n    \"text\": \"CONTRACT TEXT HERE...\"\n}\n```\n\n**Returns:**\nA JSON object containing structured contract data with validation errors if any.","operationId":"parse_contract_text_api_contract_parser_text_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContractParserRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContractParserResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/contract-parser/file":{"post":{"summary":"Parse Contract File","description":"Parse contract file and extract structured information.\n\nThis endpoint processes contract files and extracts detailed information including:\n- Basic contract information (title, reference number, type, dates)\n- Parties and duration details  \n- Financial information (currency, budget, conversion type)\n- Services array with payment terms and billing details\n\n**Supported File Formats:**\n- PDF documents\n- Microsoft Word documents (DOC, DOCX)\n- Text files\n\n**Supported Document Types:**\n- Contracts: Full service agreements with multiple parties\n- Purchase Orders: Simple procurement documents\n- Addendums: Contract modifications and amendments\n\n**File Size Limits:**\n- Maximum file size: 50MB\n- For PDFs: Maximum 50 pages\n\n**Returns:**\nA JSON object containing:\n- parsed_data: Structured contract information\n- validation_errors: List of validation issues found","operationId":"parse_contract_file_api_contract_parser_file_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_parse_contract_file_api_contract_parser_file_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContractParserResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/generate-formula-equation":{"post":{"summary":"Generate Formula Equation Endpoint","description":"Generate a JavaScript eval equation from a free text description.\n\nThis endpoint takes a natural language description and converts it into a JavaScript\nexpression that can be used with eval(). Variables are wrapped in {} and can be\nreplaced with actual values later.\n\nArgs:\n    description: Free text description of the formula/equation\n    parameters: Optional JSON string with parameter context for the LLM\n    auth_token: Authentication token\n\nReturns:\n    JSON object containing:\n    - equation: The JavaScript eval expression with variables in {}\n    - description: The original description\n    - validation_errors: List of any errors encountered\n\nExample:\n    Input: \"Calculate total price by multiplying quantity by unit price\"\n    Output: {\"equation\": \"{quantity} * {unitPrice}\", ...}","operationId":"generate_formula_equation_endpoint_api_generate_formula_equation_post","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_generate_formula_equation_endpoint_api_generate_formula_equation_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/initial-assessment-questionaire":{"post":{"summary":"Contract Parser","description":"Parse a contract and generate a JavaScript code in Nunjucks syntax.\n\nThis endpoint parses a contract text and generates a JavaScript code in Nunjucks syntax.\n\nReturns:\n    A JSON object containing the generated JavaScript code.","operationId":"contract_parser_api_initial_assessment_questionaire_post","security":[{"APIKeyHeader":[]}],"parameters":[{"name":"job_description","in":"query","required":true,"schema":{"type":"string","title":"Job Description"}},{"name":"question_count","in":"query","required":false,"schema":{"type":"integer","default":5,"title":"Question Count"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/expense-parser":{"post":{"summary":"Parse Invoice","description":"Parse an invoice file and extract structured information.\n\nThis endpoint extracts detailed information from an invoice, including:\n- Invoice number, date, and due date\n- Vendor and customer information\n- Line items with quantities and amounts\n- Totals, taxes, and payment details\n\nSupported file formats: PDF, JPG, PNG\n\nReturns:\n    A JSON object containing the structured invoice data.","operationId":"parse_invoice_api_expense_parser_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_parse_invoice_api_expense_parser_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/full-invoice-parser":{"post":{"summary":"Parse Full Invoice","description":"Parse an invoice file and extract ALL information into a comprehensive JSON structure.\n\nUses OCR to extract text from images/PDFs, then sends to LLM for structured parsing.\n\nSupported file formats: PDF, JPG, PNG, JPEG, TIFF, BMP, GIF","operationId":"parse_full_invoice_api_full_invoice_parser_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_parse_full_invoice_api_full_invoice_parser_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/helpdesk/response-generate":{"post":{"summary":"Generate Helpdesk Response Endpoint","description":"Generate a helpdesk response based on provided context, optional responder context, and response style.\n\nThis endpoint accepts a JSON body with customer context (user's issue/question) and optionally \na responder answer context to generate an appropriate response in the specified style using AI/LLM capabilities.\n\n**Available Response Styles:**\n- **professional**: Formal, business-appropriate tone with clear solutions\n- **friendly**: Warm, conversational tone with empathy and reassurance  \n- **technical**: Detailed technical explanations with specific steps\n- **concise**: Brief, direct responses focused on quick solutions\n- **educational**: Informative responses that explain concepts and reasoning\n\n**Request Body:**\n```json\n{\n    \"context\": \"The user's issue or question description (required)\",\n    \"responder_answer_context\": \"The responder's answer context or guidance (optional)\",\n    \"response_style\": \"professional|friendly|technical|concise|educational (optional, defaults to professional)\"\n}\n```\n\n**Returns:**\nA JSON object containing:\n- response: The generated helpdesk response text\n\n**Example:**\n```json\n{\n    \"context\": \"My computer won't start and shows a black screen\",\n    \"responder_answer_context\": \"Check power connections and try safe mode\",\n    \"response_style\": \"technical\"\n}\n```","operationId":"generate_helpdesk_response_endpoint_helpdesk_response_generate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HelpdeskRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HelpdeskResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/helpdesk/response-styles":{"get":{"summary":"Get Helpdesk Response Styles","description":"Get available response styles for helpdesk responses.\n\nReturns a list of available response styles with descriptions.","operationId":"get_helpdesk_response_styles_helpdesk_response_styles_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/naukri-html-processor":{"post":{"summary":"Naukri Html Processor","description":"Comprehensive Naukri HTML processor that:\n1. Extracts HTML body content\n2. Extracts text from HTML\n3. Extracts attached CV as PDF\n4. Processes PDF to extract text (first 25%)\n5. Parses both HTML and PDF text using resumeParse with option 2\n6. Returns JSON results with extracted PDF file (base64 encoded)\n\nArgs:\n    html_file: HTML file containing Naukri profile data\n    auth_token: Authentication token\n    \nReturns:\n    JSON response with processing results, parsed resume data, and extracted PDF (base64)","operationId":"naukri_html_processor_naukri_html_processor_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_naukri_html_processor_naukri_html_processor_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/cities/info":{"post":{"summary":"Get Cities Info","description":"City Information API - AI-Powered City Verification\n\nThis endpoint uses LLM to verify and enrich information for a list of cities.\nIt provides comprehensive city data including alternate names, location details, and language information.\n\n**Features:**\n- **City Verification**: Verify and enrich information for specific cities\n- **LLM-Powered**: Uses advanced AI for accurate city identification\n- **Batch Processing**: Handle multiple cities efficiently\n- **Individual Error Tracking**: Detailed error reporting per city\n- **Flexible Input**: Supports various city name formats and codes\n\n**Request Format:**\n\n```json\n{\n    \"cities\": [\"New York\", \"NYC\", \"London\", \"TYO\", \"Paris\"]\n}\n```\n\n**Response Format:**\n```json\n{\n    \"success\": true,\n    \"data\": [\n        {\n            \"inputValue\": \"NYC\",\n            \"presentName\": \"New York\",\n            \"alternateNames\": [\"NYC\", \"New York City\", \"The Big Apple\"],\n            \"shortCode\": \"NYC\",\n            \"state\": \"New York\",\n            \"stateShortCode\": \"NY\",\n            \"country\": \"United States\",\n            \"countryShortCode\": \"US\",\n            \"primaryLanguageName\": \"English\",\n            \"primaryLanguageISOCode\": \"en\"\n        }\n    ],\n    \"errors\": [],\n    \"timestamp\": \"2025-01-03T10:30:00Z\"\n}\n```\n\n**Global Coverage:**\n- Uses LLM's comprehensive geographical knowledge\n- No predefined city database - covers cities worldwide\n- Handles major and minor cities from all continents\n- Supports multiple languages and naming conventions\n\n**Error Handling:**\n- Individual error tracking for each city\n- Detailed error codes and messages\n- Partial success responses (some cities found, others not)","operationId":"get_cities_info_api_cities_info_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CityInfoRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CityInfoResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/address-parser":{"post":{"summary":"Parse Address","description":"Address Parser API - AI-Powered Address Parsing and Structuring\n\nThis endpoint uses LLM to parse and structure address information from free text.\nIt extracts and organizes address components into standardized fields.\n\n**Features:**\n- **Address Parsing**: Parse free text containing address data\n- **LLM-Powered**: Uses advanced AI for intelligent address extraction\n- **Standardized Output**: Returns structured address with consistent fields\n- **Component Extraction**: Separates address lines, city, state, country, and postal code\n- **Flexible Input**: Accepts any free text address format\n\n**Request Format:**\nSend form data with `address_text` field containing the free text address:\n\nForm field: `address_text`\n\nExample values:\n- \"123 Main Street, Apartment 4B, New York, NY 10001, United States\"\n- \"456 Oak Ave, Suite 200, San Francisco, CA 94102\"\n- \"789 Elm St, London, UK, SW1A 1AA\"\n\n**Response Format:**\n```json\n{\n    \"success\": true,\n    \"data\": {\n        \"houseNumber\": \"G-3130\",\n        \"areaLocality\": \"Mohan Garden\",\n        \"streetLaneRoad\": \"Gali No. 11\",\n        \"city\": \"West Delhi\",\n        \"state\": \"Delhi\",\n        \"country\": \"India\",\n        \"postalCode\": \"110059\"\n    },\n    \"errors\": [],\n    \"timestamp\": \"2025-11-18T04:30:00Z\"\n}\n```\n\n**Address Fields:**\n- **houseNumber**: House No./Building No./Flat No./Apartment No.\n- **areaLocality**: Area/Locality/Sector/Colony/Neighborhood\n- **streetLaneRoad**: Street/Lane/Road/Gali/Avenue name\n- **city**: City or municipality name\n- **state**: State/Province/Emirate name\n- **country**: Country name\n- **postalCode**: Postal/ZIP/PIN code\n\n**Supported Regions:**\n- Primary focus: Indian addresses\n- Also supports: Middle Eastern addresses (UAE, Saudi Arabia, Qatar, Oman, Kuwait, Bahrain)\n\n**Error Handling:**\n- Returns empty strings for fields that cannot be extracted\n- Provides detailed error messages if parsing fails\n- Validates input before processing","operationId":"parse_address_api_address_parser_post","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_parse_address_api_address_parser_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddressParserResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/cvmine/parse/job-description":{"post":{"summary":"Parse Job Description Endpoint","description":"CVMine Job Description Parser API - AI-Powered Job Parsing for Resume Matching\n\nThis endpoint uses LLM to parse and structure job descriptions into standardized fields\noptimized for candidate-job matching and resume screening. The output structure is\naligned with the resume parser for seamless comparison and candidate evaluation.\n\n**Features:**\n- **Intelligent Parsing**: Extracts job title, location, requirements, and skills\n- **Skills Extraction**: Identifies required/preferred skills with proficiency levels and categories\n- **Experience Analysis**: Determines experience level and years required\n- **Education Requirements**: Extracts minimum education level and field\n- **Resume Matching Ready**: Output structure matches resume parser for direct comparison\n- **Search Keywords**: Generates essential keywords for finding matching candidates in resumes\n- **Structured Location**: Address broken down into street, city, state, country, postal code\n\n**Request Format:**\nSend form data with `job_description` field containing the job description text:\n\nForm field: `job_description`\n\nExample value:\n```\nSenior Software Engineer\n\nWe are seeking an experienced Senior Software Engineer to join our team...\n\nRequirements:\n- 5+ years of experience in software development\n- Bachelor's degree in Computer Science or related field\n- Strong proficiency in Python and JavaScript\n- Experience with React and Django frameworks\n- Excellent communication skills\n\nResponsibilities:\n- Design and develop scalable web applications\n- Mentor junior developers\n- Collaborate with product teams\n...\n```\n\n**Response Format:**\n```json\n{\n    \"success\": true,\n    \"data\": {\n        \"job_details\": {\n            \"job_title\": \"Senior Software Engineer\",\n            \"company_name\": \"Tech Corp\",\n            \"department\": \"Engineering\",\n            \"address\": {\n                \"street\": \"123 Tech Street\",\n                \"city\": \"San Francisco\",\n                \"state\": \"CA\",\n                \"country\": \"United States\",\n                \"postal_code\": \"94102\"\n            },\n            \"job_type\": \"full-time\",\n            \"remote_type\": \"hybrid\",\n            \"salary_range\": \"$120,000 - $160,000\"\n        },\n        \"skills\": [\n            {\n                \"name\": \"Python\",\n                \"level\": 4,\n                \"years\": 5.0,\n                \"categories\": [\"programming\", \"backend\"],\n                \"importance\": \"required\"\n            },\n            {\n                \"name\": \"React\",\n                \"level\": 3,\n                \"years\": 3.0,\n                \"categories\": [\"programming\", \"frontend\"],\n                \"importance\": \"required\"\n            },\n            {\n                \"name\": \"Leadership\",\n                \"level\": 4,\n                \"years\": null,\n                \"categories\": [\"soft_skills\", \"management\"],\n                \"importance\": \"preferred\"\n            }\n        ],\n        \"requirements\": {\n            \"min_experience_years\": 5.0,\n            \"max_experience_years\": null,\n            \"experience_level\": \"senior\",\n            \"education_level\": \"bachelors\",\n            \"education_field\": \"Computer Science\",\n            \"certifications\": [\"AWS Certified Solutions Architect\"],\n            \"languages\": [\"English\"]\n        },\n        \"search_keywords\": [\n            \"Python\",\n            \"React\",\n            \"Django\",\n            \"JavaScript\",\n            \"Senior Software Engineer\",\n            \"Full Stack Developer\",\n            \"Web Development\",\n            \"API Development\",\n            \"PostgreSQL\",\n            \"Docker\",\n            \"Kubernetes\",\n            \"Agile\",\n            \"Microservices\",\n            \"REST API\"\n        ]\n    },\n    \"errors\": []\n}\n```\n\n**Extracted Fields:**\n- **job_details**: Job information including:\n    - Job title, company name, department\n    - Structured address (street, city, state, country, postal_code)\n    - Job type (full-time, part-time, contract, etc.)\n    - Remote type (remote, hybrid, on-site)\n    - Salary range\n- **skills**: Array of skills with matching resume parser structure:\n    - name: Skill name\n    - level: Proficiency level (1-5 scale)\n    - years: Years of experience required\n    - categories: Skill categories (e.g., [\"programming\", \"backend\"])\n    - importance: \"required\" or \"preferred\"\n- **requirements**: Experience and education requirements:\n    - min_experience_years, max_experience_years\n    - experience_level: entry, junior, mid, senior, lead, manager, director, executive\n    - education_level: high_school, diploma, bachelors, masters, doctorate, etc.\n    - education_field: Preferred field of study\n    - certifications: List of required/preferred certifications\n    - languages: Required spoken/written languages\n- **search_keywords**: Essential keywords for finding matching candidates in resumes\n    - Technical skills and technologies\n    - Domain knowledge terms\n    - Job title variations\n    - Industry-specific terminology\n\n**Use Cases:**\n- **Resume Matching**: Direct comparison with resume parser output for candidate-job fit analysis\n- **Candidate Search**: Use search_keywords to find relevant resumes in your database\n- **Skill Matching**: Compare job skills with candidate skills using identical data structure\n- **Location Matching**: Compare structured address data with candidate location preferences\n- **Requirements Filtering**: Filter candidates by experience level, education, certifications\n- **ATS Integration**: Feed structured data into Applicant Tracking Systems\n\n**Error Handling:**\n- Returns null for optional fields that cannot be extracted\n- Provides detailed error messages if parsing fails\n- Validates input before processing","operationId":"parse_job_description_endpoint_cvmine_parse_job_description_post","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_parse_job_description_endpoint_cvmine_parse_job_description_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobDescriptionParserResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/parse/job-description-v2":{"post":{"summary":"Parse Job Description V2 Endpoint","description":"Job Description Parser V2 API - Structured Job Parsing with Keywords and Requirements\n\nThis endpoint parses job descriptions into a structured format optimized for resume matching\nand candidate screening. It extracts keywords with importance weights, skills with proficiency\nlevels, experience requirements, location, education, industry requirements, and certifications.\n\n**Features:**\n- **Keyword Extraction**: Extracts 10-20 important keywords with weight scores (1.0-5.0)\n- **Skills Analysis**: Identifies required and preferred skills with optional proficiency levels\n- **Experience Range**: Determines minimum and maximum years of experience\n- **Seniority Level**: Classifies position level (entry, junior, mid, senior, lead, manager, director, executive)\n- **Location Parsing**: Extracts city, state, country, and remote work flag\n- **Education Requirements**: Lists required and preferred degrees\n- **Industry Requirements**: Identifies industry experience needs\n- **Certifications**: Extracts mentioned certifications\n\n**Request Format:**\nSend form data with `job_description` field containing the job description text:\n\nForm field: `job_description`\n\nExample value:\n```\nSenior Java Developer - Bangalore\n\nWe are looking for an experienced Java developer to join our technology team.\n\nRequirements:\n- 5-8 years of experience in Java development\n- Strong knowledge of Spring Boot and MySQL\n- AWS experience is a plus\n- B.E/B.Tech in Computer Science\n- Experience in technology or finance industry preferred\n\nCertifications:\n- AWS Certified Solutions Architect (preferred)\n- PMP certification is a plus\n```\n\n**Response Format:**\n```json\n{\n    \"success\": true,\n    \"data\": {\n        \"keywords\": [\n            {\"keyword\": \"java\", \"weight\": 5.0},\n            {\"keyword\": \"spring boot\", \"weight\": 4.0},\n            {\"keyword\": \"mysql\", \"weight\": 3.0},\n            {\"keyword\": \"developer\", \"weight\": 3.0}\n        ],\n        \"skills\": [\n            {\"name\": \"Java\", \"level\": 4, \"is_required\": true},\n            {\"name\": \"Spring Boot\", \"level\": 3, \"is_required\": true},\n            {\"name\": \"MySQL\", \"level\": 3, \"is_required\": true},\n            {\"name\": \"AWS\", \"is_required\": false}\n        ],\n        \"expFrom\": 5,\n        \"expTo\": 8,\n        \"seniorityLevel\": \"senior\",\n        \"city\": \"Bangalore\",\n        \"state\": \"Karnataka\",\n        \"country\": \"India\",\n        \"remote\": false,\n        \"education\": [\n            {\"degree\": \"B.E\", \"is_required\": true},\n            {\"degree\": \"B.Tech\", \"is_required\": true}\n        ],\n        \"industry_requirements\": [\n            {\"industry\": \"Technology\", \"is_required\": false},\n            {\"industry\": \"Finance\", \"is_required\": false}\n        ],\n        \"certifications\": [\n            \"AWS Certified Solutions Architect\",\n            \"PMP\"\n        ]\n    },\n    \"errors\": []\n}\n```\n\n**Extracted Fields:**\n- **keywords**: Array of keywords with importance weights (1.0-5.0 scale)\n    - 5.0: Critical (job title, primary technologies)\n    - 4.0: Very important (required skills)\n    - 3.0: Important (preferred skills)\n    - 2.0: Nice-to-have (bonus skills)\n    - 1.0: Supportive (soft skills)\n- **skills**: Array of skills with:\n    - name: Skill name\n    - level: Optional proficiency level (1-5 scale)\n    - is_required: Whether skill is required or preferred\n- **expFrom**: Minimum years of experience required\n- **expTo**: Maximum years of experience required\n- **seniorityLevel**: Position level (entry, junior, mid, senior, lead, manager, director, executive)\n- **city**: Job location city\n- **state**: Job location state/province\n- **country**: Job location country\n- **remote**: Whether job is remote (true/false)\n- **education**: Array of degree requirements with:\n    - degree: Degree name (e.g., \"B.E\", \"B.Tech\", \"M.Tech\")\n    - is_required: Whether degree is required\n- **industry_requirements**: Array of industry experience requirements with:\n    - industry: Industry name\n    - is_required: Whether industry experience is required\n- **certifications**: Array of certification names (strings)\n\n**Use Cases:**\n- **Resume Matching**: Match candidates against job requirements\n- **Candidate Search**: Use keywords to find relevant resumes\n- **Skill Filtering**: Filter candidates by required and preferred skills\n- **Experience Filtering**: Filter by years of experience and seniority level\n- **Location Matching**: Match candidates based on location preferences\n- **Education Screening**: Screen candidates by educational qualifications\n- **Industry Experience**: Filter by industry background\n\n**Error Handling:**\n- Returns empty arrays/strings for fields that cannot be extracted\n- Provides detailed error messages if parsing fails\n- Validates input before processing","operationId":"parse_job_description_v2_endpoint_api_parse_job_description_v2_post","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_parse_job_description_v2_endpoint_api_parse_job_description_v2_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/job-description/summary":{"post":{"summary":"Job Description Summary Endpoint","description":"Job Description Summary API - Generate concise summaries under 150 characters\n\nThis endpoint takes a job description and generates a short, scannable summary\nsuitable for quick review, listings, or previews.\n\n**Features:**\n- Summaries are always under 150 characters\n- Focuses on job title, key skills, and main requirements\n- Uses abbreviations for brevity\n- Optimized for quick scanning\n\n**Request Format:**\nSend form data with `job_description` field containing the full job description text.\n\n**Response Format:**\n```json\n{\n    \"success\": true,\n    \"summary\": \"Senior Python Dev - Django/FastAPI, 5+ yrs, scalable APIs\",\n    \"validation_errors\": []\n}\n```\n\n**Example Summaries:**\n- \"Senior Python Dev - Django/FastAPI, 5+ yrs, scalable APIs\"\n- \"Data Scientist - ML/AI, Python, 3+ yrs exp\"\n- \"Frontend Engineer - React/TS, 4+ yrs\"\n- \"DevOps Lead - AWS/K8s, CI/CD, 6+ yrs\"","operationId":"job_description_summary_endpoint_api_job_description_summary_post","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_job_description_summary_endpoint_api_job_description_summary_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobDescriptionSummaryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/estimate-budget":{"post":{"summary":"Estimate Budget Endpoint","description":"Budget Estimator API - AI-Powered Base Salary Estimation\n\nThis endpoint estimates BASE SALARY ranges for job positions based on client name,\nexperience requirements, designation, job description, and location/currency.\n\n**IMPORTANT: This provides BASE SALARY estimates only (excluding equity, bonuses, benefits)**\n\n**Features:**\n- **Smart Budget Estimation**: Uses OpenAI GPT-OSS-120B (OpenRouter `:nitro`, low reasoning effort) for accurate market-based estimates\n- **Base Salary Focus**: Provides cash salary only, excluding total compensation components\n- **Currency Detection**: Automatically determines appropriate currency based on country/input\n- **Configurable Scale**: Specify whether compensation should be per annum, per hour, or per month\n- **Location-Aware**: Optional location parameter for geographic adjustments\n- **Market-Aware**: Considers client reputation, market standards, and industry benchmarks\n- **Contextual Analysis**: Analyzes job description complexity and requirements\n\n**Request Format:**\n```json\n{\n    \"client_name\": \"Microsoft\",\n    \"exp_range\": \"3 to 7 years\",\n    \"designation\": \"Senior NodeJS Developer\",\n    \"job_description\": \"We are looking for an experienced NodeJS developer...\",\n    \"country_or_currency\": \"India\",\n    \"scale\": \"per annum\",\n    \"location\": \"Bangalore\"\n}\n```\n\nNote: `location` is optional but recommended for more accurate estimates\n\n**Response Format:**\n```json\n{\n    \"currency\": \"INR\",\n    \"minBudget\": 1200000,\n    \"maxBudget\": 2500000,\n    \"scale\": \"per annum\"\n}\n```\n\n**Fields:**\n- `currency`: Currency code (INR, USD, EUR, GBP, etc.)\n- `minBudget`: Minimum base salary (excluding equity/bonuses/benefits)\n- `maxBudget`: Maximum base salary (excluding equity/bonuses/benefits)\n- `scale`: Payment scale - \"per annum\", \"per hour\", or \"per month\"\n\n**Note on Total Compensation:**\n- These are BASE SALARY estimates only\n- For total compensation, add: equity/stock options, bonuses, benefits, etc.\n- Tech companies often offer 20-50% additional value in equity and bonuses\n\n**Supported Scales:**\n- `per annum`: Annual salary (common in India, USA, Europe)\n- `per hour`: Hourly rate (common for contractors/freelancers in USA)\n- `per month`: Monthly salary (common in some European countries)\n\n**Use Cases:**\n- HR budget planning\n- Salary benchmarking\n- Job posting creation\n- Compensation analysis\n- Market research\n\n**Error Handling:**\n- Returns validation errors if data is incomplete\n- Provides default schema on parsing failures\n- Detailed error messages for debugging","operationId":"estimate_budget_endpoint_api_estimate_budget_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BudgetEstimatorRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BudgetEstimatorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/education/degrees/info":{"post":{"summary":"Get Education Degrees Info","description":"Education Degrees API - AI-Powered Education Degree Verification and Standardization\n\nThis endpoint uses LLM to verify, standardize, and enrich information for a list of education degrees.\nIt provides comprehensive degree data including standardized names, types, fields, levels, and categories.\n\n**Features:**\n- **Degree Verification**: Verify and standardize education degree names\n- **LLM-Powered**: Uses advanced AI for accurate degree identification and classification\n- **Batch Processing**: Handle multiple degrees efficiently\n- **Individual Error Tracking**: Detailed error reporting per degree\n- **Flexible Input**: Supports various degree name formats, abbreviations, and incomplete names\n- **Comprehensive Classification**: Categorizes by type, level, field, and duration\n\n**Request Format:**\n\n```json\n{\n    \"degrees\": [\n        \"Bachelor of Technology HONORS\",\n        \"B.Sc. Computer Science\",\n        \"MBA\",\n        \"PGDM Sales Marketing\",\n        \"Python Full Stack Developer\"\n    ]\n}\n```\n\n**Response Format:**\n```json\n{\n    \"success\": true,\n    \"data\": [\n        {\n            \"inputValue\": \"Bachelor of Technology HONORS\",\n            \"standardizedName\": \"Bachelor of Technology (Honors)\",\n            \"degreeType\": \"Bachelor\",\n            \"field\": \"Engineering\",\n            \"level\": \"Undergraduate\",\n            \"duration\": \"4 years\",\n            \"alternateNames\": [\"B.Tech. (Hons)\", \"B.Tech. Honours\"],\n            \"abbreviations\": [\"B.Tech.\"],\n            \"category\": \"Engineering\"\n        }\n    ],\n    \"errors\": [],\n    \"timestamp\": \"2025-01-15T10:30:00Z\"\n}\n```\n\n**Degree Categories:**\n- **Engineering**: Computer Science, Information Technology, Electronics, etc.\n- **Business**: MBA, PGDM, BBA, Commerce, etc.\n- **Science**: Physics, Chemistry, Biology, Mathematics, etc.\n- **Arts & Humanities**: Literature, History, Philosophy, etc.\n- **Medicine & Health**: MBBS, Nursing, Pharmacy, etc.\n- **Law**: LLB, LLM, etc.\n- **Education**: B.Ed, M.Ed, etc.\n- **Other**: Professional courses, certifications, specialized programs\n\n**Education Levels:**\n- **Secondary**: Class X, XII, High School, etc.\n- **Diploma**: Various diplomas and certificates\n- **Undergraduate**: Bachelor's degrees\n- **Graduate**: Master's degrees\n- **Postgraduate**: Advanced diplomas, PG programs\n- **Doctoral**: PhD, DPhil, etc.\n- **Professional**: Professional certifications, specialized courses\n\n**Error Handling:**\n- Individual error tracking for each degree\n- Detailed error codes and messages\n- Partial success responses (some degrees found, others not)","operationId":"get_education_degrees_info_api_education_degrees_info_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EducationInfoRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EducationInfoResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/skills/info":{"post":{"summary":"Analyze Job Skills","description":"Job Skills Analysis API - AI-Powered Skills Categorization\n\nThis endpoint uses LLM to analyze and categorize job skills.\nIt provides comprehensive skill analysis including categories, market demand, and related skills.\n\n**Features:**\n- **Skills Analysis**: Analyze and categorize professional skills\n- **LLM-Powered**: Uses advanced AI for accurate skill classification\n- **Batch Processing**: Handle multiple skills efficiently\n- **Individual Error Tracking**: Detailed error reporting per skill\n- **Market Intelligence**: Includes demand levels and industry relevance\n\n**Request Format:**\n\n```json\n{\n    \"skills\": [\"Python\", \"Machine Learning\", \"Leadership\", \"React\", \"SQL\"]\n}\n```\n\n**Response Format:**\n```json\n{\n    \"success\": true,\n    \"data\": [\n        {\n            \"inputValue\": \"Python\",\n            \"standardizedName\": \"Python Programming\",\n            \"alternateNames\": [\"Python\", \"Python 3\", \"Python Development\"],\n            \"category\": \"Technical\",\n            \"subcategory\": \"Programming Language\",\n            \"proficiencyLevel\": null,\n            \"relatedSkills\": [\"Django\", \"Flask\", \"Data Science\", \"Machine Learning\"],\n            \"industryRelevance\": [\"Technology\", \"Data Science\", \"Web Development\"],\n            \"demandLevel\": \"High\",\n            \"description\": \"High-level programming language used for web development, data science, and automation\"\n        }\n    ],\n    \"errors\": [],\n    \"timestamp\": \"2025-01-03T10:30:00Z\"\n}\n```\n\n**Skill Categories:**\n- **Technical**: Programming languages, frameworks, tools, databases\n- **Soft Skills**: Communication, leadership, problem-solving\n- **Language**: Human languages and proficiency levels  \n- **Analytical**: Data analysis, research, statistical skills\n- **Creative**: Design, multimedia, artistic skills\n- **Management**: Project management, team leadership, strategic planning\n\n**Error Handling:**\n- Individual error tracking for each skill\n- Detailed error codes and messages\n- Partial success responses (some skills analyzed, others not)","operationId":"analyze_job_skills_api_skills_info_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobSkillsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobSkillsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/add-search-weights":{"post":{"summary":"Add Search Weights Endpoint","description":"Search weights for a candidate search, judged from the job description (gpt-oss-120b).\n\n- **jobTitle**: the requested title at weight 10, then up to 3 very close\n  alternative titles with lower weights.\n- **skills**: every requested skill, in the same order, each with a 1-10\n  weight set by the model: technical skills outweigh soft skills, and each\n  is weighted by its importance in the JD. A skill whose importance the JD\n  cannot determine (including when no JD is sent) gets 1.\n\n**Request:**\n```json\n{\"jobtitle\": \"Senior Software Engineer\", \"skills\": [\"Java\", \"Kafka\", \"Docker\", \"Communication\"], \"jobdescription\": \"...\"}\n```\n\n**Response:**\n```json\n{\n  \"jobTitle\": [{\"title\": \"Senior Software Engineer\", \"weight\": 10}, {\"title\": \"Senior Java Developer\", \"weight\": 8}],\n  \"skills\": [{\"name\": \"Java\", \"weight\": 10}, {\"name\": \"Kafka\", \"weight\": 6}, {\"name\": \"Docker\", \"weight\": 5}, {\"name\": \"Communication\", \"weight\": 3}]\n}\n```","operationId":"add_search_weights_endpoint_api_add_search_weights_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchWeightsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchWeightsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/add-search-weights":{"post":{"summary":"Add Search Weights Endpoint","description":"Search weights for a candidate search, judged from the job description (gpt-oss-120b).\n\n- **jobTitle**: the requested title at weight 10, then up to 3 very close\n  alternative titles with lower weights.\n- **skills**: every requested skill, in the same order, each with a 1-10\n  weight set by the model: technical skills outweigh soft skills, and each\n  is weighted by its importance in the JD. A skill whose importance the JD\n  cannot determine (including when no JD is sent) gets 1.\n\n**Request:**\n```json\n{\"jobtitle\": \"Senior Software Engineer\", \"skills\": [\"Java\", \"Kafka\", \"Docker\", \"Communication\"], \"jobdescription\": \"...\"}\n```\n\n**Response:**\n```json\n{\n  \"jobTitle\": [{\"title\": \"Senior Software Engineer\", \"weight\": 10}, {\"title\": \"Senior Java Developer\", \"weight\": 8}],\n  \"skills\": [{\"name\": \"Java\", \"weight\": 10}, {\"name\": \"Kafka\", \"weight\": 6}, {\"name\": \"Docker\", \"weight\": 5}, {\"name\": \"Communication\", \"weight\": 3}]\n}\n```","operationId":"add_search_weights_endpoint_add_search_weights_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchWeightsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchWeightsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/job-title-alternatives":{"post":{"summary":"Job Title Alternatives Endpoint","description":"Alternative job titles to search candidates with (gpt-oss-120b).\n\nRuns the same pure-title prompt as /extract-keywords, with the requested\njob title filled in, and returns every title variation it gives as a list:\nall seniority levels and industry synonyms, in model order, no cap. The\nrequested title itself and repeats are dropped.\n\n**Request:**\n```json\n{\"jobtitle\": \"Recruiter\", \"jobdescription\": \"...\"}\n```\n\n**Response:**\n```json\n{\"alternativeTitles\": [\"Talent Acquisition Specialist\", \"Recruitment Consultant\", \"Senior Recruiter\", \"Recruitment Manager\", \"...\"]}\n```","operationId":"job_title_alternatives_endpoint_api_job_title_alternatives_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobTitleAlternativesRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobTitleAlternativesResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/designations/info":{"post":{"summary":"Analyze Job Designations","description":"Job Designations Analysis API - AI-Powered Job Title Analysis\n\nThis endpoint uses LLM to analyze and categorize job designations/titles.\nIt provides comprehensive designation analysis including seniority levels, categories, and skill requirements.\n\n**Features:**\n- **Designation Analysis**: Analyze and categorize job titles and designations\n- **LLM-Powered**: Uses advanced AI for accurate designation classification\n- **Batch Processing**: Handle multiple designations efficiently\n- **Individual Error Tracking**: Detailed error reporting per designation\n- **Market Intelligence**: Includes seniority levels and skill requirements\n\n**Request Format:**\n\n```json\n    {\n        \"designations\": [\"Software Engineer\", \"NOC Engineer[L2]\", \"Team Lead- Service Assurance\", \"Sr Consultant - Network\"]\n    }\n```\n\n**Response Format:**\n```json\n{\n    \"success\": true,\n    \"data\": [\n        {\n            \"inputValue\": \"NOC ENGINEER[L2]\",\n            \"normalizedTitle\": \"Network Operations Center Engineer - Level 2\",\n            \"seniorityLevel\": \"Mid\",\n            \"category\": \"Operations\",\n            \"industry\": \"Telecommunications\",\n            \"skillsRequired\": [\"Network Monitoring\", \"Troubleshooting\", \"ITIL\", \"Incident Management\", \"Linux\"],\n            \"alternativeTitles\": [\"NOC Analyst L2\", \"Network Support Engineer\", \"Network Operations Specialist\"],\n            \"experienceRange\": {\n                \"minYears\": 2,\n                \"maxYears\": 5\n            },\n            \"departmentFunction\": \"Network Operations\"\n        }\n    ],\n    \"errors\": [],\n    \"timestamp\": \"2025-01-03T10:30:00Z\"\n}\n```\n\n**Seniority Levels:**\n- **Entry**: 0-2 years experience, junior roles, trainees\n- **Mid**: 2-5 years experience, individual contributors\n- **Senior**: 5-10 years experience, senior individual contributors\n- **Lead**: 7-12 years experience, technical/team leads\n- **Manager**: 8-15 years experience, people managers\n- **Director**: 12+ years experience, senior management\n- **Executive**: 15+ years experience, C-level, VP level\n\n**Categories (Exact Values):**\n- **Engineering**: Software, Hardware, Systems, Network, etc.\n- **Operations**: IT Operations, Network Operations, NOC, etc.\n- **Management**: Team Management, Project Management, etc.\n- **Sales**: Business Development, Account Management, etc.\n- **Marketing**: Digital Marketing, Product Marketing, etc.\n- **Finance**: Accounting, Financial Analysis, etc.\n- **HR**: Human Resources, Talent Acquisition, etc.\n- **Support**: Technical Support, Customer Support, etc.\n- **Consulting**: Advisory, Implementation, etc.\n- **Other**: If none of the above fit\n\n**Industries (Single Word Values):**\n- **Technology**: Software, IT, Tech companies\n- **Telecommunications**: Telecom, Network providers, ISPs\n- **Finance**: Banking, Insurance, Investment\n- **Healthcare**: Medical, Pharmaceutical, Hospitals\n- **Manufacturing**: Production, Industrial, Automotive\n- **Retail**: E-commerce, Consumer goods, Shopping\n- **Education**: Schools, Universities, Training\n- **Government**: Public sector, Agencies, Defense\n- **Consulting**: Advisory, Professional services\n- **Energy**: Oil, Gas, Renewable, Utilities\n- **Media**: Broadcasting, Publishing, Entertainment\n- **Other**: If none of the above fit\n\n**Experience Range Format:**\n- Structured with `minYears` and `maxYears` as integers\n- Based on seniority level guidelines\n- Maximum 50 years, minimum 0 years\n\n**Error Handling:**\n- Individual error tracking for each designation\n- Detailed error codes and messages\n- Partial success responses (some designations analyzed, others not)","operationId":"analyze_job_designations_api_designations_info_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DesignationInfoRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DesignationInfoResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/auth/token/current":{"get":{"summary":"Get Current Token","description":"Get the current rotational authentication token.\n\n**Security Note:**\n- Requires valid authentication to obtain a new token\n- Returns the current rotational token that clients should use\n- This endpoint is protected to prevent unauthorized token access\n\n**Usage:**\nUse this endpoint to obtain the current rotational token when your existing token is about to expire.\nThe returned token will be valid for the configured validity period.\n\n**Response:**\n```json\n{\n    \"current_token\": \"ROT_abc123...\",\n    \"token_type\": \"rotational\",\n    \"message\": \"Current rotational token retrieved successfully\"\n}\n```","operationId":"get_current_token_auth_token_current_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/auth/token/info":{"get":{"summary":"Get Token Information","description":"Get detailed information about the token rotation system.\n\n**Security Note:**\n- Requires valid authentication\n- Provides timing information for token rotation\n- Helps clients plan token refresh strategies\n\n**Response:**\n```json\n{\n    \"current_token\": \"ROT_abc123...\",\n    \"rotation_interval_hours\": 3,\n    \"token_validity_hours\": 6,\n    \"time_until_next_rotation_seconds\": 7200,\n    \"next_rotation_timestamp\": 1672531200,\n    \"system_status\": \"active\"\n}\n```","operationId":"get_token_information_auth_token_info_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/auth/token/health":{"get":{"summary":"Token System Health","description":"Check the health of the token rotation system.\n\n**Public Endpoint:**\n- No authentication required\n- Provides system health status\n- Returns basic configuration information\n\n**Response:**\n```json\n{\n    \"status\": \"healthy\",\n    \"rotation_enabled\": true,\n    \"rotation_interval_hours\": 3,\n    \"token_validity_hours\": 6,\n    \"supports_legacy_tokens\": true\n}\n```","operationId":"token_system_health_auth_token_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/auth/encryption/info":{"get":{"summary":"Get Encryption System Info","description":"Get information about the rotational encryption system.\n\n**Security Note:**\n- Requires rotational authentication (ROT_ tokens only)\n- Provides timing information for encryption key rotation\n- Helps clients synchronize encryption key generation\n\n**Response:**\n```json\n{\n    \"encryption_system\": \"rotational\",\n    \"rotation_interval_hours\": 3,\n    \"key_validity_hours\": 6,\n    \"time_until_next_rotation_seconds\": 7200,\n    \"next_rotation_timestamp\": 1672531200,\n    \"current_timestamp\": 1672524000,\n    \"valid_keys_count\": 3\n}\n```","operationId":"get_encryption_system_info_auth_encryption_info_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/formula-test-generator":{"post":{"summary":"Generate Formula Test Data Endpoint","description":"Formula Test Data Generator API - AI-Powered Test Case Generation\n\nThis endpoint uses Groq LLM to analyze JavaScript-like formula scripts and generate \ncomprehensive test data that covers all possible scenarios, edge cases, and boundary conditions.\n\n**Features:**\n- **Formula Analysis**: Parse and understand JavaScript-like conditional logic and formulas\n- **Comprehensive Test Coverage**: Generate test cases for all logical branches and conditions\n- **Boundary Testing**: Include edge cases and boundary values automatically\n- **LLM-Powered**: Uses Groq 8B model for intelligent test case generation\n- **Multiple Formats**: Return data in detailed analysis format or table format\n- **Accurate Calculations**: Ensures all expected output values are correctly calculated\n\n**Supported Formula Features:**\n- Conditional statements (if/else logic)\n- Mathematical operations (+, -, *, /, %)\n- Comparison operators (>=, <=, >, <, ==, !=)\n- Logical operators (and, or)\n- Multiple input and output variables\n- Nested conditions and complex formulas\n\n     **Request Format:**\n \n Use form data (multipart/form-data) instead of JSON:\n \n ```\n Content-Type: multipart/form-data\n \n script: if (creditScore >= 750 && loanAmount < 500000) {\n     monthlyInterest = (loanAmount * 0.035) / 12 + processingFee * 0.05;\n } else if (creditScore >= 650 && creditScore < 750) {\n     monthlyInterest = (loanAmount * 0.055) / 12 + processingFee * 0.08;\n } else {\n     monthlyInterest = (loanAmount * 0.085) / 12 + processingFee * 0.12;\n }\n \n format_type: detailed\n ```\n\n     **Example JavaScript Code Formats:**\n \n ```javascript\n // Loan interest calculation\n if (creditScore >= 750 && loanAmount < 500000) {\n     monthlyInterest = (loanAmount * 0.035) / 12 + processingFee * 0.05;\n } else if (creditScore >= 650 && creditScore < 750) {\n     monthlyInterest = (loanAmount * 0.055) / 12 + processingFee * 0.08;\n } else {\n     monthlyInterest = (loanAmount * 0.085) / 12 + processingFee * 0.12;\n }\n \n // Discount calculation\n if (age >= 18 && age < 65) {\n     discount = price * 0.1;\n } else {\n     discount = 0;\n }\n \n // Grade calculation\n if (score >= 90) {\n     grade = 'A';\n } else if (score >= 80) {\n     grade = 'B';\n } else {\n     grade = 'C';\n }\n ```\n\n**Response Formats:**\n\n**Detailed Format** (`format_type: \"detailed\"`):\n```json\n{\n    \"success\": true,\n    \"script\": \"original script\",\n    \"analysis\": {\n        \"input_variables\": [\"creditScore\", \"loanAmount\", \"processingFee\"],\n        \"output_variables\": [\"monthlyInterest\"],\n        \"conditions\": [\"creditScore >= 750 && loanAmount < 500000\", \"creditScore >= 650 && creditScore < 750\"],\n        \"formulas\": [\"(loanAmount * 0.035) / 12 + processingFee * 0.05\", \"(loanAmount * 0.055) / 12 + processingFee * 0.08\", \"(loanAmount * 0.085) / 12 + processingFee * 0.12\"]\n    },\n    \"test_data\": [\n        {\n                         \"test_case_id\": 1,\n         \"input_values\": {\"creditScore\": 750, \"loanAmount\": 400000, \"processingFee\": 1000},\n         \"expected_output\": {\"monthlyInterest\": 1216.67}\n        }\n    ],\n    \"total_test_cases\": 15,\n    \"format\": \"detailed\"\n}\n```\n\n**Table Format** (`format_type: \"table\"`):\n```json\n{\n    \"success\": true,\n    \"test_data_table\": [\n        {\n            \"creditScore\": 750,\n            \"loanAmount\": 400000,\n            \"processingFee\": 1000,\n            \"monthlyInterest\": 1216.67,\n            \"test_case_id\": 1\n        }\n    ],\n    \"format\": \"table\"\n}\n```\n\n**Use Cases:**\n- **QA Testing**: Generate comprehensive test cases for business logic validation\n- **Formula Verification**: Verify complex calculation logic with edge cases\n- **Regression Testing**: Create test data sets for automated testing\n- **Business Rule Testing**: Validate conditional business rules across all scenarios\n- **Documentation**: Generate test case documentation for formulas and business logic\n\n**Error Handling:**\n- Validates script syntax and structure\n- Handles malformed or incomplete formulas gracefully  \n- Provides detailed error messages for debugging\n- Includes validation information in response","operationId":"generate_formula_test_data_endpoint_api_formula_test_generator_post","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_generate_formula_test_data_endpoint_api_formula_test_generator_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FormulaTestResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/formula-script-validate":{"post":{"summary":"Validate Formula Script Endpoint","description":"Formula Script Validation API - deterministic, no LLM.\n\n    Validates a formula script against the terms configured for the contract and\n    returns ONE message for the UI's read-only error text box.\n\n    **The property to display: `validation_error`.** It is `null` when the script\n    is valid, and a single human-readable sentence when it is not.\n\n    **Two kinds of error:**\n\n    1. `error_type: \"term\"` — the script references a variable, attribute,\n       assignment field, class property or tag that is not in the configured\n       Assignment, Attributes, Classname or Taglist:\n\n       ```\n       Invalid field/term 'contract.designation'. The referenced term is not\n       available in the configured Assignment, Attributes, Classname, or Taglist.\n       ```\n\n    2. `error_type: \"syntax\"` — every referenced term is valid but the script is\n       malformed (invalid condition, missing bracket, invalid operator, invalid\n       expression):\n\n       ```\n       Syntax error at line 1, column 18: assignment operator '=' used inside a\n       condition. Use '==' to compare values.\n       ```\n\n    Term errors are reported first: if the script has both an unknown term and a\n    syntax error, `validation_error` names the unknown term. The syntax message\n    is still present in `validation_errors`.\n\n    **Reference syntax** — both forms are accepted for the same thing:\n    `{taglist.HeadCount}` (braced placeholder) and `contract.designation`\n    (bare dotted path). A class prefix is only a prefix: `contract.designation`\n    is valid only when `designation` itself is a configured Assignment,\n    Attribute or tag.\n\n    **Request:**\n    ```json\n    {\n      \"Assignment\": [\"BaseAmount\", \"MarkUp\", \"ExecutedServiceTerms\", \"Discount\", \"LateFee\"],\n      \"Attributes\": [\"CTC\", \"Input\", \"BillableCTC\"],\n      \"Classname\": \"contract.\",\n      \"taglist\": [],\n      \"script\": \"if (contract.designation = Java Developer) {\n  BaseAmount = (BillableCTC * 6) / 100;\n}\"\n    }\n    ```\n\n    **Response:**\n    ```json\n    {\n      \"is_valid\": false,\n      \"validation_error\": \"Invalid field/term 'contract.designation'. The referenced term is not available in the configured Assignment, Attributes, Classname, or Taglist.\",\n      \"validation_errors\": [\"Invalid field/term 'contract.designation'. ...\", \"...\"],\n      \"error_type\": \"term\",\n      \"invalid_terms\": [\"contract.designation\", \"Java\", \"Developer\"],\n      \"referenced_terms\": [\"contract.designation\", \"Java\", \"Developer\", \"BaseAmount\", \"BillableCTC\"],\n      \"term_validation_applied\": true\n    }\n    ```\n\n    **Note:** term validation needs at least one configured name. When\n    `Assignment`, `Attributes` and `taglist` are all empty there is nothing to\n    check terms against, so only syntax is validated and\n    `term_validation_applied` comes back `false`.","operationId":"validate_formula_script_endpoint_api_formula_script_validate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FormulaScriptValidationRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FormulaScriptValidationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/prepert/api/generate-questions":{"post":{"summary":"Generate Interview Questions Endpoint","description":"Generate interview questions based on job description.\n\nThis endpoint analyzes a job description and generates a comprehensive set of\ntechnical and behavioral interview questions with detailed answer keys and\nevaluation criteria.\n\nFeatures:\n- Generates both technical (70%) and behavioral (30%) questions\n- Provides detailed answer keys with evaluation criteria\n- Includes expected skills being tested for each question\n- Weighs questions by importance (1-10 scale)\n- Focuses on relevant technologies mentioned in job description","operationId":"generate_interview_questions_endpoint_prepert_api_generate_questions_post","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_generate_interview_questions_endpoint_prepert_api_generate_questions_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuestionGenerationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/prepert/api/evaluate-answer":{"post":{"summary":"Evaluate Interview Answer Endpoint","description":"Evaluate an interview answer and provide detailed feedback.\n\nThis endpoint evaluates a candidate's answer to an interview question and\nprovides comprehensive feedback including scores, strengths, weaknesses,\nand improvement suggestions.\n\nFeatures:\n- Provides overall score (0-100) and component scores\n- Identifies strengths and areas for improvement\n- Compares answer against ideal response and key points\n- Gives actionable suggestions for improvement\n- Assesses experience level demonstrated by the answer\n- Provides pass/fail recommendation with confidence level","operationId":"evaluate_interview_answer_endpoint_prepert_api_evaluate_answer_post","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_evaluate_interview_answer_endpoint_prepert_api_evaluate_answer_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnswerEvaluationResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/prepert/api/question-types":{"get":{"summary":"Get Interview Question Types","description":"Get available interview question types and categories.\n\nReturns information about the different types of questions that can be generated\nand the categories they fall into.","operationId":"get_interview_question_types_prepert_api_question_types_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/prepert/api/chat":{"post":{"summary":"Prepert Chat","description":"Chat with AI assistant using Llama 3.1 8B model for Prepert.\n\nThis endpoint allows users to ask questions and get responses from the AI assistant\npowered by the prepert_chat LLM service (gpt-oss-safeguard-20b through OpenRouter) following the same pattern as resumeParse.","operationId":"prepert_chat_prepert_api_chat_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrepertChatRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrepertChatResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/prepert/api/generate-mcq":{"post":{"summary":"Prepert Generate Mcq","description":"Generate multiple-choice questions (MCQs) with answer keys for a given subtopic.\n\nThis endpoint generates between 5 to 15 MCQ questions based on the provided subtopic name.\nEach question includes 4 options (A, B, C, D), correct answer, explanation, and difficulty level.\nUses the prepert_chat LLM service (gpt-oss-safeguard-20b through OpenRouter) following the same pattern as other Prepert endpoints.","operationId":"prepert_generate_mcq_prepert_api_generate_mcq_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrepertMCQRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrepertMCQResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/tallite-search-builder":{"post":{"summary":"Tallite Search Builder Endpoint","description":"Tallite Search Builder API - Build or refine structured search parameters.\n\n**Modes:**\n- `build` (default): extract a fresh search query from `free_text` and/or\n  `requirements_context` (job-requirement details fetched by the caller).\n- `refine`: adjust an existing `current_query` (JSON string) using\n  `adjustment_prompt` (e.g. \"make Java required\", \"exclude Mumbai\",\n  \"remove the age filter\"), optionally merging `requirements_context`.\n\n**Request Format:** form-data. `build` needs `free_text` and/or\n`requirements_context`; `refine` needs `current_query` + `adjustment_prompt`.","operationId":"tallite_search_builder_endpoint_api_tallite_search_builder_post","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_tallite_search_builder_endpoint_api_tallite_search_builder_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TalliteSearchBuilderResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/bi-reports-evaluator":{"post":{"summary":"Bi Reports Evaluator Endpoint","description":"Generates an AlaSQL query from a natural language prompt and view schema.\n\nThe frontend runs the returned query via: alasql(function_code, [data])","operationId":"bi_reports_evaluator_endpoint_api_bi_reports_evaluator_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BiReportEvaluatorRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BiReportEvaluatorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/bi-reports-summary":{"post":{"summary":"Bi Reports Summary Endpoint","description":"Generates a text-based analytical summary from computed BI report data.\n\nCall this after running the AlaSQL query on the frontend — send the result data\nand original prompt to get an AI-generated insight summary.","operationId":"bi_reports_summary_endpoint_api_bi_reports_summary_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BiReportSummaryRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BiReportSummaryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/timesheet/parse":{"post":{"summary":"Parse Timesheet Endpoint","description":"Parse a timesheet file and extract structured employee attendance data.\n\nSupported formats: .xlsx, .xls, .pdf, .jpg, .jpeg, .png, .tiff, .bmp\n\nThe context field is optional. Any missing fields will be:\n- month/year/cycleStartDate/cycleEndDate: extracted from dates found in the timesheet\n- dayHours: defaults to 8\n- halfDayHours: defaults to 4\n- sellerDayTypes: defaults to standard set (WD, HD, WO, GH, PH, LOP, CL, SL, EL, CO)","operationId":"parse_timesheet_endpoint_api_timesheet_parse_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_parse_timesheet_endpoint_api_timesheet_parse_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/plivo/incoming":{"get":{"summary":"Plivo Incoming","description":"Plivo Answer URL (the Voice Application's \"a call comes in\" webhook).\n\nResolves which agent answers from the dialed number (\"To\"), then returns\nPlivo XML that opens a bidirectional Audio Stream back to this server with\nthe resolved agent_id on the stream URL. The stream URL is derived from the\nrequest Host so it works unchanged behind ngrok (dev) or nginx (prod).\nOverride with VOICE_STREAM_WSS_URL if Plivo should reach the stream on a\ndifferent host.","operationId":"plivo_incoming_plivo_incoming_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"summary":"Plivo Incoming","description":"Plivo Answer URL (the Voice Application's \"a call comes in\" webhook).\n\nResolves which agent answers from the dialed number (\"To\"), then returns\nPlivo XML that opens a bidirectional Audio Stream back to this server with\nthe resolved agent_id on the stream URL. The stream URL is derived from the\nrequest Host so it works unchanged behind ngrok (dev) or nginx (prod).\nOverride with VOICE_STREAM_WSS_URL if Plivo should reach the stream on a\ndifferent host.","operationId":"plivo_incoming_plivo_incoming_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/admin/voice/agents":{"get":{"summary":"List Voice Agents","description":"List loaded voice agents (id, name, version, routing numbers).","operationId":"list_voice_agents_admin_voice_agents_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/admin/voice/agents/reload":{"post":{"summary":"Reload Voice Agents","description":"Re-read agents/*.yaml from disk (manual fallback to the file watcher).","operationId":"reload_voice_agents_admin_voice_agents_reload_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/tts/voices":{"get":{"tags":["Text-to-Speech"],"summary":"Tts Voices Endpoint","description":"List the voices available on the Kokoro TTS engine.\n\n**Authentication**: Bearer token (static API key or rotational token), same\nas every other API on this service.","operationId":"tts_voices_endpoint_tts_voices_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/tts":{"post":{"tags":["Text-to-Speech"],"summary":"Tts Endpoint","description":"Synthesize text into a complete WAV audio file (24 kHz, 16-bit PCM, mono).\n\nReturns the entire audio response in a single body. For long inputs prefer\n`POST /tts/stream` so playback can start before synthesis completes.\n\n**Authentication**: Bearer token, same as every other API on this service.","operationId":"tts_endpoint_tts_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TTSRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/tts/stream":{"post":{"tags":["Text-to-Speech"],"summary":"Tts Stream Endpoint","description":"Stream synthesized speech as a chunked WAV response (24 kHz, 16-bit PCM, mono).\n\nThe WAV header is emitted first, followed by PCM frames as each segment of\nthe input finishes synthesizing. Allows playback to start before the full\ntext has been processed.\n\n**Authentication**: Bearer token, same as every other API on this service.","operationId":"tts_stream_endpoint_tts_stream_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TTSRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/video/generate":{"post":{"tags":["Video"],"summary":"Generate Video Endpoint","description":"Generate a narrated lesson video from a scene spec.\n\nAccepts a ``{ lessonId, spec }`` body where ``spec`` follows the lesson-video\nschema: a `title` (required), optional `subtitle` / `accentColor` /\n`brandLabel`, and an ordered list of `scenes`. Each scene has a `kind`\n(one of: title-card, section-header, bullets, quote, checklist, callout,\nclosing, diagram, scenario), a `durationSec` (clamped here to 3–20s), a\nfree-form `data` object, and the `narration` text read aloud.\n\nThe request is validated and proxied to the internal render service, which\nsynthesizes the narration (TTS), renders the video, uploads it to MinIO, and\nreturns the playable URL. Returns ``{ videoUrl, minioKey, durationSec,\nsizeBytes }``.\n\n**Authentication**: Bearer token, same as every other API on this service.","operationId":"generate_video_endpoint_video_generate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateVideoRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateVideoResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/illustrations/catalog":{"get":{"tags":["Video"],"summary":"Illustration Catalog Endpoint","description":"Return the illustration catalog for video specs: a ``{ slug: { description,\ntags } }`` map of every illustration the render service can draw.\n\nClients (e.g. the video-spec generator) use the slugs to constrain the LLM's\n``data.illustration`` choices and the descriptions to prompt it. Proxied from\nthe render service.\n\n**Authentication**: Bearer token, same as every other API on this service.","operationId":"illustration_catalog_endpoint_illustrations_catalog_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"APIKeyHeader":[]}]}},"/web-page":{"post":{"tags":["Web page"],"summary":"Web Page Endpoint","description":"Open a public web page in a headless browser (kitesurf), run its JavaScript\nand return the rendered text: `{url, title, text, loaded, truncated, ms}`.\n\n`url` is where the page ended up after redirects. `loaded` is false when the\nload event did not fire before the timeout (the text is what had rendered by\nthen). Text is capped at 200,000 characters (`truncated`).\n\n**Authentication**: Bearer token, same as every other API on this service.","operationId":"web_page_endpoint_web_page_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebPageRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/web-page":{"post":{"tags":["Web page"],"summary":"Web Page Endpoint","description":"Open a public web page in a headless browser (kitesurf), run its JavaScript\nand return the rendered text: `{url, title, text, loaded, truncated, ms}`.\n\n`url` is where the page ended up after redirects. `loaded` is false when the\nload event did not fire before the timeout (the text is what had rendered by\nthen). Text is capped at 200,000 characters (`truncated`).\n\n**Authentication**: Bearer token, same as every other API on this service.","operationId":"web_page_endpoint_api_web_page_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebPageRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/search":{"post":{"tags":["Web page"],"summary":"Web Search Endpoint","description":"Search the web: the query runs on several engines at once in a headless\nbrowser (kitesurf), and the results are merged into one ranked list.\n\nEach result: `{position, title, url, snippet, engines, score}`, where\n`engines` lists every engine that found the page; pages several engines rank\nhigh come first. With `include_content`, the top `content_results` pages are\nopened too and get `content` (their rendered text) or `content_error`.\n\n`engines` in the response reports each engine: `ok`, `no_results`,\n`blocked` (CAPTCHA), `off_topic` (decoy results dropped) or `error`.\n503 when no engine answered.\n\n**Authentication**: Bearer token, same as every other API on this service.","operationId":"web_search_endpoint_search_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebSearchRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/search":{"post":{"tags":["Web page"],"summary":"Web Search Endpoint","description":"Search the web: the query runs on several engines at once in a headless\nbrowser (kitesurf), and the results are merged into one ranked list.\n\nEach result: `{position, title, url, snippet, engines, score}`, where\n`engines` lists every engine that found the page; pages several engines rank\nhigh come first. With `include_content`, the top `content_results` pages are\nopened too and get `content` (their rendered text) or `content_error`.\n\n`engines` in the response reports each engine: `ok`, `no_results`,\n`blocked` (CAPTCHA), `off_topic` (decoy results dropped) or `error`.\n503 when no engine answered.\n\n**Authentication**: Bearer token, same as every other API on this service.","operationId":"web_search_endpoint_api_search_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebSearchRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/embeddings":{"post":{"tags":["Embeddings"],"summary":"Embeddings Endpoint","description":"Embed text with pplx-embed-v1-0.6b, served through OpenRouter.\n\nReturns one 1024-dim unit-length vector per input, in input order, so cosine\nsimilarity is a plain dot product. Up to 2048 inputs per request (split into\nparallel OpenRouter calls); inputs over 32,768 tokens are truncated.\n\n**Authentication**: Bearer token, same as every other API on this service.","operationId":"embeddings_endpoint_embeddings_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmbeddingRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}},"/api/embeddings":{"post":{"tags":["Embeddings"],"summary":"Embeddings Endpoint","description":"Embed text with pplx-embed-v1-0.6b, served through OpenRouter.\n\nReturns one 1024-dim unit-length vector per input, in input order, so cosine\nsimilarity is a plain dot product. Up to 2048 inputs per request (split into\nparallel OpenRouter calls); inputs over 32,768 tokens are truncated.\n\n**Authentication**: Bearer token, same as every other API on this service.","operationId":"embeddings_endpoint_api_embeddings_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmbeddingRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"APIKeyHeader":[]}]}}},"components":{"schemas":{"Address":{"properties":{"street":{"type":"string","title":"Street","description":"Street address","default":""},"city":{"type":"string","title":"City","description":"City","default":""},"state":{"type":"string","title":"State","description":"State","default":""},"country":{"type":"string","title":"Country","description":"Country","default":""},"postal_code":{"type":"string","title":"Postal Code","description":"Postal code","default":""}},"type":"object","title":"Address"},"AddressData":{"properties":{"addressLine1":{"type":"string","title":"Addressline1","description":"First line of address (house number, building/complex name)","default":""},"addressLine2":{"type":"string","title":"Addressline2","description":"Second line of address (street, lane, locality)","default":""},"city":{"type":"string","title":"City","description":"City name only (without district/zone/direction)","default":""},"state":{"type":"string","title":"State","description":"State/Province/Emirate name","default":""},"country":{"type":"string","title":"Country","description":"Country name","default":""},"postalCode":{"type":"string","title":"Postalcode","description":"Postal/ZIP/PIN code","default":""}},"type":"object","title":"AddressData","description":"Model for parsed address information"},"AddressError":{"properties":{"errorCode":{"type":"string","title":"Errorcode","description":"Error code"},"message":{"type":"string","title":"Message","description":"Error message"}},"type":"object","required":["errorCode","message"],"title":"AddressError","description":"Model for address parsing errors"},"AddressParserResponse":{"properties":{"success":{"type":"boolean","title":"Success","description":"Whether the request was successful"},"data":{"anyOf":[{"$ref":"#/components/schemas/AddressData"},{"type":"null"}],"description":"Parsed address data"},"errors":{"items":{"$ref":"#/components/schemas/AddressError"},"type":"array","title":"Errors","description":"List of errors"},"timestamp":{"type":"string","title":"Timestamp","description":"Response timestamp"}},"type":"object","required":["success"],"title":"AddressParserResponse","description":"Response model for address parser API"},"AnswerEvaluationResponse":{"properties":{"overall_score":{"type":"integer","maximum":100.0,"minimum":0.0,"title":"Overall Score","description":"Overall score from 0-100","default":0},"feedback":{"type":"string","title":"Feedback","description":"Comprehensive feedback text","default":""},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","description":"Evaluation metadata"},"validation_errors":{"items":{"type":"string"},"type":"array","title":"Validation Errors","description":"List of validation errors"}},"type":"object","title":"AnswerEvaluationResponse"},"BiReportChartConfig":{"properties":{"type":{"type":"string","title":"Type","description":"Chart type: bar, horizontal_bar, stacked_bar, line, area, pie, donut, scatter, heatmap, table, kpi_card"},"title":{"type":"string","title":"Title","description":"Chart title"},"x_axis":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X Axis","description":"Result column for x-axis/category"},"y_axis":{"anyOf":[{},{"type":"null"}],"title":"Y Axis","description":"Result column(s) for y-axis/value"},"group_by":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Group By","description":"Result column for series grouping"},"value":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Value","description":"Column name for kpi_card value"},"reason":{"type":"string","title":"Reason","description":"Why this chart type fits the data","default":""}},"type":"object","required":["type","title"],"title":"BiReportChartConfig"},"BiReportEvaluatorRequest":{"properties":{"user_prompt":{"type":"string","minLength":3,"title":"User Prompt","description":"Natural language description of the desired BI report"},"view_schema":{"additionalProperties":true,"type":"object","title":"View Schema","description":"View schema with viewId, viewName, and columns array"}},"type":"object","required":["user_prompt","view_schema"],"title":"BiReportEvaluatorRequest"},"BiReportEvaluatorResponse":{"properties":{"function_code":{"type":"string","title":"Function Code","description":"Generated AlaSQL query"},"result_shape":{"items":{},"type":"array","title":"Result Shape","description":"Example shape of the result array"},"charts":{"items":{"$ref":"#/components/schemas/BiReportChartConfig"},"type":"array","title":"Charts","description":"Recommended chart visualizations"},"user_prompt":{"type":"string","title":"User Prompt","description":"The original user prompt"},"view_name":{"type":"string","title":"View Name","description":"The view name from the schema","default":""},"moderation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Moderation","description":"Content moderation message if the query was flagged as inappropriate"},"validation_errors":{"items":{},"type":"array","title":"Validation Errors","description":"List of validation errors if any"}},"type":"object","required":["function_code","user_prompt"],"title":"BiReportEvaluatorResponse"},"BiReportSummaryRequest":{"properties":{"user_prompt":{"type":"string","title":"User Prompt","description":"The original user prompt"},"result_data":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Result Data","description":"Computed result data from the AlaSQL query"}},"type":"object","required":["user_prompt","result_data"],"title":"BiReportSummaryRequest"},"BiReportSummaryResponse":{"properties":{"title":{"type":"string","title":"Title","description":"Short title for the summary","default":""},"summary":{"type":"string","title":"Summary","description":"Analytical summary in markdown format","default":""},"moderation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Moderation","description":"Content moderation message if the query was flagged as inappropriate"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error","description":"Error message if summary generation failed"}},"type":"object","title":"BiReportSummaryResponse"},"Body_analyze_career_path_analyze_career_path_post":{"properties":{"resume_file":{"type":"string","contentMediaType":"application/octet-stream","title":"Resume File","description":"Resume file to analyze"},"job_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Description","description":"Optional job description to match against"},"target_role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Role","description":"Optional target role to analyze career path for"}},"type":"object","required":["resume_file"],"title":"Body_analyze_career_path_analyze_career_path_post"},"Body_analyze_cv_analyze_cv_post":{"properties":{"resume_file":{"type":"string","contentMediaType":"application/octet-stream","title":"Resume File"},"job_description":{"type":"string","title":"Job Description"},"jd_requirements":{"type":"string","title":"Jd Requirements"},"job_context":{"type":"string","title":"Job Context"},"candidate_context":{"type":"string","title":"Candidate Context"},"applicant_id":{"type":"string","title":"Applicant Id"},"include_executive_summary":{"type":"boolean","title":"Include Executive Summary","default":false}},"type":"object","required":["resume_file"],"title":"Body_analyze_cv_analyze_cv_post"},"Body_cv_analysis_document_branded_cv_analysis_document_branded__post":{"properties":{"profile":{"type":"string","title":"Profile","description":"JSON string containing the CV analysis data"},"companyLogo":{"anyOf":[{"type":"string","contentMediaType":"application/octet-stream"},{"type":"null"}],"title":"Companylogo","description":"Company logo image file (png, jpg, svg, etc.)"},"logoPosition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logoposition","description":"Logo position: TL (top-left), TR (top-right), BL (bottom-left), BR (bottom-right)","default":"TR"},"watermark":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Watermark","description":"Enable diagonal watermark text","default":false},"watermarkText":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Watermarktext","description":"Text to display as watermark (e.g. CONFIDENTIAL, company name)"}},"type":"object","required":["profile"],"title":"Body_cv_analysis_document_branded_cv_analysis_document_branded__post"},"Body_detect_language_file_detect_language_file__post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":"PDF, DOCX, or image file to detect the language of"}},"type":"object","required":["file"],"title":"Body_detect_language_file_detect_language_file__post"},"Body_detect_language_text_detect_language_text__post":{"properties":{"text":{"type":"string","title":"Text","description":"Text to detect the language of"}},"type":"object","required":["text"],"title":"Body_detect_language_text_detect_language_text__post"},"Body_document_triage_batch_api_document_triage_batch_post":{"properties":{"files":{"items":{"type":"string","contentMediaType":"application/octet-stream"},"type":"array","title":"Files","description":"The documents to triage, up to 200 per request."},"max_pages_read":{"type":"integer","title":"Max Pages Read","description":"Pages inspected per document (default 6).","default":6},"ocr_scans":{"type":"boolean","title":"Ocr Scans","description":"OCR page 1 of each scan to name its language. Off by default; it is the one slow step.","default":false},"check_document_type":{"type":"boolean","title":"Check Document Type","description":"Also run the local CV/not-CV classifier on each document.","default":false}},"type":"object","required":["files"],"title":"Body_document_triage_batch_api_document_triage_batch_post"},"Body_document_triage_batch_document_triage_batch_post":{"properties":{"files":{"items":{"type":"string","contentMediaType":"application/octet-stream"},"type":"array","title":"Files","description":"The documents to triage, up to 200 per request."},"max_pages_read":{"type":"integer","title":"Max Pages Read","description":"Pages inspected per document (default 6).","default":6},"ocr_scans":{"type":"boolean","title":"Ocr Scans","description":"OCR page 1 of each scan to name its language. Off by default; it is the one slow step.","default":false},"check_document_type":{"type":"boolean","title":"Check Document Type","description":"Also run the local CV/not-CV classifier on each document.","default":false}},"type":"object","required":["files"],"title":"Body_document_triage_batch_document_triage_batch_post"},"Body_document_triage_one_api_document_triage_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":"The document to triage: pdf, docx, an image, txt, rtf, html, csv or xlsx."},"max_pages_read":{"type":"integer","title":"Max Pages Read","description":"Pages inspected for layout, language and text (default 6). The page count returned is always the document's real one.","default":6},"ocr_scans":{"type":"boolean","title":"Ocr Scans","description":"OCR page 1 of a scan to name its language. Off by default: the only step that costs seconds rather than milliseconds, and a scan is 'hard' either way.","default":false},"check_document_type":{"type":"boolean","title":"Check Document Type","description":"Also run the local CV/not-CV classifier, so non-CVs can be dropped from the batch before parsing.","default":false}},"type":"object","required":["file"],"title":"Body_document_triage_one_api_document_triage_post"},"Body_document_triage_one_document_triage_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":"The document to triage: pdf, docx, an image, txt, rtf, html, csv or xlsx."},"max_pages_read":{"type":"integer","title":"Max Pages Read","description":"Pages inspected for layout, language and text (default 6). The page count returned is always the document's real one.","default":6},"ocr_scans":{"type":"boolean","title":"Ocr Scans","description":"OCR page 1 of a scan to name its language. Off by default: the only step that costs seconds rather than milliseconds, and a scan is 'hard' either way.","default":false},"check_document_type":{"type":"boolean","title":"Check Document Type","description":"Also run the local CV/not-CV classifier, so non-CVs can be dropped from the batch before parsing.","default":false}},"type":"object","required":["file"],"title":"Body_document_triage_one_document_triage_post"},"Body_evaluate_interview_answer_endpoint_prepert_api_evaluate_answer_post":{"properties":{"question":{"type":"string","title":"Question","description":"The interview question text"},"question_type":{"type":"string","title":"Question Type","description":"Type of question (technical, behavioral, situational, problem_solving)"},"answer_expectations":{"type":"string","title":"Answer Expectations","description":"What constitutes a good answer for this question"},"provided_answer":{"type":"string","minLength":5,"title":"Provided Answer","description":"Candidate's answer to evaluate"}},"type":"object","required":["question","question_type","answer_expectations","provided_answer"],"title":"Body_evaluate_interview_answer_endpoint_prepert_api_evaluate_answer_post"},"Body_extract_skills_endpoint_extract_skills__post":{"properties":{"text":{"type":"string","title":"Text","description":"Resume or job description text to analyze"}},"type":"object","required":["text"],"title":"Body_extract_skills_endpoint_extract_skills__post"},"Body_fileconversion_function_auth_fileconversion_post":{"properties":{"image":{"type":"string","contentMediaType":"application/octet-stream","title":"Image"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language","description":"Language hint for OCR. Supported: 'th' (Thai), 'vi' (Vietnamese), 'ms' (Malay), 'ja' (Japanese). If not provided, defaults to English."}},"type":"object","required":["image"],"title":"Body_fileconversion_function_auth_fileconversion_post"},"Body_fileupload_v2_fileupload_post":{"properties":{"image":{"type":"string","contentMediaType":"application/octet-stream","title":"Image"}},"type":"object","required":["image"],"title":"Body_fileupload_v2_fileupload_post"},"Body_fileupload_v3_max_v3_fileupload_max_post":{"properties":{"image":{"type":"string","contentMediaType":"application/octet-stream","title":"Image"}},"type":"object","required":["image"],"title":"Body_fileupload_v3_max_v3_fileupload_max_post"},"Body_fileupload_v3_max_v3_fileupload_min_post":{"properties":{"image":{"type":"string","contentMediaType":"application/octet-stream","title":"Image"}},"type":"object","required":["image"],"title":"Body_fileupload_v3_max_v3_fileupload_min_post"},"Body_generate_formula_equation_endpoint_api_generate_formula_equation_post":{"properties":{"description":{"type":"string","title":"Description","description":"Free text description of the formula/equation"},"parameters":{"type":"string","title":"Parameters","description":"JSON array of class parameter objects (or single object). Each object: {Classname, Attributes, Assignment, ...tagLists}"},"multipleResponse":{"type":"boolean","title":"Multipleresponse","description":"If true, return an array of formulas (one per assignment target the description covers). Default false → single equation as before.","default":false}},"type":"object","required":["description"],"title":"Body_generate_formula_equation_endpoint_api_generate_formula_equation_post"},"Body_generate_formula_test_data_endpoint_api_formula_test_generator_post":{"properties":{"script":{"type":"string","title":"Script","description":"JavaScript code to analyze and generate test data for"},"format_type":{"type":"string","title":"Format Type","description":"Output format: 'detailed' for full analysis or 'table' for tabular format","default":"detailed"},"Assignment":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assignment","description":"Configured assignment field names — JSON array or comma-separated. Enables term validation."},"Attributes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Attributes","description":"Configured attribute names — JSON array or comma-separated. Enables term validation."},"Classname":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Classname","description":"Configured class prefix, e.g. 'contract.'"},"taglist":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Taglist","description":"Configured tag names — JSON array or comma-separated. Enables term validation."}},"type":"object","required":["script"],"title":"Body_generate_formula_test_data_endpoint_api_formula_test_generator_post"},"Body_generate_interview_questions_endpoint_prepert_api_generate_questions_post":{"properties":{"job_description":{"type":"string","minLength":10,"title":"Job Description","description":"Job description text for generating relevant questions"},"difficulty_level":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Difficulty Level","description":"Difficulty level from 1-10","default":5},"question_count":{"type":"integer","maximum":50.0,"minimum":1.0,"title":"Question Count","description":"Number of questions to generate","default":10}},"type":"object","required":["job_description"],"title":"Body_generate_interview_questions_endpoint_prepert_api_generate_questions_post"},"Body_generate_synopsis_file_generate_synopsis_file__post":{"properties":{"resume_file":{"type":"string","contentMediaType":"application/octet-stream","title":"Resume File"},"length":{"type":"string","title":"Length","default":"medium"},"fullname":{"type":"string","title":"Fullname","default":""},"gender":{"type":"string","title":"Gender","default":""}},"type":"object","required":["resume_file"],"title":"Body_generate_synopsis_file_generate_synopsis_file__post"},"Body_generate_synopsis_text_generate_synopsis_text__post":{"properties":{"text":{"type":"string","title":"Text"},"length":{"type":"string","title":"Length","default":"medium"},"fullname":{"type":"string","title":"Fullname","default":""},"gender":{"type":"string","title":"Gender","default":""}},"type":"object","required":["text"],"title":"Body_generate_synopsis_text_generate_synopsis_text__post"},"Body_id_card_parser_id_card_parser_post":{"properties":{"image":{"type":"string","contentMediaType":"application/octet-stream","title":"Image"},"document_type":{"type":"string","title":"Document Type"}},"type":"object","required":["image"],"title":"Body_id_card_parser_id_card_parser_post"},"Body_job_description_summary_endpoint_api_job_description_summary_post":{"properties":{"job_description":{"type":"string","title":"Job Description","description":"Job description text to summarize"}},"type":"object","required":["job_description"],"title":"Body_job_description_summary_endpoint_api_job_description_summary_post"},"Body_naukri_html_processor_naukri_html_processor_post":{"properties":{"html_file":{"type":"string","contentMediaType":"application/octet-stream","title":"Html File","description":"HTML file containing Naukri profile data"}},"type":"object","required":["html_file"],"title":"Body_naukri_html_processor_naukri_html_processor_post"},"Body_parse_address_api_address_parser_post":{"properties":{"address_text":{"type":"string","title":"Address Text","description":"Free text address to parse"}},"type":"object","required":["address_text"],"title":"Body_parse_address_api_address_parser_post"},"Body_parse_contract_file_api_contract_parser_file_post":{"properties":{"contract_file":{"type":"string","contentMediaType":"application/octet-stream","title":"Contract File","description":"Contract document file (PDF, DOC, DOCX)"}},"type":"object","required":["contract_file"],"title":"Body_parse_contract_file_api_contract_parser_file_post"},"Body_parse_full_invoice_api_full_invoice_parser_post":{"properties":{"invoice_file":{"type":"string","contentMediaType":"application/octet-stream","title":"Invoice File"}},"type":"object","required":["invoice_file"],"title":"Body_parse_full_invoice_api_full_invoice_parser_post"},"Body_parse_invoice_api_expense_parser_post":{"properties":{"invoice_file":{"type":"string","contentMediaType":"application/octet-stream","title":"Invoice File"}},"type":"object","required":["invoice_file"],"title":"Body_parse_invoice_api_expense_parser_post"},"Body_parse_job_description_endpoint_cvmine_parse_job_description_post":{"properties":{"job_description":{"type":"string","title":"Job Description","description":"Job description text to parse"}},"type":"object","required":["job_description"],"title":"Body_parse_job_description_endpoint_cvmine_parse_job_description_post"},"Body_parse_job_description_one_call_route_api_email_parse_job_description_post":{"properties":{"file":{"anyOf":[{"type":"string","contentMediaType":"application/octet-stream"},{"type":"string"},{"type":"null"}],"title":"File"},"email_body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email Body","description":"Email body text to parse"},"client":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client","description":"Client name. If it refers to 'Manpower', the job_description_written is generated in the Manpower Job Posting Template format."}},"type":"object","title":"Body_parse_job_description_one_call_route_api_email_parse_job_description_post"},"Body_parse_job_description_one_call_route_api_email_parse_job_description_v2_post":{"properties":{"file":{"anyOf":[{"type":"string","contentMediaType":"application/octet-stream"},{"type":"string"},{"type":"null"}],"title":"File"},"email_body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email Body","description":"Email body text to parse"},"client":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client","description":"Client name. If it refers to 'Manpower', the job_description_written is generated in the Manpower Job Posting Template format."}},"type":"object","title":"Body_parse_job_description_one_call_route_api_email_parse_job_description_v2_post"},"Body_parse_job_description_route_api_email_parse_job_description_v1_post":{"properties":{"file":{"anyOf":[{"type":"string","contentMediaType":"application/octet-stream"},{"type":"string"},{"type":"null"}],"title":"File"},"email_body":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email Body","description":"Email body text to parse"},"client":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client","description":"Client name. If it refers to 'Manpower', the job_description_written is generated in the Manpower Job Posting Template format."}},"type":"object","title":"Body_parse_job_description_route_api_email_parse_job_description_v1_post"},"Body_parse_job_description_v2_endpoint_api_parse_job_description_v2_post":{"properties":{"job_description":{"type":"string","title":"Job Description","description":"Job description text to parse"}},"type":"object","required":["job_description"],"title":"Body_parse_job_description_v2_endpoint_api_parse_job_description_v2_post"},"Body_parse_resume_api_parse_resume_post":{"properties":{"image":{"type":"string","contentMediaType":"application/octet-stream","title":"Image"},"detailed_passport":{"type":"boolean","title":"Detailed Passport","description":"Extract detailed passport information if available","default":false},"detailed_driving_license":{"type":"boolean","title":"Detailed Driving License","description":"Extract detailed driving license information if available","default":false},"assume_gender":{"type":"boolean","title":"Assume Gender","description":"Predict gender if not explicitly mentioned","default":false},"include_industry_analysis":{"type":"boolean","title":"Include Industry Analysis","description":"Include industry exposure analysis and potential roles assessment","default":true},"option":{"type":"integer","title":"Option","description":"Parsing option level (integer value)","default":1},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language","description":"Language hint for OCR and parsing. Supported: 'th' (Thai), 'vi' (Vietnamese), 'ms' (Malay), 'ja' (Japanese). If not provided, defaults to English."},"inEnglish":{"type":"boolean","title":"Inenglish","description":"If True (default), translates parsed output to English. If False, preserves the original language in the output.","default":true},"mode":{"type":"string","title":"Mode","description":"Parsing mode: 'classic' (default) skips the profile summary to save tokens; 'full' opts back into it. Experience highlights and skills[].category are returned in both modes.","default":"classic"},"extended_summary":{"type":"boolean","title":"Extended Summary","description":"If True, fills summary with a ~75-word professional summary in the style a candidate writes atop their resume, and adds skill_summary, a ~75-word summary of the candidate's skills. Both are written only from what the resume states.","default":false},"backfill":{"type":"boolean","title":"Backfill","description":"If True, extracts only experience (with highlights), skills, certifications, summary and skill_summary, for filling those sections into existing records. The response keeps the same structure; every other field is left empty.","default":false},"client":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client","description":"Optional client name. Logged and returned as `client` in the response; it does not change the parse."}},"type":"object","required":["image"],"title":"Body_parse_resume_api_parse_resume_post"},"Body_parse_resume_fast_parse_resume_fast_post":{"properties":{"image":{"type":"string","contentMediaType":"application/octet-stream","title":"Image"},"option":{"type":"integer","title":"Option","description":"1 (default): the /parse-resume response. 2: the Naukri format, as /parse-resume option 2.","default":1},"mode":{"type":"string","title":"Mode","description":"'classic' (default) leaves summary and profiles empty, as /parse-resume does; 'full' fills summary with the resume's own summary section and profiles with its LinkedIn/GitHub links.","default":"classic"},"include_industry_analysis":{"type":"boolean","title":"Include Industry Analysis","description":"As /parse-resume. Industries are not inferred without the LLM, so industry_exposure is [] either way.","default":true},"detailed_passport":{"type":"boolean","title":"Detailed Passport","description":"As /parse-resume: keeps the passport_details key.","default":false},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language","description":"OCR language hint for scans and images, as /parse-resume."},"client":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client","description":"Optional client name, recorded in the parse log; it does not change the parse."}},"type":"object","required":["image"],"title":"Body_parse_resume_fast_parse_resume_fast_post"},"Body_parse_resume_fast_resume_parse_fast_post":{"properties":{"image":{"type":"string","contentMediaType":"application/octet-stream","title":"Image"},"option":{"type":"integer","title":"Option","description":"1 (default): the /parse-resume response. 2: the Naukri format, as /parse-resume option 2.","default":1},"mode":{"type":"string","title":"Mode","description":"'classic' (default) leaves summary and profiles empty, as /parse-resume does; 'full' fills summary with the resume's own summary section and profiles with its LinkedIn/GitHub links.","default":"classic"},"include_industry_analysis":{"type":"boolean","title":"Include Industry Analysis","description":"As /parse-resume. Industries are not inferred without the LLM, so industry_exposure is [] either way.","default":true},"detailed_passport":{"type":"boolean","title":"Detailed Passport","description":"As /parse-resume: keeps the passport_details key.","default":false},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language","description":"OCR language hint for scans and images, as /parse-resume."},"client":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client","description":"Optional client name, recorded in the parse log; it does not change the parse."}},"type":"object","required":["image"],"title":"Body_parse_resume_fast_resume_parse_fast_post"},"Body_parse_resume_fast_v2_parse_resume_fast_v2_post":{"properties":{"image":{"type":"string","contentMediaType":"application/octet-stream","title":"Image"},"option":{"type":"integer","title":"Option","description":"1 (default): the /parse-resume response. 2: the Naukri format, as /parse-resume option 2.","default":1},"mode":{"type":"string","title":"Mode","description":"'classic' (default) leaves summary and profiles empty, as /parse-resume does; 'full' fills summary with the resume's own summary section and profiles with its LinkedIn/GitHub links.","default":"classic"},"include_industry_analysis":{"type":"boolean","title":"Include Industry Analysis","description":"As /parse-resume. Industries are not inferred without the LLM, so industry_exposure is [] either way.","default":true},"detailed_passport":{"type":"boolean","title":"Detailed Passport","description":"As /parse-resume: keeps the passport_details key.","default":false},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language","description":"OCR language hint for scans and images, as /parse-resume."}},"type":"object","required":["image"],"title":"Body_parse_resume_fast_v2_parse_resume_fast_v2_post"},"Body_parse_resume_fast_v2_resume_parse_fast_v2_post":{"properties":{"image":{"type":"string","contentMediaType":"application/octet-stream","title":"Image"},"option":{"type":"integer","title":"Option","description":"1 (default): the /parse-resume response. 2: the Naukri format, as /parse-resume option 2.","default":1},"mode":{"type":"string","title":"Mode","description":"'classic' (default) leaves summary and profiles empty, as /parse-resume does; 'full' fills summary with the resume's own summary section and profiles with its LinkedIn/GitHub links.","default":"classic"},"include_industry_analysis":{"type":"boolean","title":"Include Industry Analysis","description":"As /parse-resume. Industries are not inferred without the LLM, so industry_exposure is [] either way.","default":true},"detailed_passport":{"type":"boolean","title":"Detailed Passport","description":"As /parse-resume: keeps the passport_details key.","default":false},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language","description":"OCR language hint for scans and images, as /parse-resume."}},"type":"object","required":["image"],"title":"Body_parse_resume_fast_v2_resume_parse_fast_v2_post"},"Body_parse_resume_layout_parse_resume_layout_post":{"properties":{"image":{"type":"string","contentMediaType":"application/octet-stream","title":"Image","description":"The resume: PDF, page image (PNG, JPG, TIFF, WEBP), or Word/RTF/ODT."},"include_pages":{"type":"boolean","title":"Include Pages","description":"Add each page as a JPEG data URL, to draw the boxes on.","default":false},"include_lines":{"type":"boolean","title":"Include Lines","description":"Add every line with its box, section, heading and entry marks.","default":false},"type":{"type":"string","title":"Type","description":"Response shape: 'layout' (default) is what the parser read, with boxes; 'tallite' is /parse-resume's response (same keys, nesting and types; a value not read is left empty).","default":"layout"}},"type":"object","required":["image"],"title":"Body_parse_resume_layout_parse_resume_layout_post"},"Body_parse_resume_layout_resume_parse_layout_post":{"properties":{"image":{"type":"string","contentMediaType":"application/octet-stream","title":"Image","description":"The resume: PDF, page image (PNG, JPG, TIFF, WEBP), or Word/RTF/ODT."},"include_pages":{"type":"boolean","title":"Include Pages","description":"Add each page as a JPEG data URL, to draw the boxes on.","default":false},"include_lines":{"type":"boolean","title":"Include Lines","description":"Add every line with its box, section, heading and entry marks.","default":false},"type":{"type":"string","title":"Type","description":"Response shape: 'layout' (default) is what the parser read, with boxes; 'tallite' is /parse-resume's response (same keys, nesting and types; a value not read is left empty).","default":"layout"}},"type":"object","required":["image"],"title":"Body_parse_resume_layout_resume_parse_layout_post"},"Body_parse_resume_parse_resume_post":{"properties":{"image":{"type":"string","contentMediaType":"application/octet-stream","title":"Image"},"detailed_passport":{"type":"boolean","title":"Detailed Passport","description":"Extract detailed passport information if available","default":false},"detailed_driving_license":{"type":"boolean","title":"Detailed Driving License","description":"Extract detailed driving license information if available","default":false},"assume_gender":{"type":"boolean","title":"Assume Gender","description":"Predict gender if not explicitly mentioned","default":false},"include_industry_analysis":{"type":"boolean","title":"Include Industry Analysis","description":"Include industry exposure analysis and potential roles assessment","default":true},"option":{"type":"integer","title":"Option","description":"Parsing option level (integer value)","default":1},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language","description":"Language hint for OCR and parsing. Supported: 'th' (Thai), 'vi' (Vietnamese), 'ms' (Malay), 'ja' (Japanese). If not provided, defaults to English."},"inEnglish":{"type":"boolean","title":"Inenglish","description":"If True (default), translates parsed output to English. If False, preserves the original language in the output.","default":true},"mode":{"type":"string","title":"Mode","description":"Parsing mode: 'classic' (default) skips the profile summary to save tokens; 'full' opts back into it. Experience highlights and skills[].category are returned in both modes.","default":"classic"},"extended_summary":{"type":"boolean","title":"Extended Summary","description":"If True, fills summary with a ~75-word professional summary in the style a candidate writes atop their resume, and adds skill_summary, a ~75-word summary of the candidate's skills. Both are written only from what the resume states.","default":false},"backfill":{"type":"boolean","title":"Backfill","description":"If True, extracts only experience (with highlights), skills, certifications, summary and skill_summary, for filling those sections into existing records. The response keeps the same structure; every other field is left empty.","default":false},"client":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client","description":"Optional client name. Logged and returned as `client` in the response; it does not change the parse."}},"type":"object","required":["image"],"title":"Body_parse_resume_parse_resume_post"},"Body_parse_resume_v1_v1_resumes_parse_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":"The resume: PDF, Word (DOC/DOCX), RTF, text or an image (PNG, JPG, TIFF, BMP)."}},"type":"object","required":["file"],"title":"Body_parse_resume_v1_v1_resumes_parse_post"},"Body_parse_resume_v2_api_parse_resume_v2_post":{"properties":{"image":{"type":"string","contentMediaType":"application/octet-stream","title":"Image"},"detailed_passport":{"type":"boolean","title":"Detailed Passport","description":"Extract detailed passport information if available","default":false},"detailed_driving_license":{"type":"boolean","title":"Detailed Driving License","description":"Extract detailed driving license information if available","default":false},"assume_gender":{"type":"boolean","title":"Assume Gender","description":"Predict gender if not explicitly mentioned","default":false},"include_industry_analysis":{"type":"boolean","title":"Include Industry Analysis","description":"Include industry exposure analysis and potential roles assessment","default":true},"option":{"type":"integer","title":"Option","description":"Parsing option level (integer value)","default":1},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language","description":"Language hint for OCR and parsing. Supported: 'th' (Thai), 'vi' (Vietnamese), 'ms' (Malay), 'ja' (Japanese). If not provided, defaults to English."},"inEnglish":{"type":"boolean","title":"Inenglish","description":"If True (default), translates parsed output to English. If False, preserves the original language in the output.","default":true},"mode":{"type":"string","title":"Mode","description":"Parsing mode: 'classic' (default) skips experience highlights and the summary to save tokens; 'full' opts back into both.","default":"classic"}},"type":"object","required":["image"],"title":"Body_parse_resume_v2_api_parse_resume_v2_post"},"Body_parse_resume_v2_parse_resume_v2_post":{"properties":{"image":{"type":"string","contentMediaType":"application/octet-stream","title":"Image"},"detailed_passport":{"type":"boolean","title":"Detailed Passport","description":"Extract detailed passport information if available","default":false},"detailed_driving_license":{"type":"boolean","title":"Detailed Driving License","description":"Extract detailed driving license information if available","default":false},"assume_gender":{"type":"boolean","title":"Assume Gender","description":"Predict gender if not explicitly mentioned","default":false},"include_industry_analysis":{"type":"boolean","title":"Include Industry Analysis","description":"Include industry exposure analysis and potential roles assessment","default":true},"option":{"type":"integer","title":"Option","description":"Parsing option level (integer value)","default":1},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language","description":"Language hint for OCR and parsing. Supported: 'th' (Thai), 'vi' (Vietnamese), 'ms' (Malay), 'ja' (Japanese). If not provided, defaults to English."},"inEnglish":{"type":"boolean","title":"Inenglish","description":"If True (default), translates parsed output to English. If False, preserves the original language in the output.","default":true},"mode":{"type":"string","title":"Mode","description":"Parsing mode: 'classic' (default) skips experience highlights and the summary to save tokens; 'full' opts back into both.","default":"classic"}},"type":"object","required":["image"],"title":"Body_parse_resume_v2_parse_resume_v2_post"},"Body_parse_timesheet_endpoint_api_timesheet_parse_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":"Timesheet file (Excel, PDF, or Image)"},"context":{"type":"string","title":"Context","description":"Optional JSON string with month, year, cycle dates, hours, sellerDayTypes. Missing fields are auto-detected from the timesheet.","default":"{}"}},"type":"object","required":["file"],"title":"Body_parse_timesheet_endpoint_api_timesheet_parse_post"},"Body_redact_pdf_redact_pdf_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"},"words":{"type":"string","title":"Words","default":""},"auto_redact":{"type":"boolean","title":"Auto Redact","default":true},"custom_fields":{"type":"string","title":"Custom Fields","description":"Comma-separated list of fields to redact (e.g. 'First Name,Email ID,Phone Numbers')","default":""}},"type":"object","required":["file"],"title":"Body_redact_pdf_redact_pdf_post"},"Body_redact_pdf_v2_redact_pdf_v2_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"},"words":{"type":"string","title":"Words","description":"Comma-separated literal words/phrases to always redact","default":""},"labels":{"type":"string","title":"Labels","description":"JSON list of labels to redact in a single field, e.g. [\"GIVENNAME\",\"SURNAME\",\"EMAIL\"]. A comma-separated string is also accepted. Empty = GIVENNAME,SURNAME,MIDDLENAME,EMAIL,TELEPHONENUM,URL,SALARY","default":""},"use_model":{"type":"boolean","title":"Use Model","description":"Run the Piiranha model. False = deterministic regex layers only","default":true},"allow_degraded":{"type":"boolean","title":"Allow Degraded","description":"Return the PDF even if the NER model was requested but unavailable. Off by default: a partially redacted file that looks finished is worse than an error.","default":false},"known_names":{"type":"string","title":"Known Names","description":"Comma-separated names already known for this CV. Each is swept document-wide.","default":""},"known_pii":{"type":"string","title":"Known Pii","description":"JSON of PII you already extracted. Accepts the parser's own shape (personal_info/present_salary/eeo_information/...) or a flat {\"LABEL\": value} map. Used as a reference to locate and redact known values, and reported back as coverage.","default":""},"dpi":{"type":"integer","title":"Dpi","description":"Render DPI for the scanned/OCR path","default":150},"max_pages":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Pages"}},"type":"object","required":["file"],"title":"Body_redact_pdf_v2_redact_pdf_v2_post"},"Body_redact_resume_layout_redact_resume_layout_post":{"properties":{"image":{"type":"string","contentMediaType":"application/octet-stream","title":"Image","description":"The resume: PDF, page image (PNG, JPG, TIFF, WEBP), or Word/RTF/ODT."},"fields":{"type":"string","title":"Fields","description":"Comma-separated fields to redact: name, email, phone, address, profiles, photo, date_of_birth, gender, nationality, marital_status, fathers_name, passport_number, id_numbers, driving_licence, current_salary, expected_salary, employer, school; or groups: contact (default: name, email, phone, address, profiles, photo), personal, salary, all.","default":"contact"},"words":{"type":"string","title":"Words","description":"Comma-separated words or phrases to redact as well, wherever written.","default":""},"output":{"type":"string","title":"Output","description":"'pdf' (default): the redacted PDF; 'json': the PDF as base64 with a report of each redaction (field, text, page, box).","default":"pdf"},"branding":{"type":"string","title":"Branding","description":"Recruiter rebranding, as JSON (every key optional; see controllers/resumeParseLayout/brand.py): {\"agency_name\", \"color\", \"redaction_color\", \"recruiter\": {\"name\", \"email\", \"phone\"}, \"replace_contact\", \"logo\": {\"position\", \"max_height\"}, \"header\": {\"enabled\", \"show_agency_name\", \"show_contact\", \"text\"}, \"footer\": {\"enabled\", \"text\", \"page_numbers\"}, \"cover_page\": {\"enabled\", \"title\", \"show\", \"show_contact\", \"note\"}}. Empty: redaction only.","default":""},"logo":{"anyOf":[{"type":"string","contentMediaType":"application/octet-stream"},{"type":"null"}],"title":"Logo","description":"The agency's logo (PNG, JPG...), for the branding."}},"type":"object","required":["image"],"title":"Body_redact_resume_layout_redact_resume_layout_post"},"Body_redact_resume_layout_resume_redact_layout_post":{"properties":{"image":{"type":"string","contentMediaType":"application/octet-stream","title":"Image","description":"The resume: PDF, page image (PNG, JPG, TIFF, WEBP), or Word/RTF/ODT."},"fields":{"type":"string","title":"Fields","description":"Comma-separated fields to redact: name, email, phone, address, profiles, photo, date_of_birth, gender, nationality, marital_status, fathers_name, passport_number, id_numbers, driving_licence, current_salary, expected_salary, employer, school; or groups: contact (default: name, email, phone, address, profiles, photo), personal, salary, all.","default":"contact"},"words":{"type":"string","title":"Words","description":"Comma-separated words or phrases to redact as well, wherever written.","default":""},"output":{"type":"string","title":"Output","description":"'pdf' (default): the redacted PDF; 'json': the PDF as base64 with a report of each redaction (field, text, page, box).","default":"pdf"},"branding":{"type":"string","title":"Branding","description":"Recruiter rebranding, as JSON (every key optional; see controllers/resumeParseLayout/brand.py): {\"agency_name\", \"color\", \"redaction_color\", \"recruiter\": {\"name\", \"email\", \"phone\"}, \"replace_contact\", \"logo\": {\"position\", \"max_height\"}, \"header\": {\"enabled\", \"show_agency_name\", \"show_contact\", \"text\"}, \"footer\": {\"enabled\", \"text\", \"page_numbers\"}, \"cover_page\": {\"enabled\", \"title\", \"show\", \"show_contact\", \"note\"}}. Empty: redaction only.","default":""},"logo":{"anyOf":[{"type":"string","contentMediaType":"application/octet-stream"},{"type":"null"}],"title":"Logo","description":"The agency's logo (PNG, JPG...), for the branding."}},"type":"object","required":["image"],"title":"Body_redact_resume_layout_resume_redact_layout_post"},"Body_redact_resume_resume_redactor_post":{"properties":{"resume_file":{"type":"string","contentMediaType":"application/octet-stream","title":"Resume File"},"fields_to_redact":{"items":{"type":"string"},"type":"array","title":"Fields To Redact"}},"type":"object","required":["resume_file","fields_to_redact"],"title":"Body_redact_resume_resume_redactor_post"},"Body_refit_resume_file_upload_refit_resume_parser__post":{"properties":{"image":{"type":"string","contentMediaType":"application/octet-stream","title":"Image"}},"type":"object","required":["image"],"title":"Body_refit_resume_file_upload_refit_resume_parser__post"},"Body_tallite_search_builder_endpoint_api_tallite_search_builder_post":{"properties":{"free_text":{"type":"string","title":"Free Text","description":"Free text search query to extract structured parameters from","default":""},"mode":{"type":"string","title":"Mode","description":"'build' (default) to create a query, or 'refine' to adjust an existing one","default":"build"},"requirements_context":{"type":"string","title":"Requirements Context","description":"Assembled job-requirement context (JD, skills, exp, location) to ground the query","default":""},"current_query":{"type":"string","title":"Current Query","description":"Existing search_query JSON (string) to adjust — required when mode='refine'","default":""},"adjustment_prompt":{"type":"string","title":"Adjustment Prompt","description":"Natural-language adjustment to apply — required when mode='refine'","default":""},"boolean_search_query":{"type":"string","title":"Boolean Search Query","description":"Raw recruiter boolean query — echoed back verbatim in search_query.boolean_search_query (never sent to the LLM)","default":""}},"type":"object","title":"Body_tallite_search_builder_endpoint_api_tallite_search_builder_post"},"Body_translate_text_translate_text__post":{"properties":{"text":{"type":"string","title":"Text","description":"Text or HTML fragment to translate. HTML is auto-detected; tag structure is preserved."},"source_language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Language","description":"Optional ISO source language hint (e.g. 'th', 'vi'). When omitted, the language is auto-detected."},"target_language":{"type":"string","title":"Target Language","description":"ISO target language code (e.g. 'en', 'th', 'es'). Defaults to 'en'.","default":"en"}},"type":"object","required":["text"],"title":"Body_translate_text_translate_text__post"},"BudgetEstimatorRequest":{"properties":{"client_name":{"type":"string","title":"Client Name","description":"Name of the client/company (e.g., Wipro, Microsoft, TCS, Google)"},"exp_range":{"type":"string","title":"Exp Range","description":"Experience range (e.g., '1 to 5 years')"},"designation":{"type":"string","title":"Designation","description":"Job designation (e.g., 'NodeJS developer')"},"job_description":{"type":"string","title":"Job Description","description":"Full job description text"},"country_or_currency":{"type":"string","title":"Country Or Currency","description":"Country or Currency code (e.g., 'India' or 'INR')"},"scale":{"type":"string","title":"Scale","description":"Payment scale: 'per annum', 'per hour', or 'per month'"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Location","description":"Optional location for context (e.g., 'Bangalore', 'San Francisco', 'Remote')"}},"type":"object","required":["client_name","exp_range","designation","job_description","country_or_currency","scale"],"title":"BudgetEstimatorRequest"},"BudgetEstimatorResponse":{"properties":{"currency":{"type":"string","title":"Currency"},"minBudget":{"type":"integer","title":"Minbudget"},"maxBudget":{"type":"integer","title":"Maxbudget"},"scale":{"type":"string","title":"Scale"}},"type":"object","required":["currency","minBudget","maxBudget","scale"],"title":"BudgetEstimatorResponse"},"CareerAnalysisResponse":{"properties":{"industry_exposure":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Industry Exposure","description":"Analysis of industries the candidate has worked in"},"potential_roles":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Potential Roles","description":"Potential roles the candidate could fill based on experience"},"experience_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Experience Level","description":"Overall experience level assessment"},"career_trajectory":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Career Trajectory","description":"Analysis of career growth trajectory and recommendations"},"job_match_score":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Job Match Score","description":"Match score between resume and job description (if provided)"}},"type":"object","title":"CareerAnalysisResponse"},"ChatRequest":{"properties":{"messages":{"items":{"$ref":"#/components/schemas/Message"},"type":"array","title":"Messages"},"language":{"type":"string","title":"Language"}},"type":"object","required":["messages","language"],"title":"ChatRequest"},"CityData":{"properties":{"inputValue":{"type":"string","title":"Inputvalue","description":"Original input value"},"presentName":{"type":"string","title":"Presentname","description":"Standard city name"},"alternateNames":{"items":{"type":"string"},"type":"array","title":"Alternatenames","description":"List of alternate names"},"shortCode":{"type":"string","title":"Shortcode","description":"City short code"},"state":{"type":"string","title":"State","description":"State/Province name"},"stateShortCode":{"type":"string","title":"Stateshortcode","description":"State/Province short code"},"country":{"type":"string","title":"Country","description":"Country name"},"countryShortCode":{"type":"string","title":"Countryshortcode","description":"Country short code (ISO 3166-1 alpha-2)"},"primaryLanguageName":{"type":"string","title":"Primarylanguagename","description":"Primary language name"},"primaryLanguageISOCode":{"type":"string","title":"Primarylanguageisocode","description":"Primary language ISO code"}},"type":"object","required":["inputValue","presentName","shortCode","state","stateShortCode","country","countryShortCode","primaryLanguageName","primaryLanguageISOCode"],"title":"CityData","description":"Model for individual city information"},"CityError":{"properties":{"inputValue":{"type":"string","title":"Inputvalue","description":"Original input value that caused the error"},"errorCode":{"type":"string","title":"Errorcode","description":"Error code"},"message":{"type":"string","title":"Message","description":"Error message"}},"type":"object","required":["inputValue","errorCode","message"],"title":"CityError","description":"Model for city lookup errors"},"CityInfoRequest":{"properties":{"cities":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Cities","description":"List of city names or codes to verify"}},"type":"object","required":["cities"],"title":"CityInfoRequest","description":"Request model for city information API"},"CityInfoResponse":{"properties":{"success":{"type":"boolean","title":"Success","description":"Whether the request was successful"},"data":{"items":{"$ref":"#/components/schemas/CityData"},"type":"array","title":"Data","description":"List of city data"},"errors":{"items":{"$ref":"#/components/schemas/CityError"},"type":"array","title":"Errors","description":"List of errors"},"timestamp":{"type":"string","title":"Timestamp","description":"Response timestamp"}},"type":"object","required":["success"],"title":"CityInfoResponse","description":"Response model for city information API"},"ContractParserRequest":{"properties":{"text":{"type":"string","minLength":1,"title":"Text","description":"Contract text to parse"}},"type":"object","required":["text"],"title":"ContractParserRequest"},"ContractParserResponse":{"properties":{"parsed_data":{"additionalProperties":true,"type":"object","title":"Parsed Data","description":"Parsed contract data"},"validation_errors":{"items":{"type":"string"},"type":"array","title":"Validation Errors","description":"List of validation errors"}},"type":"object","required":["parsed_data"],"title":"ContractParserResponse"},"DesignationData":{"properties":{"inputValue":{"type":"string","title":"Inputvalue","description":"Original input designation"},"normalizedTitle":{"type":"string","title":"Normalizedtitle","description":"Standardized designation title"},"seniorityLevel":{"type":"string","enum":["Entry","Mid","Senior","Lead","Manager","Director","Executive"],"title":"Senioritylevel","description":"Seniority level with predefined values"},"category":{"type":"string","enum":["Engineering","Operations","Management","Sales","Marketing","Finance","HR","Support","Consulting","Other"],"title":"Category","description":"Functional category with predefined values"},"industry":{"type":"string","enum":["Technology","Telecommunications","Finance","Healthcare","Manufacturing","Retail","Education","Government","Consulting","Energy","Media","Other"],"title":"Industry","description":"Primary industry - single word designation"},"skillsRequired":{"items":{"type":"string"},"type":"array","maxItems":5,"title":"Skillsrequired","description":"Key skills typically required (max 5 skills)"},"alternativeTitles":{"items":{"type":"string"},"type":"array","maxItems":3,"title":"Alternativetitles","description":"Alternative or equivalent titles (max 3 titles)"},"experienceRange":{"$ref":"#/components/schemas/ExperienceRange","description":"Experience range with min/max values in years"},"departmentFunction":{"type":"string","title":"Departmentfunction","description":"Department or functional area"}},"type":"object","required":["inputValue","normalizedTitle","seniorityLevel","category","industry","experienceRange","departmentFunction"],"title":"DesignationData","description":"Model for individual designation information"},"DesignationError":{"properties":{"inputValue":{"type":"string","title":"Inputvalue","description":"Original input value that caused the error"},"errorCode":{"type":"string","title":"Errorcode","description":"Error code"},"message":{"type":"string","title":"Message","description":"Error message"}},"type":"object","required":["inputValue","errorCode","message"],"title":"DesignationError","description":"Model for designation lookup errors"},"DesignationInfoRequest":{"properties":{"designations":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Designations","description":"List of job designations or titles to analyze"}},"type":"object","required":["designations"],"title":"DesignationInfoRequest","description":"Request model for designation information API"},"DesignationInfoResponse":{"properties":{"success":{"type":"boolean","title":"Success","description":"Whether the request was successful"},"data":{"items":{"$ref":"#/components/schemas/DesignationData"},"type":"array","title":"Data","description":"List of designation data"},"errors":{"items":{"$ref":"#/components/schemas/DesignationError"},"type":"array","title":"Errors","description":"List of errors"},"timestamp":{"type":"string","title":"Timestamp","description":"Response timestamp"}},"type":"object","required":["success"],"title":"DesignationInfoResponse","description":"Response model for designation information API"},"EducationData":{"properties":{"inputValue":{"type":"string","title":"Inputvalue","description":"Original input value"},"standardizedName":{"type":"string","title":"Standardizedname","description":"Standardized degree name"},"degreeType":{"type":"string","title":"Degreetype","description":"Type of degree (Bachelor, Master, Diploma, etc.)"},"field":{"type":"string","title":"Field","description":"Field of study"},"level":{"type":"string","title":"Level","description":"Education level (Undergraduate, Graduate, Postgraduate, etc.)"},"duration":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Duration","description":"Typical duration of the degree"},"alternateNames":{"items":{"type":"string"},"type":"array","title":"Alternatenames","description":"List of alternate names for the degree"},"abbreviations":{"items":{"type":"string"},"type":"array","title":"Abbreviations","description":"Common abbreviations"},"category":{"type":"string","title":"Category","description":"General category (Engineering, Business, Science, etc.)"}},"type":"object","required":["inputValue","standardizedName","degreeType","field","level","category"],"title":"EducationData","description":"Model for individual education degree information"},"EducationError":{"properties":{"inputValue":{"type":"string","title":"Inputvalue","description":"Original input value that caused the error"},"errorCode":{"type":"string","title":"Errorcode","description":"Error code"},"message":{"type":"string","title":"Message","description":"Error message"}},"type":"object","required":["inputValue","errorCode","message"],"title":"EducationError","description":"Model for education degree lookup errors"},"EducationInfoRequest":{"properties":{"degrees":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Degrees","description":"List of education degree names to verify and standardize"}},"type":"object","required":["degrees"],"title":"EducationInfoRequest","description":"Request model for education degrees API"},"EducationInfoResponse":{"properties":{"success":{"type":"boolean","title":"Success","description":"Whether the request was successful"},"data":{"items":{"$ref":"#/components/schemas/EducationData"},"type":"array","title":"Data","description":"List of education degree data"},"errors":{"items":{"$ref":"#/components/schemas/EducationError"},"type":"array","title":"Errors","description":"List of errors"},"timestamp":{"type":"string","title":"Timestamp","description":"Response timestamp"}},"type":"object","required":["success"],"title":"EducationInfoResponse","description":"Response model for education degrees API"},"EmailResponse":{"properties":{"response":{"type":"string","title":"Response"}},"type":"object","required":["response"],"title":"EmailResponse","description":"Response model for generated email"},"EmbeddingRequest":{"properties":{"input":{"anyOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}],"title":"Input","description":"Text, or a list of texts, to embed. No instruction prefix: queries and documents are embedded the same way."}},"type":"object","required":["input"],"title":"EmbeddingRequest"},"EncryptedRequest":{"properties":{"encrypted_payload":{"type":"string","title":"Encrypted Payload","description":"Base64 encoded encrypted data"},"iv":{"type":"string","title":"Iv","description":"Base64 encoded initialization vector"},"key_marker":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Key Marker","description":"Base64 encoded key marker for rotational encryption"}},"type":"object","required":["encrypted_payload","iv"],"title":"EncryptedRequest"},"EncryptedResponse":{"properties":{"encrypted_response":{"type":"string","title":"Encrypted Response","description":"Base64 encoded encrypted response"},"iv":{"type":"string","title":"Iv","description":"Base64 encoded initialization vector"},"key_marker":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Key Marker","description":"Base64 encoded key marker for rotational encryption"}},"type":"object","required":["encrypted_response","iv"],"title":"EncryptedResponse"},"ExperienceRange":{"properties":{"minYears":{"type":"integer","maximum":50.0,"minimum":0.0,"title":"Minyears","description":"Minimum years of experience required"},"maxYears":{"type":"integer","maximum":50.0,"minimum":0.0,"title":"Maxyears","description":"Maximum years of experience required"}},"type":"object","required":["minYears","maxYears"],"title":"ExperienceRange","description":"Model for experience range with min and max values"},"ExtractedSkillsData":{"properties":{"technical_skills":{"items":{"type":"string"},"type":"array","title":"Technical Skills"},"domain_knowledge":{"items":{"type":"string"},"type":"array","title":"Domain Knowledge"},"soft_skills":{"items":{"type":"string"},"type":"array","title":"Soft Skills"},"certifications":{"items":{"type":"string"},"type":"array","title":"Certifications"},"related_skills":{"additionalProperties":{"items":{"type":"string"},"type":"array"},"type":"object","title":"Related Skills"}},"type":"object","title":"ExtractedSkillsData"},"FormulaScriptValidationRequest":{"properties":{"script":{"type":"string","minLength":1,"title":"Script","description":"The formula script to validate"},"Assignment":{"items":{"type":"string"},"type":"array","title":"Assignment","description":"Configured assignment field names, e.g. [\"BaseAmount\", \"MarkUp\"]"},"Attributes":{"items":{"type":"string"},"type":"array","title":"Attributes","description":"Configured attribute names, e.g. [\"CTC\", \"BillableCTC\"]"},"Classname":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Classname","description":"Configured class prefix, e.g. \"contract.\""},"taglist":{"items":{"type":"string"},"type":"array","title":"Taglist","description":"Configured tag names referenced as {taglist.<name>}"}},"type":"object","required":["script"],"title":"FormulaScriptValidationRequest"},"FormulaScriptValidationResponse":{"properties":{"is_valid":{"type":"boolean","title":"Is Valid","description":"True when the script passes both term and syntax validation"},"validation_error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Validation Error","description":"THE single message to display in the read-only error text box. Null when the script is valid."},"validation_errors":{"items":{"type":"string"},"type":"array","title":"Validation Errors","description":"Every problem found, in source order; validation_error is the first of these"},"error_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Type","description":"'term' for an unconfigured field/tag, 'syntax' for a malformed script, null when valid"},"invalid_terms":{"items":{"type":"string"},"type":"array","title":"Invalid Terms","description":"Every referenced term that is not configured"},"referenced_terms":{"items":{"type":"string"},"type":"array","title":"Referenced Terms","description":"Every term the script references, valid or not"},"term_validation_applied":{"type":"boolean","title":"Term Validation Applied","description":"False when no Assignment/Attributes/taglist names were supplied, in which case only syntax was checked","default":false}},"type":"object","required":["is_valid"],"title":"FormulaScriptValidationResponse"},"FormulaTestResponse":{"properties":{"success":{"type":"boolean","title":"Success","description":"Whether the test data generation was successful"},"script":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Script","description":"The original script that was analyzed"},"analysis":{"anyOf":[{"additionalProperties":{"items":{"type":"string"},"type":"array"},"type":"object"},{"type":"null"}],"title":"Analysis","description":"Analysis of the script including variables, conditions, and formulas"},"test_data":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Test Data","description":"Generated test data with detailed structure"},"test_data_table":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Test Data Table","description":"Test data formatted for table display"},"total_test_cases":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Test Cases","description":"Total number of test cases generated"},"validation":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Validation","description":"Validation information about the generated data"},"format":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Format","description":"The format type used for the response"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error","description":"Error message if generation failed"},"errors":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Errors","description":"List of specific errors encountered"},"validation_error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Validation Error","description":"THE single script-validation message to display in the read-only error text box. Null when the script is valid."},"error_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Type","description":"'term' for an unconfigured field/tag, 'syntax' for a malformed script, null when valid"},"invalid_terms":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Invalid Terms","description":"Referenced terms that are not present in the configured Assignment, Attributes, Classname or Taglist"}},"type":"object","required":["success"],"title":"FormulaTestResponse"},"GenerateVideoRequest":{"properties":{"lessonId":{"type":"string","minLength":1,"title":"Lessonid","description":"Lesson namespace for the MinIO key (courses/videos/<lessonId>/<specHash>.mp4). The render is content-addressed by spec hash within this namespace, so an unchanged spec returns the cached video."},"spec":{"$ref":"#/components/schemas/VideoSpec"},"forceRender":{"type":"boolean","title":"Forcerender","description":"Bust the cache and re-render even if a video for this spec already exists.","default":false}},"additionalProperties":true,"type":"object","required":["lessonId","spec"],"title":"GenerateVideoRequest","description":"Mirrors the render service contract: ``{ lessonId, spec, forceRender }``."},"GenerateVideoResponse":{"properties":{"videoUrl":{"type":"string","title":"Videourl"},"minioKey":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Miniokey"},"durationSec":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Durationsec"},"sizeBytes":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sizebytes"}},"type":"object","required":["videoUrl"],"title":"GenerateVideoResponse"},"Goal":{"properties":{"id":{"type":"string","title":"Id"},"title":{"type":"string","title":"Title"},"description":{"type":"string","title":"Description"},"kpis":{"items":{"$ref":"#/components/schemas/KPI"},"type":"array","title":"Kpis"}},"type":"object","required":["id","title","description","kpis"],"title":"Goal"},"GoalsResponse":{"properties":{"goals":{"items":{"$ref":"#/components/schemas/Goal"},"type":"array","title":"Goals"}},"type":"object","required":["goals"],"title":"GoalsResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HelpdeskRequest":{"properties":{"context":{"type":"string","minLength":1,"title":"Context","description":"The context or issue description from the user"},"responder_answer_context":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Responder Answer Context","description":"The responder's answer context or guidance (optional)"},"response_style":{"type":"string","title":"Response Style","description":"Response style: professional, friendly, technical, concise, or educational","default":"professional"}},"type":"object","required":["context"],"title":"HelpdeskRequest"},"HelpdeskResponse":{"properties":{"response":{"type":"string","title":"Response"}},"type":"object","required":["response"],"title":"HelpdeskResponse"},"JobDescriptionData":{"properties":{"job_details":{"$ref":"#/components/schemas/JobDetails"},"skills":{"items":{"$ref":"#/components/schemas/Skill"},"type":"array","title":"Skills","description":"Technical and soft skills required (matching resume parser structure)","default":[]},"requirements":{"$ref":"#/components/schemas/JobRequirements"},"search_keywords":{"items":{"type":"string"},"type":"array","title":"Search Keywords","description":"Essential keywords to search in resumes for finding matching candidates","default":[]}},"type":"object","required":["job_details","requirements"],"title":"JobDescriptionData"},"JobDescriptionParserResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"anyOf":[{"$ref":"#/components/schemas/JobDescriptionData"},{"type":"null"}]},"errors":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Errors","default":[]}},"type":"object","required":["success"],"title":"JobDescriptionParserResponse"},"JobDescriptionRequest":{"properties":{"job_description":{"type":"string","title":"Job Description","description":"The job description text to be parsed"}},"type":"object","required":["job_description"],"title":"JobDescriptionRequest"},"JobDescriptionResponse":{"properties":{"status":{"type":"string","title":"Status"},"data":{"additionalProperties":true,"type":"object","title":"Data"},"timestamp":{"type":"string","title":"Timestamp"}},"type":"object","required":["status","data","timestamp"],"title":"JobDescriptionResponse"},"JobDescriptionSummaryResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"summary":{"type":"string","title":"Summary"},"validation_errors":{"items":{"type":"string"},"type":"array","title":"Validation Errors","default":[]}},"type":"object","required":["success","summary"],"title":"JobDescriptionSummaryResponse"},"JobDetails":{"properties":{"job_title":{"type":"string","title":"Job Title","description":"Job title/position"},"company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name","description":"Company name if mentioned"},"department":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Department","description":"Department or team"},"address":{"anyOf":[{"$ref":"#/components/schemas/Address"},{"type":"null"}],"description":"Job location address"},"job_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Type","description":"Full-time, part-time, contract, etc."},"remote_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Remote Type","description":"Remote, hybrid, on-site"},"salary_range":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Salary Range","description":"Salary range if mentioned"}},"type":"object","required":["job_title"],"title":"JobDetails"},"JobInput":{"properties":{"title":{"type":"string","title":"Title"},"grade":{"type":"string","title":"Grade"},"description":{"type":"string","title":"Description"},"location":{"type":"string","title":"Location"},"num_goals":{"type":"integer","maximum":5.0,"minimum":2.0,"title":"Num Goals","default":3},"kpis_per_goal":{"type":"integer","maximum":4.0,"minimum":1.0,"title":"Kpis Per Goal","default":2}},"type":"object","required":["title","grade","description","location"],"title":"JobInput"},"JobRequirements":{"properties":{"min_experience_years":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Min Experience Years","description":"Minimum years of total experience"},"max_experience_years":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Max Experience Years","description":"Maximum years of total experience"},"experience_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Experience Level","description":"Experience level required"},"education_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Education Level","description":"Minimum education level required"},"education_field":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Education Field","description":"Preferred field of study"},"certifications":{"items":{"type":"string"},"type":"array","title":"Certifications","description":"Required or preferred certifications","default":[]},"languages":{"items":{"type":"string"},"type":"array","title":"Languages","description":"Required languages","default":[]}},"type":"object","title":"JobRequirements"},"JobSkillsRequest":{"properties":{"skills":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Skills","description":"List of skills to analyze and categorize"}},"type":"object","required":["skills"],"title":"JobSkillsRequest","description":"Request model for job skills analysis API"},"JobSkillsResponse":{"properties":{"success":{"type":"boolean","title":"Success","description":"Whether the request was successful"},"data":{"items":{"$ref":"#/components/schemas/SkillData"},"type":"array","title":"Data","description":"List of analyzed skill data"},"errors":{"items":{"$ref":"#/components/schemas/SkillError"},"type":"array","title":"Errors","description":"List of errors"},"timestamp":{"type":"string","title":"Timestamp","description":"Response timestamp"}},"type":"object","required":["success"],"title":"JobSkillsResponse","description":"Response model for job skills analysis API"},"JobTitleAlternativesRequest":{"properties":{"jobtitle":{"type":"string","title":"Jobtitle","description":"Job title being searched for"},"jobdescription":{"type":"string","title":"Jobdescription","description":"Full job description the alternatives are judged from","default":""}},"type":"object","required":["jobtitle"],"title":"JobTitleAlternativesRequest","description":"Request model for the job-title-alternatives API."},"JobTitleAlternativesResponse":{"properties":{"alternativeTitles":{"items":{"type":"string"},"type":"array","title":"Alternativetitles"}},"type":"object","required":["alternativeTitles"],"title":"JobTitleAlternativesResponse","description":"Every title variation for the job (the /extract-keywords title set), in\nmodel order. Never includes the requested title."},"KPI":{"properties":{"id":{"type":"string","title":"Id"},"title":{"type":"string","title":"Title"},"description":{"type":"string","title":"Description"},"targets":{"items":{"type":"string"},"type":"array","title":"Targets"}},"type":"object","required":["id","title","description","targets"],"title":"KPI"},"LanguageDetectionResponse":{"properties":{"detected_language":{"type":"string","title":"Detected Language","description":"ISO language code; 'en' when confidently English or when detection fell back","default":"en"},"language_name":{"type":"string","title":"Language Name","description":"Human-readable language name; 'Unknown' when detection failed","default":"English"},"is_english":{"type":"boolean","title":"Is English","description":"True when the text is confidently English","default":true},"confidence":{"type":"string","title":"Confidence","description":"Confidence band: 'high' | 'medium' | 'low'","default":"low"},"is_fallback":{"type":"boolean","title":"Is Fallback","description":"True when detection couldn't decide and 'en' is just a default","default":false},"reason":{"type":"string","title":"Reason","description":"Short tag describing the decision path (for debugging)","default":""},"validation_errors":{"items":{"type":"string"},"type":"array","title":"Validation Errors"}},"type":"object","title":"LanguageDetectionResponse"},"MCQOption":{"properties":{"A":{"type":"string","title":"A","description":"Option A text"},"B":{"type":"string","title":"B","description":"Option B text"},"C":{"type":"string","title":"C","description":"Option C text"},"D":{"type":"string","title":"D","description":"Option D text"}},"type":"object","required":["A","B","C","D"],"title":"MCQOption"},"MCQQuestion":{"properties":{"question_number":{"type":"integer","title":"Question Number","description":"Question number in the set"},"question_text":{"type":"string","title":"Question Text","description":"The question text"},"options":{"$ref":"#/components/schemas/MCQOption","description":"Multiple choice options"},"correct_answer":{"type":"string","title":"Correct Answer","description":"Correct answer (A, B, C, or D)"},"explanation":{"type":"string","title":"Explanation","description":"Explanation of why the answer is correct"},"difficulty":{"type":"string","title":"Difficulty","description":"Difficulty level (easy, medium, hard)"}},"type":"object","required":["question_number","question_text","options","correct_answer","explanation","difficulty"],"title":"MCQQuestion"},"Message":{"properties":{"role":{"type":"string","title":"Role"},"content":{"type":"string","title":"Content"}},"type":"object","required":["role","content"],"title":"Message"},"PrepertChatRequest":{"properties":{"query":{"type":"string","minLength":1,"title":"Query","description":"The question or query to ask the AI assistant"}},"type":"object","required":["query"],"title":"PrepertChatRequest"},"PrepertChatResponse":{"properties":{"response":{"type":"string","title":"Response","description":"The AI assistant's response to the query"}},"type":"object","required":["response"],"title":"PrepertChatResponse"},"PrepertMCQRequest":{"properties":{"subtopic_name":{"type":"string","minLength":1,"title":"Subtopic Name","description":"The name of the subtopic to generate questions for"},"num_questions":{"type":"integer","maximum":15.0,"minimum":5.0,"title":"Num Questions","description":"Number of questions to generate (5-15)","default":10}},"type":"object","required":["subtopic_name"],"title":"PrepertMCQRequest"},"PrepertMCQResponse":{"properties":{"questions":{"items":{"$ref":"#/components/schemas/MCQQuestion"},"type":"array","title":"Questions","description":"List of generated MCQ questions"},"warning":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Warning","description":"Warning message if fallback was used"}},"type":"object","required":["questions"],"title":"PrepertMCQResponse"},"QuestionGenerationResponse":{"properties":{"questions":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Questions","description":"Generated interview questions"},"distribution":{"additionalProperties":{"type":"integer"},"type":"object","title":"Distribution","description":"Question distribution by type"},"difficulty_breakdown":{"additionalProperties":{"type":"integer"},"type":"object","title":"Difficulty Breakdown","description":"Question difficulty breakdown"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata","description":"Generation metadata"},"validation_errors":{"items":{"type":"string"},"type":"array","title":"Validation Errors","description":"List of validation errors"}},"type":"object","title":"QuestionGenerationResponse"},"Scene":{"properties":{"kind":{"type":"string","title":"Kind"},"durationSec":{"type":"number","title":"Durationsec","default":6.0},"data":{"$ref":"#/components/schemas/SceneData"},"narration":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Narration"}},"additionalProperties":true,"type":"object","required":["kind"],"title":"Scene"},"SceneData":{"properties":{},"additionalProperties":true,"type":"object","title":"SceneData","description":"Per-kind payload. Every field is optional; the scene ``kind`` decides\nwhich are used. Kept permissive so a new field or kind on the render side\ndoes not require a schema change here."},"SearchWeightsRequest":{"properties":{"jobtitle":{"type":"string","title":"Jobtitle","description":"Job title being searched for; it always gets the top weight, 10"},"skills":{"items":{"type":"string"},"type":"array","title":"Skills","description":"Skills to weight against the job description"},"jobdescription":{"type":"string","title":"Jobdescription","description":"Full job description the weights are judged from","default":""}},"type":"object","required":["jobtitle"],"title":"SearchWeightsRequest","description":"Request model for the add-search-weights API."},"SearchWeightsResponse":{"properties":{"jobTitle":{"items":{"$ref":"#/components/schemas/WeightedTitle"},"type":"array","title":"Jobtitle"},"skills":{"items":{"$ref":"#/components/schemas/WeightedSkill"},"type":"array","title":"Skills"}},"type":"object","required":["jobTitle","skills"],"title":"SearchWeightsResponse","description":"The requested title at 10 followed by close alternative titles (highest\nweight first), and exactly the requested skills, in the request's order and\nspelling, each with its weight."},"Skill":{"properties":{"name":{"type":"string","title":"Name","description":"Skill name"},"level":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Level","description":"Skill level (1-5 scale)"},"years":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Years","description":"Years of experience"},"categories":{"items":{"type":"string"},"type":"array","title":"Categories","description":"Skill categories (e.g., programming, backend)","default":[]},"importance":{"type":"string","title":"Importance","description":"required or preferred","default":"required"}},"type":"object","required":["name"],"title":"Skill"},"SkillData":{"properties":{"inputValue":{"type":"string","title":"Inputvalue","description":"Original input skill"},"standardizedName":{"type":"string","title":"Standardizedname","description":"Standardized skill name"},"alternateNames":{"items":{"type":"string"},"type":"array","title":"Alternatenames","description":"List of alternate names for the skill"},"category":{"type":"string","title":"Category","description":"Skill category (e.g., Technical, Soft, Language)"},"subcategory":{"type":"string","title":"Subcategory","description":"Skill subcategory (e.g., Programming, Framework, Database)"},"proficiencyLevel":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Proficiencylevel","description":"Suggested proficiency level if determinable"},"relatedSkills":{"items":{"type":"string"},"type":"array","title":"Relatedskills","description":"List of related or complementary skills"},"industryRelevance":{"items":{"type":"string"},"type":"array","title":"Industryrelevance","description":"Industries where this skill is most relevant"},"demandLevel":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Demandlevel","description":"Market demand level (High, Medium, Low)"},"demandTrend":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Demandtrend","description":"Demand trend from job postings (Rising, Stable, Declining)"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"Brief description of the skill"},"source":{"type":"string","title":"Source","description":"Origin of the analysis: 'taxonomy' (Lightcast) or 'llm'","default":"llm"}},"type":"object","required":["inputValue","standardizedName","category","subcategory"],"title":"SkillData","description":"Model for individual skill information"},"SkillError":{"properties":{"inputValue":{"type":"string","title":"Inputvalue","description":"Original input value that caused the error"},"errorCode":{"type":"string","title":"Errorcode","description":"Error code"},"message":{"type":"string","title":"Message","description":"Error message"}},"type":"object","required":["inputValue","errorCode","message"],"title":"SkillError","description":"Model for skill analysis errors"},"SkillsResponse":{"properties":{"extracted_skills":{"$ref":"#/components/schemas/ExtractedSkillsData"},"validation_errors":{"items":{"type":"string"},"type":"array","title":"Validation Errors"}},"type":"object","title":"SkillsResponse"},"StringInput":{"properties":{"text":{"type":"string","title":"Text"}},"type":"object","required":["text"],"title":"StringInput"},"StructuredExecutiveSummary":{"properties":{"headline":{"type":"string","title":"Headline","description":"One short line naming the candidate's professional identity and domain","default":""},"summary":{"type":"string","title":"Summary","description":"The same paragraph as synopsis_data.executive_summary","default":""}},"type":"object","title":"StructuredExecutiveSummary"},"StructuredKeyStrength":{"properties":{"title":{"type":"string","title":"Title","description":"Short noun-phrase label for the strength","default":""},"detail":{"type":"string","title":"Detail","description":"One short sentence of resume evidence","default":""},"evidenceSection":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Evidencesection","description":"Resume section the evidence comes from: experience | education | skills | certifications | languages | personal, or null"}},"type":"object","title":"StructuredKeyStrength"},"StructuredSkill":{"properties":{"name":{"type":"string","title":"Name","description":"The skill as the resume names it","default":""},"type":{"type":"string","title":"Type","description":"technical | soft","default":"technical"}},"type":"object","title":"StructuredSkill"},"StructuredSynopsisData":{"properties":{"executive_summary":{"$ref":"#/components/schemas/StructuredExecutiveSummary"},"key_strengths":{"items":{"$ref":"#/components/schemas/StructuredKeyStrength"},"type":"array","title":"Key Strengths"},"skills":{"items":{"$ref":"#/components/schemas/StructuredSkill"},"type":"array","title":"Skills","description":"Every skill the resume evidences, each typed technical or soft"}},"type":"object","title":"StructuredSynopsisData","description":"The synopsis broken into addressable fields.\n\nAdditive only — every value here is either newly generated (headline, the\ntitle/detail/evidenceSection split, the skills list) or reused verbatim from\nsynopsis_data, which is unchanged."},"SynopsisData":{"properties":{"fullname":{"type":"string","title":"Fullname","default":""},"executive_summary":{"type":"string","title":"Executive Summary","default":""},"skill_summary":{"type":"string","title":"Skill Summary","default":""},"key_strengths":{"items":{"type":"string"},"type":"array","title":"Key Strengths"},"professional_experience":{"items":{"type":"string"},"type":"array","title":"Professional Experience"},"education_and_training":{"items":{"type":"string"},"type":"array","title":"Education And Training"},"personal_information":{"items":{"type":"string"},"type":"array","title":"Personal Information"}},"type":"object","title":"SynopsisData"},"SynopsisResponse":{"properties":{"synopsis_data":{"$ref":"#/components/schemas/SynopsisData"},"structured_synopsis_data":{"$ref":"#/components/schemas/StructuredSynopsisData"},"validation_errors":{"items":{"type":"string"},"type":"array","title":"Validation Errors"}},"type":"object","title":"SynopsisResponse"},"TTSRequest":{"properties":{"text":{"type":"string","minLength":1,"title":"Text","description":"Text to synthesize into speech"},"voice":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Voice","description":"Voice id (see GET /tts/voices). Defaults to the engine's configured voice."},"speed":{"anyOf":[{"type":"number","maximum":4.0,"exclusiveMinimum":0.25},{"type":"null"}],"title":"Speed","description":"Playback speed multiplier (1.0 = normal). Range: 0.25 < speed <= 4.0."},"lang_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lang Code","description":"Language. Accepts Kokoro single-letter codes (a=en-US, b=en-GB, e=es, f=fr, h=hi, i=it, j=ja, p=pt-BR, z=zh) or common aliases like 'en', 'en-US', 'english', 'fr', 'hindi'. Unknown values fall back to the engine default (en-US)."}},"type":"object","required":["text"],"title":"TTSRequest"},"TalliteSearchBuilderResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"search_query":{"additionalProperties":true,"type":"object","title":"Search Query"},"validation_errors":{"items":{"type":"string"},"type":"array","title":"Validation Errors","default":[]}},"type":"object","required":["success","search_query"],"title":"TalliteSearchBuilderResponse"},"TranslationResponse":{"properties":{"translated_text":{"type":"string","title":"Translated Text","description":"Translation; equals input when source is already in the target language. HTML structure is preserved when the input is HTML.","default":""},"source_language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Language","description":"ISO code of detected/declared source language; None if unknown"},"source_language_name":{"type":"string","title":"Source Language Name","description":"Human-readable source language name","default":"Unknown"},"target_language":{"type":"string","title":"Target Language","description":"ISO code of the target language","default":"en"},"target_language_name":{"type":"string","title":"Target Language Name","description":"Human-readable target language name","default":"English"},"detection_confidence":{"type":"string","title":"Detection Confidence","description":"Confidence band of the source-language detection: 'high' | 'medium' | 'low'","default":"low"},"was_translated":{"type":"boolean","title":"Was Translated","description":"False when input was already in the target language and passed through","default":false},"is_html":{"type":"boolean","title":"Is Html","description":"True if the input was detected as HTML and the output preserves its structure","default":false},"validation_errors":{"items":{"type":"string"},"type":"array","title":"Validation Errors"}},"type":"object","title":"TranslationResponse"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VideoSpec":{"properties":{"title":{"type":"string","minLength":1,"title":"Title"},"subtitle":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subtitle"},"accentColor":{"type":"string","title":"Accentcolor","default":"#22c55e"},"brandLabel":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Brandlabel"},"scenes":{"items":{"$ref":"#/components/schemas/Scene"},"type":"array","title":"Scenes"}},"additionalProperties":true,"type":"object","required":["title","scenes"],"title":"VideoSpec"},"WebPageRequest":{"properties":{"url":{"type":"string","maxLength":4096,"minLength":8,"title":"Url","description":"http(s) URL of the page to open"},"timeout":{"anyOf":[{"type":"number","maximum":120.0,"exclusiveMinimum":0.0},{"type":"null"}],"title":"Timeout","description":"Seconds to wait for the page (default 30, max 120)."}},"type":"object","required":["url"],"title":"WebPageRequest"},"WebSearchRequest":{"properties":{"query":{"type":"string","maxLength":400,"minLength":1,"title":"Query","description":"What to search for"},"engines":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Engines","description":"Engines to query in parallel: duckduckgo, bing, brave, google. Default duckduckgo + bing + brave (google often shows a CAPTCHA to servers)."},"max_results":{"type":"integer","maximum":30.0,"minimum":1.0,"title":"Max Results","description":"Results to return after merging","default":10},"country":{"anyOf":[{"type":"string","maxLength":2,"minLength":2},{"type":"null"}],"title":"Country","description":"Two-letter country to bias results to, e.g. ae, my, in"},"language":{"anyOf":[{"type":"string","maxLength":2,"minLength":2},{"type":"null"}],"title":"Language","description":"Two-letter interface language, e.g. en, ar"},"include_content":{"type":"boolean","title":"Include Content","description":"Also open the top results and return their page text","default":false},"content_results":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Content Results","description":"How many top results to open","default":3},"content_max_chars":{"type":"integer","maximum":100000.0,"minimum":500.0,"title":"Content Max Chars","description":"Page text cap per result","default":20000},"timeout":{"type":"number","maximum":60.0,"minimum":5.0,"title":"Timeout","description":"Seconds per page (results page or result page)","default":20}},"type":"object","required":["query"],"title":"WebSearchRequest"},"WeightedSkill":{"properties":{"name":{"type":"string","title":"Name"},"weight":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Weight"}},"type":"object","required":["name","weight"],"title":"WeightedSkill"},"WeightedTitle":{"properties":{"title":{"type":"string","title":"Title"},"weight":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Weight"}},"type":"object","required":["title","weight"],"title":"WeightedTitle"},"main__EmailRequest__1":{"properties":{"to":{"type":"string","title":"To"},"subject":{"type":"string","title":"Subject"},"html_content":{"type":"string","title":"Html Content"}},"type":"object","required":["to","subject","html_content"],"title":"EmailRequest"},"main__EmailRequest__2":{"properties":{"email_thread":{"type":"string","title":"Email Thread","description":"The complete email thread text","examples":["Subject: Project Update\n\nFrom: john@example.com\nHello team,\n\nHow is the progress?"]}},"type":"object","required":["email_thread"],"title":"EmailRequest","description":"Request model for email thread processing"}},"securitySchemes":{"APIKeyHeader":{"type":"apiKey","in":"header","name":"Authorization"}}}}