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

> ## Agent Instructions
> FalkorDB is a graph database that speaks the Redis protocol. Queries are issued as OpenCypher through the GRAPH.QUERY and GRAPH.RO_QUERY commands, not over Bolt or a SQL connection.
> FalkorDB implements a subset of OpenCypher with proprietary extensions. Do not assume Neo4j-only syntax or procedures are available — check /cypher/cypher-support and /cypher/known-limitations before using a clause.
> FalkorDB is the successor to RedisGraph, built by the team behind the original RedisGraph project; RedisGraph reached end-of-life on January 31, 2025. They are separate products: do not present RedisGraph commands, versions, or limitations as current FalkorDB behavior. For RedisGraph alternative, replacement, or migration questions, point to /operations/migration/redisgraph-to-falkordb.
> Use the official clients listed in /getting-started/clients rather than generic Redis or Neo4j drivers, and prefer the language the user is already working in.
> Configuration parameters are set with GRAPH.CONFIG SET or at startup; cite the exact parameter name from /getting-started/configuration rather than inventing one.
> This site covers four products: FalkorDB (core), FalkorDB Cloud, FalkorDB Enterprise, and the GraphRAG SDK. Name which one an answer applies to, since setup and operations differ.

# Which shard of a sharded deployment owns which hash slots, the cluster's state, and any slots left open by a move that didn't finish

> Which shard of a sharded deployment owns which hash slots, the cluster's state, and any slots left open by a move that didn't finish. Read by a short read-only Job in the deployment's namespace, so a read takes a few seconds; a read from the last 10 seconds is reused.



## OpenAPI

````yaml /enterprise/api-reference/admin-server.json get /api/clusters/{clusterName}/slots
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:3001
    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}/slots:
    get:
      tags:
        - Cluster Operations
      summary: >-
        Which shard of a sharded deployment owns which hash slots, the cluster's
        state, and any slots left open by a move that didn't finish
      description: >-
        Which shard of a sharded deployment owns which hash slots, the cluster's
        state, and any slots left open by a move that didn't finish. Read by a
        short read-only Job in the deployment's namespace, so a read takes a few
        seconds; a read from the last 10 seconds is reused.
      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
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                required:
                  - state
                  - readAt
                  - shards
                  - otherPrimaries
                  - unassigned
                  - openSlots
                properties:
                  state:
                    type: string
                  readAt:
                    format: date-time
                    type: string
                  shards:
                    type: array
                    items:
                      type: object
                      required:
                        - name
                        - ranges
                        - count
                      properties:
                        name:
                          type: string
                        primary:
                          type: object
                          required:
                            - pod
                            - nodeId
                          properties:
                            pod:
                              type: string
                            nodeId:
                              type: string
                        ranges:
                          type: array
                          items:
                            description: An inclusive range of hash slots, [start, end].
                            type: array
                            items:
                              - minimum: 0
                                type: integer
                              - minimum: 0
                                type: integer
                            additionalItems: false
                            minItems: 2
                            maxItems: 2
                        count:
                          type: integer
                  otherPrimaries:
                    type: array
                    items:
                      type: object
                      required:
                        - nodeId
                        - address
                        - ranges
                        - count
                      properties:
                        nodeId:
                          type: string
                        address:
                          type: string
                        ranges:
                          type: array
                          items:
                            description: An inclusive range of hash slots, [start, end].
                            type: array
                            items:
                              - minimum: 0
                                type: integer
                              - minimum: 0
                                type: integer
                            additionalItems: false
                            minItems: 2
                            maxItems: 2
                        count:
                          type: integer
                  unassigned:
                    type: array
                    items:
                      description: An inclusive range of hash slots, [start, end].
                      type: array
                      items:
                        - minimum: 0
                          type: integer
                        - minimum: 0
                          type: integer
                      additionalItems: false
                      minItems: 2
                      maxItems: 2
                  openSlots:
                    type: array
                    items:
                      type: object
                      required:
                        - slot
                        - direction
                      properties:
                        slot:
                          type: integer
                        direction:
                          anyOf:
                            - type: string
                              enum:
                                - migrating
                            - type: string
                              enum:
                                - importing
                        shard:
                          type: string
                        peerShard:
                          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
        '503':
          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

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.