AegeanBot Admin API

openapi: 3.2.0
info:
  title: Aegeanbot Com Admin API
  version: 0.1.0
  description: 'Operations tagged Admin 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: Admin
paths:
  /api/admin/owners:
    get:
      summary: Admin Owners
      description: Every owner on the platform — feeds the admin dashboard's user dropdown.
      operationId: admin_owners_api_admin_owners_get
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          type: string
          default: ''
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Admin
  /api/admin/mis:
    get:
      summary: Admin Mis
      description: 'MIS: every reservation deposit and add-on sale the bot generated,

        across all owners and listings.'
      operationId: admin_mis_api_admin_mis_get
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          type: string
          default: ''
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Admin
  /admin/acquisition-events:
    get:
      summary: Acquisition Events
      operationId: acquisition_events_admin_acquisition_events_get
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          type: string
          default: ''
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Admin
  /admin/google-ads/conversions/readiness:
    get:
      summary: Admin Readiness
      operationId: admin_readiness_admin_google_ads_conversions_readiness_get
      parameters:
      - name: probe
        in: query
        required: false
        schema:
          type: boolean
          default: false
          title: Probe
      - name: authorization
        in: header
        required: false
        schema:
          type: string
          default: ''
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Admin
  /admin/google-ads/conversions:
    get:
      summary: Admin List
      description: 'Redacted outbox view: statuses, reasons, Google diagnostics — no click ids.'
      operationId: admin_list_admin_google_ads_conversions_get
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 200
          title: Limit
      - name: authorization
        in: header
        required: false
        schema:
          type: string
          default: ''
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Admin
  /admin/google-ads/conversions/drain:
    post:
      summary: Admin Drain
      description: 'Scheduler / manual trigger (X-Admin-Key, same model as the other

        scheduler entry points). Also runs every 15 min via Inngest.'
      operationId: admin_drain_admin_google_ads_conversions_drain_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      tags:
      - Admin
  /admin/google-ads/conversions/probe:
    post:
      summary: Admin Probe
      description: 'X-Admin-Key. Credentials/scope/destination check from the runtime

        identity plus a validateOnly=true synthetic request (see `probe`).

        Never records a conversion, never writes a row.'
      operationId: admin_probe_admin_google_ads_conversions_probe_post
      parameters:
      - name: validate
        in: query
        required: false
        schema:
          type: boolean
          default: true
          title: Validate
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Admin
  /admin/google-ads/conversions/{upload_id}:
    get:
      summary: Admin Detail
      operationId: admin_detail_admin_google_ads_conversions__upload_id__get
      parameters:
      - name: upload_id
        in: path
        required: true
        schema:
          type: string
          title: Upload Id
      - name: authorization
        in: header
        required: false
        schema:
          type: string
          default: ''
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Admin
  /admin/google-ads/conversions/{upload_id}/requeue:
    post:
      summary: Admin Requeue
      description: 'Re-evaluate a held / failed / skipped / cancelled / unverified row now.

        Every delivery gate (first-payment verification, consent, click id,

        counting, age) runs again.'
      operationId: admin_requeue_admin_google_ads_conversions__upload_id__requeue_post
      parameters:
      - name: upload_id
        in: path
        required: true
        schema:
          type: string
          title: Upload Id
      - name: authorization
        in: header
        required: false
        schema:
          type: string
          default: ''
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Admin
  /admin/registrations:
    get:
      summary: Admin Registrations
      operationId: admin_registrations_admin_registrations_get
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 100
          title: Limit
      - name: authorization
        in: header
        required: false
        schema:
          type: string
          default: ''
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Admin
  /admin/suggest-drain:
    post:
      summary: Admin Suggest Drain
      operationId: admin_suggest_drain_admin_suggest_drain_post
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          type: string
          default: ''
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Admin
  /admin/me:
    get:
      summary: Admin Me
      description: 'Probe for the console: 200 = show the admin panels.'
      operationId: admin_me_admin_me_get
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          type: string
          default: ''
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Admin
  /admin/reservations:
    get:
      summary: Admin Reservations
      description: Every reservation across ALL owners, newest activity first.
      operationId: admin_reservations_admin_reservations_get
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          type: string
          default: ''
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Admin
  /admin/pms-listings:
    get:
      summary: Admin Pms Listings
      description: All PMS listings across owners — the left side of the Guesty map.
      operationId: admin_pms_listings_admin_pms_listings_get
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          type: string
          default: ''
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Admin
  /admin/guesty/listings:
    get:
      summary: Admin Guesty Listings
      description: Live Guesty A inventory — the right side of the map (token-manager auth).
      operationId: admin_guesty_listings_admin_guesty_listings_get
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          type: string
          default: ''
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Admin
  /admin/guesty/map:
    get:
      summary: Admin Guesty Map
      operationId: admin_guesty_map_admin_guesty_map_get
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          type: string
          default: ''
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Admin
    put:
      summary: Admin Guesty Map Save
      description: Manually declare a PMSGuesty A link. ONLY listings in this map mirror.
      operationId: admin_guesty_map_save_admin_guesty_map_put
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          type: string
          default: ''
          title: Authorization
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Admin
  /admin/guesty/map/{property_id}:
    delete:
      summary: Admin Guesty Map Delete
      description: Unlink. Frees the map row; guesty-sourced blocks for it are released too.
      operationId: admin_guesty_map_delete_admin_guesty_map__property_id__delete
      parameters:
      - name: property_id
        in: path
        required: true
        schema:
          type: string
          title: Property Id
      - name: authorization
        in: header
        required: false
        schema:
          type: string
          default: ''
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Admin
  /admin/guesty/convert-pushed:
    post:
      summary: Admin Guesty Convert Pushed
      description: 'One-off (X-Admin-Key): turn every Guesty RESERVATION this PMS pushed before the

        block-only rule (2026-09-22) into a plain calendar block.

        live (not cancelled, checkout >= today) -> cancel in Guesty, re-block the nights

        parked as ''cancelling'' -> cancel in Guesty, no block

        past or cancelled -> just unlink (Guesty ignores it)

        Every row ends with guesty_reservation_id NULL, so the mirror owns the nights

        from then on. dry_run=1 (default) only reports.'
      operationId: admin_guesty_convert_pushed_admin_guesty_convert_pushed_post
      parameters:
      - name: dry_run
        in: query
        required: false
        schema:
          type: integer
          default: 1
          title: Dry Run
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Admin
  /admin/guesty/mirror-sync:
    post:
      summary: Admin Guesty Mirror
      description: Run the two-way mirror now for every mapped, mirror-enabled listing.
      operationId: admin_guesty_mirror_admin_guesty_mirror_sync_post
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          type: string
          default: ''
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Admin
  /admin/listing-facts/platform-titles:
    post:
      summary: Admin Platform Titles
      description: Rebuild ota_listing_titles now (Channex + Guesty).
      operationId: admin_platform_titles_admin_listing_facts_platform_titles_post
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          type: string
          default: ''
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Admin
  /admin/guesty/ama-sync:
    post:
      summary: Admin Guesty Ama
      description: Run the Guesty AMA mirror now; the report lists listings still missing one.
      operationId: admin_guesty_ama_admin_guesty_ama_sync_post
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          type: string
          default: ''
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Admin
  /admin/guesty/links-sync:
    post:
      summary: Admin Guesty Links
      description: Copy public Airbnb / Booking.com page links from Guesty now.
      operationId: admin_guesty_links_admin_guesty_links_sync_post
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          type: string
          default: ''
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Admin
  /admin/guesty/policy-sync:
    post:
      summary: Admin Guesty Policy
      description: Run the Guesty cancellation-policy mirror now.
      operationId: admin_guesty_policy_admin_guesty_policy_sync_post
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          type: string
          default: ''
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Admin
  /admin/guesty/financials-sync:
    post:
      summary: Admin Guesty Financials
      description: Run the Guesty financials mirror now.
      operationId: admin_guesty_financials_admin_guesty_financials_sync_post
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          type: string
          default: ''
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Admin
  /admin/google/connect:
    post:
      summary: Admin Google Connect
      description: 'Connect Channex listings to Google Vacation Rentals (one GoogleHotelARI

        connection each). dry_run reports what would happen; limit caps the

        listings changed per call (pilot one, then the rest).'
      operationId: admin_google_connect_admin_google_connect_post
      parameters:
      - name: dry_run
        in: query
        required: false
        schema:
          type: boolean
          default: true
          title: Dry Run
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 1
          title: Limit
      - name: property_id
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Property Id
      - name: owner_id
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Owner Id
      - name: authorization
        in: header
        required: false
        schema:
          type: string
          default: ''
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Admin
  /admin/tags/propose:
    get:
      summary: Admin Tags Propose
      description: First assignment per listing (Athens+area for Attica, island/region otherwise) for review.
      operationId: admin_tags_propose_admin_tags_propose_get
      parameters:
      - name: owner_id
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Owner Id
      - name: guesty
        in: query
        required: false
        schema:
          type: boolean
          default: false
          title: Guesty
      - name: overwrite
        in: query
        required: false
        schema:
          type: boolean
          default: false
          title: Overwrite
      - name: llm
        in: query
        required: false
        schema:
          type: boolean
          default: true
          title: Llm
      - name: authorization
        in: header
        required: false
        schema:
          type: string
          default: ''
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Admin
  /admin/tags/apply:
    post:
      summary: Admin Tags Apply
      operationId: admin_tags_apply_admin_tags_apply_post
      parameters:
      - name: owner_id
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Owner Id
      - name: authorization
        in: header
        required: false
        schema:
          type: string
          default: ''
          title: Authorization
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Admin
  /admin/google/status:
    get:
      summary: Admin Google Status
      operationId: admin_google_status_admin_google_status_get
      parameters:
      - name: owner_id
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Owner Id
      - name: authorization
        in: header
        required: false
        schema:
          type: string
          default: ''
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Admin
  /admin/guesty/content-sync:
    post:
      summary: Admin Guesty Content Sync
      description: 'Mirror listing content (address, description, amenities → Channex

        facilities, type) from Guesty into every mapped listing, and re-provision

        the ones that already have a Channex twin so the twin gets the address,

        hotel + cancellation policies and facilities Google/Booking need.

        provisioned_only=false also fills the local columns for unprovisioned rows.'
      operationId: admin_guesty_content_sync_admin_guesty_content_sync_post
      parameters:
      - name: property_id
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Property Id
      - name: provisioned_only
        in: query
        required: false
        schema:
          type: boolean
          default: true
          title: Provisioned Only
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 50
          title: Limit
      - name: authorization
        in: header
        required: false
        schema:
          type: string
          default: ''
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Admin
  /admin/airbnb-listings/audit:
    post:
      summary: Airbnb Listings Audit
      description: 'Weekly scheduler entry (Sunday 08:00 Athens): refresh the mainland

        Airbnb listing list from Guesty and notify the operator''s automation when

        it changed (see app/listing_audit.py). Same guard as /envfee/auto-links.'
      operationId: airbnb_listings_audit_admin_airbnb_listings_audit_post
      parameters:
      - name: force
        in: query
        required: false
        schema:
          type: boolean
          default: false
          title: Force
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Admin
  /admin/precheckin-links:
    post:
      summary: Admin Precheckin Links
      description: Run the OTA pre-check-in link sweep now (manual trigger).
      operationId: admin_precheckin_links_admin_precheckin_links_post
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          type: string
          default: ''
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Admin
  /admin/envfee/auto-links:
    post:
      summary: Admin Envfee Auto Links
      description: Run the envfee link dispatch now (manual trigger for testing).
      operationId: admin_envfee_auto_links_admin_envfee_auto_links_post
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          type: string
          default: ''
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Admin
  /admin/checkout-reminders:
    post:
      summary: Admin Checkout Reminders
      description: Run the check-out reminder dispatch now (manual trigger for testing).
      operationId: admin_checkout_reminders_admin_checkout_reminders_post
      parameters:
      - name: authorization
        in: header
        required: false
        schema:
          type: string
          default: ''
          title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Admin
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