Bud Ecosystem

Bud Ecosystem API

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.

Documentation GitHub OpenAPI

Operations 31

Specifications

⚙

OpenAPI

https://artifacts.apis.io/budecosystem/openapi/_ae-authored/budecosystem-openapi-generated.yml

Schemas & Data

📊

JSONSchema

https://artifacts.apis.io/budecosystem/json-schema/budecosystem-get-v1-batches-batch-abc123-response-schema.json

📊

JSONSchema

https://artifacts.apis.io/budecosystem/json-schema/budecosystem-post-v1-batches-batch-abc123-cancel-response-schema.json

📊

JSONSchema

https://artifacts.apis.io/budecosystem/json-schema/budecosystem-put-routers-id-request-schema.json

📊

JSONSchema

https://artifacts.apis.io/budecosystem/json-schema/budecosystem-post-v1-chat-completions-response-schema.json

📊

JSONSchema

https://artifacts.apis.io/budecosystem/json-schema/budecosystem-get-v1-files-file-abc123-response-schema.json

📊

JSONSchema

https://artifacts.apis.io/budecosystem/json-schema/budecosystem-get-v1-files-response-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/budecosystem:budecosystem-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.1.0
info:
  title: Bud Ecosystem API
  version: '2026-10-19'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-19: 31 operation(s) read from 17 public documentation page(s) (each
    operation names its page in x-source). This is not the provider''s published contract; Bud Ecosystem has published no machine-readable contract
    that the pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 8
    documentation: 23
    pages-with-code: 13
    pages-read: 17
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-19'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://developers.openai.com/api/docs/guides/realtime
  - https://docs.budecosystem.com/connectors/reference/connectors-reference.md
  - https://docs.budecosystem.com/router/reference/router-actions-reference.md
  - https://docs.budecosystem.com/api-sdk/quickstart.md
  - https://docs.budecosystem.com/api-integration/quickstart.md
  - https://docs.budecosystem.com/router/guides/using-router-api.md
  - https://docs.budecosystem.com/api-sdk/realtime/client-secrets.md
  - https://docs.budecosystem.com/product-guide/customer-dashboard/quickstart.md
  - https://docs.budecosystem.com/api-integration/creating-first-api-integration.md
  - https://docs.budecosystem.com/router/quickstart.md
  - https://docs.budecosystem.com/connectors/quickstart.md
  - https://docs.budecosystem.com/api-sdk/files/get-file.md
  - https://docs.budecosystem.com/api-sdk/batch/get-batch.md
  - https://docs.budecosystem.com/api-sdk/files/delete-file.md
  - https://docs.budecosystem.com/api-sdk/files/upload-file.md
  - https://docs.budecosystem.com/api-sdk/images/edit-image.md
  - https://docs.budecosystem.com/api-sdk/batch/cancel-batch.md
