Usage Limit Exceeded (402) When Creating Team via Frame.io API – Guidance Needed

Help
,
1

I am building a video editing portal and planning to integrate it deeply with Frame.io APIs. I would like to explain my use case and the issue I am facing, and request guidance on how I can achieve this using your APIs.

Use Case / Flow

  • Our platform allows customers to create video editing requests.

  • Once an editor completes the video, they upload the final video to Frame.io via our portal.

  • Frame.io returns a JSON response, from which we store the assetId and associate it with the editing request in our database.

  • Customers and editors can add comments from our portal:

    • We plan to use the Frame.io Comments API to add comments to a specific asset.

    • We also plan to use webhooks so that if a customer adds a comment directly on Frame.io, it is synced and stored in our database.

Overall, we want to design this complete workflow using Frame.io APIs for assets, comments, and webhooks.

Issue Faced

I created a developer account from:
https://developer.frame.io/

Then generated an access token from:
https://developer.frame.io/app/tokens

While following the documentation to create a team using the API, I receive the following error response:

{ "code": 402, "message": "Usage Limit Exceeded", "errors": [ { "code": 402, "status": 402, "title": "Usage Limit Exceeded", "detail": "You are past your usage limits for that resource" } ] }

Questions / Clarification Needed

  1. Is team creation via API restricted or limited for non-enterprise or developer accounts?

  2. What is the recommended way to design the above workflow (assets, comments, webhooks) using Frame.io APIs?

  3. Do we need a specific plan or permission to create teams, projects, and manage comments programmatically?

  4. Is there an alternative approach you recommend for SaaS platforms integrating Frame.io?

I would really appreciate your guidance on how to properly implement this integration using your APIs and what account or plan requirements are needed.

2

Hi @ ayeshaashfaq! Looking over the screenshot in your original post, it looks like you’re using the legacy version of the API, even though you have a V4 account. (Heads up: I removed the screenshot since your auth token was visible. You should rotate that as soon as possible)

Here are the docs you’ll want to reference: Frame.io Platform | Frame.io API Documentation

I’d also recommend reading the ‘What’s New in the Frame.io V4 Developer API’ section of the Getting Started guide, as this highlights some key differences between versions that should be relevant here, such as Workspaces replacing Teams in V4.

I hope this helps!

3

Hi @rosiec Thanks for pointing that out appreciated.

I did try switching to the V4 APIs and reviewed the V4 documentation. However, I’m currently blocked because the developer token is not working with the V4 endpoints. Every V4 request returns a 401 Not Authorized response with a message indicating that I’m not allowed to access the resource.

Just to clarify:

  • The token works with legacy (v2) endpoints

  • The same token fails consistently on V4 APIs

  • This is a non-enterprise account

Is there a specific type of token or additional permission required for V4 access, or are developer tokens limited to legacy APIs unless certain account-level access is enabled?

Thanks again for the guidance happy to rotate the token as well.

4

Hi @ayeshaashfaq,

For V4, you can’t use a legacy developer token. You’ll need to authenticate using OAuth 2.0 via Adobe IMS and include a valid access token with your requests.

You can find implementation instructions here: https://developer.adobe.com/developer-console/docs/guides/authentication/UserAuthentication/implementation