> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enterprise.falkordb.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a new FalkorDB cluster



## OpenAPI

````yaml /api-reference/admin-server.json post /api/clusters/
openapi: 3.1.0
info:
  title: FalkorDB Admin API
  description: REST API for managing FalkorDB clusters, backups, and users via KubeBlocks
  version: 1.0.0
  contact:
    name: FalkorDB
    url: https://falkordb.com
    email: support@falkordb.com
servers:
  - url: http://localhost:3000
    description: Development server
security:
  - cookieAuth: []
tags:
  - name: System
    description: System health and info endpoints
  - name: Authentication
    description: User authentication endpoints
  - name: OAuth
    description: OAuth 2.0 sign-in flows
  - name: Users
    description: User management endpoints
  - name: User Profile
    description: Signed-in user profile and password
  - name: Clusters
    description: Cluster management endpoints
  - name: Cluster Operations
    description: 'KubeBlocks OpsRequests: restart, scale, reconfigure, switchover'
  - name: Backups
    description: Backup management endpoints
  - name: Backup Policies
    description: Backup policy management endpoints
  - name: Backup Schedules
    description: Recurring backup schedules
  - name: Backup Repositories
    description: Backup repository management
  - name: Restores
    description: Restore a deployment from a backup
  - name: Settings
    description: System settings endpoints
  - name: RBAC
    description: Role-based access control
  - name: Licensing
    description: License status and activation
  - name: Audit
    description: Audit log endpoints
  - name: Metrics
    description: System, deployment, and pod metrics
  - name: Diagnostics
    description: Health checks, diagnostics, and support packages
  - name: Search
    description: Cross-resource search
