---
title: "Update Details"
method: PATCH
path: "/api/operator-documents/{revision_id}"
tags: ["operator-documents"]
---

# Update Details

`PATCH /api/operator-documents/{revision_id}`

## Request

- Base URL: `https://api.corabea.it` (the document declares no server; this is the origin it was published from)
- URL: `https://api.corabea.it/api/operator-documents/{revision_id}`
- Auth: HTTP bearer

Title, category, audience and onboarding role of the document; its versions stay as they are.

## Path parameters

- `revision_id` string, uuid, required

## Request body

- DocumentDetails: What a document is, apart from its versions: changed with Modifica.
  - `title` string, required
  - `category` string, nullable
  - `profession` 'PSICOLOGO' | 'NUTRIZIONISTA', nullable
  - `onboarding` 'contract' | 'guidelines' | 'appointment_deed', nullable

## Response `200`

Successful Response

- DocumentDetail
  - `id` string, uuid, required
  - `revision_id` string, uuid, required
  - `version` integer, required
  - `is_current` boolean, required
  - `title` string, required
  - `category` string, nullable, required
  - `profession` 'PSICOLOGO' | 'NUTRIZIONISTA', nullable
  - `onboarding` 'contract' | 'guidelines' | 'appointment_deed', nullable
  - `acknowledgement_text` string, required
  - `published_at` string, date-time, required
  - `file_name` string, required
  - `byte_size` integer, required
  - `change_summary` string, nullable
  - `changes_since` integer, nullable
  - `comparisons` DocumentVersionComparison[], nullable
    - `version` integer, required
    - `text` string, required
  - `communication_id` string, uuid, nullable
  - `acknowledgement_requested` boolean
  - `acknowledged_version` integer, nullable
  - `activity` DocumentActivity
    - `opened_at` string, date-time, nullable
    - `acknowledged_at` string, date-time, nullable

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-19** `aa541cfcfcb0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/corabea/apis/corabea-api/changes/api/operator-documents/:revision_id/patch.md)

---

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