> ## Documentation Index > Fetch the complete documentation index at: https://developers.torq.io/llms.txt > Use this file to discover all available pages before exploring further. # Import dashboard > Creates a dashboard from a template returned by `Export dashboard`, or replaces an existing dashboard with it. If the template refers to custom fields, SLAs, tags, or assignees that do not exist in this workspace, the import still succeeds, and the widgets that use them may show no data. Returns RESOURCE_EXHAUSTED when the workspace has reached its dashboard limit or the template has more widgets than a dashboard allows. ## OpenAPI ````json POST /v1alpha/dashboards/import { "openapi": "3.0.1", "info": { "contact": { "email": "support@torq.io", "name": "torq.io", "url": "https://torq.io" }, "title": "Torq Public API[production]", "version": "${DH_DEPLOY_VERSION}" }, "servers": [ { "url": "https://api.torq.io/public", "description": "US Environment" }, { "url": "https://api.eu.torq.io/public", "description": "European Enviornment" } ], "security": [ { "bearerAuth": [] } ], "tags": [ { "name": "Files" }, { "name": "ActivityLogs" }, { "name": "AgentsHubService" }, { "name": "Users" }, { "name": "ApiKeys" }, { "name": "AuditLogs" }, { "name": "ContextGraph" }, { "name": "DashboardsService" }, { "name": "Executions" }, { "name": "ShareRequests" }, { "name": "StepRunners" }, { "name": "Integrations" }, { "name": "IPAccessService" }, { "name": "RolesService" }, { "name": "ScheduledReportsService" }, { "name": "Secrets" }, { "name": "SecuritySettingsService" }, { "name": "ClaimMappings" }, { "name": "IdpSsoService" }, { "name": "Workflows" }, { "name": "Workspaces" }, { "name": "WorkspaceVariables" }, { "name": "Auto Triage Alerts" }, { "name": "Auto Triage Guidance" }, { "name": "Auto Triage Alert History" }, { "name": "Auto Triage Rules" }, { "name": "Auto Triage Verdict Actions" }, { "name": "Cases" }, { "name": "Cases Custom Fields" }, { "name": "Cases Notes" }, { "name": "ExtendedCaseService" }, { "name": "Cases Attachments" }, { "name": "Observables" }, { "name": "Cases Observables" }, { "name": "CaseSearchService" }, { "name": "Cases Tasks" }, { "name": "Cases Task Templates" }, { "name": "Cases Links" }, { "name": "Cases Events" }, { "name": "Cases Runbooks" } ], "externalDocs": { "description": "Torq Documentation", "url": "https://learn.torq.io" }, "x-original-swagger-version": "2.0", "paths": { "/v1alpha/dashboards/import": { "post": { "description": "Creates a dashboard from a template returned by `Export dashboard`, or replaces an existing dashboard with it. If the template refers to custom fields, SLAs, tags, or assignees that do not exist in this workspace, the import still succeeds, and the widgets that use them may show no data. Returns RESOURCE_EXHAUSTED when the workspace has reached its dashboard limit or the template has more widgets than a dashboard allows.", "operationId": "importDashboard", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/v1alphaImportDashboardRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/v1alphaImportDashboardResponse" } } }, "description": "A successful response." }, "401": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "Invalid bearer token. If you receive this message more than once try creating a new Client ID/Client Secret or generating a new bearer token." }, "403": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "You don't have permission to access this resource." } }, "summary": "Import dashboard", "tags": [ "Dashboards" ], "x-codegen-request-body-name": "body" } } }, "components": { "schemas": { "v1alphaImportDashboardRequest": { "properties": { "template": { "$ref": "#/components/schemas/v1alphaDashboardTemplate" }, "title": { "description": "The title of the imported dashboard. If empty, the template's title is used. When creating a new dashboard, if another dashboard in the workspace already uses the title, it is numbered, as when duplicating a dashboard: \"SOC overview\" becomes \"SOC overview 1\", and \"SOC overview 1\" becomes \"SOC overview 2\".", "example": "SOC overview", "type": "string" }, "description": { "description": "The description of the imported dashboard. If empty, the template's description is used.", "example": "Open cases by severity and assignee", "type": "string" }, "conflict_mode": { "description": "What to do with the template. The possible values are: `create_new` to create a new dashboard, which is the default, and `override` to replace the dashboard in `dashboard_id`. Overriding keeps the dashboard's access settings and replaces its widgets, title, and description, and every widget gets a new ID. The widgets are replaced first: if the title cannot be set, for example because another dashboard already uses it, the new widgets are kept.", "example": "create_new", "type": "string" }, "dashboard_id": { "description": "The ID of the dashboard to override. Required when `conflict_mode` is `override`, and not allowed otherwise.", "example": "0f8fad5b-d9cb-469f-a165-70867728950e", "type": "string" }, "owner": { "description": "The email address of the user the new dashboard is private to, matched case-insensitively. A new dashboard is private, even if the template came from a dashboard shared with all users. To share it, call `Update dashboard access` afterwards. If omitted, the dashboard is private to the owner of the API key used. Required when the request is not made with an API key, such as from a workflow step. Not allowed when `conflict_mode` is `override`, or on a workspace where dashboard access control is off, where a new dashboard is visible to all users.", "example": "dana@example.com", "type": "string" } }, "required": [ "template" ], "title": "Import dashboard request", "type": "object" }, "v1alphaImportDashboardResponse": { "properties": { "id": { "description": "The ID of the created or overridden dashboard.", "example": "0f8fad5b-d9cb-469f-a165-70867728950e", "type": "string" }, "outcome": { "description": "What the import did. The possible values are: `created`, `updated`.", "example": "created", "type": "string" }, "url": { "description": "A link that opens the dashboard in Torq.", "example": "https://app.torq.io/v3/dashboards/0f8fad5b-d9cb-469f-a165-70867728950e?account=my-account", "type": "string" }, "warnings": { "description": "Warnings about the import. Reserved for future use: currently always empty.", "items": { "type": "string" }, "type": "array" } }, "title": "Import dashboard response", "type": "object" }, "v1alphaDashboardTemplate": { "description": "A dashboard exported as a portable template, ready to import into a workspace. It contains the dashboard's title, description, and widgets with their layout, and no identifiers, timestamps, creator and updater, or access list.", "properties": { "api_version": { "description": "The template format version. `Import dashboard` accepts only versions it supports.", "example": "torq.io/v1alpha", "type": "string" }, "kind": { "description": "The kind of template. Always `Dashboard`.", "example": "Dashboard", "type": "string" }, "exported_at": { "description": "When the template was exported.", "format": "date-time", "readOnly": true, "type": "string" }, "definition": { "$ref": "#/components/schemas/v1alphaDashboardDefinition" } }, "type": "object" }, "v1alphaDashboardDefinition": { "description": "Contains the title, description, and widgets of an exported dashboard.", "properties": { "title": { "description": "The dashboard title.", "example": "SOC overview", "type": "string" }, "description": { "description": "The dashboard description.", "example": "Open cases by severity and assignee", "type": "string" }, "widgets": { "description": "The dashboard widgets, in order. Each widget carries its full definition, including its position on the dashboard and its filters, without identifiers or timestamps. Widgets use Torq's internal dashboard format, which can change. Pass them to `Import dashboard` unchanged.", "items": { "properties": {}, "type": "object" }, "type": "array" } }, "type": "object" } }, "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "64fb4b65-44d8-4304-881c-b1f8b6b3100a" } } } } ````