Create version stack

POST

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

POST

/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.create(
8     account_id="e2d0326a-4ab1-4507-a4d3-40bfb4746cc4",
9     folder_id="d018ae58-e6c1-47a7-927b-fbd616e630f7",
10     data={
11         "file_ids": [
12             "ba994037-f270-4e41-bb89-7361c99f5de3",
13             "2d0081a6-0147-4994-bd40-933b29e01bf4"
14         ]
15     }
16 )

Try it

201Created

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

Create a new Version Stack under the parent folder.

Rate Limits: 10 calls per 1.00 minute(s) per account

Path parameters

account_idstringRequiredformat: "uuid"

A UUID String

folder_idstringRequiredformat: "uuid"

A UUID String

Request

Request body

dataobjectRequired

Response

Created

dataobject

Path parameters

Request

Response

Errors