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

# 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
  - `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-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/161b83b037f8?raw)