---
title: "Install, update, or uninstall Data Apps"
method: POST
path: "/v1/dataapps/apps/manage"
tags: ["Embedded Data Apps"]
---

# Install, update, or uninstall Data Apps

`POST /v1/dataapps/apps/manage`

Perform one or more install, update, or uninstall operations on embedded Data Apps. Submit an array of operations to manage which Data Apps are enabled in your organization. This endpoint supports automated governance workflows from CI/CD pipelines, GitHub Actions, or ServiceNow.

## Request body

- object[]
  - `id` string, uuid — Data App ID. Required for UPDATE and DELETE actions.
  - `name` string — Data App name. Required for CREATE and UPDATE actions.
  - `slug` string — Data App slug identifier. Required for CREATE and UPDATE actions.
  - `type` 'CONTAINER' — The type of data app. Always "CONTAINER".
  - `deploymentType` 'SERVER' — Deployment model: SERVER (ECS container, iFrame).
  - `version` string — Semantic version to install (e.g., "v2.1.0"). Required for CREATE and UPDATE actions.
  - `namespace` string — Artifact namespace (e.g., "common"). Required for CREATE and UPDATE actions.
  - `action` 'CREATE' | 'UPDATE' | 'DELETE', required — The operation to perform: CREATE (install), UPDATE (modify), or DELETE (uninstall).
  - `labels` object[] — Labels for EARS access control. Determines which users can see and use this Data App.
    - `name` string, required — Label name (e.g., "department", "environment").
    - `value` string, required — Label value (e.g., "research", "production").
  - `providerIds` string[] — Provider IDs to associate with this Data App on install.

## Response `200`

All operations completed successfully.

## Other responses

- `400` — Validation error. Common causes: missing required fields (action, version, namespace, slug, or name for CREATE/UPDATE), or invalid field values.
- `403` — Data App management is not enabled for this organization.
- `503` — Data App management service is temporarily unavailable. Retry with backoff.

---

[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/revisions/0205e2bace53/schema)