---
title: "Get file metadata"
method: GET
path: "/v1/files/{file_key}/meta"
tags: ["Files"]
---

# Get file metadata

`GET /v1/files/{file_key}/meta`

Get file metadata

## Path parameters

- `file_key` string, required

## Response `200`

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

- object
  - `file` object, required — The file metadata.
    - `name` string, required — The name of the file.
    - `folder_name` string — The name of the project containing the file.
    - `last_touched_at` string, date-time, required — The UTC ISO 8601 time at which the file content was last modified.
    - `creator` User, required — A description of a user.
      - `id` string, required — Unique stable id of the user.
      - `handle` string, required — Name of the user.
      - `img_url` string, required — URL link to the user's profile image.
    - `last_touched_by` User — A description of a user.
      - `id` string, required — Unique stable id of the user.
      - `handle` string, required — Name of the user.
      - `img_url` string, required — URL link to the user's profile image.
    - `thumbnail_url` string — A URL to a thumbnail image of the file.
    - `editorType` 'figma' | 'figjam' | 'slides' | 'buzz' | 'sites' | 'make', required — The type of editor associated with this file.
    - `role` 'owner' | 'editor' | 'viewer' — The role of the user making the API request in relation to the resource.
    - `link_access` 'view' | 'edit' | 'org_view' | 'org_edit' | 'inherit' — Access policy for users who have the link to the resource.
    - `url` string — The URL of the file.
    - `version` string — The version number of the file. This number is incremented when a file is modified and can be used to check if the file has changed between requests.

## Other responses

- `400` — Bad request. Parameters are invalid or malformed. Please check the input formats. This error can also happen if the requested resources are too large to complete the request, which results in a timeout. Please reduce the number and size of objects requested.
- `403` — The request was valid, but the server is refusing action. The user might not have the necessary permissions for a resource, or may need an account of some sort.
- `404` — The requested file or resource was not found.
- `429` — In some cases API requests may be throttled or rate limited. Please wait a while before attempting the request again (typically a minute).
- `500` — An internal server error occurred.

## Changes

- **2026-05-29** `f6cdba6b4800` — 4 breaking, 7 warning, 1 info
  - removed the required property `creator` from the response with the `200` status
  - removed the required property `editorType` from the response with the `200` status
  - removed the required property `last_touched_at` from the response with the `200` status
  - removed the required property `name` from the response with the `200` status
  - …8 more
- **2026-05-06** `2c69c439e847` — 1 info
  - the endpoint scheme security `PlanAccessToken` was added to the API
- **2025-07-02** `f904406fac21` — 3 warning
  - added the new `buzz` enum value to the `editorType` response property for the response status `200`
  - added the new `make` enum value to the `editorType` response property for the response status `200`
  - added the new `sites` enum value to the `editorType` response property for the response status `200`
- **2025-05-07** `61c8e1bd4392` — 1 info
  - endpoint added
- **2023-12-14** `de5c0106668d` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/figma/apis/figma-api/changes/v1/files/:file_key/meta/get.md)

---

[API](https://skmtc.dev/figma/apis/figma-api.md) · [All operations](https://skmtc.dev/figma/apis/figma-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/figma/figma-api/revisions/d7ab5681d84c/schema)