Brouky Update My Network API

openapi: 3.2.0
info:
  title: Brouky Update My Network 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: Update My Network
paths:
  /v1/update_my_network:
    post:
      operationId: update_my_network
      summary: Update my network
      description: 'For founders: add or remove someone the team knows: an investor (a fund or an angel), a startup, or a person ("we know Seedcamp", "I know the Productboard founders", "I know Jan Habermann", "Petra Novak at Kaya is a friend"). A person is found as a fund partner, a startup founder or an angel; give `at` (their fund or startup) when Brouky does not know them or the name is common. Every investor on the list that co-invested with that fund, or backed that startup, gets a warm way in on my_outreach; the answer names them. When several fit a name it asks which (needs_choice): call again with the key, website or `at`. Free.


        Credits per call: 0. Scope: pipeline.'
      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. Use `company` for a startup they know.
                investor:
                  type: string
                  description: 'An investor the team knows: a fund or an angel, by name or Brouky key.'
                company:
                  type: string
                  description: A startup the team is connected to (its founders can introduce them), by name, website or Brouky key.
                person:
                  type: string
                  description: 'A person the team knows, full name: a partner at a fund, a founder, an angel.'
                at:
                  type: string
                  description: 'With `person`: the fund or startup where they work, by name, website or key.'
                note:
                  type: string
                  description: How the team knows them ("Jana was our seed lead's analyst"). Shown on brouky.tech.
                remove:
                  type: boolean
                  description: Remove instead of add.
      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:
      - Update My Network
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_...).