Jobs

Generate job description using AI

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]=maximum_hours&job[expected_weekly_hours]=12&job[currency]=GBP&job[title]=Direct+Accounting+Administrator&job[description]=Curvo+reprehenderit+amet.+Vacuus+despecto+defigo.&job[postcode]=CF10+1AA&job[industries][]=tourism&job[industries][]=coach&job[drivers_required]=7&job[start_date]=2025-10-30&job[end_date]=2026-03-05&job[min_rating]=3.9&job[licenses][]=d1e&job[licenses][]=b&job[job_type]=full_time&job[status]=published&job[published_at]=2025-10-20+07%3A54%3A23+UTC

Headers

Accept: application/json
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiIxMjgyIiwic2NwIjoidXNlciIsImF1ZCI6bnVsbCwiaWF0IjoxNzYwOTUwNDYzLCJleHAiOjE3NjM1NDI0NjMsImp0aSI6IjExZWQyZGY3LTkxN2EtNDViOC1hMTRmLTY2NTQ2MTJlMDNlZCJ9.akXXyaLVcfMh9BaZAY39ts-z9p6t0DjB363nNOhwg4A
Host: example.org
Cookie:

Query Parameters

job={"show_by"=>"maximum_hours", "expected_weekly_hours"=>"12", "currency"=>"GBP", "title"=>"Direct Accounting Administrator", "description"=>"Curvo reprehenderit amet. Vacuus despecto defigo.", "postcode"=>"CF10 1AA", "industries"=>["tourism", "coach"], "drivers_required"=>"7", "start_date"=>"2025-10-30", "end_date"=>"2026-03-05", "min_rating"=>"3.9", "licenses"=>["d1e", "b"], "job_type"=>"full_time", "status"=>"published", "published_at"=>"2025-10-20 07:54:23 UTC"}

Body

{
}

Response

Simulated Response

Status

200

Headers

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: bcbd658c-661c-4b9d-b01f-1c0b97e4a9d6
x-runtime: 0.005869
content-length: 52

Body

{
  "description": "Nice description generated with AI"
}