add_comment · VenueMind Docs

Input

Field	Type	Required	Default	Bounds	Meaning
type	const "add_comment"	yes	—	—	Stable command discriminator.
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.
actor	human \| agent \| system	no	—	—	Claimed action source; policy verifies it against the principal.
idempotencyKey	string	yes	—	min 1 chars	Unique retry key for this semantic command.
correlationId	string	no	—	min 1 chars	Optional caller correlation identifier.
source	studio \| webmcp \| mcp \| system \| agent-tool	no	—	—	Surface that submitted the command.
sessionId	string	no	—	min 1 chars	Calling session identity.
actorId	string	yes	—	min 1 chars	Authenticated or local stable actor identity.

json

{
  "type": "add_comment",
  "anchor": {
    "kind": "project"
  },
  "body": "example-body",
  "actorId": "actor-example",
  "idempotencyKey": "example-command-001"
}

Output field

Meaning

status

Published result field.

commentId

Stable identifier.

anchor

Published result field.

receipt

Published result field.

Applicable errors

Code	Message	Remediation
COMMAND_INVALID	Venue command requires a type.	Send one published Venue command with its required fields.
COMMAND_UNSUPPORTED	Venue command is not supported.	Refresh the command contract and use a published command type.
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.
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.
COMMENT_NOT_FOUND	Comment not found.	List comments and retry with an existing stable Comment ID.
COMMENT_INVALID	Comment metadata is invalid.	Provide a non-empty comment body, supported status, and published fields.

DOCS

Contract

Permission comment.write.
Retry-safe mutation with a required idempotency key.
Authority is evaluated at the service boundary.

Input

Field	Type	Required	Default	Bounds	Meaning
type	const "add_comment"	yes	—	—	Stable command discriminator.
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.
actor	human \| agent \| system	no	—	—	Claimed action source; policy verifies it against the principal.
idempotencyKey	string	yes	—	min 1 chars	Unique retry key for this semantic command.
correlationId	string	no	—	min 1 chars	Optional caller correlation identifier.
source	studio \| webmcp \| mcp \| system \| agent-tool	no	—	—	Surface that submitted the command.
sessionId	string	no	—	min 1 chars	Calling session identity.
actorId	string	yes	—	min 1 chars	Authenticated or local stable actor identity.

json

{
  "type": "add_comment",
  "anchor": {
    "kind": "project"
  },
  "body": "example-body",
  "actorId": "actor-example",
  "idempotencyKey": "example-command-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

Applicable errors

Code	Message	Remediation
COMMAND_INVALID	Venue command requires a type.	Send one published Venue command with its required fields.
COMMAND_UNSUPPORTED	Venue command is not supported.	Refresh the command contract and use a published command type.
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.
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.
COMMENT_NOT_FOUND	Comment not found.	List comments and retry with an existing stable Comment ID.
COMMENT_INVALID	Comment metadata is invalid.	Provide a non-empty comment body, supported status, and published fields.

Complete error catalog