> ## Documentation Index
> Fetch the complete documentation index at: https://skyvern.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Apply to a job

> Start a workflow run that applies to a job with a résumé and optional credentials.



## OpenAPI

````yaml /api-reference/openapi.json post /v1/recipes/jobs/apply
openapi: 3.1.0
info:
  title: Skyvern API
  description: API for Skyvern
  version: 1.0.0
servers:
  - url: https://api.skyvern.com
    x-fern-server-name: Cloud
  - url: https://api-staging.skyvern.com
    x-fern-server-name: Staging
  - url: http://localhost:8000
    x-fern-server-name: Local
security: []
paths:
  /v1/recipes/jobs/apply:
    post:
      tags:
        - Runs
      summary: Apply to a job
      description: >-
        Start a workflow run that applies to a job with a résumé and optional
        credentials.
      operationId: apply_to_job_v1_recipes_jobs_apply_post
      requestBody:
        content:
          application/json:
            schema:
              properties:
                job_url:
                  type: string
                  format: uri
                  title: Job Url
                custom_prompt:
                  type: string
                  title: Custom Prompt
                resume_url:
                  type: string
                  format: uri
                  title: Resume Url
                other_information:
                  title: Other Information
                username:
                  anyOf:
                    - type: string
                      minLength: 1
                    - type: 'null'
                  title: Username
                password:
                  anyOf:
                    - type: string
                    - type: 'null'
                  title: Password
                persist_credentials:
                  anyOf:
                    - type: boolean
                    - type: 'null'
                  title: Persist Credentials
                2fa_identifier:
                  anyOf:
                    - type: string
                    - type: 'null'
                  title: 2Fa Identifier
              additionalProperties: false
              type: object
              required:
                - job_url
                - custom_prompt
                - resume_url
              title: JobRecipeApplyJSONRequest
          multipart/form-data:
            schema:
              properties:
                job_url:
                  type: string
                  format: uri
                  title: Job Url
                custom_prompt:
                  type: string
                  title: Custom Prompt
                resume_file:
                  type: string
                  format: binary
                  title: Resume File
                other_information:
                  anyOf:
                    - type: string
                    - type: 'null'
                  title: Other Information
                username:
                  anyOf:
                    - type: string
                      minLength: 1
                    - type: 'null'
                  title: Username
                password:
                  anyOf:
                    - type: string
                    - type: 'null'
                  title: Password
                persist_credentials:
                  anyOf:
                    - type: string
                      pattern: ^true$
                    - type: 'null'
                  title: Persist Credentials
                2fa_identifier:
                  anyOf:
                    - type: string
                    - type: 'null'
                  title: 2Fa Identifier
              additionalProperties: false
              type: object
              required:
                - job_url
                - custom_prompt
                - resume_file
              title: JobRecipeApplyMultipartRequest
              description: >-
                OpenAPI representation of the text and file parts accepted by
                Apply.
        required: true
      responses:
        '200':
          description: Successfully started job application
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobRecipeRunResponse'
        '400':
          description: Invalid multipart structure
        '402':
          description: Insufficient credits or required billing state
        '403':
          description: Unauthorized or insufficient organization permission
        '413':
          description: Résumé file exceeds the upload limit
        '422':
          description: Invalid apply request
        '429':
          description: Workflow submission rate limit exceeded
        '500':
          description: Upload or workflow launch failed
        '502':
          description: Credential service failed
components:
  schemas:
    JobRecipeRunResponse:
      properties:
        workflow_run_id:
          type: string
          pattern: ^wr_
          title: Workflow Run Id
      additionalProperties: false
      type: object
      required:
        - workflow_run_id
      title: JobRecipeRunResponse

````