openapi: 3.0.1
info:
  title: Service Store Management API
  description: The app's APIs allow you to build a digital distribution platform where
    users can browse, download, and install apps. Apps can be standalone applications,
    connectors, and services. These apps offer a wide range of functionality from
    invoicing and payments to user management and networking. Users can use the APIs
    to discover, download, and manage these applications.
  version: 2.0.0
servers:
- description: The Service Store Management API REST endpoint
  url: https://api.btx.fr.banqup.com/servicemngmt
- description: The Service Store Management API REST endpoint
  url: https://api.btx.eu.banqup.com/servicemngmt
tags:
- name: Application categories
  description: Application category API
- name: Application languages
  description: |
    Application Translations API is designed to make applications more accessible by providing translations for various languages.
    This functionality helps developers ensure their applications cater to a diverse audience, improving user experience across different countries.
- name: Application locations
  description: Application location API
- name: Application media
  description: Application media API
- name: Application permission
  description: Application permission API
- name: Application versions
  description: Versions simplify application updates and ensure that each version
    is correctly set up. The Version object contains essential details about the new
    version, including a manifest, copyright, and release information.
- name: Application brands
  description: Application brand API
- name: Applications
  description: |
    The app object represents a software package that allows users to perform specific tasks. They can cater to diverse business needs within the Banqup platform. There can be various apps, ranging from industry-specific tools to general-purpose applications. Apps can typically be pre-installed on a platform or distributed via a proprietary app store.

    Apps can be targeted to 2 types of audiences: the Banqup consumer and third-party developers who want to integrate with particular applications.
- name: Application space types
  description: Application space type API
- name: Categories
  description: Categories serve as organizational structures grouping similar applications
    based on functionality or use case, making it simpler for users to explore and
    find the kind of apps they are looking for. Categories help in organizing the
    available apps into specific genres or themes.
- name: Sub-categories
  description: Subcategories are used to refine further and narrow down the types
    of apps within a particular main category. While categories group applications
    based on overarching themes or functionalities, sub-categories further segment
    these applications into more specialized niches or user needs. They provide users
    with more specific options based on their preferences or requirements.
- name: Application info localizations
  description: |
    Manage the app metadata that is localized and appears on the Banqup Store.
- name: Application space segments
  description: Application space segment API
