---
title: "Unlock File"
method: POST
path: "/claims/{claim_id}/files/{file_id}/unlock"
tags: ["files"]
---

# Unlock File

`POST /claims/{claim_id}/files/{file_id}/unlock`

## Request

- Base URL: `https://api.claimkit.co` (the document declares no server; this is the origin it was published from)
- URL: `https://api.claimkit.co/claims/{claim_id}/files/{file_id}/unlock`
- Auth: none declared

Re-process a password-protected file using the supplied password.

Resets processing state and re-enqueues the background task with the password
held transiently in memory. The password is never persisted to the DB nor
written to logs.

Returns 200 with the updated row; 404 if missing; 409 if already processing.

## Path parameters

- `claim_id` integer, required
- `file_id` integer, required

## Request body

- UnlockFileRequest: Password supplied to unlock a password-protected file.
  - `password` string, required

## Response `200`

Successful Response

- FileResponse: File details response.
  - `id` integer, required
  - `filename` string, required
  - `file_type` string, required
  - `file_size` integer, required
  - `category` string, nullable, required
  - `report_year` integer, nullable
  - `status` string, required
  - `uploaded_at` string, required
  - `ai_summary` string, nullable
  - `source` string, nullable
  - `processing_status` string, required
  - `processing_error_code` string, nullable
  - `processing_error_message` string, nullable
  - `extracted_qa` object, nullable
  - `tax_return_details` object, nullable
  - `tax_return_mismatches` object[], nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/claimkit/apis/claimkit-api.md) - [All operations](https://skmtc.dev/claimkit/apis/claimkit-api/llms.txt) - [OpenAPI document](https://skmtc.dev/claimkit/apis/claimkit-api/revisions/94dc85ba5326?raw)