Versionsstapel auflisten

GET

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

GET

/v4/accounts/:account_id/folders/:folder_id/version_stacks

1 from frameio import Frameio
2 
3 client = Frameio(
4     token="YOUR_TOKEN_HERE",
5 )
6 
7 client.version_stacks.list(
8     account_id="707b3009-f7a2-41d7-a89a-6583339017cc",
9     folder_id="46aa5062-baf8-4bcf-a4a0-0af4122b99b7",
10 )

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

Versionsstapel in einem bestimmten Ordner auflisten.
Rate Limits: 5 Aufrufe pro 1 Sekunde(n) pro account_user

Authentifizierung

AuthorizationBearer

Bearer-Authentifizierung der Form Bearer <token>, wobei token Ihr Auth-Token ist.

Pfadparameter

account_idstringErforderlich

Eine Frame.io- oder Adobe-Entitäts-ID. Normalerweise eine Frame.io-UUID. Für Konten, Projekte, Ordner, Dateien und Versionsstapel, die sich im Adobe Cloud-Speicher befinden (was bei Workfront-verbundenen Konten und -Projekten der Fall ist), kann aber auch eine von Adobe vergebene ID verwendet werden. Diese IDs müssen das Präfix ‘adobe:’ haben (z. B. ‘adobe:<adobe_org_id>’ für ein Konto, ‘adobe:<adobe_asset_id>’ für ein Projekt oder einen Ordner, ‘adobe:<adobe_asset_id>|<version>’ für ein Datei-Asset).

Eine Frame.io- oder Adobe-Entitäts-ID. Normalerweise eine Frame.io-UUID. Für Konten, Projekte, Ordner, Dateien und Versionsstapel, die sich im Adobe Cloud-Speicher befinden (was bei Workfront-verbundenen Konten und -Projekten der Fall ist), kann aber auch eine von Adobe vergebene ID verwendet werden. Diese IDs müssen das Präfix 'adobe:' haben (z. B. 'adobe:<adobe_org_id>' für ein Konto, 'adobe:<adobe_asset_id>' für ein Projekt oder einen Ordner, 'adobe:<adobe_asset_id>|<version>' für ein Datei-Asset).

folder_idstringErforderlich

Eine Frame.io- oder Adobe-Entitäts-ID. Normalerweise eine Frame.io-UUID. Für Konten, Projekte, Ordner, Dateien und Versionsstapel, die sich im Adobe Cloud-Speicher befinden (was bei Workfront-verbundenen Konten und -Projekten der Fall ist), kann aber auch eine von Adobe vergebene ID verwendet werden. Diese IDs müssen das Präfix 'adobe:' haben (z. B. 'adobe:<adobe_org_id>' für ein Konto, 'adobe:<adobe_asset_id>' für ein Projekt oder einen Ordner, 'adobe:<adobe_asset_id>|<version>' für ein Datei-Asset).

Abfrageparameter

includeenumOptional

Unterstützt werden unter anderem Abfrageparameterwerte für Endpunkte, die Dateien mit Medien-Links ausgeben

afterstringOptional

Undurchsichtiger Cursor-Abfrageparameter für Anfragen, die paginierte Ergebnisse zurückgeben.

HINWEIS: Dieser Wert wird automatisch generiert und als Teil von Links aus einer vorherigen Antwort eingefügt. Er ist nicht dafür vorgesehen, für Menschen lesbar zu sein.

page_sizeintegerOptional1-500Standardwert ist 50

Seitengrößen-Abfrageparameter für Asset-Listenanfragen

include_total_countbooleanOptionalStandardwert ist false

Seiten-Abfrageparameter zum Einbeziehen der Anzahl aller Entitäten

Antwort-Header

x-ratelimit-limitinteger

Rate-Limit

x-ratelimit-remaininginteger

Verbleibendes Rate-Limit

x-ratelimit-windowinteger

Rate-Limit-Fenster in Millisekunden

Antwort

datalist of objects

linksobject

Links zu paginierten Daten

total_countinteger or nullOptional

Gesamtanzahl

Fehler

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