API Overview
A practical overview of how to integrate with Buda APIs, including authentication, common use cases, and rollout advice.
API Overview
Buda's API is for teams that want to connect external products, automate workflows, or embed Agent capabilities into their own software.
Common API use cases
- Connect your own product to a Buda Agent
- Trigger jobs or workflows from another system
- Read Agent output in your own app
- Build custom internal tooling on top of Buda
Before you integrate
- Decide which Agent should own the workflow
- Define the exact action your app needs from Buda
- Confirm what data should stay in Drive versus what should be sent at runtime
- Start with one narrow integration before expanding
Typical integration flow
- Create or choose a target Agent.
- Prepare the Drive files or structured inputs it needs.
- Authenticate your application.
- Call the relevant API endpoint.
- Store logs and response traces for troubleshooting.
Authentication
Treat API credentials like production secrets:
- Never hardcode them in frontend code
- Rotate them if they are exposed
- Keep test and production credentials separate
Integration design advice
- Keep requests small and intentional
- Make retries idempotent where possible
- Log request IDs and timestamps
- Design a fallback path for cases where the Agent cannot complete a task