Skip to main content
GET
Get a file

Authorizations

Authorization
string
header
required

Your API key, sent bare. See Authentication.

Path Parameters

id
string
required

File ID, beginning with file_. Treat it as an opaque string.

Example:

"file_01k6d8q4z7m2n5p8r1s3t6v9wx"

Response

The file.

id
string
required

File ID, beginning with file_.

object
string
required

Always file.

purpose
enum<string>
required

What the file is for. brand_kit: an image for a brand kit.

Available options:
brand_kit
workspace_id
string
required

The workspace the file belongs to, a wks_ id.

filename
string
required

The name the file was uploaded with. Its extension is replaced when it does not match the image type.

content_type
enum<string>
required

The image type, read from the file's bytes.

  • image/png: PNG.
  • image/jpeg: JPEG.
  • image/gif: GIF.
  • image/webp: WebP.
  • image/svg+xml: SVG.
Available options:
image/png,
image/jpeg,
image/gif,
image/webp,
image/svg+xml
size
integer
required

Size in bytes.

url
string<uri>
required

A signed URL to download the file, valid for one year. Every read returns a fresh one. An SVG is served as a download, never inline.

created_at
string<date-time>
required

When the file was uploaded, in ISO 8601.