Sign in
Files

Get versions of a file

This endpoint fetches the version history of a file, allowing you to see the progression of a file over time. You can then use this information to render a specific version of the file, via another endpoint.

get/v1/files/{file_key}/versions

Path parameters

file_keystring required

File to get version history 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.

Query parameters

page_sizenumber

The number of items returned in a page of the response. If not included, page_size is 30.

beforenumber

A version ID for one of the versions in the history. Gets versions before this ID. Used for paginating. If the response is not paginated, this link returns the same data in the current response.

afternumber

A version ID for one of the versions in the history. Gets versions after this ID. Used for paginating. If the response is not paginated, this property is not included.

Response

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

Changes

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

  • 2c69c439e8471See the full diff
    • ○

      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

  • 8014b4aceb2f1See the full diff
    • ○

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

      api-security-scope-added

  • de5c0106668d2See the full diff
    • ○

      the endpoint scheme security PlanAccessToken was removed from the API

      api-security-removed

    • ○

      the security scope file_versions: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