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

# Detach points from a virtual device

> Takes points off a virtual device. Origin points return to their base device. Copies are deleted.

> [!WARNING]
>
> A copy cannot go back to a base device, so detaching a copy deletes it. Copies are listed in `deletedCopies`. This cannot be undone.

Every point in `pointIds` must be on this virtual device. The request is all or nothing. If any id is not on the device, nothing changes.

The response has `detached`, the ids of origin points returned to their base device, and `deletedCopies`, the ids of copies that were deleted. The order of ids in both lists is not defined.

Repeating a request that already succeeded returns `400`, because the points are no longer on the device.

Schedule references move back to the base device after the detach, so they can lag behind the response.


## OpenAPI

````yaml /openapi/kode-api.yaml post /api/v1/buildings/{buildingId}/virtual-devices/{virtualDeviceId}/points/batch-delete
openapi: 3.1.0
info:
  title: KODE API
  version: 1.0.0
  summary: Programmatic access to KODE OS resources and operations.
  description: >
    Use the KODE API to work with buildings, data sources, connectors, devices,
    points, virtual devices,

    timeseries data, schedules, the ontology, templating, mass writes, spaces,
    space assignments, tenants, meters, users, actions,

    and AssetOps work orders.
  license:
    name: Proprietary
    identifier: LicenseRef-Proprietary
servers:
  - url: https://api.kodelabs.com/kodeos
    description: KODE API
security:
  - bearerAuth: []
tags:
  - name: Authentication
    description: OAuth 2.0 discovery, token, and revocation endpoints.
  - name: Buildings
    description: Buildings and their areas.
  - name: Data sources
    description: Data sources connected to a building.
  - name: Devices
    description: Devices and their points.
  - name: Points
    description: Point queries and point writes.
  - name: Timeseries
    description: Current and historical point values.
  - name: Actions
    description: Actions exposed by building data sources.
  - name: Work orders
    description: AssetOps work orders, lookups, comments, and attachments.
  - name: Connectors
    description: KODE API connectors and the devices and points ingested through them.
  - name: Schedules
    description: Schedules discovered on building data sources.
  - name: Templating
    description: Apply ontology templates to groups of points.
  - name: Virtual devices
    description: Virtual devices that group points from other devices.
  - name: Ontology
    description: Canonical types, fields, units, and connections of the KODE ontology.
  - name: Users
    description: Users of the organization and their app access.
  - name: Mass write
    description: Write values to many points across buildings, and follow each run.
  - name: Spaces
    description: Levels and space units of a building, and the meters located in them.
  - name: Space assignments
    description: Assign tenants to leasable spaces of a building for a period.
  - name: Tenants
    description: Tenants of a building, the people or companies that lease its spaces.
  - name: Meters
    description: >-
      Meters of a building, their space assignments, parent and child links, and
      readings.
paths:
  /api/v1/buildings/{buildingId}/virtual-devices/{virtualDeviceId}/points/batch-delete:
    post:
      tags:
        - Virtual devices
      summary: Detach points from a virtual device
      description: >-
        Takes points off a virtual device. Origin points return to their base
        device. Copies are deleted.
      operationId: detachPointsFromVirtualDevice
      parameters:
        - $ref: '#/components/parameters/BuildingId'
        - description: ID of virtual device
          name: virtualDeviceId
          in: path
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VirtualDevicePointsRequest'
        required: true
      responses:
        '200':
          description: The points that were detached and the copies that were deleted.
          content: {}
        '400':
          description: >-
            The body is not valid, or a point cannot be detached. For example
            `pointIds` is empty or has more than 200 ids, a point is not on this
            virtual device, an id is not a point of this building, or the base
            device of a point no longer exists.
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          description: >-
            No virtual device with this id exists in the building. An id of a
            real device, a malformed id, and a virtual device of another
            building also return `404`.
        '429':
          $ref: '#/components/responses/TooManyRequests'
components:
  parameters:
    BuildingId:
      name: buildingId
      in: path
      required: true
      description: Building identifier from List buildings.
      schema:
        type: string
      example: 67c960faffaa42223163099e
  schemas:
    VirtualDevicePointsRequest:
      type: object
      required:
        - pointIds
      properties:
        pointIds:
          type: array
          items:
            type: string
            pattern: '[^\p{C}\p{Z}]{1,128}'
            maxLength: 128
          maxItems: 200
          minItems: 1
  responses:
    Unauthorized:
      description: The access token is missing, invalid, or expired. Request a new token.
    Forbidden:
      description: The service account lacks permission for this building or operation.
    TooManyRequests:
      description: >-
        A rate-limit window is exhausted. Wait, then retry with increasing
        delays.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >
        Paste an access token from [Create an access
        token](/products/kode-api/api-reference/authentication/create-an-access-token).
        Tokens expire, so request a new one if you receive `401`.

````

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