---
title: "Get Data App details"
method: GET
path: "/v1/dataapps/apps/{id}"
tags: ["Data Apps"]
---

# Get Data App details

`GET /v1/dataapps/apps/{id}`

## Request

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

Retrieves complete details of a single installed Data App, including metadata, deployment configuration, platform requirements, assigned labels, and associated providers.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `includePrereleases` boolean

## Response `200`

OK

- DataApp
  - `id` string, uuid
  - `name` string
  - `description` string
  - `url` string: If type is CONNECTED then the url to the external running application
  - `iconUrl` string
  - `type` string: The type of data app. Must be either "CONNECTED" or "CONTAINER"
  - `artifactType` 'CONTAINER' | 'SERVERLESS': Internal artifact type stored in the database
  - `deploymentType` 'SERVER' | 'SERVERLESS': Deployment model: SERVER (ECS container, iFrame) or SERVERLESS (Module Federation remote loaded via ArMS dist/ tree).
  - `slug` string
  - `version` string
  - `otherVersions` string[]
  - `running` boolean: Whether the container data app is running
  - `disabled` boolean: Whether the container data app is intentionally stopped (its underlying connector's desired ECS task count is 0). Distinct from `running: false` caused by startup/health issues. Not applicable to serverless data apps.
  - `namespace` string: The namespace of the data app
  - `platformRequirements` object[]
    - `type` 'ids' | 'tetraflow' | 'ai-workflow', required
    - `namespace` string, required
    - `slug` string, required
    - `version` string, required
  - `serviceRequirements` object[]
    - `type` 'ais', required
    - `minVersion` string, required
    - `maxVersion` string
  - `supportedPlatformVersion` object: The supported platform version range for this data app
    - `minVersion` string
    - `maxVersion` string
  - `artifactLabels` object[]
    - `name` string
    - `value` string
  - `labels` object[]
    - `name` string
    - `value` string
  - `providers` DataAppProvider[]
    - `id` string
    - `name` string
    - `orgSlug` string
    - `type` string
    - `iconUrl` string
    - `updatedAt` string, date-time
    - `createdAt` string, date-time
    - `updatedBy` string
    - `createdBy` string
    - `secrets` DataAppProviderSecret[]
      - `name` string
      - `value` string
      - `type` string
      - `required` boolean
      - `arn` string
      - `envName` string

## Other responses

- `400`: Bad Request
- `404`: Not Found

---

[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)