Method postTemplateByOrganization

coderd/templates.go:183–521

Create a new template in an organization. Returns a single template. @Summary Create template by organization @ID create-template-by-organization @Security CoderSessionToken @Accept json @Produce json @Tags Templates @Param request body codersdk.CreateTemplateRequest true "Request body" @Param orga

(rw http.ResponseWriter, r *http.Request)

// @Success 200 {object} codersdk.Template
// @Router /api/v2/organizations/{organization}/templates [post]
func (api *API) postTemplateByOrganization(rw http.ResponseWriter, r *http.Request) {
	var (
		ctx                                = r.Context()
		portSharer                         = *api.PortSharer.Load()
		createTemplate                     codersdk.CreateTemplateRequest
		organization                       = httpmw.OrganizationParam(r)
		apiKey                             = httpmw.APIKey(r)
		auditor                            = *api.Auditor.Load()
		templateAudit, commitTemplateAudit = audit.InitRequest[database.Template](rw, &audit.RequestParams{
			Audit:          auditor,
			Log:            api.Logger,
			Request:        r,
			Action:         database.AuditActionCreate,
			OrganizationID: organization.ID,
		})
		templateVersionAudit, commitTemplateVersionAudit = audit.InitRequest[database.TemplateVersion](rw, &audit.RequestParams{
			Audit:          auditor,
			Log:            api.Logger,
			Request:        r,
			Action:         database.AuditActionWrite,
			OrganizationID: organization.ID,
		})
	)
	defer commitTemplateAudit()
	defer commitTemplateVersionAudit()

	if !httpapi.Read(ctx, rw, r, &createTemplate) {
		return
	}

	// Default is false as dynamic parameters are now the preferred approach.
	useClassicParameterFlow := ptr.NilToDefault(createTemplate.UseClassicParameterFlow, false)

	// Make a temporary struct to represent the template. This is used for
	// auditing if any of the following checks fail. It will be overwritten when
	// the template is inserted into the db.
	templateAudit.New = database.Template{
		OrganizationID:          organization.ID,
		Name:                    createTemplate.Name,
		Description:             createTemplate.Description,
		CreatedBy:               apiKey.UserID,
		Icon:                    createTemplate.Icon,
		DisplayName:             createTemplate.DisplayName,
		UseClassicParameterFlow: useClassicParameterFlow,
	}

	_, err := api.Database.GetTemplateByOrganizationAndName(ctx, database.GetTemplateByOrganizationAndNameParams{
		OrganizationID: organization.ID,
		Name:           createTemplate.Name,
	})
	if err == nil {
		httpapi.Write(ctx, rw, http.StatusConflict, codersdk.Response{
			Message: fmt.Sprintf("Template with name %q already exists.", createTemplate.Name),
			Validations: []codersdk.ValidationError{{
				Field:  "name",
				Detail: "This value is already in use and should be unique.",
			}},
		})