Spacelift · JSON Structure
Spacelift Stack Structure
JSON structure documentation for a Spacelift infrastructure stack object
Type: object
Properties: 0
Infrastructure as CodeFinOpsDevOpsPlatform EngineeringTerraformGitOps
Spacelift Stack Structure is a JSON Structure definition published by Spacelift.
Meta-schema:
JSON Structure
{
"title": "Spacelift Stack Structure",
"description": "JSON structure documentation for a Spacelift infrastructure stack object",
"type": "object",
"fields": [
{"name": "id", "type": "string", "required": false, "description": "Unique stack identifier"},
{"name": "name", "type": "string", "required": false, "description": "Human-readable stack name"},
{"name": "description", "type": "string", "required": false, "description": "Optional stack description"},
{"name": "createdAt", "type": "string", "format": "date-time", "required": false, "description": "Creation timestamp"},
{"name": "administrative", "type": "boolean", "required": false, "description": "Whether stack has admin privileges"},
{"name": "labels", "type": "array", "items": {"type": "string"}, "required": false, "description": "Labels for organization and policy targeting"},
{"name": "repository", "type": "string", "required": false, "description": "Source control repository (org/repo)"},
{"name": "branch", "type": "string", "required": false, "description": "Git branch tracked by this stack"},
{"name": "projectRoot", "type": "string", "required": false, "description": "Root directory for IaC code within the repository"},
{"name": "provider", "type": "string", "required": false, "description": "VCS provider type (GITHUB, GITLAB, BITBUCKET, etc.)"},
{
"name": "vendorConfig",
"type": "object",
"required": false,
"description": "IaC tool-specific configuration",
"fields": [
{
"name": "terraform",
"type": "object",
"required": false,
"description": "Terraform-specific configuration",
"fields": [
{"name": "version", "type": "string", "description": "Terraform version"},
{"name": "workspace", "type": "string", "description": "Terraform workspace name"},
{"name": "useSmartSanitization", "type": "boolean", "description": "Smart sanitization flag"}
]
},
{
"name": "pulumi",
"type": "object",
"required": false,
"description": "Pulumi-specific configuration",
"fields": [
{"name": "loginURL", "type": "string", "description": "Pulumi backend URL"},
{"name": "stackName", "type": "string", "description": "Pulumi stack name"}
]
}
]
},
{"name": "state", "type": "string", "required": false, "description": "Current stack state (CONFIRMED, FAILED, FINISHED, PLANNING, etc.)"},
{"name": "space", "type": "string", "required": false, "description": "Spacelift space this stack belongs to"},
{"name": "workerPool", "type": "string", "required": false, "nullable": true, "description": "Worker pool ID (null = public workers)"},
{"name": "driftDetection", "type": "boolean", "required": false, "description": "Whether drift detection is enabled"},
{"name": "autoApply", "type": "boolean", "required": false, "description": "Whether approved plans auto-apply"},
{"name": "lockedAt", "type": "string", "format": "date-time", "required": false, "nullable": true, "description": "Timestamp when stack was locked"},
{"name": "lockedBy", "type": "string", "required": false, "nullable": true, "description": "User who locked the stack"}
]
}