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
contents
string[]
Required
bucket
string
Required
Valid values
"issue""product""step""traceability""user""serial""task"object_key
string
Required
subfolder
string
reset_folder
boolean
Default
falseResponses
Successful Response
application/json
[
]