> ## 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.

# Set the desired total replicas and/or shard count (HorizontalScaling)



## OpenAPI

````yaml /api-reference/admin-server.json post /api/clusters/{clusterName}/ops/horizontal-scale
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/{clusterName}/ops/horizontal-scale:
    post:
      tags:
        - Cluster Operations
      summary: Set the desired total replicas and/or shard count (HorizontalScaling)
      parameters:
        - schema:
            minLength: 1
            type: string
          in: query
          name: namespace
          required: true
          description: namespace is required
        - schema:
            type: string
          in: path
          name: clusterName
          required: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                replicas:
                  minimum: 1
                  description: Desired total number of replicas for the component
                  type: integer
                shardCount:
                  minimum: 3
                  description: >-
                    Desired total number of shards (sharded topology only,
                    minimum 3)
                  type: integer
                componentName:
                  default: falkordb
                  type: string
      responses:
        '202':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                required:
                  - message
                  - opsName
                  - clusterName
                  - type
                properties:
                  message:
                    type: string
                  opsName:
                    description: Name of the created OpsRequest resource
                    type: string
                  clusterName:
                    type: string
                  type:
                    type: string
                  phase:
                    type: string
        '400':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  statusCode:
                    type: number
                  error:
                    type: string
                  message:
                    type: string
        '404':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  statusCode:
                    type: number
                  error:
                    type: string
                  message:
                    type: string
        '500':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  statusCode:
                    type: number
                  error:
                    type: string
                  message:
                    type: string
components:
  securitySchemes:
    cookieAuth:
      type: apiKey
      in: cookie
      name: token
      description: JWT token stored in HTTP-only cookie

````