> ## Documentation Index
> Fetch the complete documentation index at: https://sidenet.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Activate dashboard version

> Makes an earlier published version the one the dashboard shows (undo a change the chat made), then starts a refresh of it in the background. Returns the dashboard.



## OpenAPI

````yaml /api-reference/openapi.json post /v1/dashboards/{id}/activate
openapi: 3.1.0
info:
  title: Sidenet API
  version: 1.0.0
  description: >-
    Sidenet HTTP endpoints exposed by the Sidenet Studio. All routes require an
    api key that can be generated through the studio in studio.sidenet.ai.
servers:
  - url: https://api.sidenet.ai
security:
  - bearerAuth: []
paths:
  /v1/dashboards/{id}/activate:
    post:
      tags:
        - Dashboards
      summary: Activate dashboard version
      description: >-
        Makes an earlier published version the one the dashboard shows (undo a
        change the chat made), then starts a refresh of it in the background.
        Returns the dashboard.
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - version_number
              properties:
                version_number:
                  type: integer
                  example: 2
      responses:
        '200':
          description: The dashboard
          content:
            application/json:
              schema:
                type: object
                properties:
                  dashboard:
                    type: object
                    properties:
                      id:
                        type: string
                        format: uuid
                      name:
                        type: string
                      description:
                        type: string
                        nullable: true
                      timezone:
                        type: string
                      workflow_id:
                        type: string
                        format: uuid
                      active_version:
                        type: object
                        nullable: true
                        properties:
                          id:
                            type: string
                          number:
                            type: integer
                          created_at:
                            type: string
                            nullable: true
                      last_run_id:
                        type: string
                        nullable: true
                      last_refreshed_at:
                        type: string
                        nullable: true
                      last_refresh_status:
                        type: string
                        nullable: true
                      refresh_schedule_id:
                        type: string
                        nullable: true
                      created_at:
                        type: string
                      updated_at:
                        type: string
                  version:
                    type: object
                    nullable: true
                    properties:
                      id:
                        type: string
                      number:
                        type: integer
                      created_at:
                        type: string
                        nullable: true
                  spec:
                    type: object
                    nullable: true
                    description: >-
                      The version's spec: `filters`, `sources`, `panels`
                      (layout: `span`, `height`, order).
                  filters:
                    type: object
                    properties:
                      schema:
                        type: array
                        items:
                          type: object
                        description: >-
                          The filter definitions (key, label, kind, options,
                          default).
                      values:
                        type: object
                        additionalProperties: true
                        description: >-
                          The values the page opens on (the last refresh's, else
                          the defaults).
                  data:
                    type: object
                    properties:
                      run_id:
                        type: string
                        format: uuid
                      status:
                        type: string
                        enum:
                          - running
                          - succeeded
                          - failed
                      started_at:
                        type: string
                        format: date-time
                      refreshed_at:
                        type: string
                        format: date-time
                        nullable: true
                      filters:
                        type: object
                        additionalProperties: true
                        description: The raw filter values of this run.
                      panels:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                            kind:
                              type: string
                              enum:
                                - stats
                                - chart
                                - table
                                - text
                            title:
                              type: string
                            span:
                              type: integer
                              description: Columns of 12.
                            height:
                              type: string
                              enum:
                                - sm
                                - md
                                - lg
                            component:
                              type: object
                              nullable: true
                              description: >-
                                The rendered payload, in the chat tool-call part
                                shape: `{ toolCallId, toolName: "showStats" |
                                "showChart" | "showTable", args, result }`.
                                `args` is what the SDK renders.
                            markdown:
                              type: string
                              nullable: true
                              description: Text panels.
                      error:
                        type: string
                        nullable: true
                    nullable: true
                    description: >-
                      The latest refresh, or null when the dashboard was never
                      refreshed.
        '400':
          description: Unknown version
        '404':
          description: Not found
      security:
        - bearerAuth: []
        - sessionToken: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Organization API key, generated in studio.sidenet.ai. Backend only —
        never in a browser.
    sessionToken:
      type: http
      scheme: bearer
      description: >-
        Session token (`snat_…`) minted by POST /v1/token. Carries the
        organization and the end user; safe in a browser.

````

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