Rename a file, set its alt text, move it to a folder, set its tags, or report a video's size and length
Rename a file, set its alt text, move it to a folder, set its tags, or report a video's size and length (media:write)
Every request sends Authorization: Bearer ...: the access token in local mode, an API key stk_... in cloud mode. Use Send to try it against your cloud instance with your API key.
AuthorizationBearer <token>API key (stk_...), or in the Community Edition the access token (stk_local_...)
id*stringapplication/json- body
name?string1 <= lengthalt_text?stringlength <= 1500width?integer0 <= value <= 100000height?integer0 <= value <= 100000duration_ms?integer0 <= value <= 86400000folder_id?stringMoves the file: a folder id, or empty for the top level
tags?array<>Replaces the file's tags; lowercased, without #, spaces become dashes
items <= 20The file
application/json- response
An uploaded file
id*stringmime_type*stringsize_bytes*integeroriginal_name*stringurl*stringAbsolute URL (PUBLIC_API_URL); requires authentication
sha256*stringcreated_at*stringdate-timealt_text*stringDescribes a picture for people who can't see it; platforms that take alt text receive it
width*integerPixels; measured on upload for pictures, reported by the uploading browser for videos; 0 when unknown
height*integerPixels; 0 when unknown
duration_ms*integerA video's or audio file's length in milliseconds; 0 when unknown
folder_id*stringThe library folder the file sits in; empty for the top level
tags*array<string>deleted_at?stringSet while the file is in Deleted
date-timepurge_at?stringWhen a file in Deleted is deleted for good
date-timeduplicate_of?stringThe oldest other file with the same content, if any
curl -X PATCH 'https://staqly.example.com/v1/media/string' \ -H 'Content-Type: application/json' \ -d '{}'{ "id": "string", "mime_type": "string", "size_bytes": 0, "original_name": "string", "url": "string", "sha256": "string", "created_at": "2019-08-24T14:15:22Z", "alt_text": "string", "width": 0, "height": 0, "duration_ms": 0, "folder_id": "string", "tags": [ "string" ], "deleted_at": "2019-08-24T14:15:22Z", "purge_at": "2019-08-24T14:15:22Z", "duplicate_of": "string"}