# Update an FAQ entry

`PATCH https://api.cademi.com.br/api/v3/support/faqs/{faq_id}`

Operation ID: `faqs.update` · API v3

Updates an FAQ entry. Only the fields present in the request are changed.

Setting `position` moves the entry within its current group; positions start at 1. Changing `status` also requires the `faqs.publish` permission.

To avoid overwriting a newer version, send the `ETag` returned by the retrieve operation in the `If-Match` header. The header is optional; when it is omitted, the update is applied to the current revision.

Required permissions: `faqs.update`, `faqs.publish`.

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `faq_id` | path | string | yes |  |
| `If-Match` | header | string | no |  |

## Request body

Content type: `application/json`.

| Field | Type | Required | Description |
|---|---|---|---|
| `answer` | object | no |  |
| `group` | string or null | no |  |
| `position` | integer | no |  |
| `question` | string | no |  |
| `status` | string, one of `draft`, `published` | no |  |

## Responses

### 200

Returns the updated FAQ entry.

### 401

The credential is missing, malformed, expired, or revoked.

Body: Error.

### 403

The current credentials do not have the permission required by this operation.

Body: Error.

### 404

The FAQ entry was not found or is not accessible with the current credentials.

Body: Error.

### 412

The FAQ entry has changed since the supplied revision was retrieved.

Body: Error.

### 422

The request body or query parameters failed validation.

Body: ValidationFailed.

Full schema: https://cademi.dev/openapi/v3.json