venue.add_comment · VenueMind Docs

Input

Field	Type	Required	Default	Bounds	Meaning
anchor	object	yes	—	—	Published contract field.
body	string	yes	—	min 1 chars; max 5000 chars	Published contract field.
mentions	string[]	no	—	unique items	Published contract field.
decisionRelevant	boolean	no	—	—	Published contract field.
authorId	string	yes	—	min 1 chars	Published contract field.
idempotencyKey	string	yes	—	min 1 chars	Unique retry key for this semantic command.
correlationId	string	no	—	min 1 chars	Optional caller correlation identifier.

json

{
  "anchor": {
    "kind": "coordinate",
    "planVersion": "3.2",
    "point": {
      "x": 12,
      "y": 8
    }
  },
  "body": "Review route intersection",
  "authorId": "agent-reviewer",
  "idempotencyKey": "example-comment-001"
}

Output field

Meaning

status

Published result field.

commentId

Stable identifier.

anchor

Published result field.

receipt

Published result field.

Errors

Code	Message	Remediation
TOOL_SCOPE_REQUIRED	Tool authorization scope is required.	Grant the published scope for this tool or use a read-only tool within the current session.
AUTHORIZATION_DENIED	The current principal is not authorized for this VenueMind action.	Use an assigned Organization Membership Role or an active Organization- and Project-scoped Agent Grant containing the required permission.
AGENT_GRANT_INVALID	Agent Grant is invalid.	Issue a complete Organization- and Project-scoped grant with published scopes and a lifetime of one hour or less.
TOOL_PAYLOAD_TOO_LARGE	Tool payload exceeds its published size limit.	Reduce the requested geometry or export payload and retry within the published byte limit.
TOOL_CALL_CANCELLED	Tool call was cancelled.	Retry only if the caller still needs the operation, using the same idempotency key for an interrupted mutation.
VENUE_INTERNAL_ERROR	VenueMind could not complete the operation.	Retry once; if the error persists, inspect the server log with the correlation ID.
IDEMPOTENCY_KEY_REQUIRED	Idempotency key is required for mutating commands.	Retry with one stable idempotency key for this semantic action.
IDEMPOTENCY_KEY_CONFLICT	Idempotency key conflict.	Use the original command input or generate a new idempotency key.

DOCS

Contract

Contract version 1.6.0.
Required Agent Grant scope venue:comment.
State-affecting operation.
Input limit 65536 bytes; output limit 262144 bytes.

Input

Field	Type	Required	Default	Bounds	Meaning
anchor	object	yes	—	—	Published contract field.
body	string	yes	—	min 1 chars; max 5000 chars	Published contract field.
mentions	string[]	no	—	unique items	Published contract field.
decisionRelevant	boolean	no	—	—	Published contract field.
authorId	string	yes	—	min 1 chars	Published contract field.
idempotencyKey	string	yes	—	min 1 chars	Unique retry key for this semantic command.
correlationId	string	no	—	min 1 chars	Optional caller correlation identifier.

json

{
  "anchor": {
    "kind": "coordinate",
    "planVersion": "3.2",
    "point": {
      "x": 12,
      "y": 8
    }
  },
  "body": "Review route intersection",
  "authorId": "agent-reviewer",
  "idempotencyKey": "example-comment-001"
}

Output

Created collaboration record without planning mutation.

Output field	Meaning
status	Published result field.
commentId	Stable identifier.
anchor	Published result field.
receipt	Published result field.

Stable ID: commentId
Stable ID: anchor.subjectId
Stable ID: receipt.id

Errors

Code	Message	Remediation
TOOL_SCOPE_REQUIRED	Tool authorization scope is required.	Grant the published scope for this tool or use a read-only tool within the current session.
AUTHORIZATION_DENIED	The current principal is not authorized for this VenueMind action.	Use an assigned Organization Membership Role or an active Organization- and Project-scoped Agent Grant containing the required permission.
AGENT_GRANT_INVALID	Agent Grant is invalid.	Issue a complete Organization- and Project-scoped grant with published scopes and a lifetime of one hour or less.
TOOL_PAYLOAD_TOO_LARGE	Tool payload exceeds its published size limit.	Reduce the requested geometry or export payload and retry within the published byte limit.
TOOL_CALL_CANCELLED	Tool call was cancelled.	Retry only if the caller still needs the operation, using the same idempotency key for an interrupted mutation.
VENUE_INTERNAL_ERROR	VenueMind could not complete the operation.	Retry once; if the error persists, inspect the server log with the correlation ID.
IDEMPOTENCY_KEY_REQUIRED	Idempotency key is required for mutating commands.	Retry with one stable idempotency key for this semantic action.
IDEMPOTENCY_KEY_CONFLICT	Idempotency key conflict.	Use the original command input or generate a new idempotency key.

Surfaces

WebMCP runtime Standalone MCP Complete error catalog