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

# Request a cell move

> Starts moving a space to another cell. A Niadra operations route.



## OpenAPI

````yaml openapi/en/control.json POST /v1/spaces/{space_id}/placement
openapi: 3.1.0
info:
  title: Niadra control API
  version: '1'
  description: >-
    Tenants, projects, sources, keys, people, configuration and usage. It never
    receives customer content.
servers:
  - url: https://control.api.niadra.com
security: []
paths:
  /v1/spaces/{space_id}/placement:
    post:
      summary: Request a cell move
      description: >-
        Starts moving a space to another cell: the cells copy and write to both
        sides until the move completes. Used by Niadra operations.


        **Authentication.** Operator credential (`X-Niadra-Operator-Token`).
        Used by Niadra operations, not by your code.
      operationId: request_move_v1_spaces__space_id__placement_post
      parameters:
        - in: path
          name: space_id
          required: true
          schema:
            format: uuid
            title: Space Id
            type: string
          example: 0192f0a0-3d4e-7f50-8b61-7c8d9e0f1a23
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/MoveRequest'
            example:
              cell_id: cell-2
              reason: Rebalance before the October peak
        required: true
      responses:
        '202':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MoveOut'
              example:
                move_id: 0192f7c3-7182-7394-8fa5-1a2b3c4d5e67
                from_cell: cell-1
                to_cell: cell-2
                requested_at: '2026-09-23T02:00:00Z'
                status: copying
                completed_at: null
          description: The move, copying.
        '422':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
          description: The request does not match the contract.
      security:
        - operatorToken: []
components:
  schemas:
    MoveRequest:
      additionalProperties: false
      properties:
        cell_id:
          title: Cell Id
          type: string
        reason:
          maxLength: 1000
          minLength: 3
          title: Reason
          type: string
      required:
        - cell_id
        - reason
      title: MoveRequest
      type: object
    MoveOut:
      additionalProperties: false
      properties:
        completed_at:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          title: Completed At
        from_cell:
          title: From Cell
          type: string
        move_id:
          format: uuid
          title: Move Id
          type: string
        requested_at:
          format: date-time
          title: Requested At
          type: string
        status:
          $ref: '#/components/schemas/MoveStatus'
        to_cell:
          title: To Cell
          type: string
      required:
        - move_id
        - from_cell
        - to_cell
        - status
        - requested_at
      title: MoveOut
      type: object
    Problem:
      additionalProperties: false
      description: RFC 9457 problem details; `code` comes from the versioned error catalog.
      properties:
        code:
          title: Code
          type: string
        detail:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Detail
        request_id:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          title: Request Id
        status:
          title: Status
          type: integer
        title:
          title: Title
          type: string
        type:
          default: about:blank
          title: Type
          type: string
      required:
        - title
        - status
        - code
      title: Problem
      type: object
    MoveStatus:
      enum:
        - copying
        - completed
      title: MoveStatus
      type: string
  securitySchemes:
    operatorToken:
      type: apiKey
      in: header
      name: X-Niadra-Operator-Token

````