---
title: "Link a device to a channel or bundle override."
method: POST
path: "/device/"
tags: ["devices"]
---

# Link a device to a channel or bundle override.

`POST /device/`

## Request

- Base URL: `https://api.capgo.app`
- URL: `https://api.capgo.app/device/`
- Auth: API key in header `x-api-key`

Assign a device to a specific channel or bundle override so that device stops following the default channel.

## Request body

- DeviceLink
  - `app_id` string, required
  - `device_id` string, required
  - `version_id` string
  - `channel` string

## Response `200`

Device override accepted.

- StatusResponse
  - `status` string, required

## Other responses

- `400`: The request body or query parameters were invalid.
- `401`: The API key is missing, invalid, or expired.
- `403`: The API key is valid but lacks the required scope or org access.
- `429`: Too many requests. Back off and retry later.
- `500`: Unexpected Capgo server error.

---

[API](https://skmtc.dev/capgo/apis/capgo-public-api.md) · [All operations](https://skmtc.dev/capgo/apis/capgo-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/capgo/apis/capgo-public-api/revisions/8496acb7a95b?raw)