terraform-provider-stackgen

sg_apps (Data Source)

⚠️ Experimental — Lists applications from the Guild deployment catalog. Use optional installation to filter installed (configured) or installable (available) apps. When provider workspace_id is set, the list is scoped to that workspace.

Example Usage

data "sg_apps" "installed" {
  installation = "configured"
}

output "installed_app_names" {
  value = [for a in data.sg_apps.installed.apps : a.app_name]
}

output "installed_app_remote_runners" {
  value = {
    for a in data.sg_apps.installed.apps : a.app_name => a.remote_runners
  }
}

Schema

Optional

• installation (String) Filter by installation state: configured (installed only) or available (catalog apps not yet configured). Omit to return all catalog apps with configured on each item.

Read-Only

• apps (Attributes List) Applications from the Guild deployment catalog. (see below for nested schema)

Nested Schema for apps

Read-Only:

• app_name (String) Unique application identifier (slug).
• app_token (String, Sensitive) Secure token for the app to authenticate with the control plane (present when configured).
• app_version (String) Installed or catalog version.
• attached_workflows (List of String) Legacy operator-attached Guild workflow names.
• category (String) Application category label from the catalog.
• configured (Boolean) True when the app is installed and configured for the current owner.
• description (String) Application description from the catalog.
• display_name (String) Human-readable application name.
• enabled (Boolean) Whether this installed app is visible on the app rail.
• id (String) Server-assigned installation UUID when configured.
• installed_at (String) RFC3339 timestamp when the app was installed.
• integrations (List of String) Tenant Guild integration names bound to this app installation.
• mcp_url (String) Streamable HTTP MCP endpoint URL when advertised by this app.
• remote_runners (List of String) Remote runner IDs attached to this app installation.
• status (String) Installation status when configured.
• updated_at (String) RFC3339 timestamp of the last configuration update.
• workflow_assignments (Attributes List) Purpose-scoped custom workflow assignments for the installation. (see below for nested schema)
• workflow_purposes (Attributes List) Manifest-declared replaceable purposes and provisioned default workflows. (see below for nested schema)

Nested Schema for apps.workflow_assignments

Read-Only:

• is_default (Boolean) Whether this workflow is the default for its purpose.
• purpose (String) App-declared purpose ID.
• workflow_name (String) Assigned approved Guild workflow name.

Nested Schema for apps.workflow_purposes

Read-Only:

• purpose (String) Machine-readable workflow purpose ID declared by the app manifest.
• workflow_name (String) Provisioned default workflow name for this purpose.