---
title: "Apply to a job"
method: POST
path: "/v1/recipes/jobs/apply"
tags: ["Recipes"]
---

# Apply to a job

`POST /v1/recipes/jobs/apply`

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

## Request body

- object
  - `job_url` string, uri, required
  - `custom_prompt` string, required
  - `resume_url` string, uri, required
  - `other_information` unknown
  - `terminate_criterion` string, nullable — Condition that stops Apply. Omit to use the recipe default; null or empty text disables it.
  - `error_code_mapping` object, nullable — Error codes and descriptions. Omit for the recipe default; null or {} disables mapping. A supplied mapping replaces the default independently of terminate_criterion.
  - `username` string, nullable
  - `password` string, nullable
  - `persist_credentials` boolean, nullable
  - `2fa_identifier` string, nullable

## Response `200`

Successfully started job application

- JobRecipeRunResponse
  - `workflow_run_id` string, required

## Other responses

- `400` — Invalid multipart structure
- `402` — Insufficient credits or required billing state
- `403` — Unauthorized or insufficient organization permission
- `413` — Résumé file exceeds the upload limit
- `422` — Invalid apply request
- `429` — Workflow submission rate limit exceeded
- `500` — Upload or workflow launch failed
- `502` — Credential service failed

## Changes

- **2026-09-19** `d62300a896c8` — 4 info
  - added the new optional request property `error_code_mapping` (media type: application/json)
  - added the new optional request property `error_code_mapping` (media type: multipart/form-data)
  - added the new optional request property `terminate_criterion` (media type: application/json)
  - added the new optional request property `terminate_criterion` (media type: multipart/form-data)
- **2026-09-14** `4da39b4c8f5f` — 3 info
  - the endpoint scheme security `ApiKeyAuth` was added to the API
  - api tag `Recipes` added
  - api tag `Runs` removed
- **2026-09-09** `b090d5083c5b` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/skyvern-ai/apis/skyvern-api-2/changes/v1/recipes/jobs/apply/post.md)

---

[API](https://skmtc.dev/skyvern-ai/apis/skyvern-api-2.md) · [All operations](https://skmtc.dev/skyvern-ai/apis/skyvern-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/skyvern-ai/apis/skyvern-api-2/revisions/dae725082d1a?raw)