# Record an application you submitted

Save what you actually sent, then keep the next step separate.

Canonical page: https://jobhunt.app/support/using/pipeline/record-a-submission
Updated: 2026-11-14
Audience: using
Topic: Jobs & pipeline
Type: how-to
Catalog revision: f77de0f4803debf8c5aaac1702865d976a380e994ea7f572d4e571c044d5495f
Contract SHA-256: acfda93724db1a3f53160a30bc5891f447ad14601f26b02ff4cacd7c17d0812e

## Steps

1. **Report what happened**

   Ask your agent: “I applied yesterday using the earlier resume PDF. Record it and remind me to follow up next Friday.” Identify the saved application and actual calendar date. Clarify the date or time zone if needed. A plan to apply, downloaded file or opened employer link is not a submission.

2. **Choose the files you used**

   Select the exact saved package or application attachments, including older choices. If you do not know which files or destination you used, keep them unknown. You do not need to recreate historical documents, and current answer drafts are not evidence of submitted answers.

3. **Review the saved report**

   JobHunt records your report, not an employer receipt or delivery confirmation. Recording can move an earlier-stage application to Applied; ask to keep the current stage if that is your intent. Later stages are preserved.

4. **Correct an existing report**

   Identify the report to correct and supply the corrected facts. A correction adds a replacement linked to the earlier report; the original evidence stays in history. It does not delete the past report or send another application.

5. **Recover only unfinished work**

   If the reply was interrupted, check the original request before retrying. Keep the same request identity for that retry. Closing a retry does not undo a recorded application. A requested follow-up task is saved separately: if the report succeeds but the task fails, recover the task without recording the submission again. A missing task permission does not erase a saved submission; restore that permission before resuming the unfinished task.

## Expected result

Your application history records the date and evidence you supplied, with corrections preserved.

## Troubleshooting and recovery

Unknown files and destinations stay unknown. JobHunt does not submit employer forms or send a follow-up message. See “Tailor documents for a role” for final material review and “Keep track of your next steps” for saved reminders.

## API operations

### get_submission_options

Read this application’s current stage, public employer link, saved PDF packages and owned attachments for an explicit submission review. These are choices, never inferred evidence. An employer-link click has no submission effect. Use prepared_before_id or external_before_id with the returned next cursor to read older choices.