paths:
  /api/clusters/:
    post:
      tags:
        - Clusters
      summary: Create a new FalkorDB cluster
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - name
                - namespace
                - spec
              properties:
                name:
                  minLength: 1
                  maxLength: 63
                  pattern: ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$
                  description: >-
                    Must be a valid Kubernetes object name: lowercase letters,
                    numbers, and hyphens; must start and end with a letter or
                    number; max 63 characters.
                  type: string
                namespace:
                  minLength: 1
                  maxLength: 63
                  pattern: ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$
                  description: >-
                    Must be a valid Kubernetes object name: lowercase letters,
                    numbers, and hyphens; must start and end with a letter or
                    number; max 63 characters.
                  type: string
                labels:
                  type: object
                  additionalProperties:
                    type: string
                annotations:
                  type: object
                  additionalProperties:
                    type: string
                spec:
                  additionalProperties: true
                  type: object
                  properties:
                    replicas:
                      minimum: 1
                      type: integer
                    version:
                      minLength: 1
                      type: string
                    componentVersion:
                      minLength: 1
                      type: string
                    topology:
                      anyOf:
                        - type: string
                          enum:
                            - standalone
                        - type: string
                          enum:
                            - replication
                        - type: string
                          enum:
                            - cluster
                    resources:
                      type: object
                      properties:
                        limits:
                          type: object
                          properties:
                            cpu:
                              pattern: ^[0-9]+m?$
                              description: CPU in cores (e.g., '500m' for 0.5 cores)
                              type: string
                            memory:
                              pattern: ^[0-9]+(Mi|Gi)?$
                              description: Memory in bytes (e.g., '512Mi' for 512 MiB)
                              type: string
                        requests:
                          type: object
                          properties:
                            cpu:
                              pattern: ^[0-9]+m?$
                              description: CPU in cores (e.g., '500m' for 0.5 cores)
                              type: string
                            memory:
                              pattern: ^[0-9]+(Mi|Gi)?$
                              description: Memory in bytes (e.g., '512Mi' for 512 MiB)
                              type: string
                    persistence:
                      type: object
                      required:
                        - enabled
                      properties:
                        enabled:
                          type: boolean
                        storageClass:
                          type: string
                        size:
                          type: string
                        accessMode:
                          type: string
                    sentinel:
                      type: object
                      required:
                        - enabled
                      properties:
                        enabled:
                          type: boolean
                        replicas:
                          minimum: 1
                          type: integer
                        componentDefinition:
                          minLength: 1
                          type: string
                        resources:
                          type: object
                          properties:
                            limits:
                              type: object
                              properties:
                                cpu:
                                  pattern: ^[0-9]+m?$
                                  description: CPU in cores (e.g., '500m' for 0.5 cores)
                                  type: string
                                memory:
                                  pattern: ^[0-9]+(Mi|Gi)?$
                                  description: Memory in bytes (e.g., '512Mi' for 512 MiB)
                                  type: string
                            requests:
                              type: object
                              properties:
                                cpu:
                                  pattern: ^[0-9]+m?$
                                  description: CPU in cores (e.g., '500m' for 0.5 cores)
                                  type: string
                                memory:
                                  pattern: ^[0-9]+(Mi|Gi)?$
                                  description: Memory in bytes (e.g., '512Mi' for 512 MiB)
                                  type: string
                        persistence:
                          type: object
                          required:
                            - enabled
                          properties:
                            enabled:
                              type: boolean
                            storageClass:
                              type: string
                            size:
                              type: string
                            accessMode:
                              type: string
                        services:
                          type: array
                          items:
                            type: object
                            required:
                              - name
                              - serviceType
                            properties:
                              name:
                                minLength: 1
                                maxLength: 25
                                pattern: ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$
                                description: >-
                                  Must be a valid Kubernetes object name:
                                  lowercase letters, numbers, and hyphens; must
                                  start and end with a letter or number; max 63
                                  characters.
                                type: string
                              serviceType:
                                anyOf:
                                  - type: string
                                    enum:
                                      - ClusterIP
                                  - type: string
                                    enum:
                                      - NodePort
                                  - type: string
                                    enum:
                                      - LoadBalancer
                              annotations:
                                type: object
                                additionalProperties:
                                  type: string
                              podService:
                                type: boolean
                    sharding:
                      type: object
                      required:
                        - enabled
                      properties:
                        enabled:
                          type: boolean
                        shardCount:
                          minimum: 3
                          type: integer
                        replicas:
                          minimum: 2
                          type: integer
                        resources:
                          type: object
                          properties:
                            limits:
                              type: object
                              properties:
                                cpu:
                                  pattern: ^[0-9]+m?$
                                  description: CPU in cores (e.g., '500m' for 0.5 cores)
                                  type: string
                                memory:
                                  pattern: ^[0-9]+(Mi|Gi)?$
                                  description: Memory in bytes (e.g., '512Mi' for 512 MiB)
                                  type: string
                            requests:
                              type: object
                              properties:
                                cpu:
                                  pattern: ^[0-9]+m?$
                                  description: CPU in cores (e.g., '500m' for 0.5 cores)
                                  type: string
                                memory:
                                  pattern: ^[0-9]+(Mi|Gi)?$
                                  description: Memory in bytes (e.g., '512Mi' for 512 MiB)
                                  type: string
                        persistence:
                          type: object
                          required:
                            - enabled
                          properties:
                            enabled:
                              type: boolean
                            storageClass:
                              type: string
                            size:
                              type: string
                            accessMode:
                              type: string
                        services:
                          type: array
                          items:
                            type: object
                            required:
                              - name
                              - serviceType
                            properties:
                              name:
                                minLength: 1
                                maxLength: 25
                                pattern: ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$
                                description: >-
                                  Must be a valid Kubernetes object name:
                                  lowercase letters, numbers, and hyphens; must
                                  start and end with a letter or number; max 63
                                  characters.
                                type: string
                              serviceType:
                                anyOf:
                                  - type: string
                                    enum:
                                      - ClusterIP
                                  - type: string
                                    enum:
                                      - NodePort
                                  - type: string
                                    enum:
                                      - LoadBalancer
                              annotations:
                                type: object
                                additionalProperties:
                                  type: string
                              podService:
                                type: boolean
                    services:
                      description: >-
                        Extra ClusterIP / NodePort / LoadBalancer services for
                        the main FalkorDB component.
                      type: array
                      items:
                        type: object
                        required:
                          - name
                          - serviceType
                        properties:
                          name:
                            minLength: 1
                            maxLength: 25
                            pattern: ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$
                            description: >-
                              Must be a valid Kubernetes object name: lowercase
                              letters, numbers, and hyphens; must start and end
                              with a letter or number; max 63 characters.
                            type: string
                          serviceType:
                            anyOf:
                              - type: string
                                enum:
                                  - ClusterIP
                              - type: string
                                enum:
                                  - NodePort
                              - type: string
                                enum:
                                  - LoadBalancer
                          annotations:
                            type: object
                            additionalProperties:
                              type: string
                          podService:
                            type: boolean
                    modules:
                      additionalProperties: false
                      type: object
                      properties:
                        falkordb:
                          additionalProperties: false
                          type: object
                          properties:
                            config:
                              additionalProperties: false
                              description: >-
                                FalkorDB configuration key-value map that will
                                be encoded into the FALKORDB_ARGS environment
                                variable.
                              type: object
                              properties:
                                THREAD_COUNT:
                                  minLength: 1
                                  pattern: ^[0-9]+$
                                  description: 'Default: '
                                  type: string
                                CACHE_SIZE:
                                  minLength: 1
                                  pattern: ^[0-9]+$
                                  description: 'Default: 25'
                                  type: string
                                OMP_THREAD_COUNT:
                                  minLength: 1
                                  pattern: ^[0-9]+$
                                  description: 'Default: '
                                  type: string
                                NODE_CREATION_BUFFER:
                                  minLength: 1
                                  pattern: ^[0-9]+$
                                  description: 'Default: 16384'
                                  type: string
                                BOLT_PORT:
                                  minLength: 1
                                  pattern: ^(-1|[0-9]+)$
                                  description: 'Default: -1'
                                  type: string
                                MAX_QUEUED_QUERIES:
                                  minLength: 1
                                  pattern: ^[0-9]+$
                                  description: 'Default: 9007199254740991'
                                  type: string
                                TIMEOUT_MAX:
                                  minLength: 1
                                  pattern: ^[0-9]+$
                                  description: 'Default: 0'
                                  type: string
                                TIMEOUT_DEFAULT:
                                  minLength: 1
                                  pattern: ^[0-9]+$
                                  description: 'Default: 0'
                                  type: string
                                RESULTSET_SIZE:
                                  minLength: 1
                                  pattern: ^(-1|[0-9]+)$
                                  description: 'Default: -1'
                                  type: string
                                QUERY_MEM_CAPACITY:
                                  minLength: 1
                                  pattern: ^[0-9]+$
                                  description: 'Default: 0'
                                  type: string
                                VKEY_MAX_ENTITY_COUNT:
                                  minLength: 1
                                  pattern: ^[0-9]+$
                                  description: 'Default: 100000'
                                  type: string
                                EFFECTS_THRESHOLD:
                                  minLength: 1
                                  pattern: ^[0-9]+$
                                  description: 'Default: 300'
                                  type: string
                                CMD_INFO:
                                  minLength: 1
                                  pattern: ^(no)$
                                  description: 'Default: '
                                  type: string
                                MAX_INFO_QUERIES:
                                  minLength: 1
                                  pattern: ^(1000|[1-9][0-9]{0,2}|0)$
                                  description: 'Default: 1000'
                                  type: string
                                DELTA_MAX_PENDING_CHANGES:
                                  minLength: 1
                                  pattern: ^[0-9]+$
                                  description: 'Default: 10000'
                                  type: string
                                IMPORT_FOLDER:
                                  minLength: 1
                                  pattern: ^/.*$
                                  description: 'Default: /var/lib/FalkorDB/import/'
                                  type: string
                    falkordbArgs:
                      additionalProperties: false
                      description: >-
                        FalkorDB configuration key-value map that will be
                        encoded into the FALKORDB_ARGS environment variable.
                      type: object
                      properties:
                        THREAD_COUNT:
                          minLength: 1
                          pattern: ^[0-9]+$
                          description: 'Default: '
                          type: string
                        CACHE_SIZE:
                          minLength: 1
                          pattern: ^[0-9]+$
                          description: 'Default: 25'
                          type: string
                        OMP_THREAD_COUNT:
                          minLength: 1
                          pattern: ^[0-9]+$
                          description: 'Default: '
                          type: string
                        NODE_CREATION_BUFFER:
                          minLength: 1
                          pattern: ^[0-9]+$
                          description: 'Default: 16384'
                          type: string
                        BOLT_PORT:
                          minLength: 1
                          pattern: ^(-1|[0-9]+)$
                          description: 'Default: -1'
                          type: string
                        MAX_QUEUED_QUERIES:
                          minLength: 1
                          pattern: ^[0-9]+$
                          description: 'Default: 9007199254740991'
                          type: string
                        TIMEOUT_MAX:
                          minLength: 1
                          pattern: ^[0-9]+$
                          description: 'Default: 0'
                          type: string
                        TIMEOUT_DEFAULT:
                          minLength: 1
                          pattern: ^[0-9]+$
                          description: 'Default: 0'
                          type: string
                        RESULTSET_SIZE:
                          minLength: 1
                          pattern: ^(-1|[0-9]+)$
                          description: 'Default: -1'
                          type: string
                        QUERY_MEM_CAPACITY:
                          minLength: 1
                          pattern: ^[0-9]+$
                          description: 'Default: 0'
                          type: string
                        VKEY_MAX_ENTITY_COUNT:
                          minLength: 1
                          pattern: ^[0-9]+$
                          description: 'Default: 100000'
                          type: string
                        EFFECTS_THRESHOLD:
                          minLength: 1
                          pattern: ^[0-9]+$
                          description: 'Default: 300'
                          type: string
                        CMD_INFO:
                          minLength: 1
                          pattern: ^(no)$
                          description: 'Default: '
                          type: string
                        MAX_INFO_QUERIES:
                          minLength: 1
                          pattern: ^(1000|[1-9][0-9]{0,2}|0)$
                          description: 'Default: 1000'
                          type: string
                        DELTA_MAX_PENDING_CHANGES:
                          minLength: 1
                          pattern: ^[0-9]+$
                          description: 'Default: 10000'
                          type: string
                        IMPORT_FOLDER:
                          minLength: 1
                          pattern: ^/.*$
                          description: 'Default: /var/lib/FalkorDB/import/'
                          type: string
                    enterpriseConfig:
                      additionalProperties: false
                      description: >-
                        FalkorDB Enterprise module settings applied through a
                        Reconfiguring OpsRequest after the cluster becomes
                        ready.
                      type: object
                      properties:
                        falkordbe.idle-threshold-ms:
                          minLength: 1
                          pattern: ^(0|[1-9][0-9]*)$
                          description: 'Idle threshold (ms). Default: 0'
                          type: string
                        falkordbe.evict-interval-ms:
                          minLength: 1
                          pattern: ^[1-9][0-9]{3,}$
                          description: 'Eviction interval (ms). Default: 10000'
                          type: string
                        falkordbe.memory-pressure:
                          minLength: 1
                          pattern: ^(0(\.[0-9]+)?|1(\.0+)?)$
                          description: 'Memory pressure watermark. Default: 0'
                          type: string
                        falkordbe.load-evict-budget:
                          minLength: 1
                          pattern: ^(-1|0|[1-9][0-9]*)$
                          description: 'Load eviction budget. Default: 0'
                          type: string
                        falkordbe.ldap_servers:
                          minLength: 1
                          pattern: ^[^"'\\#\s]+$
                          description: 'LDAP servers. Default: '
                          type: string
                        falkordbe.ldap_auth_mode:
                          minLength: 1
                          pattern: ^(bind|search\+bind)$
                          description: 'Authentication mode. Default: bind'
                          type: string
                        falkordbe.ldap_bind_dn_prefix:
                          minLength: 1
                          pattern: ^[^"'\\#\s]+$
                          description: 'Bind DN prefix. Default: '
                          type: string
                        falkordbe.ldap_bind_dn_suffix:
                          minLength: 1
                          pattern: ^[^"'\\#\s]+$
                          description: 'Bind DN suffix. Default: '
                          type: string
                        falkordbe.ldap_search_base:
                          minLength: 1
                          pattern: ^[^"'\\#\s]+$
                          description: 'Search base. Default: '
                          type: string
                        falkordbe.ldap_search_filter:
                          minLength: 1
                          pattern: ^[^"'\\#\s]+$
                          description: 'Search filter. Default: '
                          type: string
                        falkordbe.ldap_search_scope:
                          minLength: 1
                          pattern: ^(base|one|sub)$
                          description: 'Search scope. Default: sub'
                          type: string
                        falkordbe.ldap_search_attribute:
                          minLength: 1
                          pattern: ^[^"'\\#\s]+$
                          description: 'Search attribute. Default: '
                          type: string
                        falkordbe.ldap_search_dn_attribute:
                          minLength: 1
                          pattern: ^[^"'\\#\s]+$
                          description: 'Search DN attribute. Default: '
                          type: string
                        falkordbe.ldap_search_bind_dn:
                          minLength: 1
                          pattern: ^[^"'\\#\s]+$
                          description: 'Search bind DN. Default: '
                          type: string
                        falkordbe.ldap_search_bind_passwd:
                          minLength: 1
                          pattern: ^[^"'\\#\s]+$
                          description: 'Search bind password. Default: '
                          type: string
                        falkordbe.ldap_connection_pool_size:
                          minLength: 1
                          pattern: >-
                            ^([1-9][0-9]{0,2}|[1-7][0-9]{3}|80[0-9]{2}|81[0-8][0-9]|819[0-2])$
                          description: 'Connection pool size. Default: 2'
                          type: string
                        falkordbe.ldap_timeout_connection:
                          minLength: 1
                          pattern: ^(0|[1-9][0-9]*)$
                          description: 'Connection timeout (s). Default: 2'
                          type: string
                        falkordbe.ldap_timeout_ldap_operation:
                          minLength: 1
                          pattern: ^(0|[1-9][0-9]*)$
                          description: 'Operation timeout (s). Default: 2'
                          type: string
                        falkordbe.ldap_failure_detector_interval:
                          minLength: 1
                          pattern: ^(0|[1-9][0-9]*)$
                          description: 'Failure detector interval (s). Default: 1'
                          type: string
                        falkordbe.ldap_use_starttls:
                          minLength: 1
                          pattern: ^(yes|no)$
                          description: 'Use StartTLS. Default: no'
                          type: string
                        falkordbe.ldap_tls_ca_cert_path:
                          minLength: 1
                          pattern: ^[^"'\\#\s]+$
                          description: 'TLS CA certificate path. Default: '
                          type: string
                        falkordbe.ldap_tls_cert_path:
                          minLength: 1
                          pattern: ^[^"'\\#\s]+$
                          description: 'TLS client certificate path. Default: '
                          type: string
                        falkordbe.ldap_tls_key_path:
                          minLength: 1
                          pattern: ^[^"'\\#\s]+$
                          description: 'TLS client key path. Default: '
                          type: string
                        falkordbe.ldap_tls_skip_verify:
                          minLength: 1
                          pattern: ^(yes|no)$
                          description: 'Skip TLS verification. Default: no'
                          type: string
                        falkordbe.ldap_exempted_users_regex:
                          minLength: 1
                          pattern: ^[^"'\\#\s]+$
                          description: 'Exempted users regex. Default: '
                          type: string
                        falkordbe.ldap_return_auth_errors:
                          minLength: 1
                          pattern: ^(yes|no)$
                          description: 'Return authentication errors. Default: no'
                          type: string
                        falkordbe.ldap_acl_fallback_enabled:
                          minLength: 1
                          pattern: ^(yes|no)$
                          description: 'ACL fallback. Default: no'
                          type: string
                        falkordbe.ldap_default_acl_rules:
                          minLength: 1
                          pattern: ^[^"'\\#\s]([^"'\\#\r\n]*[^"'\\#\s])?$
                          description: 'Default ACL rules. Default: on resetpass'
                          type: string
                        falkordbe.ldap_groups_search_base:
                          minLength: 1
                          pattern: ^[^"'\\#\s]+$
                          description: 'Groups search base. Default: '
                          type: string
                        falkordbe.ldap_groups_filter:
                          minLength: 1
                          pattern: ^[^"'\\#\s]+$
                          description: 'Groups filter. Default: objectClass=groupOfNames'
                          type: string
                        falkordbe.ldap_groups_name_attribute:
                          minLength: 1
                          pattern: ^[^"'\\#\s]+$
                          description: 'Group name attribute. Default: cn'
                          type: string
                        falkordbe.ldap_groups_member_attribute:
                          minLength: 1
                          pattern: ^[^"'\\#\s]+$
                          description: 'Group member attribute. Default: member'
                          type: string
                        falkordbe.ldap_groups_rules_attribute:
                          minLength: 1
                          pattern: ^[^"'\\#\s]+$
                          description: 'Group rules attribute. Default: valkeyACL'
                          type: string
                        falkordbe.ldap_group_acl_rules_map:
                          minLength: 1
                          pattern: ^[^"'\\#\s]([^"'\\#\r\n]*[^"'\\#\s])?$
                          description: 'Group to ACL rules map. Default: '
                          type: string
                        falkordbe.ldap_group_acl_user_map:
                          minLength: 1
                          pattern: ^[^"'\\#\s]+$
                          description: 'Group to ACL user map. Default: '
                          type: string
                    externalDomain:
                      minLength: 1
                      maxLength: 253
                      pattern: >-
                        ^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$
                      description: >-
                        DNS domain under which per-pod records are published,
                        e.g. 'db.internal.example.com'. Requires routable pod
                        IPs and an ExternalDNS instance.
                      type: string
                    disableExporter:
                      type: boolean
                    terminationPolicy:
                      anyOf:
                        - type: string
                          enum:
                            - DoNotTerminate
                        - type: string
                          enum:
                            - Delete
                        - type: string
                          enum:
                            - WipeOut
      responses:
        '201':
          description: Default Response
          content:
            application/json:
              schema:
                additionalProperties: true
                type: object
                required:
                  - name
                  - namespace
                  - state
                  - replicas
                  - version
                properties:
                  name:
                    type: string
                  namespace:
                    type: string
                  creationTimestamp:
                    type: string
                  state:
                    anyOf:
                      - type: string
                        enum:
                          - Pending
                      - type: string
                        enum:
                          - Running
                      - type: string
                        enum:
                          - Stopping
                      - type: string
                        enum:
                          - Stopped
                      - type: string
                        enum:
                          - Deleting
                      - type: string
                        enum:
                          - Failed
                      - type: string
                        enum:
                          - Degraded
                      - type: string
                        enum:
                          - Unknown
                  topology:
                    anyOf:
                      - type: string
                        enum:
                          - standalone
                      - type: string
                        enum:
                          - replication
                      - type: string
                        enum:
                          - cluster
                  replicas:
                    type: number
                  version:
                    type: string
                  componentDefinition:
                    type: string
                  resources:
                    type: object
                    properties:
                      limits:
                        type: object
                        properties:
                          cpu:
                            pattern: ^[0-9]+m?$
                            description: CPU in cores (e.g., '500m' for 0.5 cores)
                            type: string
                          memory:
                            pattern: ^[0-9]+(Mi|Gi)?$
                            description: Memory in bytes (e.g., '512Mi' for 512 MiB)
                            type: string
                      requests:
                        type: object
                        properties:
                          cpu:
                            pattern: ^[0-9]+m?$
                            description: CPU in cores (e.g., '500m' for 0.5 cores)
                            type: string
                          memory:
                            pattern: ^[0-9]+(Mi|Gi)?$
                            description: Memory in bytes (e.g., '512Mi' for 512 MiB)
                            type: string
                  persistence:
                    type: object
                    required:
                      - enabled
                    properties:
                      enabled:
                        type: boolean
                      storageClass:
                        type: string
                      size:
                        type: string
                      accessMode:
                        type: string
                  services:
                    type: array
                    items:
                      type: object
                      required:
                        - name
                        - serviceType
                      properties:
                        name:
                          minLength: 1
                          maxLength: 25
                          pattern: ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$
                          description: >-
                            Must be a valid Kubernetes object name: lowercase
                            letters, numbers, and hyphens; must start and end
                            with a letter or number; max 63 characters.
                          type: string
                        serviceType:
                          anyOf:
                            - type: string
                              enum:
                                - ClusterIP
                            - type: string
                              enum:
                                - NodePort
                            - type: string
                              enum:
                                - LoadBalancer
                        annotations:
                          type: object
                          additionalProperties:
                            type: string
                        podService:
                          type: boolean
                  modules:
                    additionalProperties: false
                    type: object
                    properties:
                      falkordb:
                        additionalProperties: false
                        type: object
                        properties:
                          config:
                            additionalProperties: false
                            description: >-
                              FalkorDB configuration key-value map that will be
                              encoded into the FALKORDB_ARGS environment
                              variable.
                            type: object
                            properties:
                              THREAD_COUNT:
                                minLength: 1
                                pattern: ^[0-9]+$
                                description: 'Default: '
                                type: string
                              CACHE_SIZE:
                                minLength: 1
                                pattern: ^[0-9]+$
                                description: 'Default: 25'
                                type: string
                              OMP_THREAD_COUNT:
                                minLength: 1
                                pattern: ^[0-9]+$
                                description: 'Default: '
                                type: string
                              NODE_CREATION_BUFFER:
                                minLength: 1
                                pattern: ^[0-9]+$
                                description: 'Default: 16384'
                                type: string
                              BOLT_PORT:
                                minLength: 1
                                pattern: ^(-1|[0-9]+)$
                                description: 'Default: -1'
                                type: string
                              MAX_QUEUED_QUERIES:
                                minLength: 1
                                pattern: ^[0-9]+$
                                description: 'Default: 9007199254740991'
                                type: string
                              TIMEOUT_MAX:
                                minLength: 1
                                pattern: ^[0-9]+$
                                description: 'Default: 0'
                                type: string
                              TIMEOUT_DEFAULT:
                                minLength: 1
                                pattern: ^[0-9]+$
                                description: 'Default: 0'
                                type: string
                              RESULTSET_SIZE:
                                minLength: 1
                                pattern: ^(-1|[0-9]+)$
                                description: 'Default: -1'
                                type: string
                              QUERY_MEM_CAPACITY:
                                minLength: 1
                                pattern: ^[0-9]+$
                                description: 'Default: 0'
                                type: string
                              VKEY_MAX_ENTITY_COUNT:
                                minLength: 1
                                pattern: ^[0-9]+$
                                description: 'Default: 100000'
                                type: string
                              EFFECTS_THRESHOLD:
                                minLength: 1
                                pattern: ^[0-9]+$
                                description: 'Default: 300'
                                type: string
                              CMD_INFO:
                                minLength: 1
                                pattern: ^(no)$
                                description: 'Default: '
                                type: string
                              MAX_INFO_QUERIES:
                                minLength: 1
                                pattern: ^(1000|[1-9][0-9]{0,2}|0)$
                                description: 'Default: 1000'
                                type: string
                              DELTA_MAX_PENDING_CHANGES:
                                minLength: 1
                                pattern: ^[0-9]+$
                                description: 'Default: 10000'
                                type: string
                              IMPORT_FOLDER:
                                minLength: 1
                                pattern: ^/.*$
                                description: 'Default: /var/lib/FalkorDB/import/'
                                type: string
                  falkordbArgs:
                    additionalProperties: false
                    description: >-
                      FalkorDB configuration key-value map that will be encoded
                      into the FALKORDB_ARGS environment variable.
                    type: object
                    properties:
                      THREAD_COUNT:
                        minLength: 1
                        pattern: ^[0-9]+$
                        description: 'Default: '
                        type: string
                      CACHE_SIZE:
                        minLength: 1
                        pattern: ^[0-9]+$
                        description: 'Default: 25'
                        type: string
                      OMP_THREAD_COUNT:
                        minLength: 1
                        pattern: ^[0-9]+$
                        description: 'Default: '
                        type: string
                      NODE_CREATION_BUFFER:
                        minLength: 1
                        pattern: ^[0-9]+$
                        description: 'Default: 16384'
                        type: string
                      BOLT_PORT:
                        minLength: 1
                        pattern: ^(-1|[0-9]+)$
                        description: 'Default: -1'
                        type: string
                      MAX_QUEUED_QUERIES:
                        minLength: 1
                        pattern: ^[0-9]+$
                        description: 'Default: 9007199254740991'
                        type: string
                      TIMEOUT_MAX:
                        minLength: 1
                        pattern: ^[0-9]+$
                        description: 'Default: 0'
                        type: string
                      TIMEOUT_DEFAULT:
                        minLength: 1
                        pattern: ^[0-9]+$
                        description: 'Default: 0'
                        type: string
                      RESULTSET_SIZE:
                        minLength: 1
                        pattern: ^(-1|[0-9]+)$
                        description: 'Default: -1'
                        type: string
                      QUERY_MEM_CAPACITY:
                        minLength: 1
                        pattern: ^[0-9]+$
                        description: 'Default: 0'
                        type: string
                      VKEY_MAX_ENTITY_COUNT:
                        minLength: 1
                        pattern: ^[0-9]+$
                        description: 'Default: 100000'
                        type: string
                      EFFECTS_THRESHOLD:
                        minLength: 1
                        pattern: ^[0-9]+$
                        description: 'Default: 300'
                        type: string
                      CMD_INFO:
                        minLength: 1
                        pattern: ^(no)$
                        description: 'Default: '
                        type: string
                      MAX_INFO_QUERIES:
                        minLength: 1
                        pattern: ^(1000|[1-9][0-9]{0,2}|0)$
                        description: 'Default: 1000'
                        type: string
                      DELTA_MAX_PENDING_CHANGES:
                        minLength: 1
                        pattern: ^[0-9]+$
                        description: 'Default: 10000'
                        type: string
                      IMPORT_FOLDER:
                        minLength: 1
                        pattern: ^/.*$
                        description: 'Default: /var/lib/FalkorDB/import/'
                        type: string
                  sentinel:
                    type: object
                    required:
                      - enabled
                    properties:
                      enabled:
                        type: boolean
                      replicas:
                        minimum: 1
                        type: integer
                      componentDefinition:
                        minLength: 1
                        type: string
                      resources:
                        type: object
                        properties:
                          limits:
                            type: object
                            properties:
                              cpu:
                                pattern: ^[0-9]+m?$
                                description: CPU in cores (e.g., '500m' for 0.5 cores)
                                type: string
                              memory:
                                pattern: ^[0-9]+(Mi|Gi)?$
                                description: Memory in bytes (e.g., '512Mi' for 512 MiB)
                                type: string
                          requests:
                            type: object
                            properties:
                              cpu:
                                pattern: ^[0-9]+m?$
                                description: CPU in cores (e.g., '500m' for 0.5 cores)
                                type: string
                              memory:
                                pattern: ^[0-9]+(Mi|Gi)?$
                                description: Memory in bytes (e.g., '512Mi' for 512 MiB)
                                type: string
                      persistence:
                        type: object
                        required:
                          - enabled
                        properties:
                          enabled:
                            type: boolean
                          storageClass:
                            type: string
                          size:
                            type: string
                          accessMode:
                            type: string
                      services:
                        type: array
                        items:
                          type: object
                          required:
                            - name
                            - serviceType
                          properties:
                            name:
                              minLength: 1
                              maxLength: 25
                              pattern: ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$
                              description: >-
                                Must be a valid Kubernetes object name:
                                lowercase letters, numbers, and hyphens; must
                                start and end with a letter or number; max 63
                                characters.
                              type: string
                            serviceType:
                              anyOf:
                                - type: string
                                  enum:
                                    - ClusterIP
                                - type: string
                                  enum:
                                    - NodePort
                                - type: string
                                  enum:
                                    - LoadBalancer
                            annotations:
                              type: object
                              additionalProperties:
                                type: string
                            podService:
                              type: boolean
                  sharding:
                    type: object
                    required:
                      - enabled
                    properties:
                      enabled:
                        type: boolean
                      shardCount:
                        minimum: 3
                        type: integer
                      replicas:
                        minimum: 2
                        type: integer
                      resources:
                        type: object
                        properties:
                          limits:
                            type: object
                            properties:
                              cpu:
                                pattern: ^[0-9]+m?$
                                description: CPU in cores (e.g., '500m' for 0.5 cores)
                                type: string
                              memory:
                                pattern: ^[0-9]+(Mi|Gi)?$
                                description: Memory in bytes (e.g., '512Mi' for 512 MiB)
                                type: string
                          requests:
                            type: object
                            properties:
                              cpu:
                                pattern: ^[0-9]+m?$
                                description: CPU in cores (e.g., '500m' for 0.5 cores)
                                type: string
                              memory:
                                pattern: ^[0-9]+(Mi|Gi)?$
                                description: Memory in bytes (e.g., '512Mi' for 512 MiB)
                                type: string
                      persistence:
                        type: object
                        required:
                          - enabled
                        properties:
                          enabled:
                            type: boolean
                          storageClass:
                            type: string
                          size:
                            type: string
                          accessMode:
                            type: string
                      services:
                        type: array
                        items:
                          type: object
                          required:
                            - name
                            - serviceType
                          properties:
                            name:
                              minLength: 1
                              maxLength: 25
                              pattern: ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$
                              description: >-
                                Must be a valid Kubernetes object name:
                                lowercase letters, numbers, and hyphens; must
                                start and end with a letter or number; max 63
                                characters.
                              type: string
                            serviceType:
                              anyOf:
                                - type: string
                                  enum:
                                    - ClusterIP
                                - type: string
                                  enum:
                                    - NodePort
                                - type: string
                                  enum:
                                    - LoadBalancer
                            annotations:
                              type: object
                              additionalProperties:
                                type: string
                            podService:
                              type: boolean
                  externalDomain:
                    minLength: 1
                    maxLength: 253
                    pattern: >-
                      ^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$
                    description: >-
                      DNS domain under which per-pod records are published, e.g.
                      'db.internal.example.com'. Requires routable pod IPs and
                      an ExternalDNS instance.
                    type: string
                  labels:
                    type: object
                    additionalProperties:
                      type: string
                  annotations:
                    type: object
                    additionalProperties:
                      type: string
                  status:
                    type: object
                    properties:
                      state:
                        type: string
                      ready:
                        type: boolean
                      replicas:
                        type: number
                      readyReplicas:
                        type: number
                      conditions:
                        type: array
                        items:
                          type: object
                          required:
                            - type
                            - status
                          properties:
                            type:
                              type: string
                            status:
                              type: string
                            reason:
                              type: string
                            message:
                              type: string
                            lastTransitionTime:
                              type: string
        '500':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  statusCode:
                    type: number
                  error:
                    type: string
                  message:
                    type: string
      security:
        - cookieAuth: []
components:
  securitySchemes:
    cookieAuth:
      type: apiKey
      in: cookie
      name: token
      description: JWT token stored in HTTP-only cookie

````