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

# Create Inventory Cluster



## OpenAPI

````yaml https://api.primeintellect.ai/openapi.json post /api/admin/inventory/clusters
openapi: 3.1.0
info:
  title: PI API
  version: 0.1.0
servers:
  - url: https://api.primeintellect.ai
security: []
paths:
  /api/admin/inventory/clusters:
    post:
      tags:
        - admin-inventory
      summary: Create Inventory Cluster
      operationId: create_inventory_cluster_api_admin_inventory_clusters_post
      parameters:
        - name: dryRun
          in: query
          required: false
          schema:
            type: boolean
            title: Dryrun
            default: false
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ClusterMutationRequest'
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericResponse_MutationResult_'
        '401':
          description: Authorization failed
        '403':
          description: Insufficient permissions
        '422':
          description: Invalid request data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - HTTPBearer: []
components:
  schemas:
    ClusterMutationRequest:
      properties:
        name:
          anyOf:
            - type: string
            - type: 'null'
          title: Name
        slug:
          anyOf:
            - type: string
            - type: 'null'
          title: Slug
        internalSlug:
          anyOf:
            - type: string
            - type: 'null'
          title: Internalslug
        displayName:
          anyOf:
            - type: string
            - type: 'null'
          title: Displayname
        status:
          anyOf:
            - $ref: '#/components/schemas/InventoryClusterStatusEnum'
            - type: 'null'
        vaultSshCaEnabled:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Vaultsshcaenabled
        liquidCompute:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Liquidcompute
        listedPrimeResell:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Listedprimeresell
        securityScanEnabled:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Securityscanenabled
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
        comments:
          anyOf:
            - type: string
            - type: 'null'
          title: Comments
        tags:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Tags
        siteId:
          anyOf:
            - type: string
            - type: 'null'
          title: Siteid
        tenantId:
          anyOf:
            - type: string
            - type: 'null'
          title: Tenantid
        clusterId:
          anyOf:
            - type: string
            - type: 'null'
          title: Clusterid
        identity:
          anyOf:
            - type: object
            - type: 'null'
          title: Identity
        commercial:
          anyOf:
            - type: object
            - type: 'null'
          title: Commercial
        network:
          anyOf:
            - type: object
            - type: 'null'
          title: Network
        storage:
          anyOf:
            - type: object
            - type: 'null'
          title: Storage
        operations:
          anyOf:
            - type: object
            - type: 'null'
          title: Operations
        access:
          anyOf:
            - type: object
            - type: 'null'
          title: Access
        additional:
          anyOf:
            - type: object
            - type: 'null'
          title: Additional
      additionalProperties: false
      type: object
      title: ClusterMutationRequest
      description: >-
        Cluster create/update. All fields optional (partial update); create
        validates

        `name` in the service. JSON buckets are persisted as-is (trusted from
        the form).
    GenericResponse_MutationResult_:
      properties:
        data:
          anyOf:
            - $ref: '#/components/schemas/MutationResult'
            - type: 'null'
          description: Response data
        status:
          anyOf:
            - type: string
            - type: 'null'
          title: Status
          description: Response status
      type: object
      title: GenericResponse[MutationResult]
    ErrorResponse:
      properties:
        errors:
          items:
            $ref: '#/components/schemas/ErrorDetail'
          type: array
          title: Errors
      type: object
      required:
        - errors
      title: ErrorResponse
    InventoryClusterStatusEnum:
      type: string
      enum:
        - PLANNED
        - ACTIVE
        - DECOMMISSIONING
        - DECOMMISSIONED
        - OFFLINE
      title: InventoryClusterStatusEnum
    MutationResult:
      properties:
        operationId:
          type: string
          title: Operationid
        targetId:
          anyOf:
            - type: string
            - type: 'null'
          title: Targetid
        targetName:
          anyOf:
            - type: string
            - type: 'null'
          title: Targetname
        message:
          type: string
          title: Message
        created:
          anyOf:
            - type: integer
            - type: 'null'
          title: Created
        updated:
          anyOf:
            - type: integer
            - type: 'null'
          title: Updated
        assigned:
          anyOf:
            - type: integer
            - type: 'null'
          title: Assigned
        detached:
          anyOf:
            - type: integer
            - type: 'null'
          title: Detached
        retired:
          anyOf:
            - type: integer
            - type: 'null'
          title: Retired
      type: object
      required:
        - operationId
        - message
      title: MutationResult
    ErrorDetail:
      properties:
        param:
          type: string
          title: Param
        details:
          type: string
          title: Details
      type: object
      required:
        - param
        - details
      title: ErrorDetail
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````