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

# Manage Channels and Locations

> List, create and edit Channels and Locations, then assign them to a Screen.

## Channel or Location?

A **Channel** selects content for Screens. A **Location** identifies where a Screen is installed, with a timezone and optional address. A Location does not publish content.

## Before you start

Use the [Postman setup](https://docs.layarva.com/developers/platform-quickstart.md): `platform_base` is `https://api.layarva.com/api/platform/v1/workspaces/YOUR_WORKSPACE_ID`, with your Platform key in **Authorization → Bearer Token**.

For POST, PATCH and DELETE, use **Body → raw → JSON**, `Content-Type: application/json` and a new [Idempotency-Key](https://docs.layarva.com/developers/platform-request-keys.md) for each new change. GET needs no body or operation key.

Choose the relevant permissions: `channels.read`, `channels.create`, `channels.update`, `channels.delete`, and `locations.read`, `locations.create`, `locations.update`, `locations.delete`. Assigning them to a Screen needs `screens.update`.

## Step 1: List or find a Channel

Send **GET** `{{platform_base}}/channels?limit=25`. Search by name with `/channels?q=Lobby&limit=25`.

Save the chosen item's `id` as `channel_id`. If `page.nextCursor` is not null, get the next page using `after`; see [pagination](https://docs.layarva.com/developers/platform-quickstart.md#list-resources).

## Step 2: Create a Channel if needed

Send **POST** `{{platform_base}}/channels`:

```json theme={null}
{
  "name": "Lobby",
  "description": "Welcome and promotional content"
}
```

The response is **201 Created**. Save `data.id` as `channel_id`.

This creates the destination, not its content. Follow [Playlist → Ready → Publish](https://docs.layarva.com/developers/platform-playlists-publication.md) to release content. Do not send `playlistId` or `playlistVersionId` in a Channel create/edit request.

## Step 3: Edit the Channel

Send **PATCH** `{{platform_base}}/channels/{{channel_id}}`:

```json theme={null}
{
  "name": "Main lobby",
  "description": "Ground-floor displays"
}
```

Include only details you want to change. Confirm with **GET** `/channels/{{channel_id}}`.

## Step 4: List or create a Location

Send **GET** `{{platform_base}}/locations?limit=25`, or search with `/locations?q=Lobby&limit=25`.

For a new Location, send **POST** `{{platform_base}}/locations`:

```json theme={null}
{
  "name": "Ground-floor lobby",
  "timezone": "Asia/Jakarta",
  "address": "Ground floor, reception area"
}
```

`name` and `timezone` are required. Save `data.id` as `location_id`. Use a valid timezone such as `Asia/Jakarta`, not `GMT+7`.

Coordinates are optional. If used, supply both `expectedLatitude` and `expectedLongitude`; optionally set `geofenceRadiusMeters`. To remove coordinates, set both values to `null`.

## Step 5: Edit the Location

Send **PATCH** `{{platform_base}}/locations/{{location_id}}`:

```json theme={null}
{
  "address": "Ground floor, next to the entrance"
}
```

Confirm with **GET** `/locations/{{location_id}}`.

## Step 6: Assign them to an existing Screen

Send **PATCH** `{{platform_base}}/screens/{{screen_id}}`:

```json theme={null}
{
  "channelId": "{{channel_id}}",
  "locationId": "{{location_id}}"
}
```

All IDs must belong to the key's workspace. Follow the [Screen guide](https://docs.layarva.com/developers/platform-screens.md) to create or pair a new Screen.

## Delete only when no longer in use

Send **DELETE** `/channels/{{channel_id}}` or `/locations/{{location_id}}` with `{}`. If you receive `409 resource_in_use`, review and change dependent assignments first; do not repeatedly retry deletion. Queue-managed resources are protected.

## Related guides

* [Create a Playlist and publish](https://docs.layarva.com/developers/platform-playlists-publication.md)
* [Create and pair Screens](https://docs.layarva.com/developers/platform-screens.md)
* [API errors](https://docs.layarva.com/developers/error-codes.md)


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