---
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`

## Request

- Base URL: `https://api.tetrascience.com`
- URL: `https://api.tetrascience.com/v1/dataapps/apps/{id}/labels`
- Auth: API key in header `ts-auth-token` and API key in header `x-org-slug`

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.dev/tetrascience/apis/data-ai-workspace-api.md) - [All operations](https://skmtc.dev/tetrascience/apis/data-ai-workspace-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tetrascience/apis/data-ai-workspace-api/revisions/99f3b2ac0b83?raw)