<!-- Code generated by internal/app/tools/agenttooldocgen; DO NOT EDIT. -->

# read_dashboard_source

Read the exact current private dashboard draft as canonical YAML for a subsequent source edit.

Machine-readable: [focused JSON](/docs/agent-tools/tools/read_dashboard_source.json) · [complete manifest](/docs/agent-tools/manifest.json)

## Contract

| Property | Value |
| --- | --- |
| Authorization | `RESOURCE_EDIT` |
| Effect | `read` |
| Operation | `manual` |
| Tags | `dashboard`, `authoring`, `source` |
| Defaults | `{}` |
| MCP annotations | read-only, idempotent, non-destructive, closed-world |

## Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "dashboardId": {
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "dashboardId"
  ],
  "type": "object"
}
```

## Output schema

```json
{
  "additionalProperties": false,
  "properties": {
    "dashboardId": {
      "type": "string"
    },
    "draftId": {
      "type": "string"
    },
    "revision": {
      "additionalProperties": false,
      "properties": {
        "contentHash": {
          "type": "string"
        },
        "number": {
          "type": "integer"
        },
        "revisionId": {
          "type": "string"
        }
      },
      "required": [
        "contentHash",
        "number",
        "revisionId"
      ],
      "type": "object"
    },
    "yaml": {
      "type": "string"
    }
  },
  "required": [
    "dashboardId",
    "draftId",
    "revision",
    "yaml"
  ],
  "type": "object"
}
```