Documents
Store a file on immut and create permanent proof
POST
https://backend.immut.io/api/v1/documentsRequired scope: documents:write
Multipart field file (required) and workspace (required). Preferred path for the public agent skill.
Request body
Content type: multipart/form-data (required)
| Field | Type | Required | Description |
|---|---|---|---|
file | file | yes | multipart file field (required) |
workspace | string | yes | workspace id (required) |
title | string | no | optional |
category | string | no | optional |
folder | string | no | optional folder id |
Responses
| Status | Meaning |
|---|---|
201 | Created. data is the stored document, including its id. |
400 | BadRequest |
401 | Unauthorized |
403 | Forbidden |
429 | RateLimited |
Example
curl -X POST "https://backend.immut.io/api/v1/documents" \
-H "Authorization: Bearer $IMMUT_API_KEY" \
-F "file=@/path/to/file" \
-F "workspace=<workspace>" \
-F "title=<title>" \
-F "category=<category>" \
-F "folder=<folder>"
Generated from the immut API contract, version 1.9.0. Machine-readable: this page as markdown · everything in one file · OpenAPI