openapi: 3.0.3
info:
  title: App API
  description: API for managing app publishing and installed app.
  version: 1.0.0
tags:
  - name: App Configuration
    description: Create and manage app configurations
  - name: App Installation
    description: Install and uninstall apps

servers:
  - url: https://app.sls.epilot.io

security:
  - EpilotAuth: []
  - EpilotOrg: []

paths:
  /v1/app-configurations:
    get:
      summary: listConfigurations
      description: List all app configuration metadata owned by an organization. To get full app configuration details, use the /v1/app-configurations/{appId} endpoint.
      operationId: listConfigurations
      tags:
        - App Configuration
      parameters:
        - name: page
          in: query
          schema:
            type: integer
            default: 1
          description: Page number for pagination
        - name: pageSize
          in: query
          schema:
            type: integer
            default: 20
          description: Number of items per page
      responses:
        "200":
          description: List of app configurations
          content:
            application/json:
              schema:
                type: object
                properties:
                  configurations:
                    type: array
                    items:
                      $ref: "#/components/schemas/ConfigurationMetadata"
                  pagination:
                    type: object
                    properties:
                      total:
                        type: integer
                      page:
                        type: integer
                      pageSize:
                        type: integer
    post:
      summary: createConfiguration
      description: Create a new private app configuration. To make it public a verification process needs to be triggered
      operationId: createConfiguration
      tags:
        - App Configuration
      requestBody:
        $ref: "#/components/requestBodies/CreateConfigRequest"
      responses:
        "201":
          description: App configuration created successfully
          content:
            application/json:
              schema:
                type: object
                required:
                  - app_id
                properties:
                  app_id:
                    type: string

  /v1/app-configurations/public/{appId}:
    parameters:
      - name: appId
        in: path
        required: true
        schema:
          type: string
        description: ID of the app configuration to install
    get:
      summary: getPublicConfiguration
      description: Retrieve the public configuration of an app to install in your tenant
      operationId: getPublicConfiguration
      tags:
        - App Configuration
      parameters:
        - name: version
          in: query
          schema:
            type: string
          description: Version of the app configuration to retrieve
      responses:
        "200":
          description: Successful response
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PublicConfiguration"
        "404":
          description: App configuration not found

  /v1/app-configurations/{appId}:
    parameters:
      - name: appId
        in: path
        required: true
        schema:
          type: string
        description: ID of the app configuration
    get:
      summary: getConfiguration
      description: Retrieve a specific app configuration
      operationId: getConfiguration
      tags:
        - App Configuration
      parameters:
        - name: version
          in: query
          schema:
            type: string
          description: Version of the app configuration to retrieve
      responses:
        "200":
          description: Successful response
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Configuration"
        "404":
          description: App configuration not found
    patch:
      summary: patchMetadata
      description: Patch non-versioned configuration metadata of a given app configuration.
      operationId: patchMetadata
      tags:
        - App Configuration
      requestBody:
        $ref: "#/components/requestBodies/PatchConfigMetadataRequest"
      responses:
        "204":
          description: Configuration patched successfully
        "404":
          description: App configuration not found

  /v1/app-configurations/{appId}/bundle:
    post:
      summary: createBundleUploadUrl
      description: Generate a presigned URL for uploading app bundle to /<app-id>/bundle.zip path
      operationId: createBundleUploadUrl
      tags:
        - App Configuration
      parameters:
        - name: appId
          in: path
          required: true
          schema:
            type: string
          description: ID of the app configuration
      requestBody:
        $ref: "#/components/requestBodies/CreateBundlePresignedRequest"
      responses:
        "200":
          description: Upload URL generated successfully
          content:
            application/json:
              schema:
                type: object
                required:
                  - upload_url
                properties:
                  component_id:
                    type: string
                    description: ID of the journye block component
                  component_url:
                    type: string
                    description: URL of the web component object
                  upload_url:
                    type: string
                    description: Presigned S3 URL for uploading the bundle
                  s3ref:
                    $ref: "#/components/schemas/S3Reference"
                  expires_at:
                    type: string
                    format: date-time
                    description: Timestamp when the upload URL expires
        "404":
          description: App configuration not found

  /v1/app-configurations/{appId}/logo:
    parameters:
      - name: appId
        in: path
        required: true
        schema:
          type: string
        description: ID of the app configuration
    post:
      summary: createLogoUploadUrl
      description: Generate a presigned URL for uploading app logo to /<app-id>/logo.png path
      operationId: createLogoUploadUrl
      tags:
        - App Configuration
      requestBody:
        $ref: "#/components/requestBodies/CreateLogoPresignedRequest"
      responses:
        "200":
          description: Upload URL generated successfully
          content:
            application/json:
              schema:
                type: object
                required:
                  - upload_url
                properties:
                  upload_url:
                    type: string
                    description: Presigned S3 URL for uploading the logo
                  s3ref:
                    $ref: "#/components/schemas/S3Reference"
                  expires_at:
                    type: string
                    format: date-time
                    description: Timestamp when the upload URL expires
        "404":
          description: App configuration not found
    delete:
      summary: deleteLogo
      description: Delete the app logo from /<app-id>/logo.png path
      operationId: deleteLogo
      tags:
        - App Configuration
      responses:
        "204":
          description: Logo deleted successfully
        "404":
          description: App configuration not found

  /v1/app-configurations/{appId}/versions:
    get:
      summary: listVersions
      description: Retrieve a list of versions for an app configuration
      operationId: listVersions
      tags:
        - App Configuration
      parameters:
        - name: appId
          in: path
          required: true
          schema:
            type: string
          description: ID of the app configuration
        - name: page
          in: query
          schema:
            type: integer
            default: 1
          description: Page number for pagination
        - name: pageSize
          in: query
          schema:
            type: integer
            default: 20
          description: Number of items per page
      responses:
        "200":
          description: List of app versions
          content:
            application/json:
              schema:
                type: object
                properties:
                  versions:
                    type: array
                    items:
                      $ref: "#/components/schemas/ConfigurationVersion"
                  pagination:
                    type: object
                    properties:
                      total:
                        type: integer
                      page:
                        type: integer
                      pageSize:
                        type: integer

  /v1/app-configurations/{appId}/versions/{version}:
    get:
      summary: getVersion
      description: Retrieve a specific version of an app configuration
      operationId: getVersion
      tags:
        - App Configuration
      parameters:
        - name: appId
          in: path
          required: true
          schema:
            type: string
          description: ID of the app configuration
        - name: version
          in: path
          required: true
          schema:
            type: string
          description: Version of the app configuration to retrieve
      responses:
        "200":
          description: App configuration for specific version
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Configuration"
        "404":
          description: App configuration or version not found
    delete:
      summary: deleteVersion
      description: Delete a specific version of an app configuration
      operationId: deleteVersion
      tags:
        - App Configuration
      parameters:
        - name: appId
          in: path
          required: true
          schema:
            type: string
          description: ID of the app configuration
        - name: version
          in: path
          required: true
          schema:
            type: string
          description: Version to delete
      responses:
        "204":
          description: Version deleted successfully
        "400":
          description: Cannot delete the only remaining version
        "404":
          description: Version not found
        "409":
          description: Version is in use by installations

  /v1/app-configurations/{appId}/versions/{version}/components:
    post:
      summary: createComponent
      description: Patch an existing app version to create/add a component
      operationId: createComponent
      tags:
        - App Configuration
      parameters:
        - name: appId
          in: path
          required: true
          schema:
            type: string
          description: ID of the app configuration
        - name: version
          in: path
          required: true
          schema:
            type: string
          description: Version to update
      requestBody:
        $ref: "#/components/requestBodies/UpsertComponentRequest"
      responses:
        "204":
          description: Component created successfully
        "400":
          description: Invalid version format
        "404":
          description: Version not found

  /v1/app-configurations/{appId}/versions/{version}/components/{componentId}:
    patch:
      summary: patchComponent
      description: Patch an existing app version to update its components
      operationId: patchComponent
      tags:
        - App Configuration
      parameters:
        - name: appId
          in: path
          required: true
          schema:
            type: string
          description: ID of the app configuration
        - name: version
          in: path
          required: true
          schema:
            type: string
          description: Version to update
        - name: componentId
          in: path
          required: true
          schema:
            type: string
          description: ID of the component to update
      requestBody:
        $ref: "#/components/requestBodies/UpsertComponentRequest"
      responses:
        "204":
          description: Component patched successfully
        "400":
          description: Invalid version format
        "404":
          description: Version or component not found
    delete:
      summary: deleteComponent
      description: Delete a specific component from an app version
      operationId: deleteComponent
      tags:
        - App Configuration
      parameters:
        - name: appId
          in: path
          required: true
          schema:
            type: string
          description: ID of the app configuration
        - name: version
          in: path
          required: true
          schema:
            type: string
          description: Version to update
        - name: componentId
          in: path
          required: true
          schema:
            type: string
          description: ID of the component to delete
      responses:
        "204":
          description: Component deleted successfully
        "404":
          description: Version or component not found

  ? /v1/app-configurations/{appId}/versions/{sourceVersion}/clone-to/{targetVersion}
  : post:
      summary: cloneVersion
      description: Clone an existing app version to create a new version
      operationId: cloneVersion
      tags:
        - App Configuration
      parameters:
        - name: appId
          in: path
          required: true
          schema:
            type: string
          description: ID of the app configuration
        - name: sourceVersion
          in: path
          required: true
          schema:
            type: string
          description: Source version to clone from
        - name: targetVersion
          in: path
          required: true
          schema:
            type: string
          description: Target version to create
      responses:
        "201":
          description: New version created successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  app_id:
                    type: string
                  version:
                    type: string
                  status:
                    type: string
                    enum: [pending, published]
        "400":
          description: Invalid version format or target version already exists
        "404":
          description: Source version not found

  /v1/app:
    get:
      summary: listInstallations
      description: Retrieve a list of installed apps for the organization.
      operationId: listInstallations
      tags:
        - App Installation
      parameters:
        - name: componentType
          in: query
          schema:
            $ref: "#/components/schemas/ComponentType"
          description: Filter apps by specific component type
          example: CUSTOM_JOURNEY_BLOCK
        - name: enabled
          in: query
          schema:
            type: boolean
          description: Filter apps by enabled status
        - name: page
          in: query
          schema:
            type: integer
            default: 1
          description: Page number for pagination
        - name: pageSize
          in: query
          schema:
            type: integer
            default: 20
          description: Number of items per page
      responses:
        "200":
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  apps:
                    type: array
                    items:
                      $ref: "#/components/schemas/Installation"
                  pagination:
                    type: object
                    properties:
                      total:
                        type: integer
                      page:
                        type: integer
                      pageSize:
                        type: integer

  /v1/app/{appId}:
    get:
      summary: getInstallation
      description: Retrieve details of an installed app by its ID.
      operationId: getInstallation
      tags:
        - App Installation
      parameters:
        - name: appId
          in: path
          required: true
          schema:
            type: string
      responses:
        "200":
          description: Details about an app installation.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Installation"
        "404":
          description: Installation not found.
    post:
      summary: install
      description: Upsert app installation by its ID.
      operationId: install
      tags:
        - App Installation
      parameters:
        - name: appId
          in: path
          required: true
          schema:
            type: string
      requestBody:
        $ref: "#/components/requestBodies/InstallRequest"
      responses:
        "204":
          description: App successfully installed.
        "404":
          description: App not found.
    patch:
      summary: patchInstallation
      description: Patch an installed app by its ID.
      operationId: patchInstallation
      tags:
        - App Installation
      parameters:
        - name: appId
          in: path
          required: true
          schema:
            type: string
      requestBody:
        $ref: "#/components/requestBodies/InstallRequest"
      responses:
        "204":
          description: App installation patched successfully.
        "404":
          description: App not found.
    delete:
      summary: uninstall
      description: Uninstall an app by its ID.
      operationId: uninstall
      tags:
        - App Installation
      parameters:
        - name: appId
          in: path
          required: true
          schema:
            type: string
      responses:
        "204":
          description: App deleted successfully.
        "404":
          description: App not found.

  /v1/app/{appId}/promote-to/{version}:
    post:
      summary: promoteVersion
      description: Update an installed app to a new version
      operationId: promoteVersion
      tags:
        - App Installation
      parameters:
        - name: appId
          in: path
          required: true
          schema:
            type: string
        - name: version
          in: path
          required: true
          schema:
            type: string
      responses:
        "200":
          description: App successfully promoted to new version
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Installation"
        "400":
          description: Invalid version or version not available
        "404":
          description: App installation not found

