---
title: "Store an original file in the authenticated tenant"
method: POST
path: "/v1/files"
tags: ["Files"]
---

# Store an original file in the authenticated tenant

`POST /v1/files`

## Request

- Base URL: `https://api.cernion.de`
- URL: `https://api.cernion.de/v1/files`
- Auth: none declared

Authenticated tenant and current Workbench mapping/clearance required. Gateway credentials delegate no independent privileges. No file contents are logged.

## Query parameters

- `token` string

## Request body

- object
  - `name` string, required
  - `contentBase64` string, byte, required
  - `mimeType` 'application/pdf' | 'application/vnd.openxmlformats-officedocument.wordprocessingml.document' | 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' | 'text/csv' | 'application/vnd.openxmlformats-officedocument.presentationml.presentation' | 'text/plain' | 'application/edifact' | 'application/edifact' | 'message/rfc822'
  - `sensitivityLevel` 'public' | 'tenant_internal' | 'restricted' | 'highly_sensitive'
  - `openWebuiOrgId` string
  - `token` string: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.

## Response `200`

Store an original file in the authenticated tenant

- object
  - `fileId` string, required
  - `hash` string, required
  - `name` string, required
  - `mimeType` 'application/pdf' | 'application/vnd.openxmlformats-officedocument.wordprocessingml.document' | 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' | 'text/csv' | 'application/vnd.openxmlformats-officedocument.presentationml.presentation' | 'text/plain' | 'application/edifact' | 'application/edifact' | 'message/rfc822', required
  - `size` integer, required
  - `duplicate` boolean

## Other responses

- `401`: Authentication required
- `403`: Mapping, tenant, confidentiality or signed-link authorization denied
- `413`: Configured file/expanded archive budget exceeded
- `422`: Invalid file type, name or encoding

---

[API](https://skmtc.dev/cernion/apis/cernion-energy-tools-api.md) · [All operations](https://skmtc.dev/cernion/apis/cernion-energy-tools-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cernion/apis/cernion-energy-tools-api/revisions/cdb94473b538?raw)