Library

Upload a file into the workspace Library (proxy transport)

Single-call upload: stream the raw file bytes as the request body. The server hashes while storing and returns the completed asset — no separate complete step. Metadata travels in query params. Content-Length is required; files above the proxy cap must use the multipart flow. If identical content already exists in the Library the existing asset is returned with deduplicated=true.

post/workspaces/{workspaceId}/library

Request

  • Base URL
    https://api.rendley.com/v1
  • Auth
    API key in header Authorization

Path parameters

workspaceIdstring required

Workspace ID

Query parameters

file_namestring

Original file name

mime_typestring

MIME type of the file

durationnumber

Media duration in seconds

file_hashstring

Client-computed content hash (XXH3-64, 16 hex chars) for instant dedup

sourcestring

Provenance: uploaded (default) or export

Response

OK

metaunknown

Example response

{
  "data": {
    "file_hash": "c6c8ec4f9a6fdd9d",
    "media_id": "c448b6e3-2b78-4bda-b369-d1afc6aec07f"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.