> ## 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. # Copy points to devices > Creates a copy of each listed point on each listed device. A copy is a point on another device that mirrors its source. Use copies to show the same point on a virtual device or on another equipment device without ingesting it twice. The request creates one copy for each pair of a point in `pointIds` and a device in `deviceIds`. The number of pairs, `pointIds` times `deviceIds`, cannot be more than 50. Repeated ids are merged. The request is refused with `400` before anything is written when: * A point or a device is not in this building. * A point is not an origin point. A copy cannot be copied. * The points sit on more than one device. * A device is the device or the base device of one of the points. * A device is not an origin or a virtual device. The response has one item per pair, in the order of the request. Each item has a `status`: * `CREATED`: The copy was created. * `COPY_EXISTS`: The pair already has a copy. Nothing was created, so you can repeat a request safely. * `LIMIT_REACHED`: The source point already has the maximum of 200 copies. Each `CREATED` item also carries the `_id` of the new copy, so you can read or delete it right away. The same `_id` appears in [List point copies](https://docs.kodelabs.com/products/kode-api/api-reference/points/list-point-copies.md). > [!NOTE] > > Copies are written device by device, not as one atomic change. If a later step fails, the response is `400`, copies that were already written stay, and the rest are not attempted. List the copies, then send the request again. Pairs that already exist return `COPY_EXISTS`. Deleting the source point deletes its copies. See [Delete a point](https://docs.kodelabs.com/products/kode-api/api-reference/points/delete-a-point.md). ## OpenAPI ````yaml /openapi/kode-api.yaml post /api/v1/buildings/{buildingId}/points/copies 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}/points/copies: post: tags: - Points summary: Copy points to devices description: Creates a copy of each listed point on each listed device. operationId: copyPointsToDevices parameters: - $ref: '#/components/parameters/BuildingId' requestBody: content: application/json: schema: $ref: '#/components/schemas/CopyPointsRequest' required: true responses: '200': description: One item per point and device pair, in request order. content: application/json: schema: $ref: '#/components/schemas/CopyPointsResult' '400': description: >- The body is not valid, or a rule above refused it. For example a list is empty or has more than 50 ids, there are more than 50 pairs, an id contains whitespace or control characters, an id is not in the building, or a device is the device of its own source. '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '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: CopyPointsRequest: type: object required: - pointIds - deviceIds properties: pointIds: type: array items: type: string pattern: '[^\p{C}\p{Z}]{1,128}' maxLength: 128 maxItems: 50 minItems: 1 deviceIds: type: array items: type: string pattern: '[^\p{C}\p{Z}]{1,128}' maxLength: 128 maxItems: 50 minItems: 1 CopyPointsResult: type: object properties: items: type: array items: $ref: '#/components/schemas/Item3' Item3: type: object properties: pointId: type: string deviceId: type: string status: type: string _id: type: string 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. NotFound: description: The resource does not exist or is not assigned to the service account. 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.