Zum Hauptinhalt springen
POST
Eine private Dokumentversion hochladen
Verwenden Sie eine gültige Bearer-Sitzung des Arbeitsbereichs. Ein API-Schlüssel kann diesen Endpunkt nicht autorisieren. Der aktuelle Arbeitsbereich und die Umgebung werden von dieser Sitzung abgeleitet. Informationen zu Dateigrenzen, Versionierung, Sperren, Aufbewahrungs- und Entsorgungsverhalten finden Sie unter Informationsverarbeitung.

Autorisierungen

Authorization
string
header
erforderlich

JWT für benutzerinitiierte Operationen

Header

Idempotency-Key
string<uuid>
erforderlich

Eine UUID pro beabsichtigtem Upload. Verwenden Sie sie für Wiederholungen mit derselben Datei; verwenden Sie sie nicht für verschiedene Dateien.

Body

multipart/form-data
file
file
erforderlich

PDF- oder UTF-8-.txt-, .md-, .json-, .yaml-, .yml-Datei, 1 Byte bis 5 MiB.

document_id
string<uuid>

Für ein neues Dokument weglassen. Geben Sie eine aktive Dokument-ID an, um eine neue Version anzuhängen.

title
string

Erforderlich für ein neues Dokument.

Maximum string length: 160
category
enum<string>

Erforderlich für ein neues Dokument.

Verfügbare Optionen:
technical_specification,
architecture,
security,
policy,
general
description
string
Maximum string length: 2000

Antwort

Erfolgreiche Antwort

id
string<uuid>
document_id
string<uuid>
version
integer
filename
string
content_type
string
size_bytes
integer
sha256
string
Pattern: ^[a-f0-9]{64}$
created_at
string<date-time>
purged_at
string<date-time> | null