delete_draft

Access and behavior

Write or Administrator OAuth consent and a member/administrator team role are required. Tools are listed and callable only when the current grant and role permit them.

Deletion removes the draft for the team. A stale version returns a conflict; read again before asking the user to confirm a new deletion.

Confirm the exact target and consequence with the user before calling this tool.

Arguments

Argument	Required	Type or meaning
`draftId`	Yes	Draft UUID; choose a new UUID when creating, or read the saved draft before updating.
`version`	Yes	Latest record version; use 0 only when creating a new draft.

Complete input schema

{
  "type": "object",
  "properties": {
    "draftId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "version": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": ["draftId", "version"],
  "additionalProperties": false
}

Example call

The client initializes the MCP connection before sending this JSON-RPC call. Example records are fictional.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "delete_draft",
    "arguments": {
      "draftId": "33333333-3333-4333-8333-333333333333",
      "version": 1
    }
  }
}

Connect a client

MCP reference

API Reference

Workflow

Access and behavior

Arguments

Example call

Example result

​Workflow

​Access and behavior

​Arguments

​Example call

​Example result

​Related reference

Workflow

Access and behavior

Arguments

Example call

Example result

Related reference