---
title: "Draft a job description with AI"
method: POST
path: "/openings/description/draft"
tags: ["opening"]
---

# Draft a job description with AI

`POST /openings/description/draft`

## Request

- Base URL: `https://localhost:4410/api/v1`
- URL: `https://localhost:4410/api/v1/openings/description/draft`
- Auth: HTTP bearer

A first draft of a job's description on the workspace's own language model key: the model writes About the role and What you'll do from the title, the place, the notes and the careers page's introduction, and the requirements go under What we're looking for word for word. The pay range, equity and applications are never sent. Sentences that add a qualification are asked again once, then left out and listed. Nothing is saved: a person accepts the draft into the job.

## Request body

- object
  - `title` string, required
  - `location` object, required
    - `kind` 'on_site' | 'hybrid' | 'remote', required
    - `place` object, nullable
      - `city` string, required
      - `region` string, nullable
      - `country` string, required
    - `remote_region` string, nullable
  - `notes` string, required
  - `requirements` string[], required

## Response `200`

The result.

- object
  - `text` string, required
  - `model` string, required
  - `removed` string[], required

## Other responses

- `default`: An RFC 9457 problem.

---

[API](https://skmtc.dev/binderwork/apis/binderwork-api.md) · [All operations](https://skmtc.dev/binderwork/apis/binderwork-api/llms.txt) · [OpenAPI document](https://skmtc.dev/binderwork/apis/binderwork-api/revisions/f8fab0ebee53?raw)