---
title: Job Description Generator API
slug: job-description-generator
url: https://apyhub.com/sharpapi/service/job-description-generator
provider: SharpAPI
categories: [HR, Smart Generation]
tags: [cv, hr, resume, job]
auth: api_key
---

# Job Description Generator API

Generate structured job descriptions from a title and hiring context. Returns requirements, responsibilities, and a short summary for HR workflows.

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| POST | `/sharpapi/api/v1/hr/job_description` | What it does Submits a job-description generation request and starts an async job. The request body… | 50 |
| GET | `/sharpapi/api/v1/hr/job_description/job/status/:job_id` | What it does Checks the status of a previously submitted job description generation job by job ID a… | 1 |

## About

## What it does
Job Description Generator creates structured job descriptions from a job title and optional hiring context. Send a `name` and, when needed, add fields like `remote`, `country`, `language`, `voice_tone`, `company_name`, `visa_sponsored`, `employment_type`, `optional_skills`, `required_skills`, `minimum_education`, `minimum_work_experience`, and `context`.

Use it when you need a fast first draft for a new opening, a localized posting, or a role description that reflects specific hiring constraints. The submit endpoint returns a `job_id` and `status_url` so you can track generation asynchronously.

When the job finishes, the status endpoint returns a `data` object with `id`, `type`, and `attributes`. Inside `attributes`, you get `status` plus a `result` object containing `job_requirements`, `job_responsibilities`, and `job_short_description`.

Job Description Generator is useful for HR teams, recruiters, and internal tools that need consistent job copy without hand-writing every posting. It fits workflows where a title, a few requirements, and basic role metadata need to become a ready-to-review description.

## Usage

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/sharpapi/service/job-description-generator