venue.apply_edit · VenueMind Docs

Input

Field	Type	Required	Default	Bounds	Meaning
edit	object \| object \| object \| object \| object \| object \| object \| object \| object \| object \| object \| object \| object \| object	yes	—	—	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

{
  "edit": {
    "operation": "move",
    "objectIds": [
      "obj-av-desk"
    ],
    "delta": {
      "x": 1,
      "y": 0
    }
  },
  "idempotencyKey": "example-edit-001"
}

Output

One Proposal-safe editing operation.

Output field	Meaning
status	Published result field.
proposalId	Stable identifier.
changeId	Stable identifier.
operation	Published result field.
changedItems	Published result field.
requiresHumanApproval	Published result field.
receipt	Published result field.

Stable ID: proposalId

Stable ID: changeId

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.

DOCS

Contract

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

Input

Field	Type	Required	Default	Bounds	Meaning
edit	object \| object \| object \| object \| object \| object \| object \| object \| object \| object \| object \| object \| object \| object	yes	—	—	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

{
  "edit": {
    "operation": "move",
    "objectIds": [
      "obj-av-desk"
    ],
    "delta": {
      "x": 1,
      "y": 0
    }
  },
  "idempotencyKey": "example-edit-001"
}

Output

One Proposal-safe editing operation.

Output field	Meaning
status	Published result field.
proposalId	Stable identifier.
changeId	Stable identifier.
operation	Published result field.
changedItems	Published result field.
requiresHumanApproval	Published result field.
receipt	Published result field.

Stable ID: proposalId
Stable ID: changeId
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