Skip to main content
POST
Share an image

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Share one image, the image_id an upload returns.

image_id
string
required
Example:

"aB3dE5fG"

Response

Successful Response

A share of one image. access says who it reaches and role what they can do; url is the link to send.

id
string<uuid>
required
image_id
string
required
access
enum<string>
required

Who the share reaches. Always anyone_with_link today.

Available options:
anyone_with_link,
user
role
enum<string>
required

What they can do. Always viewer today: shared images are read-only.

Available options:
viewer,
editor
view_count
integer
required

How many times the link has been opened.

created_at
string<date-time>
required
url
string | null

The link to send, for anyone_with_link shares. Anyone holding it can view.

last_viewed_at
string<date-time> | null
revoked_at
string<date-time> | null

When the share was turned off. A revoked link no longer opens.