# Suggest a knowledge revision

Create a new draft revision for a workspace-owned knowledge section. The draft remains unavailable to writing agents until a person activates it.

- Exact name: `knowledge_revision_create`
- Category: Knowledge
- Required access: write
- Allowed agent roles: admin, content_writer
- MCP endpoint: `https://api.funnels.akera.agency/`

## Annotations

- None declared

## Input JSON Schema

```json
{
  "type": "object",
  "properties": {
    "workspaceId": {
      "type": "string",
      "minLength": 1
    },
    "documentId": {
      "type": "string",
      "minLength": 1
    },
    "title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120
    },
    "body": {
      "type": "string",
      "maxLength": 120000
    },
    "facts": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "buyer": {
              "type": "string",
              "maxLength": 2000
            },
            "trigger": {
              "type": "string",
              "maxLength": 2000
            },
            "outcome": {
              "type": "string",
              "maxLength": 2000
            },
            "mechanism": {
              "type": "string",
              "maxLength": 2000
            },
            "deliverables": {
              "type": "string",
              "maxLength": 4000
            },
            "price": {
              "type": "string",
              "maxLength": 1000
            },
            "proof": {
              "type": "string",
              "maxLength": 4000
            },
            "destination": {
              "type": "string",
              "maxLength": 2000
            },
            "unresolved": {
              "type": "string",
              "maxLength": 4000
            }
          },
          "required": [
            "buyer",
            "trigger",
            "outcome",
            "mechanism",
            "deliverables",
            "price",
            "proof",
            "destination",
            "unresolved"
          ]
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "workspaceId",
    "documentId",
    "title",
    "body"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## Call shape

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "knowledge_revision_create",
    "arguments": {}
  }
}
```