---
title: "Update Data App labels for access control"
method: PUT
path: "/v1/dataapps/apps/{id}/labels"
tags: ["Data Apps"]
---

# Update Data App labels for access control

`PUT /v1/dataapps/apps/{id}/labels`

Replaces all labels assigned to a Data App. Labels drive EARS (Entitlement and Access Rights Service) access control policies — use them to control which users and teams can see and interact with a Data App. Pass an empty array to clear all labels.

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `labels` object[], required — Complete set of labels to assign. Replaces any previously assigned labels.
    - `name` string, required — Label name (e.g., "department", "environment").
    - `value` string, required — Label value (e.g., "research", "production").

## Response `200`

Labels updated successfully.

- object
  - `success` boolean

## Other responses

- `400` — Invalid request format or label configuration.
- `404` — Data App not found.
- `500` — Internal Server Error

---

[API](https://skmtc.net/tetrascience/apis/tetra-data-lake.md) · [All operations](https://skmtc.net/tetrascience/apis/tetra-data-lake/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tetrascience/tetra-data-lake/versions/0205e2bace53/schema)