AegeanBot Internal API

openapi: 3.2.0
info:
  title: Aegeanbot Com Internal API
  version: 0.1.0
  description: 'Operations tagged Internal across 2 of this provider''s published API definitions: app-aegeanbot-com-openapi.json, pms-aegeanbot-com-openapi.json. Each path carries the servers of the definition it was published in.'
tags:
- name: Internal
paths:
  /api/internal/mint-upsell-links:
    post:
      summary: Mint Upsell Links
      description: 'PMS relay (dispatch secret): (re)mint Stripe payment links for an owner''s

        active global extras — Stripe owner-status logic lives in this service.'
      operationId: mint_upsell_links_api_internal_mint_upsell_links_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      tags:
      - Internal
  /api/internal/suggest-reply:
    post:
      summary: Suggest Reply
      description: 'Inbox AI suggestions (spec §1.5): the PMS posts a thread''s context and

        gets back a draft reply produced by the SAME router+subagents that power

        the widget — mode=''suggest'' makes write-tools dry-run. Hard 25s budget;

        failures return 200 {error} so the PMS can apply its bounded retry/backoff

        instead of retrying hot.'
      operationId: suggest_reply_api_internal_suggest_reply_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      tags:
      - Internal
  /api/internal/detect-repairs:
    post:
      summary: Detect Repairs
      description: 'Batch classifier for the PMS''s daily/history inbox repair sweep.


        Read-only and advisory: the PMS owns deduplication, review state and every

        write. This endpoint returns no reply text and cannot contact a guest.'
      operationId: detect_repairs_api_internal_detect_repairs_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      tags:
      - Internal
  /internal/remind-payment/{booking_id}:
    post:
      summary: Internal Remind Payment
      description: 'Ops/testing: trigger the payment reminder for any reservation (dispatch secret).'
      operationId: internal_remind_payment_internal_remind_payment__booking_id__post
      parameters:
      - name: booking_id
        in: path
        required: true
        schema:
          type: string
          title: Booking Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Internal
  /internal/briefing/{owner}:
    post:
      summary: Internal Briefing
      description: 'Ops/testing: generate the daily briefing for an owner (dispatch secret).'
      operationId: internal_briefing_internal_briefing__owner__post
      parameters:
      - name: owner
        in: path
        required: true
        schema:
          type: string
          title: Owner
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Internal
  /internal/qa-cancel-booking:
    post:
      summary: Internal Qa Cancel Booking
      description: 'QA-harness cleanup: cancel a test booking made by the conversation

        harness. HARD-GUARDED to the QA guest email — it can never touch a real

        guest''s reservation. Mirrors the owner cancel path: local cancel +

        Guesty reservation cancel + calendar reopen + event log.'
      operationId: internal_qa_cancel_booking_internal_qa_cancel_booking_post
      requestBody:
        content:
          application/json:
            schema:
              additionalProperties: true
              type: object
              title: Body
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Internal
  /internal/auto-publish-bot-listings:
    post:
      summary: Internal Auto Publish
      description: 'Nightly (called by the bot''s sync job): open newly-eligible Guesty

        listings to the platform catalog — >=2 open days in the next 90 and a

        legit description. Idempotent; returns what it opened.'
      operationId: internal_auto_publish_internal_auto_publish_bot_listings_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      tags:
      - Internal
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
x-refined-from:
- app-aegeanbot-com-openapi.json
- pms-aegeanbot-com-openapi.json