> ## 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. # Export dashboard > Returns a dashboard as a portable template, ready to pass to `Import dashboard`. The template can contain data from the source workspace, such as user email addresses in widget filters, so review it before sharing it. Every export is recorded in the audit log. The API key must be able to see the dashboard, as described in `List dashboards`. ## OpenAPI ````json GET /v1alpha/dashboards/{dashboard_id}/export { "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/{dashboard_id}/export": { "get": { "description": "Returns a dashboard as a portable template, ready to pass to `Import dashboard`. The template can contain data from the source workspace, such as user email addresses in widget filters, so review it before sharing it. Every export is recorded in the audit log. The API key must be able to see the dashboard, as described in `List dashboards`.", "operationId": "exportDashboard", "parameters": [ { "description": "The ID of the dashboard to export.", "in": "path", "name": "dashboard_id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/v1alphaExportDashboardResponse" } } }, "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": "Export dashboard", "tags": [ "Dashboards" ] } } }, "components": { "schemas": { "v1alphaExportDashboardResponse": { "properties": { "template": { "$ref": "#/components/schemas/v1alphaDashboardTemplate" } }, "title": "Export 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" } } } } ````