Cernion Files API
The Files API from Cernion — 4 operation(s) for files.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/cernion-de:cernion-de-files-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Cernion Energy Tools Files API
version: 0.99.22
description: 'MicroService Agent System for Energy Markets - REST API with AI integration.
CERNION_TOKEN: request at https://cernion.de/ or by email: dev@stromdao.com.
For the public instance at https://api.cernion.de/, create your token at https://cernion.de/cet-token/.'
servers:
- url: https://api.cernion.de
description: API Server
tags:
- name: Files
paths:
/v1/files:
post:
summary: Store an original file in the authenticated tenant
tags:
- Files
operationId: files_upload
parameters:
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: Store an original file in the authenticated tenant
content:
application/json:
schema:
type: object
required:
- fileId
- name
- mimeType
- size
- hash
properties:
fileId:
type: string
pattern: ^[a-f0-9]{64}$
hash:
type: string
pattern: ^[a-f0-9]{64}$
name:
type: string
maxLength: 200
mimeType:
type: string
enum:
- application/pdf
- application/vnd.openxmlformats-officedocument.wordprocessingml.document
- application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
- text/csv
- application/vnd.openxmlformats-officedocument.presentationml.presentation
- text/plain
- text/markdown
- application/edifact
- application/edifact
- message/rfc822
size:
type: integer
minimum: 1
duplicate:
type: boolean
'401':
description: Authentication required
'403':
description: Mapping, tenant, confidentiality or signed-link authorization denied
'413':
description: Configured file/expanded archive budget exceeded
'422':
description: Invalid file type, name or encoding
description: Authenticated tenant and current Workbench mapping/clearance required. Gateway credentials delegate no independent privileges. No file contents are logged.
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- name
- contentBase64
properties:
name:
type: string
maxLength: 200
contentBase64:
type: string
format: byte
mimeType:
type: string
enum:
- application/pdf
- application/vnd.openxmlformats-officedocument.wordprocessingml.document
- application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
- text/csv
- application/vnd.openxmlformats-officedocument.presentationml.presentation
- text/plain
- text/markdown
- application/edifact
- application/edifact
- message/rfc822
sensitivityLevel:
type: string
enum:
- public
- tenant_internal
- restricted
- highly_sensitive
default: tenant_internal
openWebuiOrgId:
type: string
token:
type: string
description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
/v1/files/{fileId}/content:
get:
summary: Download a signed tenant-bound file; audit each retrieval
tags:
- Files
operationId: files_download
parameters:
- name: fileId
in: path
required: true
schema:
type: string
pattern: ^[a-f0-9]{64}$
- name: openWebuiOrgId
in: query
schema:
type: string
- name: ticket
in: query
required: true
schema:
type: string
maxLength: 2048
description: Signed seven-day capability; current tenant authentication is also required.
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: Download a signed tenant-bound file; audit each retrieval
content:
application/pdf:
schema:
type: string
format: binary
application/vnd.openxmlformats-officedocument.wordprocessingml.document:
schema:
type: string
format: binary
application/vnd.openxmlformats-officedocument.spreadsheetml.sheet:
schema:
type: string
format: binary
text/csv:
schema:
type: string
format: binary
application/vnd.openxmlformats-officedocument.presentationml.presentation:
schema:
type: string
format: binary
text/plain:
schema:
type: string
format: binary
text/markdown:
schema:
type: string
format: binary
application/edifact:
schema:
type: string
format: binary
message/rfc822:
schema:
type: string
format: binary
'401':
description: Authentication required
'403':
description: Mapping, tenant, confidentiality or signed-link authorization denied
'413':
description: Configured file/expanded archive budget exceeded
'422':
description: Invalid file type, name or encoding
description: Authenticated tenant and current Workbench mapping/clearance required. Gateway credentials delegate no independent privileges. No file contents are logged.
/v1/files/{fileId}/link:
get:
summary: Create a seven-day signed link for an authorized file
tags:
- Files
operationId: files_link
parameters:
- name: fileId
in: path
required: true
schema:
type: string
pattern: ^[a-f0-9]{64}$
- name: openWebuiOrgId
in: query
schema:
type: string
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: Create a seven-day signed link for an authorized file
content:
application/json:
schema:
type: object
'401':
description: Authentication required
'403':
description: Mapping, tenant, confidentiality or signed-link authorization denied
'413':
description: Configured file/expanded archive budget exceeded
'422':
description: Invalid file type, name or encoding
description: Authenticated tenant and current Workbench mapping/clearance required. Gateway credentials delegate no independent privileges. No file contents are logged.
/v1/files/{fileId}:
delete:
summary: Physically remove an authorized file and revoke its links
tags:
- Files
operationId: files_remove
parameters:
- name: fileId
in: path
required: true
schema:
type: string
pattern: ^[a-f0-9]{64}$
- name: openWebuiOrgId
in: query
schema:
type: string
- $ref: '#/components/parameters/TokenQuery'
responses:
'200':
description: Physically remove an authorized file and revoke its links
content:
application/json:
schema:
type: object
'401':
description: Authentication required
'403':
description: Mapping, tenant, confidentiality or signed-link authorization denied
'413':
description: Configured file/expanded archive budget exceeded
'422':
description: Invalid file type, name or encoding
description: Authenticated tenant and current Workbench mapping/clearance required. Gateway credentials delegate no independent privileges. No file contents are logged.
requestBody:
required: false
content:
application/json:
schema:
type: object
properties:
token:
type: string
description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
components:
parameters:
TokenQuery:
name: token
in: query
required: false
schema:
type: string
description: Optional Cernion MCP token as URL query parameter. If provided, it overrides CERNION_TOKEN for this request. Prefer Authorization Bearer header in production to reduce token exposure in URLs/logs.
securitySchemes:
ApiKeyAuth:
type: apiKey
in: header
name: X-API-Key
BearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: 'Optional Cernion MCP token. If not provided, falls back to CERNION_TOKEN from environment. Request token at https://cernion.de/ or by email: dev@stromdao.com.'