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

# create_dashboard

> Create an empty dashboard — the page a set of reports is shown on. Tiles are pinned onto it from the Qobra web app.

Create an empty dashboard — the page a set of reports is shown on.

The dashboard is created with no tiles, and comes back here with its id and a
link to it — reuse that id rather than looking the dashboard up again, which
can miss a creation this recent. Reports are pinned onto it from the Qobra web
app.

Available only where the Qobra write tools beta is enabled. Every write to the
live environment is recorded in the audit trail as the `Qobra MCP` agent;
writes to a sandbox are not audited.

## Parameters

<Accordion title="Body" defaultOpen>
  <ParamField body="name" type="string" required>
    Display name of the dashboard, as people will read it in Qobra — 'Q3
    board review', 'EMEA performance'.
  </ParamField>

  <ParamField body="description" type="string">
    Optional free-text note about what the dashboard is for.
  </ParamField>

  <ParamField body="sandbox_id" type="string">
    Id of the sandbox to create the dashboard in — the id list\_sandboxes
    returns. Omit it to create the dashboard in the live environment. Only a
    sandbox id is accepted here — never a sandbox name, and never the live
    environment's own id.
  </ParamField>
</Accordion>

## Response

<Accordion title="Body" defaultOpen>
  <ResponseField name="dashboard" type="object">
    The dashboard as it now exists — the same row list\_dashboards returns,
    so the id can be reused straight away.

    <Expandable title="object properties">
      <ResponseField name="id" type="string" />

      <ResponseField name="resource_url" type="string">
        Deep link to open this dashboard in the Qobra web app.
      </ResponseField>

      <ResponseField name="name" type="string" />

      <ResponseField name="description" type="string" />

      <ResponseField name="updated_at" type="string" />
    </Expandable>
  </ResponseField>
</Accordion>