components:
  requestBodies:
    CreateLogoPresignedRequest:
      required: true
      content:
        application/json:
          schema:
            type: object
            required:
              - filename
              - mime_type
            properties:
              filename:
                type: string
                description: Original filename of the logo
                example: "company-logo.png"
              mime_type:
                type: string
                description: MIME type of the logo file
                enum:
                  - image/png
                  - image/jpeg
                  - image/jpg
                example: "image/png"

    CreateBundlePresignedRequest:
      required: true
      content:
        application/json:
          schema:
            type: object
            required:
              - version
            properties:
              version:
                type: string
                description: Version of the app
              component_id:
                type: string
                description: ID of the journye block component

    PatchConfigMetadataRequest:
      required: true
      content:
        application/json:
          schema:
            type: object
            properties:
              name:
                type: string
                description: Name of the app
              description:
                $ref: "#/components/schemas/TranslatedString"
              category:
                type: string
              documentation_url:
                type: string
              notifications:
                $ref: "#/components/schemas/NotificationConfig"
              pricing:
                $ref: "#/components/schemas/Pricing"
              logo_url_key:
                type: string
                description: S3 key of the logo file
              support_email:
                type: string
                description: Email address for support requests

    UpsertComponentRequest:
      required: true
      content:
        application/json:
          schema:
            $ref: "#/components/schemas/BaseComponent"

    CreateConfigRequest:
      required: true
      content:
        application/json:
          schema:
            type: object
            required:
              - name
              - description
            properties:
              name:
                type: string
                description: Name of the app
              description:
                $ref: "#/components/schemas/TranslatedString"
              category:
                type: string
              logo_url_key:
                type: string
                description: S3 key of the logo file

    InstallRequest:
      content:
        application/json:
          schema:
            type: object
            properties:
              option_values:
                type: array
                items:
                  $ref: "#/components/schemas/OptionsRef"
                description: Configuration values for the app components

  securitySchemes:
    EpilotAuth:
      type: http
      scheme: bearer
      description: Authorization header with epilot OAuth2 bearer token
      bearerFormat: JWT
    EpilotOrg:
      description: Overrides the target organization to allow shared tenantaccess
      name: x-epilot-org-id
      in: header
      type: apiKey

  schemas:
    Options:
      type: object
      description: Options for the component configuration
      required:
        - key
        - type
      properties:
        key:
          type: string
          description: Unique identifier for this configuration option
        label:
          type: string
          description: Human-readable label for the configuration option
        required:
          type: boolean
          description: Flag to indicate if this option is required
        description:
          type: string
          description: Detailed description of what this configuration option does
        value:
          type: string
          description: The configured value for this option. Is only present when the component is installed.
        type:
          type: string
          enum: [text, number, boolean, secret]

    Option:
      type: object
      required:
        - key
        - value
      properties:
        key:
          type: string
          description: Key matching a config_option from the component
        value:
          type: string
          description: The configured value for this option

    OptionsRef:
      type: object
      required:
        - component_id
        - options
      properties:
        component_id:
          type: string
          description: ID of the component these values are for
        options:
          type: array
          items:
            $ref: "#/components/schemas/Option"

    S3Reference:
      type: object
      properties:
        bucket:
          type: string
          description: The name of the S3 bucket where the JSON file for import is stored.
          example: "my-bucket"
        key:
          type: string
          description: The key or path to the JSON file within the S3 bucket.
          example: "manifest.json"
      required:
        - bucket
        - key

    ComponentType:
      type: string
      enum:
        - CUSTOM_JOURNEY_BLOCK
        - PORTAL_EXTENSION
      description: Type of app component

    Author:
      type: object
      required:
        - company
      properties:
        name:
          type: string
          description: Name of the author
          maxLength: 50
        company:
          type: string
          description: Company of the author
          maxLength: 30
        email:
          type: string
          description: Email of the author
          maxLength: 30

    NotificationConfig:
      type: object
      properties:
        email:
          type: string
          format: email
          description: Email address to receive notifications
          example: "developer@example.com"
        events:
          type: array
          description: List of events to subscribe to
          items:
            $ref: "#/components/schemas/NotificationEvent"
          minItems: 0

    NotificationEvent:
      type: string
      enum:
        - app.installed
        - app.uninstalled

    BaseComponentCommon:
      type: object
      required:
        - id
      properties:
        id:
          type: string
          description: Unique identifier for the component
        name:
          allOf:
            - description: Name of the component
            - $ref: "#/components/schemas/TranslatedString"
        description:
          allOf:
            - description: Description of the component
            - $ref: "#/components/schemas/TranslatedString"
        options:
          type: array
          items:
            $ref: "#/components/schemas/Options"
          description: List of options for the app component

    BaseComponent:
      allOf:
        - $ref: "#/components/schemas/BaseComponentCommon"
        - type: object
          discriminator:
            propertyName: component_type
            mapping:
              CUSTOM_JOURNEY_BLOCK: "#/components/schemas/JourneyBlockComponent"
              PORTAL_EXTENSION: "#/components/schemas/PortalExtensionComponent"
          oneOf:
            - $ref: "#/components/schemas/JourneyBlockComponent"
            - $ref: "#/components/schemas/PortalExtensionComponent"

    JourneyBlockComponent:
      type: object
      required:
        - component_type
        - configuration
      properties:
        component_type:
          type: string
          enum: [CUSTOM_JOURNEY_BLOCK]
        configuration:
          $ref: "#/components/schemas/JourneyBlockConfig"

    PortalExtensionComponent:
      type: object
      required:
        - component_type
        - configuration
      properties:
        component_type:
          type: string
          enum: [PORTAL_EXTENSION]
        origin:
          type: string
          enum: [END_CUSTOMER_PORTAL, INSTALLER_PORTAL]
        configuration:
          $ref: "#/components/schemas/PortalExtensionConfig"

    PortalExtensionConfig:
      type: object
      properties:
        id:
          type: string
        hooks:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              type:
                type: string
              name:
                $ref: "#/components/schemas/TranslatedString"
              interval:
                type: array
                items:
                  type: string
              auth:
                $ref: "#/components/schemas/PortalAuth"
              call:
                type: object
                properties:
                  url:
                    type: string
                  headers:
                    type: object
                    additionalProperties:
                      type: string
                  params:
                    type: object
                    additionalProperties:
                      type: string
        links:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              type:
                type: string
              name:
                $ref: "#/components/schemas/TranslatedString"
              description:
                $ref: "#/components/schemas/TranslatedString"
              condition:
                type: string
              auth:
                $ref: "#/components/schemas/PortalAuth"
              redirect:
                type: object
                properties:
                  url:
                    type: string
                  params:
                    type: object
                    additionalProperties:
                      type: string

    PortalAuth:
      type: object
      properties:
        type:
          type: string
        url:
          type: string
        method:
          type: string
        headers:
          type: object
          additionalProperties:
            type: string

    JourneyBlockConfig:
      type: object
      required:
        - component_url
        - component_tag
      properties:
        component_url:
          type: string
          description: URL of the web component object
          example: "https://cdn.apps.com/123/v1.0.0/bundle.js"
          readOnly: true
        component_tag:
          type: string
          description: Custom element tag for the component
        component_args:
          type: array
          description: Arguments to pass to the component
          items:
            $ref: "#/components/schemas/JourneyBlockComponentArgs"
        component_size:
          type: number
          description: Size of the bundle in bytes
          readOnly: true
        component_mapping:
          x-speakeasy-terraform-ignore: true
          description: Define data which is mapped to entity mapping ui blocks
          type: object
          additionalProperties:
            type: string
            enum:
              - string
              - boolean
              - date
              - datetime
              - link

    JourneyBlockComponentArgs:
      allOf:
        - type: object
          required:
            - key
            - label
            - type
          properties:
            key:
              type: string
              description: Unique identifier for this component arg
            type:
              type: string
              enum: [text, boolean, enum]
            required:
              type: boolean
              description: Flag to indicate if this option is required
              default: false
            description:
              allOf:
                - description: Description of what this component arg does
                - $ref: "#/components/schemas/TranslatedString"
            label:
              allOf:
                - description: Human-readable label for the component arg
                - $ref: "#/components/schemas/TranslatedString"
        - type: object
          discriminator:
            propertyName: type
            mapping:
              text: "#/components/schemas/TextArg"
              boolean: "#/components/schemas/BooleanArg"
              enum: "#/components/schemas/EnumArg"
          oneOf:
            - $ref: "#/components/schemas/TextArg"
            - $ref: "#/components/schemas/BooleanArg"
            - $ref: "#/components/schemas/EnumArg"

    TextArg:
      type: object
      properties:
        type:
          type: string
          enum: [text]

    BooleanArg:
      type: object
      properties:
        type:
          type: string
          enum: [boolean]

    EnumArg:
      type: object
      required:
        - options
      properties:
        type:
          type: string
          enum: [enum]
        isMulti:
          type: boolean
          description: If true, allows selection of multiple values
          default: false
        options:
          type: array
          description: List of options for enum type
          minItems: 1
          items:
            type: object
            required:
              - id
              - label
            properties:
              id:
                type: string
                description: Unique identifier for the option
              label:
                allOf:
                  - description: Display label for the option
                  - $ref: "#/components/schemas/TranslatedString"

    BillingFrequency:
      type: string
      enum:
        - MONTHLY
        - QUARTERLY
        - YEARLY
        - CUSTOM
      description: How often the subscription is billed

    Pricing:
      type: object
      properties:
        pricing_type:
          type: string
          enum: [FREE, SUBSCRIPTION, USAGE_BASED, ONE_TIME, CUSTOM, UNKNOWN]
        billing_frequency:
          $ref: "#/components/schemas/BillingFrequency"

    Audit:
      type: object
      properties:
        created_at:
          type: string
          description: Timestamp of the creation
          readOnly: true
        created_by:
          type: string
          description: User ID of the creator
          readOnly: true
        updated_at:
          type: string
          description: Timestamp of the last update
          readOnly: true
        updated_by:
          type: string
          description: User ID of the last updater
          readOnly: true

    ConfigurationMetadata:
      description: Basic metadata about your app configuration which does not get versioned
      type: object
      required:
        - name
        - description
        - latest_version
        - owner_org_id
        - app_id
        - versions
      properties:
        app_id:
          type: string
          readOnly: true
        name:
          type: string
          description: Name of the app
        author:
          $ref: "#/components/schemas/Author"
        versions:
          type: array
          items:
            type: string
          description: List of available versions of the app
          readOnly: true
        public_versions:
          type: array
          items:
            type: string
          description: List of available public versions of the app
          readOnly: true
        support_email:
          type: string
          description: Email address for support requests
        latest_version:
          type: string
          description: Latest version of the app
          readOnly: true
        category:
          type: string
          description: Category of the app.
        icon_url:
          type: string
          description: URL of the app icon.
        documentation_url:
          type: string
          description: URL of the app documentation.
        description:
          allOf:
            - description: Markdown description of the app.
            - $ref: "#/components/schemas/TranslatedString"
        notifications:
          allOf:
            - description: Configuration for developer notifications
            - $ref: "#/components/schemas/NotificationConfig"
        owner_org_id:
          type: string
          description: Organization ID of the app owner, required for private apps or sandbox accounts
          readOnly: true
        internal:
          type: boolean
          default: false
          description: Flag to indicate if the app is built by epilot.
          readOnly: true
        pricing:
          allOf:
            - description: Pricing information for the app
            - $ref: "#/components/schemas/Pricing"
        configuration_audit:
          readOnly: true
          allOf:
            - description: Audit information for the app
            - $ref: "#/components/schemas/Audit"

    ConfigurationVersion:
      description: Configuration data about your app which is versionable
      type: object
      required:
        - version
        - components
        - app_id
        - version_audit
        - owner_org_id
      properties:
        app_id:
          type: string
          readOnly: true
        owner_org_id:
          type: string
          description: Organization ID of the app owner
          readOnly: true
        components:
          type: array
          items:
            $ref: "#/components/schemas/BaseComponent"
          minItems: 0
        public:
          type: boolean
          default: true
          description: Flag to indicate if the app is public.
          readOnly: true
        pending:
          type: boolean
          default: false
          description: Flag to indicate if the app is pending for verification
          readOnly: true
        version:
          type: string
          description: Version of the app that is installed
          readOnly: true
          maxLength: 10
        is_beta:
          type: boolean
          description: Flag to indicate if the app is in beta.
          readOnly: true
        deprecated_at:
          type: string
          description: Timestamp when the app version is deprecated
        changelog:
          type: string
          description: Changelog for the app version
          maxLength: 250
        review_status:
          type: string
          enum: [approved, rejected, pending]
          description: Status of the review process
        version_audit:
          readOnly: true
          allOf:
            - $ref: "#/components/schemas/Audit"
            - type: object
              properties:
                versioned_at:
                  type: string
                  description: Timestamp of the last version update
                  readOnly: true
                versioned_by:
                  type: string
                  description: User ID of the user who last updated the app
                  readOnly: true

    Installation:
      description: Information about the installed app. Has configuration data of the installed version
      type: object
      required:
        - app_id
        - installer_org_id
        - enabled
        - name
        - components
        - installed_version
      properties:
        app_id:
          type: string
          description: ID of the app configuration
          readOnly: true
        installer_org_id:
          type: string
          description: Unique identifier for the organization the app is installed in
          readOnly: true
        enabled:
          readOnly: true
          type: boolean
          default: true
          description: Flag to indicate if the app is enabled. Enabled is set to true when required option values are set.
        name:
          type: string
          description: Name of the app
          readOnly: true
        option_values:
          type: array
          items:
            $ref: "#/components/schemas/OptionsRef"
          description: Configuration values for the app components
        components:
          description: List of component configurations for the installed version
          type: array
          items:
            $ref: "#/components/schemas/BaseComponent"
          minLength: 0
          readOnly: true
        installed_version:
          type: string
          description: Version of the app that is installed
          readOnly: true
        installation_audit:
          readOnly: true
          allOf:
            - description: Audit information for the app
            - $ref: "#/components/schemas/Audit"

    PublicConfiguration:
      description: Public configuration of the published app
      type: object
      required:
        - version
        - components
        - owner_org_id
        - app_id
        - name
      properties:
        app_id:
          type: string
          description: ID of the app configuration
        support_email:
          type: string
          description: Email address for support requests
        owner_org_id:
          type: string
          description: Organization ID of the app owner
        name:
          type: string
          description: Name of the app
        author:
          $ref: "#/components/schemas/Author"
        category:
          type: string
          description: Category of the app.
        icon_url:
          type: string
          description: URL of the app icon.
        documentation_url:
          type: string
          description: URL of the app documentation.
        description:
          allOf:
            - description: Markdown description of the app.
            - $ref: "#/components/schemas/TranslatedString"
        pricing:
          allOf:
            - description: Pricing information for the app
            - $ref: "#/components/schemas/Pricing"
        components:
          type: array
          items:
            $ref: "#/components/schemas/BaseComponent"
          minItems: 0
        is_beta:
          type: boolean
          description: Flag to indicate if the app is in beta.
          readOnly: true
        deprecated_at:
          type: string
          description: Timestamp when the app version is deprecated
        version:
          type: string
          description: Version of the app that is installed
          readOnly: true

    Configuration:
      description: Configuration of the published app
      allOf:
        - $ref: "#/components/schemas/ConfigurationMetadata"
        - $ref: "#/components/schemas/ConfigurationVersion"

    TranslatedString:
      type: object
      required:
        - de
      properties:
        en:
          type: string
          nullable: true
          description: English translation
        de:
          type: string
          description: German translation

    CallerIdentity:
      type: object
      properties:
        name:
          description: a human readable name of the caller (e.g. user name, token name or email address)
          example: manifest@epilot.cloud
        org_id:
          description: epilot organization id
          type: string
          example: "911690"
        user_id:
          description: epilot user id, when called by a user
          type: string
          example: "11001045"
        token_id:
          description: token id, when called by API token
          type: string
          example: api_5ZugdRXasLfWBypHi93Fk
      required:
        - org_id