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

# execute_dashboard_command

Publish or archive one dashboard authoring revision using a closed, typed command and exact expected revision. Actor and agent provenance are server-bound.

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

## Contract

| Property | Value |
| --- | --- |
| Authorization | `RESOURCE_MANAGE` |
| Effect | `destructive` |
| Operation | `manual` |
| Tags | `dashboard`, `authoring`, `command` |
| Defaults | `{}` |
| MCP annotations | read/write, not idempotent, destructive, closed-world |

## Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "archive": {
      "type": "object"
    },
    "contentHash": {
      "minLength": 1,
      "type": "string"
    },
    "dashboardId": {
      "minLength": 1,
      "type": "string"
    },
    "draftId": {
      "minLength": 1,
      "type": "string"
    },
    "expectedRevision": {
      "additionalProperties": false,
      "properties": {
        "contentHash": {
          "type": "string"
        },
        "number": {
          "type": "integer"
        },
        "revisionId": {
          "type": "string"
        }
      },
      "required": [
        "contentHash",
        "number",
        "revisionId"
      ],
      "type": "object"
    },
    "publish": {
      "type": "object"
    }
  },
  "required": [
    "dashboardId",
    "draftId",
    "expectedRevision"
  ],
  "type": "object"
}
```

## Output schema

```json
{
  "additionalProperties": false,
  "properties": {
    "lifecycle": {
      "additionalProperties": {},
      "type": "object"
    },
    "revision": {
      "additionalProperties": {},
      "type": "object"
    }
  },
  "required": [
    "lifecycle",
    "revision"
  ],
  "type": "object"
}
```