Crea stack di versioni

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 }

Crea un nuovo stack di versioni nella cartella padre.
Limiti di frequenza: 10 chiamate ogni 1,00 minuto per account_user

Autenticazione

AuthorizationBearer

Autenticazione bearer nella forma Bearer <token>, dove token è il tuo token di autenticazione.

Parametri di percorso

account_idstringObbligatorio

Un identificatore di entità Frame.io o Adobe. Di solito è un UUID Frame.io, ma per account, progetti, cartelle, file e stack di versioni che risiedono nell’archiviazione cloud Adobe (ad esempio gli account e i progetti connessi a Workfront) puoi usare anche un ID assegnato da Adobe in modo intercambiabile. Questi ID devono avere il prefisso adobe: (ad esempio adobe:<adobe_org_id> per un account, adobe:<adobe_asset_id> per un progetto o una cartella, adobe:adobe:<adobe_asset_id>|<version>` per una risorsa file).

Un identificatore di entità Frame.io o Adobe. Di solito è un UUID Frame.io, ma per account, progetti, cartelle, file e stack di versioni che risiedono nell'archiviazione cloud Adobe (ad esempio gli account e i progetti connessi a Workfront) puoi usare anche un ID assegnato da Adobe in modo intercambiabile. Questi ID devono avere il prefisso `adobe:` (ad esempio `adobe:<adobe_org_id>` per un account, `adobe:<adobe_asset_id>` per un progetto o una cartella, `adobe:`adobe:<adobe_asset_id>|<version>` per una risorsa file).

folder_idstringObbligatorio

Richiesta

Corpo della richiesta

dataobjectObbligatorio

Header di risposta

x-ratelimit-limitinteger

Limite di frequenza

x-ratelimit-remaininginteger

Limite di frequenza rimanente

x-ratelimit-windowinteger

Finestra del limite di frequenza in millisecondi

Risposta

Creato

dataobject

Errori

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