> ## Documentation Index > Fetch the complete documentation index at: https://basedash.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Create a dashboard > Creates a new dashboard within an organization, including a default "Main" tab. Requires admin access to the organization. ## OpenAPI ````yaml https://charts.basedash.com/api/public/openapi post /api/public/organizations/{orgId}/dashboards openapi: 3.1.0 info: title: Basedash Public API version: 0.0.0 description: >- API for programmatic access to Basedash features. Use API keys for authentication. contact: name: Basedash Support url: https://basedash.com email: support@basedash.com servers: - url: https://charts.basedash.com description: Production security: [] tags: - name: Organizations description: Manage organizations - name: Groups description: Manage organization groups and memberships - name: Data Sources description: Manage database connections and data sources - name: MCP servers description: Manage MCP server data sources - name: Insights description: Manage generated insights - name: Automations description: Manage automations and automation runs - name: Skills description: Manage organization skills - name: Definitions description: Manage reusable SQL definitions - name: Dashboards description: Manage dashboards and their tabs - name: Charts description: Manage charts and their SQL queries - name: Chats description: >- Chat with the Basedash AI agent about your data. Start a chat by sending a message, then continue the conversation with follow-up messages. The assistant responds asynchronously: pass the `wait` query parameter to receive the finished response in the same request, or poll the assistant message (or stream its events) after an HTTP 202. Chats created through the API are not shown in the Basedash app. paths: /api/public/organizations/{orgId}/dashboards: post: tags: - Dashboards summary: Create a dashboard description: >- Creates a new dashboard within an organization, including a default "Main" tab. Requires admin access to the organization. parameters: - schema: type: string description: Organization ID required: true description: Organization ID name: orgId in: path requestBody: content: application/json: schema: $ref: '#/components/schemas/CreateDashboardInput' responses: '201': description: Dashboard created successfully content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/DashboardWithTabsResponse' required: - data '400': description: Bad request - Invalid JSON body or validation error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Unauthorized - Missing or invalid API key content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: Forbidden - Organization trial has expired content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Not found - Organization not found or no admin access content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '429': description: Rate limit exceeded - Too many requests content: application/json: schema: $ref: '#/components/schemas/RateLimitErrorResponse' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - bearerAuth: [] components: schemas: CreateDashboardInput: type: object properties: name: type: string minLength: 1 description: Name of the dashboard description: type: - string - 'null' description: Optional description of the dashboard icon: type: string minLength: 1 description: Icon name for the dashboard color: type: string minLength: 1 description: Icon color key for the dashboard dashboardFolderId: type: - string - 'null' description: ID of the folder to place the dashboard in width: $ref: '#/components/schemas/DashboardWidth' defaultDateRange: $ref: '#/components/schemas/DateRange' defaultCustomDateRangeStart: type: - string - 'null' format: date-time description: Start of the custom date range (when defaultDateRange is CUSTOM) defaultCustomDateRangeEnd: type: - string - 'null' format: date-time description: End of the custom date range (when defaultDateRange is CUSTOM) defaultGroupByInterval: $ref: '#/components/schemas/GroupByInterval' required: - name DashboardWithTabsResponse: allOf: - $ref: '#/components/schemas/DashboardResponse' - type: object properties: tabs: type: array items: $ref: '#/components/schemas/DashboardTab' description: Tabs on the dashboard, ordered by their sort order required: - tabs ErrorResponse: type: object properties: error: $ref: '#/components/schemas/ApiError' required: - error RateLimitErrorResponse: type: object properties: error: $ref: '#/components/schemas/RateLimitError' required: - error DashboardWidth: anyOf: - type: string enum: - NORMAL - type: string enum: - WIDE - type: string enum: - ULTRAWIDE description: Width of the dashboard grid DateRange: anyOf: - type: string enum: - CUSTOM - type: string enum: - TODAY - type: string enum: - YESTERDAY - type: string enum: - THIS_WEEK - type: string enum: - THIS_MONTH - type: string enum: - THIS_QUARTER - type: string enum: - THIS_YEAR - type: string enum: - LAST_7_DAYS - type: string enum: - LAST_30_DAYS - type: string enum: - LAST_60_DAYS - type: string enum: - LAST_90_DAYS - type: string enum: - LAST_6_MONTHS - type: string enum: - LAST_1_YEAR - type: string enum: - ALL_TIME description: Default date range applied to the dashboard GroupByInterval: anyOf: - type: string enum: - HOUR - type: string enum: - DAY - type: string enum: - WEEK - type: string enum: - MONTH - type: string enum: - YEAR description: Default group-by interval applied to the dashboard DashboardResponse: type: object properties: id: type: string description: Dashboard ID createdAt: type: string format: date-time description: Dashboard creation timestamp updatedAt: type: string format: date-time description: Dashboard last update timestamp name: type: string description: Name of the dashboard description: type: - string - 'null' description: Description of the dashboard icon: type: string description: Icon name for the dashboard color: type: string description: Icon color key for the dashboard dashboardFolderId: type: - string - 'null' description: ID of the folder the dashboard is in width: $ref: '#/components/schemas/DashboardWidth' defaultDateRange: $ref: '#/components/schemas/DateRange' defaultCustomDateRangeStart: type: - string - 'null' format: date-time description: Start of the custom date range defaultCustomDateRangeEnd: type: - string - 'null' format: date-time description: End of the custom date range defaultGroupByInterval: $ref: '#/components/schemas/GroupByInterval' organizationId: type: string description: Organization ID required: - id - createdAt - updatedAt - name - description - icon - color - dashboardFolderId - width - defaultDateRange - defaultCustomDateRangeStart - defaultCustomDateRangeEnd - defaultGroupByInterval - organizationId DashboardTab: type: object properties: id: type: string description: Dashboard tab ID createdAt: type: string format: date-time description: Tab creation timestamp updatedAt: type: string format: date-time description: Tab last update timestamp name: type: string description: Name of the tab order: type: number description: Sort order of the tab within the dashboard dashboardId: type: string description: ID of the dashboard the tab belongs to required: - id - createdAt - updatedAt - name - order - dashboardId ApiError: type: object properties: title: type: string description: Error type identifier detail: type: string description: Human-readable error description required: - title - detail RateLimitError: allOf: - $ref: '#/components/schemas/ApiError' - type: object properties: title: type: string enum: - RateLimitExceeded retryAfterMs: type: number description: Milliseconds until the rate limit window resets required: - retryAfterMs securitySchemes: bearerAuth: type: http scheme: bearer description: >- API key authentication using Bearer token format: `Bearer ` ````