Skip to main content
POST
cURL

Authorizations

X-Api-Key
string
header
required

API key provided by Jobo

Path Parameters

id
string<uuid>
required

Application ID.

Body

application/json

The complete answer snapshot for the application's current answerable step. Validated synchronously; accepted exactly once per (step, correction round).

answers
object[]
required
correction_round
integer | null

Optional optimistic guard. When present and not equal to the step's current correction round, the request is refused with stale_correction_round instead of answering the wrong round.

Required range: x >= 0

Response

The next decision point: the next step's fields, a correction round on the same step, or the terminal result.

api_version
enum<string>
required

Version of the profileless Auto Apply API contract.

Available options:
2026-08-12
Example:

"2026-08-12"

id
string<uuid>
required

Stable application ID.

job_id
string | null
required

Supplied Jobo job ID, or null when apply_url was supplied directly.

apply_url
string<uri>
required

Resolved application URL.

provider_id
string
required

Stable provider identifier selected at intake.

provider_name
string
required

Provider display name captured at intake.

status
enum<string>
required

Current durable application state.

Available options:
queued,
running,
awaiting_answers,
submitted,
failed,
canceled
cancel_requested
boolean
required

Whether cancellation has been requested.

status_updated_at
string<date-time>
required
queued_at
string<date-time>
required
started_at
string<date-time> | null
required
submitted_at
string<date-time> | null
required
failed_at
string<date-time> | null
required
canceled_at
string<date-time> | null
required
completed_at
string<date-time> | null
required

submitted_at, failed_at, or canceled_at, whichever is set.

created_at
string<date-time>
required
provider_version
string
required

Provider implementation version captured at intake.

matcher_revision
integer<int64>
required
catalog_revision
integer<int64>
required
settings_revision
integer<int64>
required
failure
object | null
required
canceled_by
string | null
required

Actor that completed cancellation, when applicable.

steps
object[]
required
current_step
object | null
required

The step currently awaiting answers - the one to answer next. Null while the application is queued, running between steps, or terminal.