Brouky My Outreach API

openapi: 3.2.0
info:
  title: Brouky My Outreach API
  version: 1.0.0
  description: 'Venture intelligence for investors and startups: an AI data agent over Brouky''s database, the AI VC Finder, and investor, startup and market data. The same operations are available as an MCP server.'
  contact:
    url: https://brouky.tech/dashboard/developers
servers:
- url: https://api.brouky.tech/functions/v1/brouky-api
security:
- bearer: []
tags:
- name: My Outreach
paths:
  /v1/my_outreach:
    post:
      operationId: my_outreach
      summary: My investor outreach
      description: 'For founders: the investors to write to, each with why Brouky matched them, the companies in their portfolio closest to the user''s startup (what each does, what they share), the ways in (people the user knows who can introduce them, founders the fund backed, the contact or fund email) and the current email: a saved draft, or the email Brouky''s AI suggested. Use for "who should I write to", "give me the draft for MMC", "how do I get to Atomico". Then write or polish the email, send it with the user''s own mail tools if they have them, save it with save_outreach_draft and confirm it went out with mark_email_sent. Brouky never sends it. Free.


        Credits per call: 0. Scope: read.'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                startup:
                  type:
                  - string
                  - 'null'
                  description: Which of the user's startups, if they have more than one. Defaults to the most recent.
                investor:
                  type: string
                  description: One investor by name, for its full detail and draft.
                filter:
                  type: string
                  enum:
                  - prospects
                  - warm
                  - contacted
                  - all
                  description: 'prospects (default): not contacted yet. warm: someone the user knows can introduce them. contacted: emailed, waiting. all.'
                limit:
                  type: integer
                  minimum: 1
                  maximum: 50
                  description: How many investors (default 15), warm ones and best fit first.
      responses:
        '200':
          description: Result
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Result'
        '400':
          description: Invalid input
        '401':
          description: Missing or invalid key
        '402':
          description: Not enough credits
        '403':
          description: Key lacks the scope, or plan required
        '429':
          description: Rate limited
      tags:
      - My Outreach
components:
  schemas:
    Result:
      type: object
      properties:
        success:
          type: boolean
        operation:
          type: string
        data:
          type: object
          description: Operation-specific structured result.
        summary:
          type: string
          description: A short readable answer.
        charts:
          type: array
          description: 'Chart specs (RichChartSpec: type, title, xKey, series, data, unit).'
          items:
            type: object
        url:
          type:
          - string
          - 'null'
          description: The full interactive view on brouky.tech.
        credits:
          type:
          - object
          - 'null'
          properties:
            charged:
              type: integer
            remaining:
              type:
              - integer
              - 'null'
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      description: Your key from /dashboard/developers (brk_live_...).