Files

Create file

Creates a new file in the specified Files app.

post/api/apps/{app}/files

Request

  • Base URL: https://docs.weavy.com (the document declares no server; this is the origin it was published from)
  • URL: https://docs.weavy.com/api/apps/{app}/files
  • Auth: none declared

Path parameters

appstring required

App identifier (id or uid)

Request body

namestring nullable

File name. When not specified the file will get the name of the underlying blob.

metadataobject nullable

Additional metadata properties, e.g. { "color": "blue", "size": "XL" }.

tagsstring[] nullable

A list of tags to associate with the file.

replaceboolean

true to force an existing file with the same name to be overwritten (otherwise a 409 Conflict response will be produced).

Response

OK

namestring nullable
kindstring nullable
media_typestring nullable
metadataobject nullable
tagsstring[] nullable
providerstring nullable
rawstring nullable
download_urlstring nullable
application_urlstring nullable
embed_urlstring nullable
external_urlstring nullable
preview_format'none' | 'audio' | 'code' | 'embed' | 'html' | 'image' | 'pdf' | 'text' | 'video'
preview_urlstring nullable
thumbnail_urlstring nullable
created_atstring date-time nullable
updated_atstring date-time nullable
is_starredboolean nullable
is_subscribedboolean nullable
is_trashedboolean nullable

Changes

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