Migrating to API v4

Hi, we have a lot of automated Python scripts in our studio that integrates heavily with frame.io. I’m testing API v4 and trying to rewrite our functionality and I have few questions:

  1. I cannot find an endpoint to get shared files from share/review_link. In API v2 we could get shared items by
    /v2/review_links/{review_link_id}/items/shared
    But in v4 I found just endpoint /v4/accounts/{account_id}/shares/{share_id} which return share entity:

{
“data”: {
“access”: “public”,
“collection_id”: “2804e37e-8e3a-482e-8820-98571ad45c9e”,
“commenting_enabled”: true,
“created_at”: “2024-02-02T21:19:24.828948Z”,
“description”: “Description of share”,
“downloading_enabled”: true,
“enabled”: true,
“expiration”: “2025-10-07T20:47:58.795787Z”,
“id”: “d7a68e22-bb56-43bf-9d0e-00f1900451db”,
“last_viewed_at”: “2024-03-02T21:19:24.828948Z”,
“name”: “Test Share”,
“passphrase”: “as!dfj39sd(*”,
“short_url”: “``https://f.io/GGa9wPw5”``,
“updated_at”: “2024-02-02T21:19:24.828948Z”
}
}

But does not return assets included in shared link. How can I get shared files using share_id? I see there is some “collection_id” but I don’t see any endpoint where to use it.

  1. We used to utilize version_stacks, but now they have a limit of 10 files - just in API endpoint
    /v4/accounts/{account_id}/folders/{folder_id}/version_stacks

Although it is possible to create a version_stack with more than 10 files on the web interface, there is no endpoint in the API to add a new file to an existing stack. Is there any way to insert files into an existing stack via the API?

Although it is possible to create version_stack with more than just 10 files on the web interface. Also there is no endpoint in API to add a new file into existing stack. Is there any way to push files into existing stack via API?

  1. Is API v4 the final version? I do not see functionality I mentioned above in the experimental branch, so we cannot upgrade to new frame.io in our studio yet, and it will cause a lot of problems for us in the future.

hi @tomas, apologies for the delay here, this post got caught in our spam filter.

I’ve raised your question about listing the assets in a share to the dev team, will report back when I have an answer.

Is there any way to push files into existing stack via API?

Yes, you can use the Move file endpoint to move a file to the top of a version stack, with the parent_id being the version stack id when using “list version stack

Is API v4 the final version? I do not see functionality I mentioned above in the experimental branch, so we cannot upgrade to new frame.io in our studio yet, and it will cause a lot of problems for us in the future.

It is not final, no. We are still working on improving and adding functionality to the API and if something is not listed here please by all means let me know and I will be happy to add as a ticket to ensure the work gets scheduled!

hi @CharlieAnderson , thank you for response, I will try Move file endpoint. Please let me know about answer from dev team about listing assets in share - that functionality is really important for us. When is scheduled mandatory migration of all accounts to Frame.io V4 ?

hi @tomas this is on the roadmap for this quarter to have more advances shares features.