# Bud Ecosystem API

**Canonical:** https://apis.io/apis/budecosystem/budecosystem-api/  
**Provider:** Bud Ecosystem — https://apis.io/providers/budecosystem/  
**Base URL:** https://gateway.bud.studio  
**Documentation:** https://developers.openai.com/api/docs/guides/realtime

Bud Ecosystem API is one of 2 APIs that [Bud Ecosystem](https://apis.io/providers/budecosystem/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Bud Ecosystem API as documented publicly: 31 operations. Contract generated from the documentation by API Evangelist (2026-10-19); not the provider's own document.

## Operations (31)

| Method | Path | Summary |
|---|---|---|
| POST | `/` | POST / |
| GET | `/connectors/available` | List available gateways |
| GET | `/connectors/configured` | List configured |
| PATCH | `/connectors/configured/{gatewayId}` | Update connection tags |
| PATCH | `/connectors/configured/{gatewayId}/toggle` | Toggle configured gateway |
| POST | `/connectors/custom` | Create custom gateway |
| POST | `/connectors/gateways` | Configure connector |
| DELETE | `/connectors/gateways/{gatewayId}` | Delete gateway |
| POST | `/connectors/oauth/callback` | OAuth callback |
| GET | `/connectors/registry` | List registry connectors |
| GET | `/connectors/registry/{connectorId}` | Get registry connector |
| POST | `/connectors/{gatewayId}/fetch-tools` | Loads tools after authorization. |
| POST | `/connectors/{gatewayId}/oauth/initiate` | Start OAuth |
| GET | `/connectors/{gatewayId}/oauth/status` | OAuth status |
| GET | `/connectors/{gatewayId}/tools` | Supports pagination. |
| GET | `/events/descriptors` | Descriptor catalog and credential field specs. |
| GET | `/events/shared-connections` | Optional project filter. |
| POST | `/events/shared-connections` | Supports project and global scope. |
| DELETE | `/events/shared-connections/{connectionId}` | Cascades provider subscriptions. |
| PATCH | `/events/shared-connections/{connectionId}` | Rename or replace project share set. |
| POST | `/prompts/{promptId}/connections/{gatewayId}/attach-tools` | Stores selected tool IDs for one agent. |
| DELETE | `/prompts/{promptId}/connections/{gatewayId}/detach` | Removes the gateway from one agent only. |
| PUT | `/routers/{id}` | Save a router configuration by updating its DAG representation. |
| GET | `/v1/batches/batch_abc123` | GET /v1/batches/batch_abc123 |
| POST | `/v1/batches/batch_abc123/cancel` | POST /v1/batches/batch_abc123/cancel |
| POST | `/v1/chat/completions` | POST /v1/chat/completions |
| GET | `/v1/files` | GET /v1/files |
| DELETE | `/v1/files/file-abc123` | DELETE /v1/files/file-abc123 |
| GET | `/v1/files/file-abc123` | GET /v1/files/file-abc123 |
| GET | `/v1/images/edits` | GET /v1/images/edits |
| POST | `/v1/realtime/client_secrets` | Use POST /v1/realtime/client_secrets to create ephemeral credentials for browser or mobile clients. |

## Machine-readable artifacts (7)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/budecosystem/refs/heads/main/openapi/_ae-authored/budecosystem-openapi-generated.yml
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/budecosystem/refs/heads/main/json-schema/budecosystem-get-v1-batches-batch-abc123-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/budecosystem/refs/heads/main/json-schema/budecosystem-post-v1-batches-batch-abc123-cancel-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/budecosystem/refs/heads/main/json-schema/budecosystem-put-routers-id-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/budecosystem/refs/heads/main/json-schema/budecosystem-post-v1-chat-completions-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/budecosystem/refs/heads/main/json-schema/budecosystem-get-v1-files-file-abc123-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/budecosystem/refs/heads/main/json-schema/budecosystem-get-v1-files-response-schema.json

## Other Bud Ecosystem APIs (1)

- [Bud Ecosystem API](https://apis.io/apis/budecosystem/bud-ecosystem-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/budecosystem/budecosystem-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/budecosystem/.