Introduction
We recently launched the third version (V3) of the Treblle platform - a reimagined experience from design to tech stack to code to capabilities. Treblle 3.0 doubles down on what Treblle has been about since its founding: providing critical data points for users to understand, manage, and improve their APIs.
With more than 70% of internet traffic coming from APIs, the focus on APIs is only increasing. This is true for technical and non-technical teams. Not only do engineering teams need to know design and architecture information (formats, contracts, linting), and operations teams need to know the metrics about their APIs (performance, configuration, security), there is a growing group of API stakeholders who need additional data about their APIs.
For example, management and business leaders need digestible insights about their APIs in order to do resource planning or support compliance, security, sales, marketing, and product teams. Further, company leaders need a single pane of glass to understand how the APIs impact their business units.
For Treblle, the single pane of glass starts at the Workspace.
What Are Workspaces in Treblle
Workspaces are the highest level “container” where all team members, APIs, and platform capabilities live. Workspaces provide a high-level Dashboard with important information about your entire API landscape (more on this below). As such, the Workspace is the starting point for users to easily navigate through their team’s or company’s APIs, find the API they are looking for, and dive in to get more than 40+ data points for each one.
List of APIs inside user's Workspace
Workspaces can be customized depending on the plan you choose, but Workspaces across all our plans can have unlimited users. Unlike previous versions of Treblle, where users collaborated only at the API level and pricing was based on number of users, Workspaces allow for unprecedented collaboration across multiple APIs and capabilities in the same space.
Alongside Workspaces, we introduced some important capabilities in Treblle 3.0, each designed to give teams greater control and flexibility in managing their APIs. These features enhance collaboration and ensure that API data is accessible and secure across various team roles and projects:
- Roles & Permissions
Each user can be assigned an Owner or Member role at both the Workspace and API levels. This role determines what information users can view and what permissions they have for managing Workspaces and APIs, including settings and configurations.
- API Visibility
Some APIs may need to be hidden from the broader team or company—for example, those part of a stealth project or upcoming app. Setting an API’s visibility to Private hides it from the Dashboard, limiting access to select team members.
Mark your APIs Public or Private
- API Catalog
APIs can be published to the Catalog, regardless of visibility settings. This feature allows any user to discover, understand, and integrate with an API, making it especially valuable for Partner and Solution Engineering teams.
Now, we are turning our focus back to Workspaces. As one of Treblle 3.0’s standout features, Workspaces offer a unified space for team collaboration, helping users easily manage and understand APIs. Let’s explore the key benefits Workspaces bring to API collaboration.
Key Benefits of Workspaces for API Collaboration
Workspaces provide several benefits for how teams work.
- Centralized Access Control : Workspace Settings ensure that each member of the Workspace has the right permissions and access to the right APIs. Workspace Owners can determine Workspace details, how API data can be shared, how authentication into the Workspace should happen, etc.
- Understanding your API Landscape : The Workspace provides API stakeholders a high-level view into their API landscape. Users can quickly see the total number of APIs, how many requests those APIs have made, and how many issues all of the APIs have had in the last 24 hours.
- API Snapshot : Users can also see the status and quality of each API at a glance. Users will immediately know if the API has problems or needs to be looked at more closely.
- Resource Management : Leadership can use the Workspace Dashboard to make decisions about what APIs teams should spend time and effort on. For example, a company should want all of its production APIs to have a certain level of quality, which is reflected in the Treblle API Score. If a score is low, teams can see what issues to address by diving deeper to the API and plan to address it in an upcoming cycle.
- Collaboration : Workspaces also provide a level of transparency and collaboration between teams. Since all users can be part of the same Workspace, individual users can add comments on specific API elements if they notice something that should be communicated out. We introduced tagging, which will send a user notification in app and via email, as well as Custom Alerts. With the latter, teams can send out a Slack alert for example, to let users know when response time is high or if the API is returning several non-2xx responses.
Getting Started with Workspaces
Once a user signs in or creates a Treblle account, they can Create, Join, or Switch between Workspaces using the Workspace drop-down:
Create, Join, or Switch between Workspaces
Configure your Workspace
Workspace Settings is the place to manage and configure your Treblle Workspace. Workspace Owners are the only users who can make changes to many of the settings found here.
Treblle Workspace configuration
Invite People to your Workspace
Under Settings > People, Workspace Owners can enter the email of people they want to add to the Workspace as well as the Role the user should have. They can also manage current Workspace members and outstanding invitations.
Add your API(s)
Next, add your APIs and fill out the required fields.
*Integrate the SDK *
Integrate our SDK into your app to get API data at runtime. Treblle supports a wide range of languages and frameworks—including popular choices like Node.js, PHP, Python, and many more—making it easy to work with any tech stack. With runtime data, you can make quick adjustments and keep your API experience smooth and reliable for users. For the full list, check out our integration options.
Utilizing your Workspaces
Workspace Dashboard
Once your APIs have been added, the main screen of the Workspace or the Workspace Dashboard will provide high-level information about your APIs as well as the tools to find and navigate into chosen APIs. There are several features and functionalities to be aware of:
API Landscape Analytics
At the top of the Workspace Dashboard, users are shown three high-level datasets that provide an overview of all APIs that they have access to.
Three datasets on top of Workspace Dashboard
- Total APIs - the number of total APIs will vary depending on what APIs you have access to and what APIs have been made public to this list. If you are a Workspace Member, you will see the Total number of “public” APIs as well as APIs that you are a Member or Owner of. See People & Workspace Roles and Visibility.
- Total Requests - this is the number of requests for all APIs included in your Total APIs.
- Issues - We calculate this value every 5 minutes based on data points used in our proprietary Heartbeat model. This model provides a comprehensive view into how the APIs you have access to are doing.
List of APIs
Under the Total APIs and Requests section is a list of all the APIs that you have access to including all APIs that have been marked as Public
.
By default, the API List is organized by APIs with the most recent requests. These are updated in near real-time, so the order of your APIs may change every few minutes.
Finding APIs
When a team has several hundred or thousands of APIs, we provide several ways for users to search or find APIs that they are interested in:
- Favorites
Users can Favorite an API by clicking on the star on the right side of the row. Users can then show only the list of APIs that have been selected as favorites by choosing the Favorite toggle on the upper right of the API List.
- Filtering
Users can narrow the number of APIs by filtering the list by SDK and/or Environment.
- Search
Users can find APIs by using our free text search.
- Timescale
And lastly, users can narrow a search based on a timescale of when APIs were created.
Conclusion
Treblle 3.0's Workspaces and collaboration features provide essential tools for boosting productivity and simplifying API management across teams. With Workspaces, all users—from developers to business leaders—gain a centralized view of API performance, quality, and consumption insights, making it easier to make data-driven decisions that support both technical and business goals.
By offering over 40 detailed data points, Workspaces allow teams to monitor every aspect of their APIs, identify key areas for improvement, and align efforts across projects.
For a unified approach to managing, understanding, and collaborating on your API landscape, Workspaces offer an invaluable resource. Check out Treblle 3.0 to see how Workspaces bring clarity and control to every stage of your API journey.
Top comments (0)