---
title: "Import Project Template"
method: POST
path: "/v0/project/import_template"
tags: ["Projects"]
---

# Import Project Template

`POST /v0/project/import_template`

Import a project template into a project.

## Request body

- ImportProjectTemplateRequest — Request to import a project template.
  - `project_name` string, required
  - `template` ProjectTemplateSchema, required — Template schema for multiple interfaces from a project
    - `interfaces` InterfaceTemplateSchema[]
      - `name` string, required
      - `icon` string, nullable
      - `color` string, nullable
      - `order` integer, nullable
      - `tabs` TabTemplateSchema[]
        - `name` string, required
        - `visible` boolean
        - `active` boolean
        - `order` integer, nullable
        - `context` string, nullable
        - `color` string, nullable
        - `icon` string, nullable
        - `tiles` TileTemplateSchema[]
          - `name` string, required
          - `position` TilePosition, required
            - `x` number, required
            - `y` number, required
            - `width` number, required
            - `height` number, required
          - `type` string, nullable
          - `minW` number, nullable
          - `minH` number, nullable
          - `visible` boolean
          - `locked` boolean
          - `moved` boolean
          - `static` boolean
          - `color` string, nullable
          - `context` string, nullable
          - `table` string, nullable
          - `auto_update` string, nullable
          - `freeze` string, nullable
          - `filters` string, nullable
          - `common_filter` string, nullable
          - `metric` string, nullable
          - `column_context` string, nullable
          - `grouping` string, nullable
          - `table_tile` TableTileSchema
            - `id` string, nullable
            - `tile_id` string, nullable
            - `table_type` string, nullable
            - `page_number` string, nullable
            - `column_order` string, nullable
            - `hidden_columns` string, nullable
            - `default_hidden_columns` boolean, nullable
            - `sorting` string, nullable
            - `group_sorting` string, nullable
            - `columns_pin_left` string, nullable
            - `columns_pin_right` string, nullable
            - `selected` string, nullable
          - `plot_tile` PlotTileSchema
            - `id` string, nullable
            - `tile_id` string, nullable
            - `plot_type` string, nullable
            - `plot_scale_x` string, nullable
            - `plot_scale_y` string, nullable
            - `plot_aggregate` string, nullable
            - `x_axis` string, nullable
            - `y_axis` string, nullable
            - `plot_group_by` string, nullable
            - `plot_group_by_colors` string, nullable
            - `bin_count` string, nullable
            - `regression_line` string, nullable
          - `view_tile` ViewTileSchema
            - `id` string, nullable
            - `tile_id` string, nullable
            - `base_index` string, nullable
          - `editor_tile` EditorTileSchema
            - `id` string, nullable
            - `tile_id` string, nullable
            - `file_name` string, nullable
            - `file_type` string, nullable
            - `content` string, nullable
          - `terminal_tile` TerminalTileSchema
            - `id` string, nullable
            - `tile_id` string, nullable
            - `shell_type` string, nullable
          - `template_version` string
          - `description` string, nullable
          - `created_by` string, nullable
          - `tags` string[]
        - `template_version` string
        - `description` string, nullable
        - `created_by` string, nullable
        - `tags` string[]
      - `active_tab_name` string, nullable
      - `template_version` string
      - `description` string, nullable
      - `created_by` string, nullable
      - `tags` string[]
    - `template_version` string
    - `description` string, nullable
    - `created_by` string, nullable
    - `tags` string[]
  - `validate_first` boolean
  - `auto_sanitize` boolean
  - `overwrite_existing` boolean
  - `interface_name_prefix` string, nullable

## Response `200`

Project template imported successfully

