Alfa

Tools

Write a job advert

POST/v1/tools/job-advert-writer

Requires the session token of a signed-in Alfa user as a bearer token.

Request body

  • companyNamestringrequired

    at least 1 characters

  • companyDescriptionstring
  • jobTitlestringrequired

    at least 1 characters

  • essentialRequirementsstring[]
  • bonusRequirementsstring[]
  • locationstring
  • workSetup"remote" | "hybrid" | "onsite"
  • salarystring
  • benefitsstring[]
  • style"balanced" | "formal" | "casual" | "enthusiastic" | "punchy"
  • length"balanced" | "short" | "long"

Responses

  • 200Success.
  • 400The request is malformed: invalid JSON, an unexpected body or an unknown query parameter. Problem details
  • 401The bearer token is missing, expired or invalid. Problem details
  • 403The caller may not perform this operation, or has no active organisation. Problem details
  • 404The resource does not exist or is not visible to the caller. Problem details
  • 422The request failed validation; `errors` lists each invalid field. Problem details
  • 429Too many requests, or the AI service is busy. Retry after a short wait. Problem details
  • 500An unexpected error. Quote the `correlationId` to support. Problem details