v1

latestOpenAPI 3.1.02026-07-24239123562.1 KB

Embedded Data Apps

Install, update, or uninstall Data Apps

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.

post/v1/dataapps/apps/manage

Request body

idstring uuid

Data App ID. Required for UPDATE and DELETE actions.

namestring

Data App name. Required for CREATE and UPDATE actions.

slugstring

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

versionstring

Semantic version to install (e.g., "v2.1.0"). Required for CREATE and UPDATE actions.

namespacestring

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

providerIdsstring[]

Provider IDs to associate with this Data App on install.

Response

All operations completed successfully.