Skip to main content
POST
cURL

Authorizations

X-Api-Key
string
header
required

API key provided by Jobo

Headers

Idempotency-Key
string
required

Unique key for this create request. Retained for 24 hours.

Required string length: 1 - 200

Body

application/json

Profileless application target. Supply exactly one of job_id and apply_url.

job_id
string<uuid>
required

Jobo job ID whose current apply URL should be used.

Example:

"2c1ac0f5-8772-43d2-b5a8-26b44a3fa171"

apply_url
string<uri>

Public HTTPS application URL handled by an active Auto Apply provider.

Example:

"https://boards.greenhouse.io/acme/jobs/4567890"

Response

The application reached a decision point: awaiting_answers with current_step carrying the discovered fields, or a terminal failure.

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.