POST /media/create

Create Media

POST

/media/create

Upload a new media file and create its Media record.

Generates a UUID key, writes the file to {media_root}/{key} on disk,
and inserts a Media document into the Media collection. The returned
detail contains the new media document. The media record is initially
unconnected — link it to an entity via the media_connection edge
collection after creation.

Emits: (direct transaction — no event class)

Required scope: attachment:media:upload

Authorizations

OAuth2PasswordBearer

password Flow

Token URL"/api/auth"

Scopes:

• "admin"User can access and edit users and system settings
• "library"User can access and edit products
• "production"User can access and edit production plans
• "operator"User can access the operator panel and make production declarations

Request Body

multipart/form-data

object

Responses

Successful Response

Content-Type

application/json

{

  

"status": 200,

  

"message": "string",

  

"detail": "string"

}

Samples