openapi: 3.0.3
info:
  title: BCG Engineering API
  version: 1.0.0
  description: REST/GraphQL control plane for BCG Engineering autonomous sales agents. Owned by BCG Engineering, LLC.
  contact:
    name: BCG Engineering, LLC
    email: contact@bcg-engineering.com
    url: https://bcg-engineering.com
  license:
    name: Proprietary
    url: https://bcg-engineering.com/terms
servers:
  - url: https://api.bcg-engineering.com/v1
paths:
  /graphql:
    post:
      summary: GraphQL gateway (leads, agents, meetings)
      operationId: graphql
      responses:
        "200":
          description: GraphQL response
  /webhooks/{destination}:
    post:
      summary: Signed outbound webhooks (HubSpot, Salesforce)
      parameters:
        - in: path
          name: destination
          required: true
          schema:
            type: string
      responses:
        "202":
          description: Accepted
  /agents/{id}/cycle:
    post:
      summary: Run one prospecting cycle for an agent worker
      parameters:
        - in: path
          name: id
          required: true
          schema:
            type: string
      responses:
        "200":
          description: Cycle metrics
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
security:
  - bearerAuth: []