paths:
  /v1/applications/{applicationId}/languages:
    post:
      tags:
      - Application languages
      summary: Create application language
      description: 'Assign a language to an application <br/> Scope: store_write,
        store_admin<br/> This Endpoint is part of: service-store-mngmt-service'
      operationId: createAppLanguage
      parameters:
      - name: applicationId
        in: path
        description: The application identifier
        required: true
        schema:
          pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
          type: string
          format: uuid
      requestBody:
        description: Application language to add
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AppLanguageRequest'
            example:
              language: fr-FR
              translation:
                description: Les factures de vente simplifient votre processus de
                  facturation. Créez, envoyez et gérez vos factures de vente sans
                  effort grâce à leur interface conviviale. Suivez les paiements,
                  soyez informé des factures en souffrance et conservez un aperçu
                  clair de vos transactions de vente. Cette application prend en charge
                  différentes devises et taux de taxe, garantissant ainsi la conformité
                  aux réglementations locales. Améliorez l'efficacité de votre facturation
                  avec l'application Factures de vente.
                display_name: Factures de vente
                short_description: Créez, envoyez et gérez facilement vos factures
                  de vente. Suivez les paiements, automatisez les mises à jour et
                  obtenez des informations sur vos ventes.
        required: true
      responses:
        '201':
          description: Created application language
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AppLanguageResponse'
              example:
                id: 00000001-0000-0000-0000-000000000000
                language: fr-FR
                translation:
                  description: Les factures de vente simplifient votre processus de
                    facturation. Créez, envoyez et gérez vos factures de vente sans
                    effort grâce à leur interface conviviale. Suivez les paiements,
                    soyez informé des factures en souffrance et conservez un aperçu
                    clair de vos transactions de vente. Cette application prend en
                    charge différentes devises et taux de taxe, garantissant ainsi
                    la conformité aux réglementations locales. Améliorez l'efficacité
                    de votre facturation avec l'application Factures de vente.
                  display_name: Factures de vente
                  short_description: Créez, envoyez et gérez facilement vos factures
                    de vente. Suivez les paiements, automatisez les mises à jour et
                    obtenez des informations sur vos ventes.
        '409':
          description: Already exists
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ApiErrorProblemDetail'
      security:
      - oauth2:
        - store_write
        - store_admin
  /v1/applications/{applicationId}/locations:
    post:
      tags:
      - Application locations
      summary: Create application location
      description: 'Assign a location to an application <br/> Scope: store_write,
        store_admin<br/> This Endpoint is part of: service-store-mngmt-service'
      operationId: createAppLocation
      parameters:
      - name: applicationId
        in: path
        description: The application identifier
        required: true
        schema:
          pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
          type: string
          format: uuid
      requestBody:
        description: Application location to add
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AppLocationRequest'
            example:
              countryCode: BE
              status: ACTIVE
        required: true
      responses:
        '201':
          description: Created application location
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AppLocationResponse'
              example:
                id: 00000001-0000-0000-0000-000000000000
                countryCode: BE
                status: ACTIVE
        '409':
          description: Already exists
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ApiErrorProblemDetail'
      security:
      - oauth2:
        - store_write
        - store_admin
  /v1/applications/{applicationId}/medias:
    post:
      tags:
      - Application media
      summary: Create application media
      description: 'Assign a media to an application <br/> Scope: store_write, store_admin<br/>
        This Endpoint is part of: service-store-mngmt-service'
      operationId: createAppMedia
      parameters:
      - name: applicationId
        in: path
        description: The application identifier
        required: true
        schema:
          pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
          type: string
          format: uuid
      requestBody:
        content:
          multipart/form-data:
            schema:
              required:
              - displayOrder
              type: object
              properties:
                mediaFile:
                  type: object
                  description: The media file
                  format: binary
                mediaType:
                  type: string
                  description: 'The type of the media. Possible values: IMAGE, VIDEO'
                displayOrder:
                  type: integer
                  description: The order of the media (UI level)
                  format: int32
      responses:
        '201':
          description: Created application media
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AppMediaResponse'
              example:
                id: 00000001-0000-0000-0000-000000000000
                mediaType: IMAGE
                displayOrder: '1'
        '409':
          description: Already exists
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ApiErrorProblemDetail'
      security:
      - oauth2:
        - store_write
        - store_admin
  /v1/applications/{applicationId}/versions:
    post:
      tags:
      - Application versions
      summary: Create application version
      description: 'Create a new application version <br/> Scope: store_write, store_admin<br/>
        This Endpoint is part of: service-store-mngmt-service'
      operationId: createAppVersion
      parameters:
      - name: applicationId
        in: path
        description: The application identifier
        required: true
        schema:
          pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
          type: string
          format: uuid
      requestBody:
        description: Application version to create
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AppVersionRequest'
            example:
              version: 1.0.0
              releaseNote: Initial Sales release notes
              releaseDate: 2023-06-16T13:03:36Z
              manifest:
                serviceAccount: f47c5440-89cb-11ee-b9d1-0242ac120002
                accessManagement:
                  permissions:
                  - resource: space
                    scope: space_read
                  - resource: space
                    scope: space_write
                  - resource: entity
                    scope: entity_read
                additionalScopes:
                  spaceScopes:
                  - valitax_manage_configuration
                  translations: http://app.valitax.com/btx/translations
                frontendModules:
                - name: Purchase
                  type: Application
                  basePath: purchase-invoices
                  supportedDevices:
                  - web
                  - mobile
                  module: invoices
                  moduleUrl: /assets/{version}/micro-frontends/purchase/something.js
                dependencies:
                - namespace: com.unifiedpost.btx
                  name: app-dependency-1
                  minVersion: '1.0'
                  countries:
                  - BE
                  - FR
                - namespace: com.unifiedpost.btx
                  name: app-dependency-2
                  minVersion: '1.2'
                appCallbacks:
                  addUrl: http://addurl.com
                  activationUrl: http://activationurl.com
                  deactivationUrl: http://deactivationurl.com
                  configureUrl: http://configureurl.com
                  removeUrl: http://removeurl.com
                minAssuranceLevels:
                  entity: urn:btx:L2
                  user: urn:btx:L1
                clientConfigurations:
                  data:
                    translationBaseUri: https://translation-base-uri.com
                    formTemplateUri: https://form-template-uri.com
                  accessManagement:
                    permissions:
                    - resource: client
                      scope: client_read
                    - resource: client
                      scope: client_write
                  appCallbacks:
                    clientAddUrl: http://addurl.com
                    clientActivationUrl: http://activationurl.com
                    clientDeactivationUrl: http://deactivationurl.com
                    clientConfigureUrl: http://configureurl.com
                    clientRemoveUrl: http://removeurl.com
                    security:
                    - oauth2: []
              properties:
                prop1: value1
                prop2: value2
              copyright: Copyright 2024 Unifiedpost
              extensions:
              - extensionPoint:
                  name: documentConnectors
                  namespace: com.unifiedpost.btx
                  version: '1.0'
                data:
                  name: peppol
                  foo: bar
                  type: INOUT
                  basePath: https://app.acme.com/connector/choruspro
        required: true
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AppVersionResponse'
              example:
                id: 2aa7c753-6d55-44b6-9b60-06212611cfd6
                version: 1.2.3
                releaseNote: Initial Sales release notes
                releaseDate: 2023-06-16T13:03:36Z
                manifest:
                  accessManagement:
                    permissions:
                    - resource: space
                      scope: space_read
                    - resource: space
                      scope: space_write
                    - resource: entity
                      scope: entity_read
                  additionalScopes:
                    spaceScopes:
                    - valitax_manage_configuration
                    translations: http://app.valitax.com/btx/translations
                  frontendModules:
                  - name: Purchase
                    type: Application
                    basePath: purchase-invoices
                    supportedDevices:
                    - web
                    - mobile
                    module: invoices
                    moduleUrl: /assets/{version}/micro-frontends/purchase/something.js
                  dependencies:
                  - name: orchestration
                    namespace: com.unifiedpost.btx.platform
                    minVersion: '1.0'
                  - name: cross-upload
                    namespace: com.unifiedpost.btx.platform
                    minVersion: '1.0'
                  - name: cross-sales
                    namespace: com.unifiedpost.btx.platform.connectors
                    minVersion: '1.0'
                  appCallbacks:
                    addUrl: http://addurl.com
                    activationUrl: http://activationurl.com
                    deactivationUrl: http://deactivationurl.com
                    configureUrl: http://configureurl.com
                    removeUrl: http://removeurl.com
                  minAssuranceLevels:
                    entity: urn:btx:L2
                    user: urn:btx:L1
                copyright: Copyright 2024 Unifiedpost
                status: VALID
        '409':
          description: Already exists
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ApiErrorProblemDetail'
      security:
      - oauth2:
        - store_write
        - store_admin
  /v1/applications/{applicationId}/brands:
    post:
      tags:
      - Application brands
      summary: Create application brand
      description: 'Assign a brand to an application <br/> Scope: store_write, store_admin<br/>
        This Endpoint is part of: service-store-mngmt-service'
      operationId: createApplicationBrand
      parameters:
      - name: applicationId
        in: path
        description: The application identifier
        required: true
        schema:
          pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
          type: string
          format: uuid
      requestBody:
        description: Space type to add
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ApplicationBrandRequest'
            example:
              brandName: Banqup
        required: true
      responses:
        '201':
          description: Created application brand
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApplicationBrandResponse'
              example:
                id: 00000001-0000-0000-0000-000000000000
                brandName: Banqup
        '409':
          description: Already exists
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ApiErrorProblemDetail'
      security:
      - oauth2:
        - store_write
        - store_admin
  /v1/applications/{applicationId}:
    get:
      tags:
      - Applications
      summary: Get application
      description: 'Retrieve the application <br/> Scope: store_read<br/> This Endpoint
        is part of: service-store-mngmt-service'
      operationId: getApplication
      parameters:
      - name: applicationId
        in: path
        description: The application identifier
        required: true
        schema:
          pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
          type: string
          format: uuid
      responses:
        '200':
          description: Retrieved application
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApplicationResponse'
              example:
                id: 2aa7c753-6d55-44b6-9b60-06212611cfd6
                namespace: com.unifiedpost.btx.documents
                name: sales-invoices
                status: APPROVED
                functionalType: APPLICATION
                audienceType: INTERNAL
        '404':
          description: Not found
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ApiErrorProblemDetail'
      security:
      - oauth2:
        - store_read
    delete:
      tags:
      - Applications
      summary: Delete application
      description: 'Delete the application <br/> Scope: store_write, store_admin<br/>
        This Endpoint is part of: service-store-mngmt-service'
      operationId: deleteApplication
      parameters:
      - name: applicationId
        in: path
        description: The application identifier
        required: true
        schema:
          pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
          type: string
          format: uuid
      responses:
        '204':
          description: Deleted application
        '404':
          description: Not found
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ApiErrorProblemDetail'
      security:
      - oauth2:
        - store_write
        - store_admin
    patch:
      tags:
      - Applications
      summary: Update application field(s)
      description: 'Patch some application field(s) <br/> Scope: store_write, store_admin<br/>
        This Endpoint is part of: service-store-mngmt-service'
      operationId: updateApplication
      parameters:
      - name: applicationId
        in: path
        description: The application identifier
        required: true
        schema:
          pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
          type: string
          format: uuid
      requestBody:
        description: Application patch request in json-patch format
        content:
          application/json-patch+json:
            schema:
              $ref: '#/components/schemas/JsonPatch'
            example:
            - op: replace
              path: /name
              value: new name
        required: true
      responses:
        '200':
          description: Updated/patched application field(s)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApplicationResponse'
              example:
                id: 2aa7c753-6d55-44b6-9b60-06212611cfd6
                namespace: com.unifiedpost.btx.documents
                name: sales-invoices
                status: APPROVED
                functionalType: APPLICATION
                audienceType: INTERNAL
        '404':
          description: Not found
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ApiErrorProblemDetail'
        '409':
          description: Already exists
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ApiErrorProblemDetail'
      security:
      - oauth2:
        - store_write
        - store_admin
  /v1/applications:
    get:
      tags:
      - Applications
      summary: List applications
      description: 'List applications with pagination <br/> Scope: store_admin<br/>
        This Endpoint is part of: service-store-mngmt-service'
      operationId: listApplications
      parameters:
      - name: status
        in: query
        description: Application status
        schema:
          type: string
        example: APPROVED
      - name: page
        in: query
        description: Zero-based page index, cannot be negative, default 0
        schema:
          maximum: 10000
          minimum: 0
          type: integer
          format: int32
          default: 0
        example: 20
      - name: pageSize
        in: query
        description: 'Page size. Minimum 1, maximum: 200, default 20'
        schema:
          maximum: 200
          minimum: 1
          type: integer
          format: int32
          default: 20
        example: 20
      - name: includeTotalElements
        in: query
        description: Return the totalElements number of entries in the response
        schema:
          type: boolean
          default: false
        example: true
      responses:
        '200':
          description: ok
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListApplicationResponse'
              example:
                applications:
                - id: 2aa7c753-6d55-44b6-9b60-06212611cfd6
                  namespace: com.unifiedpost.btx.documents
                  name: sales-invoices
                  status: APPROVED
                  functionalType: APPLICATION
                  audienceType: INTERNAL
                - id: 228cf514-83cc-46ca-aa56-7a627dc777eb
                  namespace: com.unifiedpost.btx.connectors
                  name: cross-peppol
                  status: APPROVED
                  functionalType: CONNECTOR
                  audienceType: PUBLIC
                totalElements: 6
                currentPage: 0
                pageSize: 2
      security:
      - oauth2:
        - store_admin
  /v1/applications/{applicationId}/logo:
    put:
      tags:
      - Applications
      summary: Replace application logo
      description: 'Upload logo to an application <br/> Scope: store_write, store_admin<br/>
        This Endpoint is part of: service-store-mngmt-service'
      operationId: replaceAppLogo
      parameters:
      - name: applicationId
        in: path
        description: The application identifier
        required: true
        schema:
          pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
          type: string
          format: uuid
      requestBody:
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                logoFile:
                  type: object
                  description: The logo file
                  format: binary
      responses:
        '204':
          description: Logo uploaded successfully
      security:
      - oauth2:
        - store_write
        - store_admin
  /v1/applications/{applicationId}/spaceTypes:
    post:
      tags:
      - Application space types
      summary: Create application space type
      description: 'Assign a space type to an application <br/> Scope: store_write,
        store_admin<br/> This Endpoint is part of: service-store-mngmt-service'
      operationId: createApplicationSpaceType
      parameters:
      - name: applicationId
        in: path
        description: The application identifier
        required: true
        schema:
          pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
          type: string
          format: uuid
      requestBody:
        description: Space type to add
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ApplicationSpaceTypeRequest'
            example:
              spaceType: PERSONAL
        required: true
      responses:
        '201':
          description: Created application space type
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApplicationSpaceTypeResponse'
              example:
                id: 00000001-0000-0000-0000-000000000000
                spaceType: BUSINESS
        '409':
          description: Already exists
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ApiErrorProblemDetail'
      security:
      - oauth2:
        - store_write
        - store_admin
  /v1/categories:
    get:
      tags:
      - Categories
      summary: List categories
      description: 'List the categories <br/> Scope: []<br/> This Endpoint is part
        of: service-store-mngmt-service'
      operationId: listCategories
      responses:
        '200':
          description: Listed categories
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListCategoryResponse'
              example:
                categories:
                - id: ac313bfd-1bc2-460a-853e-5102091e52ec
                  name: Purchases
                  description: Purchases main category
                  displayOrder: 1
                  displayName: category.purchases
                  theme: Purchases
                - id: 00751e78-2285-4369-9e04-58f386aa63f6
                  name: Sales
                  description: Sales main category
                  displayOrder: 2
                  displayName: category.sales
                  theme: Sales
  /v1/categories/{categoryId}/subcategories:
    get:
      tags:
      - Sub-categories
      summary: List sub-categories
      description: 'List the sub-categories for a category <br/> Scope: []<br/> This
        Endpoint is part of: service-store-mngmt-service'
      operationId: listSubCategories
      parameters:
      - name: categoryId
        in: path
        description: The category identifier
        required: true
        schema:
          pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
          type: string
          format: uuid
      responses:
        '200':
          description: Listed sub-categories
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListSubCategoryResponse'
              example:
                subcategories:
                - id: 5ccfb15f-1b59-4463-9d4b-ffc181947fe4
                  categoryId: ac313bfd-1bc2-460a-853e-5102091e52ec
                  name: Purchases
                  description: Purchases sub category
                  displayOrder: 1
                  displayName: subcategory.purchases
                  theme: Purchases
  /v2/applications/{applicationId}/infoLocalizations:
    post:
      tags:
      - Application info localizations
      summary: Create application info localization
      description: 'Assign info localization to an application <br/> Scope: store_write,
        store_admin<br/> This Endpoint is part of: service-store-mngmt-service'
      operationId: createInfoLocalization
      parameters:
      - name: applicationId
        in: path
        description: The application identifier
        required: true
        schema:
          pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
          type: string
          format: uuid
      requestBody:
        description: Application info localization to add
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ApplicationInfoLocalizationRequest'
            example:
              locale: en-GB
              displayName: Purchases
              shortDescription: Manage purchase invoices
              description: Purchase invoices helps you manage your purchase invoices
        required: true
      responses:
        '201':
          description: Created application info localization
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApplicationInfoLocalizationResponse'
              example:
                id: 2aa7c753-6d55-44b6-9b60-06212611cfd6
                locale: en-GB
                displayName: Purchases
                shortDescription: Manage purchase invoices
                description: Purchase invoices helps you manage your purchase invoices
        '409':
          description: Already exists
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ApiErrorProblemDetail'
      security:
      - oauth2:
        - store_write
        - store_admin
  /v2/applications:
    post:
      tags:
      - Applications
      summary: Create application V2
      description: 'Create a new application <br/> Scope: store_write, store_admin<br/>
        This Endpoint is part of: service-store-mngmt-service'
      operationId: createApplicationV2
      requestBody:
        description: Application to create
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ApplicationRequest_V2'
            example:
              namespace: com.unifiedpost.btx
              name: test-app
              ownerEntityId: f47c5440-89cb-11ee-b9d1-0242ac120002
              functionalType: CONNECTOR
              audienceType: INTERNAL
        required: true
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApplicationResponse_V2'
              example:
                id: 2aa7c753-6d55-44b6-9b60-06212611cfd6
                namespace: com.unifiedpost.btx.documents
                name: sales-invoices
                status: APPROVED
                functionalType: APPLICATION
                audienceType: INTERNAL
        '409':
          description: Already exists
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ApiErrorProblemDetail'
      security:
      - oauth2:
        - store_write
        - store_admin
  /v2/applications/{applicationId}:
    patch:
      tags:
      - Applications
      summary: Update application V2
      description: 'Patch some application field(s) <br/> Scope: store_admin<br/>
        This Endpoint is part of: service-store-mngmt-service'
      operationId: updateApplicationV2
      parameters:
      - name: applicationId
        in: path
        description: The application identifier
        required: true
        schema:
          pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
          type: string
          format: uuid
      requestBody:
        description: Application to update
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ApplicationPatchRequest_V2'
            example:
              audienceType: INTERNAL
        required: true
      responses:
        '200':
          description: Updated/patched application field(s)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApplicationResponse_V2'
              example:
                id: 2aa7c753-6d55-44b6-9b60-06212611cfd6
                namespace: com.unifiedpost.btx.documents
                name: sales-invoices
                status: APPROVED
                functionalType: APPLICATION
                audienceType: INTERNAL
        '404':
          description: Not found
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ApiErrorProblemDetail'
      security:
      - oauth2:
        - store_admin
  /v2/applications/{applicationId}/spaceSegments:
    post:
      tags:
      - Application space segments
      summary: Create application space segment
      description: 'Assign a space segment to an application <br/> Scope: store_write,
        store_admin<br/> This Endpoint is part of: service-store-mngmt-service'
      operationId: createApplicationSpaceSegment
      parameters:
      - name: applicationId
        in: path
        description: The application identifier
        required: true
        schema:
          pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
          type: string
          format: uuid
      requestBody:
        description: Space segment to add
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ApplicationSpaceSegmentRequest'
            example:
              spaceSegment: CORPORATE
        required: true
      responses:
        '201':
          description: Created application space segment
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApplicationSpaceSegmentResponse'
              example:
                id: 00000001-0000-0000-0000-000000000000
                spaceSegment: CONSUMER
        '409':
          description: Already exists
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ApiErrorProblemDetail'
      security:
      - oauth2:
        - store_write
        - store_admin
  /v2/categories:
    get:
      tags:
      - Categories
      summary: List categories V2
      description: 'List the categories <br/> Scope: []<br/> This Endpoint is part
        of: service-store-mngmt-service'
      operationId: listCategoriesV2
      parameters:
      - name: include
        in: query
        description: What extra data to include in the response.
        explode: false
        schema:
          type: array
          items:
            type: string
            enum:
            - presentation
            - subcategories
        example: subcategories
      responses:
        '200':
          description: Listed categories
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListCategoryResponse_V2'
              example:
                categories:
                - id: ac313bfd-1bc2-460a-853e-5102091e52ec
                  name: Purchases
                  description: Purchases main category
                  presentation:
                    displayOrder: 1
                    theme: Purchases
                    translations:
                      en-GB:
                        name: Purchases
                      fr-FR:
                        name: Achats
                - id: 00751e78-2285-4369-9e04-58f386aa63f6
                  name: Sales
                  description: Sales main category
                  presentation:
                    displayOrder: 2
                    theme: Sales
                    translations:
                      en-GB:
                        name: Sales
                      fr-FR:
                        name: Ventes
  /v2/categories/{categoryId}:
    get:
      tags:
      - Categories
      summary: Get category V2
      description: 'Retrieve the category details <br/> Scope: []<br/> This Endpoint
        is part of: service-store-mngmt-service'
      operationId: getCategoryV2
      parameters:
      - name: categoryId
        in: path
        description: The category identifier
        required: true
        schema:
          pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
          type: string
          format: uuid
      - name: include
        in: query
        description: What extra data to include in the response.
        explode: false
        schema:
          type: array
          items:
            type: string
            enum:
            - presentation
            - subcategories
        example: subcategories
      responses:
        '200':
          description: Retrieved category
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CategoryResponse_V2'
              example:
                id: ac313bfd-1bc2-460a-853e-5102091e52ec
                name: Purchases
                description: Purchases main category
                presentation:
                  displayOrder: 1
                  theme: Purchases
                  translations:
                    en-GB:
                      name: Purchases
                    fr-FR:
                      name: Achats
                subcategories:
                - id: 92655142-1dff-4099-b136-89d9643d06d7
                  name: Purchases1
                  description: Purchases first sub category
                  presentation:
                    displayOrder: 1
                    theme: Purchases
                    translations:
                      en-GB:
                        name: Purchases1
                      fr-FR:
                        name: Achats1
                - id: 192d0bd1-96c6-4433-8dfd-b19251347af3
                  name: Purchases2
                  description: Purchases second sub category
                  presentation:
                    displayOrder: 2
                    theme: Purchases
                    translations:
                      en-GB:
                        name: Purchases2
                      fr-FR:
                        name: Achats2
        '404':
          description: Not found
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ApiErrorProblemDetail'
components:
  schemas:
    AppCategoryResponse:
      required:
      - id
      - subCategoryId
      type: object
      properties:
        id:
          type: string
          description: The unique identifier of the application category
          format: uuid
        subCategoryId:
          type: string
          description: The unique identifier of the sub-category
          format: uuid
      description: List of application categories
    ApiErrorProblemDetail:
      required:
      - error
      - requestId
      - timestamp
      type: object
      properties:
        status:
          type: integer
          format: int32
        error:
          type: string
        requestId:
          type: string
        timestamp:
          type: string
          format: date-time
        type:
          type: string
          format: uri
        title:
          type: string
        detail:
          type: string
        instance:
          type: string
          format: uri
        problems:
          type: array
          items:
            $ref: '#/components/schemas/NestedProblem'
        properties:
          type: object
          additionalProperties:
            type: object
    NestedProblem:
      required:
      - detail
      - error
      - title
      type: object
      properties:
        error:
          type: string
        title:
          type: string
        detail:
          type: string
        type:
          type: string
          format: uri
    AppCategoryRequest:
      required:
      - subCategoryId
      type: object
      properties:
        subCategoryId:
          type: string
          description: The identifier of the application sub-category
          format: uuid
    ListAppCategoryResponse:
      type: object
      properties:
        applicationCategories:
          type: array
          items:
            $ref: '#/components/schemas/AppCategoryResponse'
    AppLanguageResponse:
      required:
      - id
      - language
      type: object
      properties:
        id:
          type: string
          description: The unique identifier of the application language
          format: uuid
        language:
          type: string
          description: The ISO code of the language
        translation:
          type: object
          additionalProperties:
            type: object
            description: The translations
          description: The translations
    AppLanguageRequest:
      type: object
      properties:
        language:
          type: string
          description: The locale of the language
          example: fr-FR
        translation:
          type: object
          additionalProperties:
            type: object
            description: translations
          description: translations
    ListAppLanguageResponse:
      type: object
      properties:
        languages:
          type: array
          items:
            $ref: '#/components/schemas/AppLanguageResponse'
    AppLanguagePatchRequest:
      type: object
      properties:
        translation:
          type: object
          additionalProperties:
            type: object
            description: translations
          description: translations
    AppLocationResponse:
      required:
      - countryCode
      - id
      type: object
      properties:
        id:
          type: string
          description: The unique identifier of the application location
          format: uuid
        countryCode:
          type: string
          description: The country ISO code of the location
        status:
          $ref: '#/components/schemas/LocationStatus'
    LocationStatus:
      type: string
      description: The status of the location
      example: ACTIVE
      enum:
      - ACTIVE
      - INACTIVE
    AppLocationRequest:
      type: object
      properties:
        countryCode:
          pattern: ^[A-Z]{2}
          type: string
          description: The ISO country code of the location
        status:
          $ref: '#/components/schemas/LocationStatus'
    ListAppLocationResponse:
      type: object
      properties:
        locations:
          type: array
          items:
            $ref: '#/components/schemas/AppLocationResponse'
    AppLocationPatchRequest:
      type: object
      properties:
        status:
          $ref: '#/components/schemas/LocationStatus'
    AppMediaResponse:
      required:
      - displayOrder
      - id
      type: object
      properties:
        id:
          type: string
          description: The unique identifier of the application media
          format: uuid
        mediaType:
          $ref: '#/components/schemas/MediaType'
        displayOrder:
          type: integer
          description: The order of the media (UI level)
          format: int32
    MediaType:
      type: string
      description: The type of the media
      example: IMAGE
      enum:
      - VIDEO
      - IMAGE
    ListAppMediaResponse:
      type: object
      properties:
        medias:
          type: array
          items:
            $ref: '#/components/schemas/AppMediaResponse'
    AppMediaPatchRequest:
      type: object
      properties:
        displayOrder:
          type: integer
          description: The order of the media (UI level)
          format: int32
    PermissionResponse:
      type: object
      properties:
        requester:
          type: string
          description: The identifier of the requester who is requesting the permission.
        id:
          type: string
          description: The unique identifier for the permission.
        scope:
          type: string
          description: The scope name associated with the permission.
          example: store_read
        granted:
          type: boolean
          description: Indicates whether the permission is granted or not (true/false).
    PermissionRequest:
      required:
      - permission
      - requester
      type: object
      properties:
        requester:
          pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
          type: string
          description: OIDC subject that identifies the user or service account for
            which the permission is granted.
        permission:
          type: string
          description: The permission (resource scope)
    ListPermissionsResult:
      required:
      - subjects
      type: object
      properties:
        subjects:
          type: array
          items:
            $ref: '#/components/schemas/PermissionsResult'
    PermissionListItem:
      type: object
      properties:
        id:
          type: string
          description: The unique identifier for the permission.
        scope:
          type: string
          description: The scope name associated with the permission.
          example: entity_read
        granted:
          type: boolean
          description: Indicates whether the permission is granted or not (true/false).
      description: the list of permissions
    PermissionsResult:
      required:
      - permissions
      - requester
      type: object
      properties:
        requester:
          type: string
          description: the requester
        permissions:
          type: array
          items:
            $ref: '#/components/schemas/PermissionListItem'
      description: List of permissions
    AppVersionResponse:
      required:
      - id
      - status
      - version
      type: object
      properties:
        id:
          type: string
          description: The unique identifier of the application version
          format: uuid
        version:
          type: string
          description: The version of the application
        releaseNote:
          type: string
          description: The release note of version
        releaseDate:
          type: string
          description: The release date of version
          format: date-time
        manifest:
          type: object
          additionalProperties:
            type: object
            description: The manifest of version
          description: The manifest of version
        copyright:
          type: string
          description: The copyright of version
        status:
          $ref: '#/components/schemas/VersionStatus'
    VersionStatus:
      type: string
      description: The status of the version
      example: VALID
      enum:
      - DRAFT
      - VALID
      - INVALID
    AppVersionRequest:
      required:
      - version
      type: object
      properties:
        releaseNote:
          type: string
          description: The release note of version
        releaseDate:
          type: string
          description: The release date of version
          format: date-time
        manifest:
          type: object
          additionalProperties:
            type: object
            description: The manifest of version
          description: The manifest of version
        properties:
          type: object
          additionalProperties:
            type: object
            description: The properties of version
          description: The properties of version
        copyright:
          type: string
          description: The copyright of version
        extensions:
          type: array
          description: The app extensions
          items:
            $ref: '#/components/schemas/Extension'
        version:
          pattern: \d+(\.\d+){0,2}
          type: string
          description: The version of the application
    Extension:
      required:
      - data
      - extensionPoint
      type: object
      properties:
        extensionPoint:
          $ref: '#/components/schemas/ExtensionPoint'
        data:
          $ref: '#/components/schemas/JsonNode'
      description: The app extensions
    ExtensionPoint:
      required:
      - name
      - namespace
      - version
      type: object
      properties:
        name:
          type: string
          description: The name of the extension point
          example: my_connector
        namespace:
          type: string
          description: The namespace of the extension point
          example: com.unifiedpost.btx
        version:
          type: string
          description: The version of the extension point
          example: '1.0'
      description: The extension point
    JsonNode:
      type: object
      description: The extension data
    AppVersionInfo:
      type: object
      properties:
        id:
          type: string
          description: The unique identifier of the application version
          format: uuid
        version:
          type: string
          description: The version of the application
        releaseDate:
          type: string
          description: The release date of version
          format: date-time
        status:
          $ref: '#/components/schemas/VersionStatus'
      description: List of application versions
    ListAppVersionInfoResponse:
      type: object
      properties:
        versions:
          type: array
          items:
            $ref: '#/components/schemas/AppVersionInfo'
    AppVersionPatchRequest:
      type: object
      properties:
        releaseNote:
          type: string
          description: The release note of version
        releaseDate:
          type: string
          description: The release date of version
          format: date-time
        manifest:
          type: object
          additionalProperties:
            type: object
            description: The manifest of version
          description: The manifest of version
        properties:
          type: object
          additionalProperties:
            type: object
            description: The properties of version
          description: The properties of version
        copyright:
          type: string
          description: The copyright of version
        extensions:
          type: array
          description: The app extensions
          items:
            $ref: '#/components/schemas/Extension'
    ApplicationBrandResponse:
      required:
      - brandName
      - id
      type: object
      properties:
        id:
          type: string
          description: The unique identifier of the brand
          format: uuid
        brandName:
          type: string
          description: The brand name
      description: List of application brands
    ApplicationBrandRequest:
      type: object
      properties:
        brandName:
          type: string
          description: The brand name
    ListApplicationBrandResponse:
      type: object
      properties:
        brands:
          type: array
          items:
            $ref: '#/components/schemas/ApplicationBrandResponse'
    ApplicationResponse:
      required:
      - audienceType
      - functionalType
      - id
      - name
      - namespace
      - status
      type: object
      properties:
        id:
          type: string
          description: The unique identifier of the application
          format: uuid
        namespace:
          type: string
          description: The namespace of the application
          example: com.unifiedpost.btx.connectors
        name:
          type: string
          description: The name of the application
          example: my-app
        status:
          $ref: '#/components/schemas/ApplicationStatus'
        functionalType:
          $ref: '#/components/schemas/FunctionalType'
        audienceType:
          $ref: '#/components/schemas/AudienceType'
    ApplicationStatus:
      type: string
      description: The status of the application
      example: APPROVED
      enum:
      - DRAFT
      - REVIEW
      - APPROVED
      - REFUSED
      - DELETED
    AudienceType:
      type: string
      description: The type of the audience
      example: PUBLIC
      enum:
      - INTERNAL
      - PUBLIC
    FunctionalType:
      type: string
      description: The type of the application
      example: APPLICATION
      enum:
      - CONNECTOR
      - APPLICATION
      - SERVICE
    IdResponse:
      required:
      - id
      type: object
      properties:
        id:
          type: string
          description: The identifier
          format: uuid
    ListApplicationResponse:
      type: object
      properties:
        applications:
          type: array
          items:
            $ref: '#/components/schemas/ApplicationResponse'
        totalElements:
          type: integer
          description: Total number of items in the database that correspond to this
            search criteria
          format: int64
        currentPage:
          type: integer
          description: Current page
          format: int32
        pageSize:
          type: integer
          description: Response page size
          format: int32
    JsonPatch:
      type: object
    ApplicationSpaceTypeResponse:
      required:
      - id
      type: object
      properties:
        id:
          type: string
          description: The unique identifier of the space type
          format: uuid
        spaceType:
          $ref: '#/components/schemas/SpaceType'
      description: List of application space type
    SpaceType:
      type: string
      description: The type of the space
      example: BUSINESS
      enum:
      - BUSINESS
      - PARTNER
      - PERSONAL
    ApplicationSpaceTypeRequest:
      type: object
      properties:
        spaceType:
          $ref: '#/components/schemas/SpaceType'
    ListApplicationSpaceTypeResponse:
      type: object
      properties:
        spaceTypes:
          type: array
          items:
            $ref: '#/components/schemas/ApplicationSpaceTypeResponse'
    CategoryResponse:
      required:
      - description
      - displayName
      - displayOrder
      - id
      - name
      - theme
      type: object
      properties:
        id:
          type: string
          description: The unique identifier of the category
          format: uuid
        name:
          type: string
          description: The name of the category
        description:
          type: string
          description: The description of the category
        displayOrder:
          type: integer
          description: The order of the category (UI level)
          format: int32
        displayName:
          type: string
          description: The translation key of the category
        theme:
          type: string
          description: The theme the category
      description: List of categories
    ListCategoryResponse:
      type: object
      properties:
        categories:
          type: array
          items:
            $ref: '#/components/schemas/CategoryResponse'
    ListSubCategoryResponse:
      type: object
      properties:
        subCategories:
          type: array
          items:
            $ref: '#/components/schemas/SubCategoryResponse'
    SubCategoryResponse:
      required:
      - categoryId
      - description
      - displayName
      - displayOrder
      - id
      - name
      - theme
      type: object
      properties:
        id:
          type: string
          description: The unique identifier of the sub-category
          format: uuid
        categoryId:
          type: string
          description: The unique identifier of the parent category
          format: uuid
        name:
          type: string
          description: The name of the sub-category
        description:
          type: string
          description: The description of the sub-category
        displayOrder:
          type: integer
          description: The order of the sub-category (UI level)
          format: int32
        displayName:
          type: string
          description: The translation key of the category
        theme:
          type: string
          description: The theme the category
      description: List of sub-categories
    ApplicationInfoLocalizationResponse:
      required:
      - displayName
      - id
      - locale
      type: object
      properties:
        id:
          type: string
          description: The unique identifier of the application
          format: uuid
        locale:
          type: string
          description: The locale of the info
          example: en-GB
        displayName:
          type: string
          description: The application's display name
          example: Purchase invoices
        shortDescription:
          type: string
          description: The application's short description
          example: Manage purchase invoices
        description:
          type: string
          description: The application's description
          example: Purchase invoices helps you manage your purchase invoices
    ApplicationInfoLocalizationRequest:
      required:
      - displayName
      type: object
      properties:
        locale:
          type: string
          description: The locale of the info
          example: en-GB
        displayName:
          type: string
          description: The application's display name
          example: Purchase invoices
        shortDescription:
          type: string
          description: The application's short description
          example: Manage purchase invoices
        description:
          type: string
          description: The application's description
          example: Purchase invoices helps you manage your purchase invoices
    ListApplicationInfoLocalizationResponse:
      type: object
      properties:
        infoLocalizations:
          type: array
          items:
            $ref: '#/components/schemas/ApplicationInfoLocalizationResponse'
    ApplicationInfoLocalizationPatchRequest:
      type: object
      properties:
        displayName:
          type: string
          description: The application's display name
          example: Purchase invoices
        shortDescription:
          type: string
          description: The application's short description
          example: Manage purchase invoices
        description:
          type: string
          description: The application's description
          example: Purchase invoices helps you manage your purchase invoices
    ApplicationResponse_V2:
      required:
      - audienceType
      - functionalType
      - id
      - name
      - namespace
      - status
      type: object
      properties:
        id:
          type: string
          description: The unique identifier of the application
          format: uuid
        namespace:
          type: string
          description: The namespace of the application
          example: com.unifiedpost.btx.connectors
        name:
          type: string
          description: The name of the application
          example: my-app
        status:
          $ref: '#/components/schemas/ApplicationStatus'
        functionalType:
          $ref: '#/components/schemas/FunctionalType'
        audienceType:
          $ref: '#/components/schemas/AudienceType'
    ApplicationRequest_V2:
      required:
      - audienceType
      - functionalType
      - name
      - namespace
      - ownerEntityId
      type: object
      properties:
        namespace:
          type: string
          description: The namespace of the application
          example: com.unifiedpost.btx
        name:
          type: string
          description: The name of the application
          example: my-app
        ownerEntityId:
          type: string
          description: The entity identifier
          format: uuid
        functionalType:
          $ref: '#/components/schemas/FunctionalType'
        audienceType:
          $ref: '#/components/schemas/AudienceType'
    ExtensionsChangeAction:
      type: string
      description: The action type of the extensions change
      example: ADD
      enum:
      - ADD
      - REMOVE
      - UPGRADE
    ExtensionsChangedFailureResponse:
      required:
      - applicationId
      - changeAction
      - errorLog
      - retryTimes
      - spaceId
      type: object
      properties:
        spaceId:
          type: string
          description: The unique identifier of the space
          format: uuid
        applicationId:
          type: string
          description: The unique identifier of the application
          format: uuid
        changeAction:
          $ref: '#/components/schemas/ExtensionsChangeAction'
        errorLog:
          type: string
          description: The error log of failure
        retryTimes:
          type: integer
          description: The number of retry times
          format: int32
      description: List of extensions changed failures
    ListExtensionsChangedFailuresResponse:
      type: object
      properties:
        extensionsChangedFailures:
          type: array
          items:
            $ref: '#/components/schemas/ExtensionsChangedFailureResponse'
    ApplicationPatchRequest_V2:
      type: object
      properties:
        audienceType:
          $ref: '#/components/schemas/AudienceType'
    ApplicationSpaceSegmentResponse:
      required:
      - id
      type: object
      properties:
        id:
          type: string
          description: The unique identifier of the space segment
          format: uuid
        spaceSegment:
          type: string
          description: The value can be "ALL" or one of the Space Segments, which
            is referenced in Entity Store API
      description: List of application space segments
    ApplicationSpaceSegmentRequest:
      type: object
      properties:
        spaceSegment:
          type: string
          description: The value can be "ALL" or one of the Space Segments, which
            is referenced in Entity Store API
    ListApplicationSpaceSegmentResponse:
      type: object
      properties:
        spaceSegments:
          type: array
          items:
            $ref: '#/components/schemas/ApplicationSpaceSegmentResponse'
    CategoryPresentation:
      required:
      - displayOrder
      type: object
      properties:
        displayOrder:
          type: integer
          description: The order of the category (UI level)
          format: int32
        theme:
          type: string
          description: The theme of the category
        translations:
          type: object
          additionalProperties:
            type: object
            description: The translations of the category
          description: The translations of the category
      description: The presentation of the category
    CategoryResponse_V2:
      required:
      - description
      - id
      - name
      type: object
      properties:
        id:
          type: string
          description: The unique identifier of the category
          format: uuid
        name:
          type: string
          description: The name of the category
        description:
          type: string
          description: The description of the category
        presentation:
          $ref: '#/components/schemas/CategoryPresentation'
        subcategories:
          type: array
          items:
            $ref: '#/components/schemas/CategoryResponse_V2'
    CategoryRequest_V2:
      required:
      - description
      - name
      type: object
      properties:
        name:
          pattern: ^[a-zA-Z]+
          type: string
          description: The name of the category
        description:
          type: string
          description: The description of the category
        presentation:
          $ref: '#/components/schemas/CategoryPresentation'
    ListCategoryResponse_V2:
      type: object
      properties:
        categories:
          type: array
          items:
            $ref: '#/components/schemas/CategoryResponse_V2'
    CategoryPatchPresentation:
      type: object
      properties:
        displayOrder:
          type: integer
          description: The order of the category (UI level)
          format: int32
        theme:
          type: string
          description: The theme of the category
        translations:
          type: object
          additionalProperties:
            type: object
            description: The translations of the category
          description: The translations of the category
      description: The presentation of the category
    CategoryPatchRequest_V2:
      type: object
      properties:
        description:
          type: string
          description: The description of the category
        presentation:
          $ref: '#/components/schemas/CategoryPatchPresentation'
  securitySchemes:
    oauth2:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: https://api.btx.fr.banqup.com/oauth2/client_credential/gettoken
          scopes:
            info: Scopes are endpoint-specific, see each endpoint for required scope.
        authorizationCode:
          authorizationUrl: https://api.btx.fr.banqup.com/oauth2/auth
          tokenUrl: https://api.btx.fr.banqup.com/oauth2/token
          scopes:
            info: Scopes are endpoint-specific, see each endpoint for required scope.
