Criar pilha de versões

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 }

Criar uma nova pilha de versões na pasta principal.
Limites de taxa: 10 chamadas por 1,00 minuto por account_user

Autenticação

AuthorizationBearer

Autenticação bearer na forma Bearer <token>, onde token é seu token de autenticação.

Parâmetros de caminho

account_idstringObrigatório

Um identificador de entidade da Frame.io ou da Adobe. Normalmente, um UUID do Frame.io. Mas, no caso de contas, projetos, pastas, arquivos e pilhas de versões armazenados na nuvem da Adobe – como ocorre com contas e projetos conectados ao Workfront –, também é possível utilizar um ID atribuído pela Adobe de forma intercambiável. Esses IDs devem ser prefixados com adobe: (por exemplo, adobe:<adobe_org_id> para uma conta, adobe:<adobe_asset_id> para um projeto ou pasta e adobe:<adobe_asset_id>|<version> para um arquivo).

Um identificador de entidade da Frame.io ou da Adobe. Normalmente, um UUID do Frame.io. Mas, no caso de contas, projetos, pastas, arquivos e pilhas de versões armazenados na nuvem da Adobe – como ocorre com contas e projetos conectados ao Workfront –, também é possível utilizar um ID atribuído pela Adobe de forma intercambiável. Esses IDs devem ser prefixados com `adobe:` (por exemplo, `adobe:<adobe_org_id>` para uma conta, `adobe:<adobe_asset_id>` para um projeto ou pasta e `adobe:<adobe_asset_id>|<version>` para um arquivo).

folder_idstringObrigatório

Um identificador de entidade da Frame.io ou da Adobe. Normalmente, um UUID do Frame.io. Mas, no caso de contas, projetos, pastas, arquivos e pilhas de versões armazenados na nuvem da Adobe – como ocorre com contas e projetos conectados ao Workfront –, também é possível utilizar um ID atribuído pela Adobe de forma intercambiável. Esses IDs devem ser prefixados com `adobe:` (por exemplo, `adobe:<adobe_org_id>` para uma conta, `adobe:<adobe_asset_id>` para um projeto ou pasta e `adobe:<adobe_asset_id>|<version>` para um arquivo).

Solicitação

Corpo da solicitação

dataobjectObrigatório

Cabeçalhos de resposta

x-ratelimit-limitinteger

Limite de taxa

x-ratelimit-remaininginteger

Limite de taxa restante

x-ratelimit-windowinteger

Janela do limite de taxa em milissegundos

Resposta

Criado

dataobject

Erros

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