Создать стек версий

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 from frameio.version_stacks import VersionStackCreateParamsData
3 
4 client = Frameio(
5     token="YOUR_TOKEN_HERE",
6 )
7 
8 client.version_stacks.create(
9     account_id="d32154e6-7eee-4a23-93dd-0931156e284f",
10     folder_id="428cc6d4-5175-46be-bd5b-2cf8a840954a",
11     data=VersionStackCreateParamsData(
12         file_ids=[
13             "c89fcce0-c241-42ef-8e40-e3c4d386c584",
14             "71579296-60e4-4eb2-936b-ad1ae7717133"
15         ],
16     ),
17 )

1 {
2   "data": {
3     "head_version": {
4       "created_at": "2023-09-25T19:18:29.614189Z",
5       "file_size": 1137444,
6       "id": "b4c00e24-9beb-4c38-91ad-8f58a88f5a8a",
7       "media_type": "image/png",
8       "name": "asset.png",
9       "parent_id": "6ecaf9c3-23ab-4031-8dc8-8acbfec1afbd",
10       "project_id": "70e467b0-c8ab-4881-9c63-836664103a26",
11       "status": "created",
12       "type": "file",
13       "updated_at": "2024-02-07T16:44:41.986478Z",
14       "view_url": "https://next.frame.io/project/d5e6011c-2bc9-4596-be05-77d562627112/view/5a89a9fb-0900-4b23-826b-127b90e4db4c",
15       "adobe_id": "urn:aaid:sc:US:a1b2c3d4-e5f6-7890-abcd-ef1234567890",
16       "adobe_version_id": "2",
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": "36279dd3-a607-432e-ad85-2005522b3c4e",
41           "field_definition_name": "Fields definition name",
42           "mutable": true,
43           "value": [
44             {
45               "display_name": "Display name",
46               "id": "6711d43d-b717-4765-bde4-994bf39f88df"
47             }
48           ],
49           "field_options": [
50             {
51               "display_name": "Display name",
52               "id": "6711d43d-b717-4765-bde4-994bf39f88df"
53             },
54             {
55               "display_name": "Display name 2",
56               "id": "6f10a133-919f-43f0-8e67-13efc50ba439"
57             }
58           ]
59         }
60       ],
61       "project": {
62         "created_at": "2024-01-25T19:18:29.614189Z",
63         "id": "90d3f72c-abed-463f-8d1b-1c3c084556e1",
64         "name": "My Project",
65         "root_folder_id": "a8426cb1-5056-4010-92d0-416e2c0d3a78",
66         "status": "active",
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": "f9cc69f8-c0f8-4176-9eb1-3049c4b6b647",
71         "description": "Project Description",
72         "adobe_id": "urn:aaid:sc:US:9f4e4d7a-4b6b-4c4f-9f00-b31a91cfc6f3",
73         "restricted": false,
74         "owner": {
75           "active": true,
76           "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",
77           "email": "user_email@example.com",
78           "id": "196C1A5666BF4EB00A49411B@176719f5667c82b4494214.e",
79           "name": "Jon Doe"
80         }
81       }
82     },
83     "id": "b4c00e24-9beb-4c38-91ad-8f58a88f5a8a",
84     "name": "asset.png",
85     "parent_id": "6ecaf9c3-23ab-4031-8dc8-8acbfec1afbd",
86     "created_at": "2023-09-25T19:18:29.614189Z",
87     "project_id": "70e467b0-c8ab-4881-9c63-836664103a26",
88     "type": "file",
89     "updated_at": "2024-02-07T16:44:41.986478Z",
90     "view_url": "https://next.frame.io/project/d5e6011c-2bc9-4596-be05-77d562627112/view/5a89a9fb-0900-4b23-826b-127b90e4db4c",
91     "adobe_id": "urn:aaid:sc:US:a1b2c3d4-e5f6-7890-abcd-ef1234567890",
92     "creator": {
93       "active": true,
94       "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",
95       "email": "user_email@example.com",
96       "id": "196C1A5666BF4EB00A49411B@176719f5667c82b4494214.e",
97       "name": "Jon Doe"
98     },
99     "metadata": [
100       {
101         "field_type": "select",
102         "field_definition_id": "36279dd3-a607-432e-ad85-2005522b3c4e",
103         "field_definition_name": "Fields definition name",
104         "mutable": true,
105         "value": [
106           {
107             "display_name": "Display name",
108             "id": "6711d43d-b717-4765-bde4-994bf39f88df"
109           }
110         ],
111         "field_options": [
112           {
113             "display_name": "Display name",
114             "id": "6711d43d-b717-4765-bde4-994bf39f88df"
115           },
116           {
117             "display_name": "Display name 2",
118             "id": "6f10a133-919f-43f0-8e67-13efc50ba439"
119           }
120         ]
121       }
122     ],
123     "project": {
124       "created_at": "2024-01-25T19:18:29.614189Z",
125       "id": "90d3f72c-abed-463f-8d1b-1c3c084556e1",
126       "name": "My Project",
127       "root_folder_id": "a8426cb1-5056-4010-92d0-416e2c0d3a78",
128       "status": "active",
129       "storage": 15000,
130       "updated_at": "2024-02-07T16:44:41.986478Z",
131       "view_url": "https://next.frame.io/project/d5e6011c-2bc9-4596-be05-77d562627112/",
132       "workspace_id": "f9cc69f8-c0f8-4176-9eb1-3049c4b6b647",
133       "description": "Project Description",
134       "adobe_id": "urn:aaid:sc:US:9f4e4d7a-4b6b-4c4f-9f00-b31a91cfc6f3",
135       "restricted": false,
136       "owner": {
137         "active": true,
138         "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",
139         "email": "user_email@example.com",
140         "id": "196C1A5666BF4EB00A49411B@176719f5667c82b4494214.e",
141         "name": "Jon Doe"
142       }
143     }
144   }
145 }

Создание нового стека версий в родительской папке.
Лимиты запросов: 10 вызовов за 1 мин. для account_user

Аутентификация

AuthorizationBearer

Аутентификация Bearer в форме Bearer <token>, где token — ваш токен аутентификации.

Параметры пути

account_idstringОбязательный

Идентификатор сущности Frame.io или Adobe. Обычно это UUID Frame.io. Но для учетных записей, проектов, папок, файлов и стеков версий, которые хранятся в облачном хранилище Adobe (что характерно для учетных записей и проектов, подключенных к Workfront), в качестве идентификатора также может использоваться назначенный идентификатор Adobe. Эти идентификаторы должны иметь префикс adobe: (например, adobe:<adobe_org_id> для учетной записи, adobe:<adobe_asset_id> для проекта или папки, adobe:adobe:<adobe_asset_id>|<version> для файла).

folder_idstringОбязательный

Запрос

Тело запроса

dataobjectОбязательный

Заголовки ответа

x-ratelimit-limitinteger

Лимит запросов

x-ratelimit-remaininginteger

Остаток лимита запросов

x-ratelimit-windowinteger

Окно лимита запросов (в мс)

Ответ

Создано

dataobject

Ошибки

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

422

Unprocessable Entity Error

429

Too Many Requests Error