> ## Documentation Index > Fetch the complete documentation index at: https://jobo.world/docs/llms.txt > Use this file to discover all available pages before exploring further. # Submit session answers > Fill the current page's fields and advance the flow. The response is the updated session state: `next_available` pages return the next page's `fields`; validation problems come back in `validation_errors` with `status` unchanged; when the last page is accepted the application is submitted and `status` becomes `submitted`. Repeat until `is_terminal` is `true`. ## OpenAPI ````yaml /openapi.yaml post /api/auto-apply/sessions/{id}/answers openapi: 3.1.0 info: title: Jobo Enterprise API description: > The Jobo Enterprise API provides programmatic access to job listings, intelligent search, real-time feeds, automated job applications, and geocoding services. version: 1.0.0 contact: name: Jobo Support url: https://jobo.world email: support@jobo.world servers: - url: https://connect.jobo.world description: Production security: - ApiKeyAuth: [] tags: - name: Jobs Search description: Search and retrieve job listings - name: Jobs Feed description: Bulk job feeds and expiration tracking - name: Career Sites Feed description: Bulk feed of newly discovered career sites with enriched company profiles - name: Companies description: Company profiles and company-scoped job listings - name: Auto Apply Profiles description: Resume-first applicant profiles that power automated applications - name: Auto Apply Applications description: >- Fully automated job applications — submit asynchronously and poll for the outcome - name: Auto Apply Sessions description: Interactive, step-by-step application sessions with full answer control - name: Locations description: Geocoding and location services paths: /api/auto-apply/sessions/{id}/answers: post: tags: - Auto Apply Sessions summary: Submit session answers description: >- Fill the current page's fields and advance the flow. The response is the updated session state: `next_available` pages return the next page's `fields`; validation problems come back in `validation_errors` with `status` unchanged; when the last page is accepted the application is submitted and `status` becomes `submitted`. Repeat until `is_terminal` is `true`. operationId: submitAutoApplySessionAnswers parameters: - name: id in: path required: true schema: type: string format: uuid description: Session ID requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/AnswersRequest' responses: '200': description: The updated session state content: application/json: schema: $ref: '#/components/schemas/Session' '400': description: Validation error (e.g. empty `answers`, missing `field_id`) content: application/json: schema: $ref: '#/components/schemas/ValidationProblemDetails' '401': $ref: '#/components/responses/Unauthorized' '410': description: The session has expired or was already closed — start a new one content: application/json: schema: $ref: '#/components/schemas/ProblemDetails' '502': description: >- The automation backend is temporarily unavailable — the up-front charge (if any) is automatically refunded; retry shortly content: application/json: schema: $ref: '#/components/schemas/ProblemDetails' components: schemas: AnswersRequest: type: object required: - answers properties: answers: type: array items: $ref: '#/components/schemas/FieldAnswer' description: >- Answers for the current page's form fields. At least one is required. Session: type: object description: >- The live state of an interactive session, returned by session create and answer submissions. `fields` carries the current page's form fields. When `status` is `redirect_required`, start a new session with `redirect_url`. properties: id: type: string format: uuid description: Session identifier. Use it in the answers, get, and end endpoints. example: 6f1d2b3c-4a5e-4f60-9b7a-8c9d0e1f2a3b provider_id: type: string description: >- Detected ATS provider identifier (e.g. `greenhouse`, `lever`, `ashby`). example: greenhouse provider_name: type: string description: Human-readable ATS provider name. example: Greenhouse status: $ref: '#/components/schemas/ApplyFlowStatus' is_terminal: type: boolean description: >- True when the session is finished and no further answer submissions are possible. example: false error: type: string nullable: true description: Human-readable error detail when `status` is `error`. example: null current_url: type: string nullable: true description: The URL the session's browser is currently on. example: https://boards.greenhouse.io/acme/jobs/4567890 validation_errors: type: array items: $ref: '#/components/schemas/ValidationError' description: >- Field-level problems reported by the ATS form after an answers submission. fields: type: array items: $ref: '#/components/schemas/FormFieldInfo' description: The current page's form fields to answer. redirect_url: type: string nullable: true description: >- When `status` is `redirect_required` — the application continues on a different ATS. Start a new session with this URL. example: null redirect_provider_id: type: string nullable: true description: >- When `status` is `redirect_required` — the provider expected to handle the redirect. example: null ValidationProblemDetails: allOf: - $ref: '#/components/schemas/ProblemDetails' - type: object properties: errors: type: object additionalProperties: type: array items: type: string description: Map of field name to list of validation error messages. ProblemDetails: type: object description: RFC 7807 problem details object returned for error responses. properties: type: type: string nullable: true title: type: string nullable: true status: type: integer nullable: true detail: type: string nullable: true instance: type: string nullable: true FieldAnswer: type: object required: - field_id - value - type description: One answer for a discovered form field. properties: field_id: type: string description: Field identifier copied from the corresponding `FormFieldInfo`. example: c0203e24-63fd-4425-914c-216a5701861c value: type: string description: >- The value to set. Format depends on `type` — option `value` for choice fields, `"true"`/`"false"` for toggles, `YYYY-MM-DD` for dates, a file reference for `file` fields. example: Ada type: $ref: '#/components/schemas/FieldType' typeahead_selection: type: string nullable: true description: >- For `typeahead` fields — the exact dropdown option to click after typing `value`. example: null handler_type: type: string nullable: true description: >- ATS-specific handler hint copied from the corresponding `FormFieldInfo`. example: first-name clear_first: type: boolean default: true description: Clear any existing value before typing. ApplyFlowStatus: type: string description: >- The flow state of an interactive session. `form_ready`, `next_available`, and `submit_ready` are active states; `submitted`, `login_required`, `captcha_required`, `expired`, `redirected`, `redirect_required`, and `error` are terminal (`is_terminal = true`). `login_required`, `captcha_required`, `redirected`, and `redirect_required` are reserved — those situations report `error` until dedicated detection ships; treat the enum as open. enum: - form_ready - next_available - submit_ready - submitted - login_required - captcha_required - expired - redirected - redirect_required - error example: form_ready ValidationError: type: object description: A field-level problem reported by the ATS form. properties: field_id: type: string nullable: true description: The offending field, or null for page-level problems. example: c0203e24-63fd-4425-914c-216a5701861c message: type: string description: The validation message shown by the form. example: This field is required. FormFieldInfo: type: object description: A parsed form field on the current application page. properties: field_id: type: string description: >- Stable identifier for the field within the session. Echo it back in `FieldAnswer.field_id`. example: c0203e24-63fd-4425-914c-216a5701861c type: $ref: '#/components/schemas/FieldType' label: type: string description: The field's visible label. example: First name is_required: type: boolean description: True when the ATS marks the field as required. example: true options: type: array items: $ref: '#/components/schemas/FieldOption' description: >- Available options for `select`, `multi_select`, `radio`, and similar fields. handler_type: type: string nullable: true description: ATS-specific handler hint (e.g. "first-name", "email", "resume"). example: first-name current_value: type: string nullable: true description: >- The field's current value on the page (pre-filled or previously set), or null when empty. example: null FieldType: type: string description: >- The kind of form control, which dictates the expected `FieldAnswer.value` format. enum: - text - text_area - select - multi_select - radio - checkbox - file - date - number - hidden - password - typeahead - toggle - rich_text - static - complex - unknown example: text FieldOption: type: object description: One selectable option of a choice field. properties: value: type: string description: The option value to send back in `FieldAnswer.value`. example: '4018213008' text: type: string description: The option's visible label. example: San Francisco, CA responses: Unauthorized: description: Missing or invalid API key securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-Api-Key description: API key provided by Jobo ````