Files

Get image fills

Returns download links for all images present in image fills in a document. Image fills are how Figma represents any user supplied images. When you drag an image into Figma, we create a rectangle with a single fill that represents the image, and the user is able to transform the rectangle (and properties on the fill) as they wish.

This endpoint returns a mapping from image references to the URLs at which the images may be download. Image URLs will expire after no more than 14 days. Image references are located in the output of the GET files endpoint under the imageRef attribute in a Paint.

get/v1/files/{file_key}/images

Path parameters

file_keystring required

File to get image URLs from. This can be a file key or branch key. Use GET /v1/files/:key with the branch_data query param to get the branch key.

Response

Response from the GET /v1/files/{file_key}/images endpoint.

errorfalse required

For successful requests, this value is always false.

status200 required

Status code

Changes

Changed in 3 of the 36 revisions of this API.4

    • the endpoint scheme security PlanAccessToken was added to the API

      api-security-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • the security scope file_content:read was added to the endpoint's security scheme OAuth2

      api-security-scope-added

    • the endpoint scheme security PlanAccessToken was removed from the API

      api-security-removed

    • the security scope file_content:read was removed from the endpoint's security scheme OAuth2

      api-security-scope-removed

    This revision also has 77 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog