staqlydocs
REST APIAPI referenceMedia

A file's details

A file's details (media:read); the file itself is GET /v1/media/{id}

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.

GET
/v1/media/{id}/info

Authorization

headerAuthorizationBearer <token>

API key (stk_...), or in the Community Edition the access token (stk_local_...)

Path Parameters

id*string

Response Body

The file

application/json
  1. response

An uploaded file

id*string
mime_type*string
size_bytes*integer
original_name*string
url*string

Absolute URL (PUBLIC_API_URL); requires authentication

sha256*string
created_at*string
Formatdate-time
alt_text*string

Describes a picture for people who can't see it; platforms that take alt text receive it

width*integer

Pixels; measured on upload for pictures, reported by the uploading browser for videos; 0 when unknown

height*integer

Pixels; 0 when unknown

duration_ms*integer

A video's or audio file's length in milliseconds; 0 when unknown

folder_id*string

The library folder the file sits in; empty for the top level

tags*array<string>
deleted_at?string

Set while the file is in Deleted

Formatdate-time
purge_at?string

When a file in Deleted is deleted for good

Formatdate-time
duplicate_of?string

The oldest other file with the same content, if any

curl -X GET 'https://staqly.example.com/v1/media/string/info'
{  "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"}