> ## 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. # Attach points to a virtual device > Moves points from their pseudo device onto a virtual device. > [!WARNING] > > Attaching moves a point. It keeps its `id` and its trend data, but its modeling is reset, including canonical type, measurement, precision and unit. Attach first, then apply modeling. Only origin points on pseudo devices can be attached. The point's current device is read from the point. A copy, a point on a real device, and a point on a different virtual device are refused with `400`. To show a point of a real device on a virtual device, use [Copy points to devices](https://docs.kodelabs.com/products/kode-api/api-reference/points/copy-points-to-devices.md). The request is checked as a whole before anything moves. The points are then moved one source device at a time. If one device fails, the devices before it stay attached and the rest are not attempted. Repeat the request: points already on the virtual device are skipped and listed in `skipped`. The response has `attached`, the ids of the points that were moved, and `skipped`, a list of `pointId` and `reason` for the points that were already on the device. The order of ids in `attached` is not defined. ## OpenAPI ````yaml /openapi/kode-api.yaml post /api/v1/buildings/{buildingId}/virtual-devices/{virtualDeviceId}/points 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: post: tags: - Virtual devices summary: Attach points to a virtual device description: Moves points from their pseudo device onto a virtual device. operationId: attachPointsToVirtualDevice 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 attached and the points that were skipped. content: {} '400': description: >- The body is not valid, or a point cannot be attached. For example `pointIds` is empty or has more than 200 ids, an id is not a point of this building, a point is a copy, or a point is not on a pseudo device or on this virtual device. '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.