> ## Documentation Index
> Fetch the complete documentation index at: https://docs.penbox.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Request

> Previous version of Update Form. Update a request's status or expiration.

<Warning>
  Previous API version. Use [`PATCH /forms/{id}`](/api-reference/requests/update-request) for new integrations. This route still works but is deprecated.
</Warning>

Update a request's (now form's) status or expiration date.

```text theme={null}
PATCH https://connect.penbox.io/v1/requests/{id}
```

## Path Parameters

| Parameter | Type          | Description        |
| --------- | ------------- | ------------------ |
| `id`      | string (uuid) | Request identifier |

## Request Body

At least one field must be provided.

| Field          | Type    | Description                                           |
| -------------- | ------- | ----------------------------------------------------- |
| `archived`     | boolean | Archive or unarchive the request                      |
| `draft`        | boolean | Set draft status (`true` = draft, `false` = activate) |
| `processed`    | boolean | Mark as processed or unprocessed                      |
| `active_until` | string  | Update expiration date (ISO 8601)                     |

## Example

```bash cURL theme={null}
curl -X PATCH 'https://connect.penbox.io/v1/requests/REQUEST_ID' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{ "archived": true }'
```

## Response

Returns the updated request object (same shape as [Get Request](/api-reference/previous-api-version/get-request)).

## Response Codes

| Code  | Description                           |
| ----- | ------------------------------------- |
| `200` | Success                               |
| `400` | Bad Request — no valid field provided |
| `401` | Unauthorized                          |
| `403` | Forbidden                             |
| `404` | Not Found — request doesn't exist     |
| `422` | Unprocessable — validation failed     |
| `429` | Too Many Requests                     |
| `500` | Server Error                          |