Crear pila de versiones

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 }

Cree una pila de versiones nueva en la carpeta principal.
Límites de frecuencia: 10 llamadas por 1,00 minutos por account_user

Autenticación

AuthorizationBearer

Autenticación de portador de la forma Bearer <token>, donde token es tu token de autenticación.

Parámetros de ruta

account_idstringRequerido

Un identificador de entidad de Frame.io o Adobe. Normalmente, un UUID de Frame.io. Sin embargo, para cuentas, proyectos, carpetas, archivos y pilas de versiones que residen en el almacenamiento en la nube de Adobe, lo que ocurre en el caso de cuentas y proyectos conectados con Workfront, también se puede usar indistintamente un id asignado por Adobe. Estos id deben llevar el prefijo adobe: (por ejemplo, adobe:<adobe_org_id>para una cuenta,adobe:<adobe_asset_id>para un proyecto o una carpeta,adobe:adobe:<adobe_asset_id>|<version> para un activo de archivo).

Un identificador de entidad de Frame.io o Adobe. Normalmente, un UUID de Frame.io. Sin embargo, para cuentas, proyectos, carpetas, archivos y pilas de versiones que residen en el almacenamiento en la nube de Adobe, lo que ocurre en el caso de cuentas y proyectos conectados con Workfront, también se puede usar indistintamente un id asignado por Adobe. Estos id deben llevar el prefijo `adobe:` (por ejemplo, adobe:<adobe_org_id>` para una cuenta, `adobe:<adobe_asset_id>` para un proyecto o una carpeta, `adobe:`adobe:<adobe_asset_id>|<version>` para un activo de archivo).

folder_idstringRequerido

Un identificador de entidad de Frame.io o Adobe. Normalmente, un UUID de Frame.io. Sin embargo, para cuentas, proyectos, carpetas, archivos y pilas de versiones que residen en el almacenamiento en la nube de Adobe, lo que ocurre en el caso de cuentas y proyectos conectados con Workfront, también se puede usar indistintamente un id asignado por Adobe. Estos id deben llevar el prefijo `adobe:` (por ejemplo, adobe:<adobe_org_id>` para una cuenta, `adobe:<adobe_asset_id>` para un proyecto o una carpeta, `adobe:`adobe:<adobe_asset_id>|<version>` para un activo de archivo).

Solicitud

Cuerpo de la solicitud

dataobjectRequerido

Encabezados de respuesta

x-ratelimit-limitinteger

Límite de frecuencia

x-ratelimit-remaininginteger

Límite de frecuencia restante

x-ratelimit-windowinteger

Periodo de límite de frecuencia en milisegundos

Respuesta

Creado

dataobject

Errores

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