Skip to content

POST /files

Upload Files

POST
/files

Upload one or more files and attach them to an entity.

Validates the target entity and subfolder path via verify_target_data,
then writes each uploaded file to the configured file storage under
{bucket}/{object_key}/{subfolder}/. When reset_folder=true, the
target subfolder is cleared before writing. No auth dependency is declared
on the decorator — access is controlled by the caller's session token
checked upstream by middleware.

Emits: (direct transaction — no event class)

Required scope: attachment:file:upload

Request Body

multipart/form-data
object
Valid values"issue""product""step""traceability""user""serial""task"
Defaultfalse

Responses

Successful Response

application/json
JSON
[
]

Samples

Powered by VitePress OpenAPI