Job Roles

Generate Job Description

Generate a job description using AI based on job title, department, and key requirements

This endpoint helps recruiters quickly create comprehensive JDs by providing:

  • Job title (required)
  • Department (optional, for context)
  • Key requirements (3-5 bullet points of must-have skills/qualifications)

The AI will generate a complete JD with:

  • Role overview
  • Responsibilities
  • Qualifications
  • Culture fit

Requires: admin or recruiter role

post/api/job-roles/generate-jd

Request

  • Base URL: https://api.thebetterhire.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.thebetterhire.ai/api/job-roles/generate-jd
  • Auth: HTTP bearer

Request body

job_titlestring required
departmentstring nullable
company_namestring nullable
key_requirementsstring[] nullable
fix_instructionsstring[] nullable

Response

Successful Response

successboolean required
job_descriptionstring required
messagestring nullable

Changes

No recorded changes to this operation across all 1 revision of this API.