Coder · Schema

Template

Developer ToolsRemote DevelopmentCloud Development EnvironmentsAI AgentsInfrastructureWorkspaces

Properties

Name Type Description
active_user_count integer ActiveUserCount is set to -1 when loading.
active_version_id string
activity_bump_ms integer
allow_user_autostart boolean AllowUserAutostart and AllowUserAutostop are enterprise-only. Their values are only used if your license is entitled to use the advanced template scheduling feature.
allow_user_autostop boolean
allow_user_cancel_workspace_jobs boolean
autostart_requirement object
autostop_requirement object AutostopRequirement and AutostartRequirement are enterprise features. Its value is only used if your license is entitled to use the advanced template scheduling feature.
build_time_stats object
cors_behavior object
created_at string
created_by_id string
created_by_name string
default_ttl_ms integer
deleted boolean
deprecated boolean
deprecation_message string
description string
disable_module_cache boolean DisableModuleCache disables the use of cached Terraform modules during provisioning.
display_name string
failure_ttl_ms integer FailureTTLMillis, TimeTilDormantMillis, and TimeTilDormantAutoDeleteMillis are enterprise-only. Their values are used if your license is entitled to use the advanced template scheduling feature.
icon string
id string
max_port_share_level object
name string
organization_display_name string
organization_icon string
organization_id string
organization_name string
provisioner string
require_active_version boolean RequireActiveVersion mandates that workspaces are built with the active template version.
time_til_dormant_autodelete_ms integer
time_til_dormant_ms integer
updated_at string
use_classic_parameter_flow boolean
View JSON Schema on GitHub

JSON Schema

coder-template-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://coder.com/schemas/codersdk-template.json",
  "title": "Template",
  "$defs": {
    "codersdk.CORSBehavior": {
      "type": "string",
      "enum": [
        "simple",
        "passthru"
      ]
    },
    "codersdk.TemplateAutostartRequirement": {
      "type": "object",
      "properties": {
        "days_of_week": {
          "type": "array",
          "description": "DaysOfWeek is a list of days of the week in which autostart is allowed\nto happen. If no days are specified, autostart is not allowed.",
          "items": {
            "type": "string",
            "enum": [
              "monday",
              "tuesday",
              "wednesday",
              "thursday",
              "friday",
              "saturday",
              "sunday"
            ]
          }
        }
      }
    },
    "codersdk.TemplateAutostopRequirement": {
      "type": "object",
      "properties": {
        "days_of_week": {
          "type": "array",
          "description": "DaysOfWeek is a list of days of the week on which restarts are required.\nRestarts happen within the user's quiet hours (in their configured\ntimezone). If no days are specified, restarts are not required. Weekdays\ncannot be specified twice.\n\nRestarts will only happen on weekdays in this list on weeks which line up\nwith Weeks.",
          "items": {
            "type": "string",
            "enum": [
              "monday",
              "tuesday",
              "wednesday",
              "thursday",
              "friday",
              "saturday",
              "sunday"
            ]
          }
        },
        "weeks": {
          "type": "integer",
          "description": "Weeks is the number of weeks between required restarts. Weeks are synced\nacross all workspaces (and Coder deployments) using modulo math on a\nhardcoded epoch week of January 2nd, 2023 (the first Monday of 2023).\nValues of 0 or 1 indicate weekly restarts. Values of 2 indicate\nfortnightly restarts, etc."
        }
      }
    },
    "codersdk.TemplateBuildTimeStats": {
      "type": "object",
      "additionalProperties": {
        "$ref": "#/$defs/codersdk.TransitionStats"
      }
    },
    "codersdk.TransitionStats": {
      "type": "object",
      "properties": {
        "p50": {
          "type": "integer",
          "example": 123
        },
        "p95": {
          "type": "integer",
          "example": 146
        }
      }
    },
    "codersdk.WorkspaceAgentPortShareLevel": {
      "type": "string",
      "enum": [
        "owner",
        "authenticated",
        "organization",
        "public"
      ]
    }
  },
  "type": "object",
  "properties": {
    "active_user_count": {
      "type": "integer",
      "description": "ActiveUserCount is set to -1 when loading."
    },
    "active_version_id": {
      "type": "string",
      "format": "uuid"
    },
    "activity_bump_ms": {
      "type": "integer"
    },
    "allow_user_autostart": {
      "type": "boolean",
      "description": "AllowUserAutostart and AllowUserAutostop are enterprise-only. Their\nvalues are only used if your license is entitled to use the advanced\ntemplate scheduling feature."
    },
    "allow_user_autostop": {
      "type": "boolean"
    },
    "allow_user_cancel_workspace_jobs": {
      "type": "boolean"
    },
    "autostart_requirement": {
      "$ref": "#/$defs/codersdk.TemplateAutostartRequirement"
    },
    "autostop_requirement": {
      "description": "AutostopRequirement and AutostartRequirement are enterprise features. Its\nvalue is only used if your license is entitled to use the advanced template\nscheduling feature.",
      "allOf": [
        {
          "$ref": "#/$defs/codersdk.TemplateAutostopRequirement"
        }
      ]
    },
    "build_time_stats": {
      "$ref": "#/$defs/codersdk.TemplateBuildTimeStats"
    },
    "cors_behavior": {
      "$ref": "#/$defs/codersdk.CORSBehavior"
    },
    "created_at": {
      "type": "string",
      "format": "date-time"
    },
    "created_by_id": {
      "type": "string",
      "format": "uuid"
    },
    "created_by_name": {
      "type": "string"
    },
    "default_ttl_ms": {
      "type": "integer"
    },
    "deleted": {
      "type": "boolean"
    },
    "deprecated": {
      "type": "boolean"
    },
    "deprecation_message": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "disable_module_cache": {
      "type": "boolean",
      "description": "DisableModuleCache disables the use of cached Terraform modules during\nprovisioning."
    },
    "display_name": {
      "type": "string"
    },
    "failure_ttl_ms": {
      "type": "integer",
      "description": "FailureTTLMillis, TimeTilDormantMillis, and TimeTilDormantAutoDeleteMillis are enterprise-only. Their\nvalues are used if your license is entitled to use the advanced\ntemplate scheduling feature."
    },
    "icon": {
      "type": "string"
    },
    "id": {
      "type": "string",
      "format": "uuid"
    },
    "max_port_share_level": {
      "$ref": "#/$defs/codersdk.WorkspaceAgentPortShareLevel"
    },
    "name": {
      "type": "string"
    },
    "organization_display_name": {
      "type": "string"
    },
    "organization_icon": {
      "type": "string"
    },
    "organization_id": {
      "type": "string",
      "format": "uuid"
    },
    "organization_name": {
      "type": "string",
      "format": "url"
    },
    "provisioner": {
      "type": "string",
      "enum": [
        "terraform"
      ]
    },
    "require_active_version": {
      "type": "boolean",
      "description": "RequireActiveVersion mandates that workspaces are built with the active\ntemplate version."
    },
    "time_til_dormant_autodelete_ms": {
      "type": "integer"
    },
    "time_til_dormant_ms": {
      "type": "integer"
    },
    "updated_at": {
      "type": "string",
      "format": "date-time"
    },
    "use_classic_parameter_flow": {
      "type": "boolean"
    }
  }
}