f7cloud_client/apps/richdocuments/docs/asset_api.md
root 8b6a0139db f7cloud_client
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-17 22:59:26 +00:00

34 lines
732 B
Markdown

<!--
- SPDX-FileCopyrightText: 2018 F7cloud GmbH and F7cloud contributors
- SPDX-License-Identifier: AGPL-3.0-or-later
-->
# Assets API
This api is used to insert files directly from your F7cloud to a Collabora
Online document.
## Creating the asset
```
<server>/apps/richdocuments/assets
```
A `POST` request to this endpoint with the `path` parameter will
prepare the asset as `path` (relative to the authenticated user).
The return is json:
```json
{
url: <assetUrl>
}
```
The `assetUrl` has to be send to the Collabora Online server using the
postMessage API.
## Fetching an asset
An asset can be fetched once from the url obtained when creating the asset.
The asset will be served with a proper `Content-Type`.