---
title: "Update state, notes, next steps or final document references. Only mark applied after the user confirms submission. Gmail-derived changes need user approval; store only approved references and minimal notes."
method: PATCH
path: "/me/applications/{applicationId}"
---

# Update state, notes, next steps or final document references. Only mark applied after the user confirms submission. Gmail-derived changes need user approval; store only approved references and minimal notes.

`PATCH /me/applications/{applicationId}`

## Request

- Base URL: `https://api.hiddenjobs.dev/v1`
- URL: `https://api.hiddenjobs.dev/v1/me/applications/{applicationId}`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://api.hiddenjobs.dev/v1/oauth/authorize`, token URL `https://api.hiddenjobs.dev/v1/oauth/token`, scopes: `email`)

## Path parameters

- `applicationId` string, uuid, required

## Request body

- object
  - `status` 'saved' | 'preparing' | 'prepared' | 'applied' | 'interview' | 'offer' | 'rejected' | 'withdrawn'
  - `data` object
  - `cvDocumentId` string, uuid
  - `coverLetterDocumentId` string, uuid
  - `interviewDocumentId` string, uuid
  - `userConfirmed` boolean
  - `expectedRevision` integer, required: Last known revision; use 0 when creating a record. A conflict requires reading the record again.
  - `requestId` string, required: Stable unique key for this intended write. Reuse it only when retrying the same arguments.

## Response `200`

Operation result

- object
  - `data` unknown, required

## Other responses

- `400`: Invalid arguments
- `401`: Invalid credentials
- `403`: Permission denied
- `404`: Record not found
- `409`: Revision, idempotency or state conflict
- `413`: Size or quota limit
- `429`: Request limit
- `503`: Temporarily unavailable

---

[API](https://skmtc.dev/hiddenjobs/apis/hidden-jobs-api.md) · [All operations](https://skmtc.dev/hiddenjobs/apis/hidden-jobs-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hiddenjobs/apis/hidden-jobs-api/revisions/c1d57d8e4720?raw)