---
title: "Close or edit a verification request"
method: PATCH
path: "/v1/requests/{request_id}"
---

# Close or edit a verification request

`PATCH /v1/requests/{request_id}`

## Request

- Base URL: `https://api.lumethic.com`
- URL: `https://api.lumethic.com/v1/requests/{request_id}`
- Auth: `OAuth2PasswordBearer` (a scheme the document does not define)

Close a request (terminal) or edit its subject, instructions, expiry, cap or share default.

## Path parameters

- `request_id` string, uuid, required

## Headers

- `X-API-Key` string, nullable

## Request body

- VerificationRequestUpdate
  - `status` 'closed', nullable: The only transition: 'closed' is terminal and cannot be reopened.
  - `subject` string, nullable
  - `instructions` string, nullable
  - `expires_at` string, date-time, nullable
  - `max_submissions` integer, nullable
  - `share_with_provider` boolean, nullable

## Response `200`

Successful Response

- VerificationRequestResponse
  - `id` string, uuid, required
  - `subject` string, required
  - `instructions` string, nullable, required
  - `mode` 'existing_original' | 'capture', required: How the provider answers a request: an uploaded camera original, or a capture with Lumethic Capture.
  - `status` 'open' | 'closed' | 'expired', required: Derived status of a verification request. ``open`` and ``closed`` are stored; ``expired`` is ``open`` past ``expires_at`` and is never written to the row.
  - `expires_at` string, date-time, required
  - `closed_at` string, date-time, nullable, required
  - `max_submissions` integer, required
  - `submission_count` integer, required: Accepted uploads so far (counted, never stored).
  - `share_with_provider` boolean, required
  - `token` string, required: Bearer secret: anyone holding it can open the landing page and upload to this request until it closes, expires or fills. Returned on every owner read; listing requests exposes every open link of the account.
  - `url` string, required: The landing page link (and the QR code's content): {FRONTEND_URL}/r/{token}.
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `404`: Request not found
- `422`: Invalid update

---

[API](https://skmtc.dev/lumethic/apis/lumethic-integration-api.md) · [All operations](https://skmtc.dev/lumethic/apis/lumethic-integration-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lumethic/apis/lumethic-integration-api/revisions/fdafea3a491e?raw)