---
title: "Link devices to a vehicle"
method: POST
path: "/v2/organisations/{organisation_id}/devices/link-to-vehicle"
tags: ["Gateway GRPC"]
---

# Link devices to a vehicle

`POST /v2/organisations/{organisation_id}/devices/link-to-vehicle`

## Request

- Base URL: `https://api.cautio.in` (the document declares no server; this is the origin it was published from)
- URL: `https://api.cautio.in/v2/organisations/{organisation_id}/devices/link-to-vehicle`
- Auth: HTTP bearer

## Path parameters

- `organisation_id` string, required

## Request body

- LinkDevicesToVehicleRequestDto
  - `items` DeviceVehicleLinkDto[], required: List of device-vehicle links
    - `device_number` string, required: Device Number
    - `plate_number` string, required: Vehicle Plate Number

## Response `200`

Device link result, including row errors for partial failures

- LinkDevicesToVehicleResponseDto
  - `data` LinkDevicesToVehicleResponseDataDto, required
    - `success` boolean, required: Whether all requested links succeeded
    - `errors` DeviceErrorDetailDto[]: Per-row errors for partial failures
      - `code` number, required: Error code
      - `message` string, required: Error message
      - `field` string: Field with the error
      - `index` number: Request item index

---

[API](https://skmtc.dev/cautio/apis/cautio-api.md) - [All operations](https://skmtc.dev/cautio/apis/cautio-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cautio/apis/cautio-api/revisions/214e6d1d2b6c?raw)