Generate job description using AI
Jobs
GET ai description
Endpoint
GET /api/v1/jobs/ai_description
Parameters
| Name | Description |
|---|---|
| job[title] required | Job title |
| job[drivers_required] required | Job drivers required |
| job[industries] required | Job industries |
| job[start_date] required | Job start date |
| job[end_date] | Job end date |
| job[ongoing] | Job ongoing |
| job[postcode] required | Job postcode |
| job[description] required | Job description |
| job[licenses] | Job licenses |
| job[min_rating] required | Job min rating |
| job[young_drivers] | Job young drivers |
| job[inexperienced_drivers] | Job inexperienced drivers |
| job[job_type] required | Job job type |
| job[show_by] required | Job show by |
| job[expected_weekly_hours] | Job expected weekly hours |
| job[hours_from] | Job hours from |
| job[hours_to] | Job hours to |
| job[wages_attributes] required | Job wages attributes |
| job[overtime_after] | Job overtime after |
| job[overtime_rate] | Job overtime rate |
| job[dbs_check] | Job dbs check |
| job[dbs_last_performed_months] | Job dbs last performed months |
Request
Route
GET /api/v1/jobs/ai_description?job[show_by]=fixed_hours&job[expected_weekly_hours]=25&job[currency]=GBP&job[title]=International+Manufacturing+Engineer&job[description]=Copia+candidus+harum.+Aperte+denego+trado.&job[postcode]=B1+1AA&job[industries][]=private_hire&job[industries][]=international&job[drivers_required]=10&job[start_date]=2025-11-21&job[end_date]=2026-04-01&job[min_rating]=4.0&job[licenses][]=phv&job[licenses][]=c&job[job_type]=fixed_term_contract&job[status]=published&job[published_at]=2025-11-20+07%3A13%3A14+UTC
Headers
Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIxMzI2Iiwic2NwIjoidXNlciIsImF1ZCI6bnVsbCwiaWF0IjoxNzYzNjI2Mzk0LCJleHAiOjE3NjYyMTgzOTQsImp0aSI6IjExYTJkNGE0LTI2N2YtNDJmNS1hZWVkLWRiNzgzNTcxMjZjNyJ9.eueOwZ9iH-I22BlH_-M2kK5AVksksPxsXqBPgDETlXY
Host: example.org
Cookie: Query Parameters
job={"show_by"=>"fixed_hours", "expected_weekly_hours"=>"25", "currency"=>"GBP", "title"=>"International Manufacturing Engineer", "description"=>"Copia candidus harum. Aperte denego trado.", "postcode"=>"B1 1AA", "industries"=>["private_hire", "international"], "drivers_required"=>"10", "start_date"=>"2025-11-21", "end_date"=>"2026-04-01", "min_rating"=>"4.0", "licenses"=>["phv", "c"], "job_type"=>"fixed_term_contract", "status"=>"published", "published_at"=>"2025-11-20 07:13:14 UTC"}
Body
{
}Response
Simulated Response
Status
200Headers
x-frame-options: SAMEORIGIN
x-xss-protection: 0
x-content-type-options: nosniff
x-permitted-cross-domain-policies: none
referrer-policy: strict-origin-when-cross-origin
content-type: application/json; charset=utf-8
vary: Accept, Origin
etag: W/"ed3b53f9ba829476f6bd61a09ec6f1ac"
cache-control: max-age=0, private, must-revalidate
x-request-id: 8850d1aa-c6b3-4b81-bf0e-038819cc9fe5
x-runtime: 0.005023
content-length: 52Body
{
"description": "Nice description generated with AI"
}