Create a Job Post

post/public/v1/job-posts

Creates a draft job post. Attach a published job application form before publishing it. Screening questions and the job video are managed in Astalty.

post/public/v1/job-posts

curl --request POST \
  --url 'https://api.app.astalty.com.au/public/v1/job-posts' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "title": "string",
  "description": "string",
  "location": "string",
  "employment_basis": "casual",
  "application_form": {
    "id": "string"
  }
}'

Response

{
  "data": {
    "id": "b2c3d4e5-f6a7-48b9-8c0d-1e2f3a4b5c6d",
    "reference": "JOB-2026-00012",
    "title": "Weekend Support Worker",
    "description": "Support participants in Parramatta on Saturdays and Sundays.",
    "location": "Parramatta NSW",
    "employment_basis": "casual",
    "status": "published",
    "accepting_applications": true,
    "video_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "application_form": {
      "id": "c3d4e5f6-a7b8-49c0-9d1e-2f3a4b5c6d7e",
      "name": "Support worker application"
    },
    "questions": [
      {
        "id": "d4e5f6a7-b8c9-40d1-8e2f-3a4b5c6d7e8f",
        "question": "Do you hold a current NDIS Worker Screening Check?",
        "type": "yes_no",
        "importance": "must_have",
        "options": [
          {
            "id": "e5f6a7b8-c9d0-41e2-9f3a-4b5c6d7e8f9a",
            "label": "Yes",
            "meets_requirement": true
          }
        ]
      }
    ],
    "published_at": "2026-03-02T09:00:00+11:00",
    "archived_at": "2026-06-01T00:00:00+10:00",
    "created_at": "2026-03-01T10:30:00+11:00",
    "updated_at": "2026-03-02T09:00:00+11:00"
  }
}

Authorization

Authorizationstringrequired
Bearer authentication header of the form Bearer <token>, where <token> is your API key. See How to set up an API key.

Body

application/json

titlestringrequiredmax length 255
descriptionstring | nullmax length 20000
locationstring | nullmax length 255
employment_basisenum<string> | null
Available options:casualfull_timepart_time
application_formobject
▶Show 1 child attributesHide child attributes
- idstring

Response

200application/json

JobPostResource

dataobjectrequired
▶Show 15 child attributesHide child attributes
- idstringrequired
  Example:b2c3d4e5-f6a7-48b9-8c0d-1e2f3a4b5c6d
- referencestringrequired
  Example:JOB-2026-00012
- titlestringrequired
  Example:Weekend Support Worker
- descriptionstring | nullrequired
  Example:Support participants in Parramatta on Saturdays and Sundays.
- locationstring | nullrequired
  Example:Parramatta NSW
- employment_basisstring | nullrequired
  Example:casual
- statusstringrequired
  Example:published
- accepting_applicationsbooleanrequired
  Example:true
- video_urlstring | nullrequired
  Example:https://www.youtube.com/watch?v=dQw4w9WgXcQ
- application_formobject | nullrequired
  ▶Show 2 child attributesHide child attributes
  idstringrequired
  Example:c3d4e5f6-a7b8-49c0-9d1e-2f3a4b5c6d7e
  namestringrequired
  Example:Support worker application
- questionsobject[]required
  ▶Show 5 child attributesHide child attributes
  idstringrequired
  Example:d4e5f6a7-b8c9-40d1-8e2f-3a4b5c6d7e8f
  questionstringrequired
  Example:Do you hold a current NDIS Worker Screening Check?
  typestringrequired
  Example:yes_no
  importancestringrequired
  Example:must_have
  optionsobject[]required
  ▶Show 3 child attributesHide child attributes
  idstringrequired
  Example:e5f6a7b8-c9d0-41e2-9f3a-4b5c6d7e8f9a
  labelstringrequired
  Example:Yes
  meets_requirementbooleanrequired
  Example:true
- published_atstring | nullrequired
  Example:2026-03-02T09:00:00+11:00
- archived_atstring | nullrequired
  Example:2026-06-01T00:00:00+10:00
- created_atstringrequired
  Example:2026-03-01T10:30:00+11:00
- updated_atstringrequired
  Example:2026-03-02T09:00:00+11:00

Errors

401Unauthenticated
403Authorization error
422Validation error

Command Palette

Authorization

Body

Response

Errors