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.
Behavior
- Read-only hint
- Not declared
- Destructive hint
- Not declared
- Idempotent hint
- Not declared
- Open-world hint
- Not declared
Parameters
| Name | Type | Requirement | Description |
|---|---|---|---|
workspaceId | string | Required | No additional description. |
documentId | string | Required | No additional description. |
title | string | Required | No additional description. |
body | string | Required | No additional description. |
facts | union | Optional | No additional description. |
Input JSON Schema
Generated from the registered input schema
{
"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
Use an MCP client rather than sending this JSON directly. The client handles protocol negotiation, sessions, and authentication.
Protocol request
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "knowledge_revision_create",
"arguments": {}
}
}