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

## Request

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

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' | 'SERVERLESS': Deployment model: SERVER (ECS container, iFrame) or SERVERLESS (Module Federation remote loaded via ArMS dist/ tree). Defaults to SERVER for backward compatibility; clients installing SERVERLESS data-apps must send the value explicitly.
  - `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.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)