> ## 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.

# Get an automation run

> Retrieves an automation run by ID, including the final assistant answer as markdown and its charts. Markdown image URLs and chart imageUrl values require the same Bearer authentication as this request. Requires admin access to the organization.



## OpenAPI

````yaml https://charts.basedash.com/api/public/openapi get /api/public/organizations/{orgId}/automations/{id}/runs/{runId}
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: Models
    description: Manage reusable SQL models
  - 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}/automations/{id}/runs/{runId}:
    get:
      tags:
        - Automations
      summary: Get an automation run
      description: >-
        Retrieves an automation run by ID, including the final assistant answer
        as markdown and its charts. Markdown image URLs and chart imageUrl
        values require the same Bearer authentication as this request. Requires
        admin access to the organization.
      parameters:
        - schema:
            type: string
            description: Organization ID
          required: true
          description: Organization ID
          name: orgId
          in: path
        - schema:
            type: string
            description: Automation ID
          required: true
          description: Automation ID
          name: id
          in: path
        - schema:
            type: string
            description: Automation run ID
          required: true
          description: Automation run ID
          name: runId
          in: path
      responses:
        '200':
          description: Automation run retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicAutomationRunResponse'
        '401':
          description: Unauthorized - Missing or invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Not found - Automation run 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:
    PublicAutomationRunResponse:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/PublicAutomationRunDetail'
      required:
        - data
    ErrorResponse:
      type: object
      properties:
        error:
          $ref: '#/components/schemas/ApiError'
      required:
        - error
    RateLimitErrorResponse:
      type: object
      properties:
        error:
          $ref: '#/components/schemas/RateLimitError'
      required:
        - error
    PublicAutomationRunDetail:
      allOf:
        - $ref: '#/components/schemas/PublicAutomationRun'
        - type: object
          properties:
            finalMessageContent:
              type:
                - string
                - 'null'
              description: >-
                Final assistant answer as markdown. Internal chart tags are
                replaced with authenticated chart image URLs that require the
                same Bearer token as this request.
            charts:
              type: array
              items:
                $ref: '#/components/schemas/PublicAutomationRunChart'
              description: Charts included in the final automation run response
          required:
            - finalMessageContent
            - charts
    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
    PublicAutomationRun:
      type: object
      properties:
        id:
          type: string
          description: Automation run ID
        automationId:
          type: string
          description: Automation ID
        organizationId:
          type: string
          description: Organization ID
        name:
          type: string
          description: Run name
        status:
          type:
            - string
            - 'null'
          enum:
            - GENERATING
            - FINISHED
            - null
          description: Run status
        isManualRun:
          type: boolean
          description: Whether the run was manually triggered
        memberId:
          type:
            - string
            - 'null'
          description: Member ID associated with the run
        createdAt:
          type: string
          format: date-time
          description: Creation timestamp
        updatedAt:
          type: string
          format: date-time
          description: Last update timestamp
      required:
        - id
        - automationId
        - organizationId
        - name
        - status
        - isManualRun
        - memberId
        - createdAt
        - updatedAt
    PublicAutomationRunChart:
      type: object
      properties:
        id:
          type: string
          description: Chart ID
        chartVersionId:
          type: string
          description: Chart version shown in the run
        imageUrl:
          type: string
          format: uri
          description: >-
            Authenticated public API URL for fetching the chart version as a
            PNG. Send the same Bearer token used for this request.
      required:
        - id
        - chartVersionId
        - imageUrl
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        API key authentication using Bearer token format: `Bearer
        <basedash_api_key>`

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.