List version stacks

GET

https://api.frame.io/v4/accounts/:account_id/folders/:folder_id/version_stacks

GET

/v4/accounts/:account_id/folders/:folder_id/version_stacks

1 from frameio import Frameio
2 
3 client = Frameio(
4     base_url="https://api.frame.io"
5 )
6 
7 client.version_stacks.list(
8     account_id="6d1c7993-02a2-4391-bd38-ccdb6a7883e9",
9     folder_id="8d82deba-2b18-426a-bd75-690163923f23"
10 )

Try it

200Retrieved

1 {
2   "data": [
3     {
4       "created_at": "2023-09-25T19:18:29.614189Z",
5       "head_version": {
6         "created_at": "2023-09-25T19:18:29.614189Z",
7         "file_size": 1137444,
8         "id": "a8b31dfd-59c5-448d-b797-0ccb1c408bc6",
9         "media_type": "image/png",
10         "name": "asset.png",
11         "parent_id": "572e249a-b67d-4a66-a4ed-3a49276677e3",
12         "project_id": "0bf22394-bc3a-47d6-bd90-e1955d2c6fe3",
13         "status": "created",
14         "type": "file",
15         "updated_at": "2024-02-07T16:44:41.986478Z",
16         "view_url": "https://next.frame.io/project/d5e6011c-2bc9-4596-be05-77d562627112/view/5a89a9fb-0900-4b23-826b-127b90e4db4c",
17         "creator": {
18           "active": true,
19           "avatar_url": "https://assets.frame.io/uploads/cd58cb8e-24b3-4448-8d0f-9532fcd04d11/original.png?response-content-disposition=attachment%3B+filename%3D%22foo.png&Expires=1729857600&Signature=L09h0pi82dCrMYjr9lMHBragByWYh1&Key-Pair-Id=KKI497NESTHMN",
20           "email": "user_email@example.com",
21           "id": "196C1A5666BF4EB00A49411B@176719f5667c82b4494214.e",
22           "name": "Jon Doe"
23         },
24         "media_links": {
25           "high_quality": {
26             "download_url": "https://assets.frame.io/uploads/cd58cb8e-24b3-4448-8d0f-9532fcd04d11/original.png?response-content-disposition=attachment%3B+filename%3D%22foo.png&Expires=1729857600&Signature=L09h0pi82dCrMYjr9lMHBragByWYh1&Key-Pair-Id=KKI497NESTHMN"
27           },
28           "original": {
29             "download_url": "https://assets.frame.io/uploads/cd58cb8e-24b3-4448-8d0f-9532fcd04d11/original.png?response-content-disposition=attachment%3B+filename%3D%22foo.png&Expires=1729857600&Signature=L09h0pi82dCrMYjr9lMHBragByWYh1&Key-Pair-Id=KKI497NESTHMN",
30             "inline_url": "https://assets.frame.io/uploads/cd58cb8e-24b3-4448-8d0f-9532fcd04d11/original.png?response-content-disposition=inline%3B+filename%3D%22foo.png&Expires=1729857600&Signature=L09h0pi82dCrMYjr9lMHBragSDFXDFh&1Key-Pair-Id=KKI497NESTHMN"
31           },
32           "thumbnail": {
33             "download_url": "https://assets.frame.io/uploads/cd58cb8e-24b3-4448-8d0f-9532fcd04d11/original.png?response-content-disposition=attachment%3B+filename%3D%22foo.png&Expires=1729857600&Signature=L09h0pi82dCrMYjr9lMHBragByWYh1&Key-Pair-Id=KKI497NESTHMN",
34             "url": "https://picture2.frame.io/image/s3://frameio-assets-development/image/cd58cb8e-24b3-4498-8d0f-9532fcd04d11/image_full.png?alg=HS256&sig=0_u7w_wz2MwQHOXp000ibbQSMRijujyaUu8V3YYPxu4&exp=1729857600"
35           }
36         },
37         "metadata": [
38           {
39             "field_type": "select",
40             "field_definition_id": "345023f3-9bb9-4d53-8b17-0b88a5736cb5",
41             "field_definition_name": "Fields definition name",
42             "mutable": true,
43             "value": [
44               {
45                 "display_name": "Display name",
46                 "id": "e6bdded8-f3c7-4df4-9548-f0667a18e358"
47               }
48             ],
49             "field_options": [
50               {
51                 "display_name": "Display name",
52                 "id": "e6bdded8-f3c7-4df4-9548-f0667a18e358"
53               },
54               {
55                 "display_name": "Display name 2",
56                 "id": "ab4dfd21-3f85-4f90-8de7-dbe92d8f438e"
57               }
58             ]
59           }
60         ],
61         "project": {
62           "created_at": "2024-01-25T19:18:29.614189Z",
63           "description": "Project Description",
64           "id": "64e90198-c372-4c37-aa27-eea6b53df5fc",
65           "name": "My Project",
66           "root_folder_id": "cbf1c36a-07eb-480f-ae3d-bec524362d59",
67           "storage": 15000,
68           "updated_at": "2024-02-07T16:44:41.986478Z",
69           "view_url": "https://next.frame.io/project/d5e6011c-2bc9-4596-be05-77d562627112/",
70           "workspace_id": "7a0ac02a-b2f8-4b3d-909f-63e9813ba19d",
71           "owner": {
72             "active": true,
73             "avatar_url": "https://assets.frame.io/uploads/cd58cb8e-24b3-4448-8d0f-9532fcd04d11/original.png?response-content-disposition=attachment%3B+filename%3D%22foo.png&Expires=1729857600&Signature=L09h0pi82dCrMYjr9lMHBragByWYh1&Key-Pair-Id=KKI497NESTHMN",
74             "email": "user_email@example.com",
75             "id": "196C1A5666BF4EB00A49411B@176719f5667c82b4494214.e",
76             "name": "Jon Doe"
77           }
78         }
79       },
80       "id": "a8b31dfd-59c5-448d-b797-0ccb1c408bc6",
81       "name": "asset.png",
82       "parent_id": "572e249a-b67d-4a66-a4ed-3a49276677e3",
83       "project_id": "0bf22394-bc3a-47d6-bd90-e1955d2c6fe3",
84       "type": "file",
85       "updated_at": "2024-02-07T16:44:41.986478Z",
86       "view_url": "https://next.frame.io/project/d5e6011c-2bc9-4596-be05-77d562627112/view/5a89a9fb-0900-4b23-826b-127b90e4db4c",
87       "creator": {
88         "active": true,
89         "avatar_url": "https://assets.frame.io/uploads/cd58cb8e-24b3-4448-8d0f-9532fcd04d11/original.png?response-content-disposition=attachment%3B+filename%3D%22foo.png&Expires=1729857600&Signature=L09h0pi82dCrMYjr9lMHBragByWYh1&Key-Pair-Id=KKI497NESTHMN",
90         "email": "user_email@example.com",
91         "id": "196C1A5666BF4EB00A49411B@176719f5667c82b4494214.e",
92         "name": "Jon Doe"
93       },
94       "metadata": [
95         {
96           "field_type": "select",
97           "field_definition_id": "345023f3-9bb9-4d53-8b17-0b88a5736cb5",
98           "field_definition_name": "Fields definition name",
99           "mutable": true,
100           "value": [
101             {
102               "display_name": "Display name",
103               "id": "e6bdded8-f3c7-4df4-9548-f0667a18e358"
104             }
105           ],
106           "field_options": [
107             {
108               "display_name": "Display name",
109               "id": "e6bdded8-f3c7-4df4-9548-f0667a18e358"
110             },
111             {
112               "display_name": "Display name 2",
113               "id": "ab4dfd21-3f85-4f90-8de7-dbe92d8f438e"
114             }
115           ]
116         }
117       ],
118       "project": {
119         "created_at": "2024-01-25T19:18:29.614189Z",
120         "description": "Project Description",
121         "id": "64e90198-c372-4c37-aa27-eea6b53df5fc",
122         "name": "My Project",
123         "root_folder_id": "cbf1c36a-07eb-480f-ae3d-bec524362d59",
124         "storage": 15000,
125         "updated_at": "2024-02-07T16:44:41.986478Z",
126         "view_url": "https://next.frame.io/project/d5e6011c-2bc9-4596-be05-77d562627112/",
127         "workspace_id": "7a0ac02a-b2f8-4b3d-909f-63e9813ba19d",
128         "owner": {
129           "active": true,
130           "avatar_url": "https://assets.frame.io/uploads/cd58cb8e-24b3-4448-8d0f-9532fcd04d11/original.png?response-content-disposition=attachment%3B+filename%3D%22foo.png&Expires=1729857600&Signature=L09h0pi82dCrMYjr9lMHBragByWYh1&Key-Pair-Id=KKI497NESTHMN",
131           "email": "user_email@example.com",
132           "id": "196C1A5666BF4EB00A49411B@176719f5667c82b4494214.e",
133           "name": "Jon Doe"
134         }
135       }
136     }
137   ],
138   "links": {
139     "next": "/v4/accounts/1234/workspaces/5678/projects?after=g3QAAAACZAACaWRtAAAAJGFiMmNiY2QzLWFkODQtNDQwMC05YTRkLWE1ZDRkMGE4ZTIxM2QABG5hbWVtAAAACVByb2plY3QgMg=="
140   },
141   "total_count": 10
142 }

List version stacks in a given folder

Path parameters

account_idstringRequiredformat: "uuid"

A UUID String

folder_idstringRequiredformat: "uuid"

A UUID String

Query parameters

includeenumOptional

Supported include query parameter values for endpoints that return files with media links

afterstringOptional

Opaque Cursor query param for requests returning paginated results.

NOTE: this value is auto-generated and included as part of links from a previous response. It is not intended to be human readable.

page_sizeintegerOptional>=1<=100Defaults to 50

Page size query param for requests

include_total_countbooleanOptionalDefaults to false

Page query param to include the count of all entities

Response

datalist of objects

linksobject

Links to paginated data

total_countinteger or null

Total count

Path parameters

Query parameters

Response

Errors