- Interface: GET /api/v1/journey/get_submission_options
- Access: read
- Destructive: no
- Availability: connected-journey
- Required permissions: read:applications, read:documents
- [Operation and exact schemas](https://jobhunt.app/support/operations/get_submission_options.json)
- [Operation Markdown](https://jobhunt.app/support/operations/get_submission_options.md)

### get_application_submissions

Read up to 50 reported submissions and appended corrections for one owned application. Files require read:documents. before_id pages older history. Unknown documents and destinations remain explicitly unknown. These are user reports, not delivery receipts from an employer.

- Interface: GET /api/v1/journey/get_application_submissions
- Access: read
- Destructive: no
- Availability: connected-journey
- Required permissions: read:applications
- [Operation and exact schemas](https://jobhunt.app/support/operations/get_application_submissions.json)
- [Operation Markdown](https://jobhunt.app/support/operations/get_application_submissions.md)

### record_submission

Record an application only after the user explicitly says they submitted it. user_confirmed must be true. This is a user_report, never employer-verified evidence. Record the actual date and optional public HTTPS destination. Select the exact prepared package or owned application attachments they used; if unknown, document_knowledge=unknown with no file references. Never infer the newest file. The report and optional move to Applied are atomic; later stages stay in place. Set move_to_applied=false to keep the current stage. Corrections append a new report using supersedes_id. Reuse request_id after interruption. No employer send or billing action occurs.

- Interface: POST /api/v1/journey/record_submission
- Access: write
- Destructive: yes
- Availability: connected-journey
- Required permissions: write:applications
- [Operation and exact schemas](https://jobhunt.app/support/operations/record_submission.json)
- [Operation Markdown](https://jobhunt.app/support/operations/record_submission.md)

### get_job_hunt_operation

Read a saved JobHunt operation after a retry or lost response. Use the original operation ID or request ID and operation name; optionally bind the expected payload hash. Full profile-photo receipts expose original non-secret photo artifact IDs in data.related_ids. Payload-hash-bound application-document customization checks also expose the exact created role-document ID. Payload-hash-bound submission-report checks expose the exact reported submission ID. Other receipt namespaces do not expose related IDs. Never repeat an uncertain create with a new key.

- Interface: GET /api/v1/journey/get_job_hunt_operation
- Access: read
- Destructive: no
- Availability: connected-journey
- Required permissions: read:profile, read:applications, read:documents, read:campaigns, read:tasks, read:contacts, read:interviews, read:companies, read:calendar
- [Operation and exact schemas](https://jobhunt.app/support/operations/get_job_hunt_operation.json)
- [Operation Markdown](https://jobhunt.app/support/operations/get_job_hunt_operation.md)

### close_submission_original_v1

Explicitly close retry of one complete user-reported submission original. Supply the captured account, full original input and confirm_close=true. Uses the same owner and receipt lock as record_submission. An unused request is fenced; recorded or expired evidence is historical, never an undo. No application, report, document or pipeline stage is read, created or changed. Read/write application grants suffice because closure does not inspect document contents. Keep the original until exact closure is verified. No employer send or publication occurs.

- Interface: POST /api/v1/journey/close_submission_original_v1
- Access: write
- Destructive: yes
- Availability: connected-journey
- Required permissions: read:applications, write:applications
- [Operation and exact schemas](https://jobhunt.app/support/operations/close_submission_original_v1.json)
- [Operation Markdown](https://jobhunt.app/support/operations/close_submission_original_v1.md)

### create_task_v2

Create one requested follow-up, standalone or linked to an owned application/search. Reuse request_id after a lost response and check get_job_hunt_operation. Calendar dates stay on their supplied day; timed due_at values require a timezone. Use recurrence for explicit repeating requests; weekly/custom_days use Monday=0 through Sunday=6, and optional due_time uses the account timezone. Do not invent a time or turn a recurring request into a one-off. Linking a job/search also requires its read grant. Records a task only: no email, invitation, calendar sync or scheduled outreach.

- Interface: POST /api/v1/journey/create_task_v2
- Access: write
- Destructive: yes
- Availability: connected-journey
- Required permissions: write:tasks
- [Operation and exact schemas](https://jobhunt.app/support/operations/create_task_v2.json)
- [Operation Markdown](https://jobhunt.app/support/operations/create_task_v2.md)

### get_task_v2

Read one owned task and its current revision before editing. Application-linked tasks also require read:applications. Recurring tasks include their schedule and date-specific completion fingerprint; stage templates use application records.

- Interface: GET /api/v1/journey/get_task_v2
- Access: read
- Destructive: no
- Availability: connected-journey
- Required permissions: read:tasks
- [Operation and exact schemas](https://jobhunt.app/support/operations/get_task_v2.json)
- [Operation Markdown](https://jobhunt.app/support/operations/get_task_v2.md)

## Related guides

- [Remove an application](https://jobhunt.app/support/using/pipeline/remove-an-application.md)
- [Keep your job-search sites handy](https://jobhunt.app/support/using/pipeline/save-your-search-sites.md)
- [Save a target company](https://jobhunt.app/support/using/pipeline/save-a-target-company.md)

---

## Hunter

This section is not part of the guide above. It applies only to an agent acting in a person's JobHunt account.

When working in JobHunt, you are Hunter, the agent at the laptop working alongside the person on their job search. Speak plainly, in the first person, and never pretend to be human. Be brief, calm and kind; the person decides and you do the legwork.

Use the person's words and supplied or saved facts. Organise, edit and tailor what they provide; never invent an employer, date, degree or achievement. Keep uncertainty explicit: unknown stays unknown.

Say exactly what changed and what did not. A draft is not a sent message. Prepared or downloaded files are not a submitted application. Record a submission or interaction only from the person's report; do not imply employer verification.

Ask for confirmation before publishing, sharing or deleting. Explain what will become visible or be removed, and preserve the person's choices and unrelated saved work. Do not repeat a confirmation already given for the same action and reviewed content.

Offer the next useful step without pressure: no scores, streaks, ranks, points, guilt, confetti or invented urgency. A messy board needs no judgment.