servers:
- url: https://gateway.bud.studio
paths:
  /:
    post:
      operationId: post
      tags:
      - Api
      summary: POST /
      x-source: https://docs.budecosystem.com/product-guide/customer-dashboard/quickstart.md
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl https://<gateway-host>/v1/chat/completions  -H \"Authorization: Bearer <YOUR_API_KEY>\"  -H \"Content-Type: application/json\"\
          \  -d '{\n    \"model\": \"<MODEL_NAME>\",\n    \"messages\": [{\"role\": \"user\", \"content\": \"Hello from Customer Dashboard\"}]\n\
          \  }'\n```"
  /connectors/available:
    get:
      operationId: get_connectors_available
      tags:
      - Connectors
      summary: List available gateways
      x-source: https://docs.budecosystem.com/connectors/reference/connectors-reference.md
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /connectors/configured:
    get:
      operationId: get_connectors_configured
      tags:
      - Connectors
      summary: List configured
      x-source: https://docs.budecosystem.com/connectors/reference/connectors-reference.md
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /connectors/configured/{gatewayId}:
    patch:
      operationId: patch_connectors_configured_gatewayId
      tags:
      - Connectors
      summary: Update connection tags
      x-source: https://docs.budecosystem.com/connectors/reference/connectors-reference.md
      parameters:
      - name: gatewayId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /connectors/configured/{gatewayId}/toggle:
    patch:
      operationId: patch_connectors_configured_gatewayId_toggle
      tags:
      - Connectors
      summary: Toggle configured gateway
      x-source: https://docs.budecosystem.com/connectors/reference/connectors-reference.md
      parameters:
      - name: gatewayId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /connectors/custom:
    post:
      operationId: post_connectors_custom
      tags:
      - Connectors
      summary: Create custom gateway
      x-source: https://docs.budecosystem.com/connectors/reference/connectors-reference.md
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /connectors/gateways:
    post:
      operationId: post_connectors_gateways
      tags:
      - Connectors
      summary: Configure connector
      x-source: https://docs.budecosystem.com/connectors/reference/connectors-reference.md
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /connectors/gateways/{gatewayId}:
    delete:
      operationId: delete_connectors_gateways_gatewayId
      tags:
      - Connectors
      summary: Delete gateway
      x-source: https://docs.budecosystem.com/connectors/reference/connectors-reference.md
      parameters:
      - name: gatewayId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /connectors/oauth/callback:
    post:
      operationId: post_connectors_oauth_callback
      tags:
      - Connectors
      summary: OAuth callback
      x-source: https://docs.budecosystem.com/connectors/reference/connectors-reference.md
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostConnectorsOauthCallbackRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /connectors/registry:
    get:
      operationId: get_connectors_registry
      tags:
      - Connectors
      summary: List registry connectors
      x-source: https://docs.budecosystem.com/connectors/reference/connectors-reference.md
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /connectors/registry/{connectorId}:
    get:
      operationId: get_connectors_registry_connectorId
      tags:
      - Connectors
      summary: Get registry connector
      x-source: https://docs.budecosystem.com/connectors/reference/connectors-reference.md
      parameters:
      - name: connectorId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /connectors/{gatewayId}/fetch-tools:
    post:
      operationId: post_connectors_gatewayId_fetch_tools
      tags:
      - Connectors
      summary: Loads tools after authorization.
      x-source: https://docs.budecosystem.com/connectors/reference/connectors-reference.md
      parameters:
      - name: gatewayId
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /connectors/{gatewayId}/oauth/initiate:
    post:
      operationId: post_connectors_gatewayId_oauth_initiate
      tags:
      - Connectors
      summary: Start OAuth
      x-source: https://docs.budecosystem.com/connectors/reference/connectors-reference.md
      parameters:
      - name: gatewayId
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostConnectorsGatewayidOauthInitiateRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /connectors/{gatewayId}/oauth/status:
    get:
      operationId: get_connectors_gatewayId_oauth_status
      tags:
      - Connectors
      summary: OAuth status
      x-source: https://docs.budecosystem.com/connectors/reference/connectors-reference.md
      parameters:
      - name: gatewayId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /connectors/{gatewayId}/tools:
    get:
      operationId: get_connectors_gatewayId_tools
      tags:
      - Connectors
      summary: Supports pagination.
      x-source: https://docs.budecosystem.com/connectors/reference/connectors-reference.md
      parameters:
      - name: gatewayId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /events/descriptors:
    get:
      operationId: get_events_descriptors
      tags:
      - Events
      summary: Descriptor catalog and credential field specs.
      x-source: https://docs.budecosystem.com/connectors/reference/connectors-reference.md
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /events/shared-connections:
    get:
      operationId: get_events_shared_connections
      tags:
      - Events
      summary: Optional project filter.
      x-source: https://docs.budecosystem.com/connectors/reference/connectors-reference.md
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    post:
      operationId: post_events_shared_connections
      tags:
      - Events
      summary: Supports project and global scope.
      x-source: https://docs.budecosystem.com/connectors/reference/connectors-reference.md
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /events/shared-connections/{connectionId}:
    delete:
      operationId: delete_events_shared_connections_connectionId
      tags:
      - Events
      summary: Cascades provider subscriptions.
      x-source: https://docs.budecosystem.com/connectors/reference/connectors-reference.md
      parameters:
      - name: connectionId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
    patch:
      operationId: patch_events_shared_connections_connectionId
      tags:
      - Events
      summary: Rename or replace project share set.
      x-source: https://docs.budecosystem.com/connectors/reference/connectors-reference.md
      parameters:
      - name: connectionId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /prompts/{promptId}/connections/{gatewayId}/attach-tools:
    post:
      operationId: post_prompts_promptId_connections_gatewayId_attach_tools
      tags:
      - Prompts
      summary: Stores selected tool IDs for one agent.
      x-source: https://docs.budecosystem.com/connectors/reference/connectors-reference.md
      parameters:
      - name: promptId
        in: path
        required: true
        schema:
          type: string
      - name: gatewayId
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /prompts/{promptId}/connections/{gatewayId}/detach:
    delete:
      operationId: delete_prompts_promptId_connections_gatewayId_detach
      tags:
      - Prompts
      summary: Removes the gateway from one agent only.
      x-source: https://docs.budecosystem.com/connectors/reference/connectors-reference.md
      parameters:
      - name: promptId
        in: path
        required: true
        schema:
          type: string
      - name: gatewayId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /routers/{id}:
    put:
      operationId: put_routers_id
      tags:
      - Routers
      summary: Save a router configuration by updating its DAG representation.
      x-source: https://docs.budecosystem.com/router/reference/router-actions-reference.md
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PutRoutersIdRequest'
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/batches/batch_abc123:
    get:
      operationId: get_v1_batches_batch_abc123
      tags:
      - Batches
      summary: GET /v1/batches/batch_abc123
      x-source: https://docs.budecosystem.com/api-sdk/batch/get-batch.md
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1BatchesBatchAbc123Response'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl https://gateway.bud.studio/v1/batches/batch_abc123  -H \"Authorization: Bearer YOUR_API_KEY\"\n  ```\n</RequestExample>"
  /v1/batches/batch_abc123/cancel:
    post:
      operationId: post_v1_batches_batch_abc123_cancel
      tags:
      - Batches
      summary: POST /v1/batches/batch_abc123/cancel
      x-source: https://docs.budecosystem.com/api-sdk/batch/cancel-batch.md
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1BatchesBatchAbc123CancelResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST https://gateway.bud.studio/v1/batches/batch_abc123/cancel  -H \"Authorization: Bearer YOUR_API_KEY\"\n  ```\n</RequestExample>"
  /v1/chat/completions:
    post:
      operationId: post_v1_chat_completions
      tags:
      - Chat
      summary: POST /v1/chat/completions
      x-source: https://docs.budecosystem.com/api-sdk/quickstart.md
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1ChatCompletionsRequest'
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1ChatCompletionsResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl https://gateway.bud.studio/v1/chat/completions  -H \"Content-Type: application/json\"  -H \"Authorization: Bearer bud_your_key_here\"\
          \  -d '{\n    \"model\": \"llama-3.2-1b\",\n    \"messages\": [\n      {\"role\": \"user\", \"content\": \"What is machine learning?\"\
          }\n    ]\n  }'\n```"
  /v1/files:
    get:
      operationId: get_v1_files
      tags:
      - Files
      summary: GET /v1/files
      x-source: https://docs.budecosystem.com/api-sdk/files/upload-file.md
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1FilesResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl https://gateway.bud.studio/v1/files  -H \"Authorization: Bearer YOUR_API_KEY\"  -F \"purpose=batch\"  -F \"file=@batch_requests.jsonl\"\
          \n  ```\n</RequestExample>"
  /v1/files/file-abc123:
    delete:
      operationId: delete_v1_files_file_abc123
      tags:
      - Files
      summary: DELETE /v1/files/file-abc123
      x-source: https://docs.budecosystem.com/api-sdk/files/delete-file.md
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteV1FilesFileAbc123Response'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X DELETE https://gateway.bud.studio/v1/files/file-abc123  -H \"Authorization: Bearer YOUR_API_KEY\"\n  ```\n</RequestExample>"
    get:
      operationId: get_v1_files_file_abc123
      tags:
      - Files
      summary: GET /v1/files/file-abc123
      x-source: https://docs.budecosystem.com/api-sdk/files/get-file.md
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1FilesFileAbc123Response'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl https://gateway.bud.studio/v1/files/file-abc123  -H \"Authorization: Bearer YOUR_API_KEY\"\n  ```\n</RequestExample>"
  /v1/images/edits:
    get:
      operationId: get_v1_images_edits
      tags:
      - Images
      summary: GET /v1/images/edits
      x-source: https://docs.budecosystem.com/api-sdk/images/edit-image.md
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1ImagesEditsResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl https://gateway.bud.studio/v1/images/edits  -H \"Authorization: Bearer YOUR_API_KEY\"  -F \"image=@original.png\"  -F \"\
          mask=@mask.png\"  -F \"prompt=Add a red hat to the person\"  -F \"model=dall-e-2\"  -F \"n=1\"  -F \"size=1024x1024\"\n  ```\n</RequestExample>"
  /v1/realtime/client_secrets:
    post:
      operationId: post_v1_realtime_client_secrets
      tags:
      - Realtime
      summary: Use POST /v1/realtime/client_secrets to create ephemeral credentials for browser or mobile clients.
      x-source: https://developers.openai.com/api/docs/guides/realtime
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
components:
  schemas:
    PostRequest:
      type: object
      properties:
        model:
          type: string
        messages:
          type: array
          items:
            type: object
            properties:
              role:
                type: string
              content:
                type: string
    PostConnectorsOauthCallbackRequest:
      type: object
      properties:
        code:
          type: string
          description: Authorization code
        state:
          type: string
          description: OAuth state
      required:
      - code
      - state
    PostConnectorsGatewayidOauthInitiateRequest:
      type: object
      properties:
        return_url:
          type: string
          description: URL to return to after OAuth
    PutRoutersIdRequest:
      type: object
      properties:
        name:
          type: string
          description: Router name used by the UI and API snippets
        description:
          type: string
          description: Router summary
        tags:
          type: string
          description: Optional colored labels
        icon:
          type: string
          description: Display icon
        dag_config:
          type: string
          description: Router graph configuration
        status:
          type: string
          description: '`draft`, `active`, or `inactive`'
        step_count:
          type: string
          description: Number of configured steps
        created_at:
          type: string
          description: Creation timestamp
        modified_at:
          type: string
          description: Last modification timestamp
        project_id:
          type: string
          description: Owning project identifier
    GetV1BatchesBatchAbc123Response:
      type: object
      properties:
        id:
          type: string
        object:
          type: string
        endpoint:
          type: string
        errors:
          type:
          - string
          - 'null'
        input_file_id:
          type: string
        completion_window:
          type: string
        status:
          type: string
        output_file_id:
          type:
          - string
          - 'null'
        error_file_id:
          type:
          - string
          - 'null'
        created_at:
          type: integer
        in_progress_at:
          type: integer
        expires_at:
          type: integer
        finalizing_at:
          type:
          - string
          - 'null'
        completed_at:
          type:
          - string
          - 'null'
        failed_at:
          type:
          - string
          - 'null'
        expired_at:
          type:
          - string
          - 'null'
        cancelling_at:
          type:
          - string
          - 'null'
        cancelled_at:
          type:
          - string
          - 'null'
        request_counts:
          type: object
          properties:
            total:
              type: integer
            completed:
              type: integer
            failed:
              type: integer
        metadata:
          type: object
          properties:
            customer_id:
              type: string
            batch_name:
              type: string
    PostV1BatchesBatchAbc123CancelResponse:
      type: object
      properties:
        id:
          type: string
        object:
          type: string
        endpoint:
          type: string
        errors:
          type:
          - string
          - 'null'
        input_file_id:
          type: string
        completion_window:
          type: string
        status:
          type: string
        output_file_id:
          type:
          - string
          - 'null'
        error_file_id:
          type:
          - string
          - 'null'
        created_at:
          type: integer
        in_progress_at:
          type: integer
        expires_at:
          type: integer
        finalizing_at:
          type:
          - string
          - 'null'
        completed_at:
          type:
          - string
          - 'null'
        failed_at:
          type:
          - string
          - 'null'
        expired_at:
          type:
          - string
          - 'null'
        cancelling_at:
          type: integer
        cancelled_at:
          type:
          - string
          - 'null'
        request_counts:
          type: object
          properties:
            total:
              type: integer
            completed:
              type: integer
            failed:
              type: integer
        metadata:
          type: object
    PostV1ChatCompletionsRequest:
      type: object
      properties:
        model:
          type: string
        messages:
          type: array
          items:
            type: object
            properties:
              role:
                type: string
              content:
                type: string
    PostV1ChatCompletionsResponse:
      type: object
      properties:
        id:
          type: string
        object:
          type: string
        created:
          type: integer
        model:
          type: string
        choices:
          type: array
          items:
            type: object
            properties:
              index:
                type: integer
              message:
                type: object
                properties:
                  role:
                    type: string
                  content:
                    type: string
              finish_reason:
                type: string
        usage:
          type: object
          properties:
            prompt_tokens:
              type: integer
            completion_tokens:
              type: integer
            total_tokens:
              type: integer
    GetV1FilesResponse:
      type: object
      properties:
        id:
          type: string
        object:
          type: string
        bytes:
          type: integer
        created_at:
          type: integer
        filename:
          type: string
        purpose:
          type: string
        status:
          type: string
        status_details:
          type:
          - string
          - 'null'
    DeleteV1FilesFileAbc123Response:
      type: object
      properties:
        id:
          type: string
        object:
          type: string
        deleted:
          type: boolean
    GetV1FilesFileAbc123Response:
      type: object
      properties:
        id:
          type: string
        object:
          type: string
        bytes:
          type: integer
        created_at:
          type: integer
        filename:
          type: string
        purpose:
          type: string
        status:
          type: string
        status_details:
          type:
          - string
          - 'null'
    GetV1ImagesEditsResponse:
      type: object
      properties:
        created:
          type: integer
        data:
          type: array
          items:
            type: object
            properties:
              url:
                type: string
              b64_json:
                type:
                - string
                - 'null'
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: Api
- name: Batches
- name: Chat
- name: Connectors
- name: Events
- name: Files
- name: Images
- name: Prompts
- name: Realtime
- name: Routers