- TemplateImportResponse — Response from importing a template
  - `success` boolean, required
  - `validation_result` ValidationResultSchema — Result of validating a template against a project
    - `is_valid` boolean, required
    - `issues` ValidationIssue[]
      - `level` string, required
      - `component` string, required
      - `component_name` string, required
      - `issue_type` string, required
      - `message` string, required
      - `suggested_fix` string, nullable
    - `can_sanitize` boolean, required
    - `sanitized_template` union
      - ProjectTemplateSchema — Template schema for multiple interfaces from a project
        - `interfaces` InterfaceTemplateSchema[]
          - `name` string, required
          - `icon` string, nullable
          - `color` string, nullable
          - `order` integer, nullable
          - `tabs` TabTemplateSchema[]
            - `name` string, required
            - `visible` boolean
            - `active` boolean
            - `order` integer, nullable
            - `context` string, nullable
            - `color` string, nullable
            - `icon` string, nullable
            - `tiles` TileTemplateSchema[]
              - …
            - `template_version` string
            - `description` string, nullable
            - `created_by` string, nullable
            - `tags` string[]
          - `active_tab_name` string, nullable
          - `template_version` string
          - `description` string, nullable
          - `created_by` string, nullable
          - `tags` string[]
        - `template_version` string
        - `description` string, nullable
        - `created_by` string, nullable
        - `tags` string[]
      - InterfaceTemplateSchema — Template schema for a detached interface
        - `name` string, required
        - `icon` string, nullable
        - `color` string, nullable
        - `order` integer, nullable
        - `tabs` TabTemplateSchema[]
          - `name` string, required
          - `visible` boolean
          - `active` boolean
          - `order` integer, nullable
          - `context` string, nullable
          - `color` string, nullable
          - `icon` string, nullable
          - `tiles` TileTemplateSchema[]
            - `name` string, required
            - `position` TilePosition, required
              - …
            - `type` string, nullable
            - `minW` number, nullable
            - `minH` number, nullable
            - `visible` boolean
            - `locked` boolean
            - `moved` boolean
            - `static` boolean
            - `color` string, nullable
            - `context` string, nullable
            - `table` string, nullable
            - `auto_update` string, nullable
            - `freeze` string, nullable
            - `filters` string, nullable
            - `common_filter` string, nullable
            - `metric` string, nullable
            - `column_context` string, nullable
            - `grouping` string, nullable
            - `table_tile` TableTileSchema
              - …
            - `plot_tile` PlotTileSchema
              - …
            - `view_tile` ViewTileSchema
              - …
            - `editor_tile` EditorTileSchema
              - …
            - `terminal_tile` TerminalTileSchema
              - …
            - `template_version` string
            - `description` string, nullable
            - `created_by` string, nullable
            - `tags` string[]
          - `template_version` string
          - `description` string, nullable
          - `created_by` string, nullable
          - `tags` string[]
        - `active_tab_name` string, nullable
        - `template_version` string
        - `description` string, nullable
        - `created_by` string, nullable
        - `tags` string[]
      - TabTemplateSchema — Template schema for a detached tab
        - `name` string, required
        - `visible` boolean
        - `active` boolean
        - `order` integer, nullable
        - `context` string, nullable
        - `color` string, nullable
        - `icon` string, nullable
        - `tiles` TileTemplateSchema[]
          - `name` string, required
          - `position` TilePosition, required
            - `x` number, required
            - `y` number, required
            - `width` number, required
            - `height` number, required
          - `type` string, nullable
          - `minW` number, nullable
          - `minH` number, nullable
          - `visible` boolean
          - `locked` boolean
          - `moved` boolean
          - `static` boolean
          - `color` string, nullable
          - `context` string, nullable
          - `table` string, nullable
          - `auto_update` string, nullable
          - `freeze` string, nullable
          - `filters` string, nullable
          - `common_filter` string, nullable
          - `metric` string, nullable
          - `column_context` string, nullable
          - `grouping` string, nullable
          - `table_tile` TableTileSchema
            - `id` string, nullable
            - `tile_id` string, nullable
            - `table_type` string, nullable
            - `page_number` string, nullable
            - `column_order` string, nullable
            - `hidden_columns` string, nullable
            - `default_hidden_columns` boolean, nullable
            - `sorting` string, nullable
            - `group_sorting` string, nullable
            - `columns_pin_left` string, nullable
            - `columns_pin_right` string, nullable
            - `selected` string, nullable
          - `plot_tile` PlotTileSchema
            - `id` string, nullable
            - `tile_id` string, nullable
            - `plot_type` string, nullable
            - `plot_scale_x` string, nullable
            - `plot_scale_y` string, nullable
            - `plot_aggregate` string, nullable
            - `x_axis` string, nullable
            - `y_axis` string, nullable
            - `plot_group_by` string, nullable
            - `plot_group_by_colors` string, nullable
            - `bin_count` string, nullable
            - `regression_line` string, nullable
          - `view_tile` ViewTileSchema
            - `id` string, nullable
            - `tile_id` string, nullable
            - `base_index` string, nullable
          - `editor_tile` EditorTileSchema
            - `id` string, nullable
            - `tile_id` string, nullable
            - `file_name` string, nullable
            - `file_type` string, nullable
            - `content` string, nullable
          - `terminal_tile` TerminalTileSchema
            - `id` string, nullable
            - `tile_id` string, nullable
            - `shell_type` string, nullable
          - `template_version` string
          - `description` string, nullable
          - `created_by` string, nullable
          - `tags` string[]
        - `template_version` string
        - `description` string, nullable
        - `created_by` string, nullable
        - `tags` string[]
      - TileTemplateSchema — Template schema for a detached tile - inherits all fields from base
        - `name` string, required
        - `position` TilePosition, required
          - `x` number, required
          - `y` number, required
          - `width` number, required
          - `height` number, required
        - `type` string, nullable
        - `minW` number, nullable
        - `minH` number, nullable
        - `visible` boolean
        - `locked` boolean
        - `moved` boolean
        - `static` boolean
        - `color` string, nullable
        - `context` string, nullable
        - `table` string, nullable
        - `auto_update` string, nullable
        - `freeze` string, nullable
        - `filters` string, nullable
        - `common_filter` string, nullable
        - `metric` string, nullable
        - `column_context` string, nullable
        - `grouping` string, nullable
        - `table_tile` TableTileSchema
          - `id` string, nullable
          - `tile_id` string, nullable
          - `table_type` string, nullable
          - `page_number` string, nullable
          - `column_order` string, nullable
          - `hidden_columns` string, nullable
          - `default_hidden_columns` boolean, nullable
          - `sorting` string, nullable
          - `group_sorting` string, nullable
          - `columns_pin_left` string, nullable
          - `columns_pin_right` string, nullable
          - `selected` string, nullable
        - `plot_tile` PlotTileSchema
          - `id` string, nullable
          - `tile_id` string, nullable
          - `plot_type` string, nullable
          - `plot_scale_x` string, nullable
          - `plot_scale_y` string, nullable
          - `plot_aggregate` string, nullable
          - `x_axis` string, nullable
          - `y_axis` string, nullable
          - `plot_group_by` string, nullable
          - `plot_group_by_colors` string, nullable
          - `bin_count` string, nullable
          - `regression_line` string, nullable
        - `view_tile` ViewTileSchema
          - `id` string, nullable
          - `tile_id` string, nullable
          - `base_index` string, nullable
        - `editor_tile` EditorTileSchema
          - `id` string, nullable
          - `tile_id` string, nullable
          - `file_name` string, nullable
          - `file_type` string, nullable
          - `content` string, nullable
        - `terminal_tile` TerminalTileSchema
          - `id` string, nullable
          - `tile_id` string, nullable
          - `shell_type` string, nullable
        - `template_version` string
        - `description` string, nullable
        - `created_by` string, nullable
        - `tags` string[]
  - `import_stats` object, required
  - `created_ids` object, required
  - `warnings` string[]

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/unify/apis/unifyai-http-api-reference.md) · [All operations](https://skmtc.net/unify/apis/unifyai-http-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unify/unifyai-http-api-reference/versions/900377f918b6/schema)
