Skip to content
SupaCloud Docs
Select themeSelect language

`GET /api/marketplace/installs` — list the workspace's marketplace installs.

GET
/api/marketplace/installs
curl --request GET \
  --url https://example.com/api/marketplace/installs

Responses

Section titled “Responses”

200

Section titled “200”
Media typeapplication/json
Array<object>

A marketplace item installed into a workspace. Tracks the installed version, the local resources created (app, scripts, workflows), and the manifest hash for drift detection.

object
auto_update
required

#1060 — when armed, the auto-update tick pulls newer non-withdrawn versions through the SAME service path the Update button uses, so it can skip none of that path’s signature / review-gate / licence checks.

boolean
auto_update_checked_at

Last tick attempt for this install (success or failure), so “never checked” and “checked and found nothing” stay distinguishable.

string | null format: date-time
auto_update_last_error

Why the last auto-update attempt failed; None after a success. Without this a blocked review gate or a lapsed licence would leave the install silently pinned to an old version while the toggle still reads “on”.

string | null
id
required
string format: uuid
install_manifest_sha256
required
string
installed_app_id
string | null format: uuid
installed_at
required
string format: date-time
installed_by
string | null format: uuid
installed_node_type_ids
required
Array<string>
installed_script_ids
required
Array<string>
installed_workflow_ids
required
Array<string>
item_id
required
string format: uuid
latest_version
string | null
resource_mappings
update_available

Issue #351 — whether a newer NON-withdrawn version than the installed one exists (the “update available” signal), and that latest version string. Populated only by list_installs_by_workspace via correlated subqueries; absent in other projections that select INSTALL_COLUMNS, where #[sqlx(default)] supplies false / None.

boolean
updated_at
required
string format: date-time
version_id
required
string format: uuid
workspace_id
required
string format: uuid
Examplegenerated
[
  {
    "auto_update": true,
    "auto_update_checked_at": "2026-04-15T12:00:00Z",
    "auto_update_last_error": "example",
    "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "install_manifest_sha256": "example",
    "installed_app_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "installed_at": "2026-04-15T12:00:00Z",
    "installed_by": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "installed_node_type_ids": [
      "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
    ],
    "installed_script_ids": [
      "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
    ],
    "installed_workflow_ids": [
      "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
    ],
    "item_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "latest_version": "example",
    "resource_mappings": "example",
    "update_available": true,
    "updated_at": "2026-04-15T12:00:00Z",
    "version_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "workspace_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
  }
]