Field schema

Auto Apply is coming soon as a generally available product — today an invite-only beta on public API version 2026-08-12. Accounts without access get 403 with problem code auto_apply_not_enabled from create.

Field shape

{
  "field_id": "field_country",
  "type": "select",
  "label": "Country",
  "required": true,
  "requires_answer": true,
  "current_value": null,
  "options": [{ "value": "US", "label": "United States" }],
  "constraints": {},
  "category": "address",
  "semantic_key": "address.country",
  "sensitive": false
}

Supported scalar types are text, textarea, select, multi_select, radio, checkbox, number, date, partial_date, typeahead, file, and unknown.

date: YYYY-MM-DD.
partial_date: YYYY, YYYY-MM, or YYYY-MM-DD, subject to minimum_precision.
select and radio: exact option value.
multi_select: array of exact option values.
typeahead: {"query":"MIT","selection":{"value":"...","label":"..."}}.
file: {"url":"https://...","filename":"resume.pdf","content_type":"application/pdf"}.
Required unknown fields fail safely as unsupported_field.

Education and work history

Repeated ATS sections are one repeating_group field rather than flattened children:

{
  "field_id": "grp_education",
  "type": "repeating_group",
  "group_type": "education",
  "label": "Education",
  "required": true,
  "min_items": 1,
  "max_items": 5,
  "item_fields": [
    { "key": "school", "type": "typeahead", "required": true },
    { "key": "degree", "type": "select", "required": true, "options": [] },
    { "key": "field_of_study", "type": "text", "required": false },
    {
      "key": "start_date",
      "type": "partial_date",
      "required": false,
      "constraints": { "minimum_precision": "month" }
    }
  ]
}

The answer value is an ordered array:

{
  "field_id": "grp_work_experience",
  "value": [
    {
      "company": "Acme",
      "title": "Engineer",
      "location": "Remote",
      "start_date": "2021-03",
      "end_date": null,
      "is_current": true,
      "description": "Built internal systems."
    }
  ]
}

item_fields is dynamic because ATSs may request additional children such as country, state, contact permission, graduation status, or hours per week. Unknown item keys are rejected. The array is the complete desired group state, preserves order, and is capped by both the provider limit and a platform maximum of ten entries. Supported group_type values are education, work_experience, website, language, skill, and other. When is_current is true, end_date must be null or omitted. Nested validation errors contain field_id, item_index, field_key, code, and message. Address, phone, and voluntary self-identification remain scalar fields with category and semantic_key. Voluntary self-identification fields are marked sensitive: true; Jobo never infers their answers.

Failure and correction codes

Terminal applications expose failure: {code, message, retryable}. Stable failure codes include:

Category	Codes
Answers	`answers_timeout`, `verification_timeout`, `answers_wait_failed`
ATS validation	`correction_limit_exceeded`, `field_discovery_failed`, `job_unavailable`, `unsupported_field`
Login and CAPTCHA	`login_required`, `captcha_required`
Browser agent	`agent_unavailable`, `agent_lease_lost`, `agent_navigation_failed`, `agent_click_failed`, `agent_state_failed`
Limits and timeouts	`queue_timeout`, `execution_timeout`, `page_limit_exceeded`, `stalled`
Navigation and workflow safety	`unsafe_navigation`, `invalid_step_state`, `workflow_failed`
Submission	`submission_unconfirmed`

retryable is authoritative for the individual failure. In particular, submission_unconfirmed is not safely retryable because the employer may have received the application. Before the correction limit is exhausted, file and ATS value problems are returned in command_errors with codes such as unsafe_file_url, file_upload_failed, invalid_file_type, ats_field_rejected, and ats_fill_failed. The next answers submission must be a complete corrected snapshot for the step.

Overview

API essentials

Jobs

Feed

Companies

Locations

Auto Apply — Preview

Field shape

Education and work history

Failure and correction codes

​Field shape

​Education and work history

​Failure and correction codes

Field shape

Education and work history

Failure and correction codes