components:
  schemas:
    ErrorResponse:
      additionalProperties: false
      properties:
        error:
          type: string
      required:
      - error
      type: object
info:
  title: Pinner.xyz Meta API
  version: v0.4.2-0.20251202222020-6d7e7eeb1b5a
openapi: 3.0.0
paths:
  /api/auth/complete:
    get:
      description: Handles the final redirect after successful authentication (password
        or social). Sets authentication cookies and redirects to the return URL.
      parameters:
      - description: URL to redirect to after completion
        in: query
        name: return
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Success
        "302":
          description: Redirecting to return URL
        "400":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Bad request
        "404":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Not found
        "500":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Internal server error
      summary: Authentication Complete Redirect
  /api/meta:
    get:
      description: Returns metadata about installed plugins and their web bundles
      parameters:
      - description: Filter metadata by application type
        in: query
        name: app
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Success
        "400":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Bad request
        "401":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Unauthorized
        "403":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Forbidden
        "404":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Not found
        "500":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Internal server error
      summary: Get Portal Metadata
      tags:
      - Public
  /api/meta/plugin/{plugin_id}/bundle/{bundle_id}/*:
    get:
      description: Serves static files from a plugin's web bundle
      parameters:
      - description: Bundle index number
        in: path
        name: bundle_id
        required: true
        schema:
          type: string
      - description: Plugin identifier
        in: path
        name: plugin_id
        required: true
        schema:
          type: string
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Success
        "400":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Invalid bundle ID
        "401":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Unauthorized
        "403":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Forbidden
        "404":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Plugin, bundle or file not found
        "500":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Failed to serve file
      summary: Get Plugin Web Bundle File
      tags:
      - Public
servers:
- url: /api