API Reference

POST Create Job

v1Updated 2026-03-07

Create job

POST/api/v1/public/:tenant_slug/jobs

Header	Required	Description
Authorization	yes	`Bearer <API_KEY>`
Idempotency-Key	recommended	Safe retry key.

Body field	Type	Required
name	string	yes
status	string	no
location_id	integer	no
recruiter_id	integer	no

Request


curl -X POST \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Idempotency-Key: jobs-create-001" \
  -H "Content-Type: application/json" \
  -d '{"name":"Senior Backend Engineer","status":"published"}' \
  "http://localhost:3333/api/v1/public/agado-ats/jobs"

201 Response


{ "data": { "id": 102, "name": "Senior Backend Engineer", "status": "published" } }

400 Response


{
  "error": {
    "code": "bad_request",
    "message": "Validation failed for request payload",
    "request_id": "req_123"
  }
}

500 Response


{
  "error": {
    "code": "internal_error",
    "message": "Unexpected server error",
    "request_id": "req_500"
  }
}