Turn Your API Sprawl Into An Agent-Ready Catalogue

28East
5 hours ago
3 min read

In today’s rapidly scaling cloud architectures, APIs are the essential building blocks that drive applications. But as organisations grow, these APIs often become scattered across various gateways, teams, and platforms.

This decentralised sprawl can lead to blind spots, impacting management and resuability and creating obstacles for adopting AI tech.

In this blog, we’ll take a look at how you can solve this with:

Specification boost add-ons.
A new integration between API Hub and API Gateway.

Why This Matters for Your AI Strategy

An AI agent is only as good as the tools you provide. Apigee API hub lets you consolidate and organise information about all of the APIs your organisation may be interested in.

This API hub also lets you capture essential information about APIs that allow developers to discover and evaluate them easily and leverage the work of other teams.

You can also:

Prevent shadow APIs: Centralising your APIs ensures they are discoverable by AI tools, preventing essential ones from being overlooked.

Enhance API usage: With enhanced documentation, AI agents will reduce the chance of incorrect results and improve function calling success rates.

As organisations move to adopt AI solutions, it’s important for foundational APIs to be well-documented and easily accessible. This approach also helps to mitigate common issues like data silos and undocumented legacy proxies.

How API Sprawl Hurts AI Adoption

Organisations often use different platforms for managing APIs. This created a distributed reality that complicates management and prevents effective AI adoption.

The main issues are:

Scattered APIs: APIs are hidden in various systems, making them difficult to discover.

Incomplete APIs: Without rich context, such as examples and error codes, agents struggle to understand how to use APIs correctly.

Non-existent APIs: Legacy APIs without specifications or documentation stay invisible to automated tools.

Steps for Centralising Your APIs

Let’s take a look at how you can centralise your APIs to improve AI tech adoption.

Step 1: Centralise your API metadata

The first step in resolving API sprawl is visibility. With the new integration between API Gateway and API Hub, you can automatically sync your API metadata to a single system.

This helps create a unified view of your distributed APIs.

API Gateway also provides secure, consistent access to backend services through well-defined REST APIs.

When connected to API Hub, API Gateway automatically finds and syncs your API definitions, OpenAPI specifications, and gateway configurations in real-time.

By consolidating this metadata into one platform, you retain distributed control over the tools you use while standardising the knowledge base in one system.

Step 2: Make your APIs agent-ready with API spec boosting add-ons

Once your APIs are centralised, you must ensure they’re ready for agent-based interactions. That’s where the API spec boost add-on for API Hub comes in.

This feature improves the readability and accessibility of your API specifications, making them more agent-friendly. Here’s how it works:

Analysis: The spec boost add-on scans your centralised APIs to identify gaps, such as missing usage examples, undefined error conditions, or incomplete documentation.

Enhancements: The add-on automatically enriches your API specs, filling in these gaps to make them more accessible to both developers and AI agents.

Result: Your APIs become more discoverable, understandable, and usable, improving both human and AI interactions with your services.

Once enabled, you can view the status of your specifications in the API hub list view.

Your boosted specifications are clearly linked alongside your original files, making it easy to access the enhanced versions.

28East’s Role in Your AI and API Strategy

Integrating advanced solutions into your existing tech architecture requires careful consideration of the different tools and strategies.

Our integration solutions can help organisations like yours to simplify the complexity of API management while preparing your infrastructure for future innovations. We can help you: