venue.report_incident · VenueMind Docs

Contract

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

Input

Field	Type	Required	Default	Bounds	Meaning
severity	low \| medium \| high \| critical	yes	—	—	Published contract field.
category	accessibility \| crowd-capacity \| medical \| security \| fire-life-safety \| facilities \| production-av \| catering \| staffing \| transport \| weather \| other	yes	—	—	Published contract field.
summaryCode	string	yes	—	min 2 chars; max 64 chars; pattern ^[A-Z][A-Z0-9_]{1,63}$	Published contract field.
location	object \| object	yes	—	—	Published contract field.
relatedRefs	object[]	no	—	max 20 items	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

{
  "severity": "high",
  "category": "crowd-capacity",
  "summaryCode": "EAST_ENTRY_CONGESTION",
  "location": {
    "kind": "plan-object",
    "planObjectId": "obj-entry-east"
  },
  "relatedRefs": [
    {
      "kind": "occupancy-alert",
      "id": "occupancy-alert-east-entry"
    }
  ],
  "idempotencyKey": "example-incident-report-001"
}

Output

Idempotent agent report acceptance without acknowledgement, escalation, response, or resolution authority.

Output field	Meaning
register	Published result field.
incident	Published result field.
receipt	Published result field.
duplicate	Published result field.

Stable ID: register.id
Stable ID: incident.id
Stable ID: receipt.id
Stable ID: register.ledger[].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.
INCIDENT_REGISTER_NOT_FOUND	Incident Register is unavailable.	Create the register from the active Event Day Runbook before inspecting or reporting incidents.
INCIDENT_NOT_FOUND	Operational Incident is unavailable.	Inspect the Incident Register and retry with an existing stable Incident ID.
INCIDENT_TOOL_UNAVAILABLE	Incident tool Adapter is unavailable.	Open VenueMind Studio or connect an MCP Project session with Incident Register operations enabled.
INCIDENT_REVISION_CONFLICT	Operational Incident revision conflict.	Refresh the incident and retry only if the transition is still required.
INCIDENT_INVALID	Operational Incident input is invalid.	Use the published severity, category, owner, reason, reference, and transition fields.
INCIDENT_PRIVACY_REJECTED	Incident input contains prohibited person-level data.	Remove identities, contacts, ticket, device, attendee, medical, and free-form person records.
INCIDENT_LOCATION_INVALID	Incident Location Context is invalid.	Anchor the incident to one object or in-room coordinate in the frozen accepted Plan.
INCIDENT_LEDGER_INTEGRITY_FAILED	Incident Register ledger integrity failed.	Restore the last verified register state before inspection or export.

Surfaces

WebMCP runtime Standalone MCP Complete error catalog

Input

Field	Type	Required	Default	Bounds	Meaning
severity	low \| medium \| high \| critical	yes	—	—	Published contract field.
category	accessibility \| crowd-capacity \| medical \| security \| fire-life-safety \| facilities \| production-av \| catering \| staffing \| transport \| weather \| other	yes	—	—	Published contract field.
summaryCode	string	yes	—	min 2 chars; max 64 chars; pattern ^[A-Z][A-Z0-9_]{1,63}$	Published contract field.
location	object \| object	yes	—	—	Published contract field.
relatedRefs	object[]	no	—	max 20 items	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

{
  "severity": "high",
  "category": "crowd-capacity",
  "summaryCode": "EAST_ENTRY_CONGESTION",
  "location": {
    "kind": "plan-object",
    "planObjectId": "obj-entry-east"
  },
  "relatedRefs": [
    {
      "kind": "occupancy-alert",
      "id": "occupancy-alert-east-entry"
    }
  ],
  "idempotencyKey": "example-incident-report-001"
}

Output

Idempotent agent report acceptance without acknowledgement, escalation, response, or resolution authority.

Output field	Meaning
register	Published result field.
incident	Published result field.
receipt	Published result field.
duplicate	Published result field.

Stable ID: register.id

Stable ID: incident.id

Stable ID: receipt.id

Stable ID: register.ledger[].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.
INCIDENT_REGISTER_NOT_FOUND	Incident Register is unavailable.	Create the register from the active Event Day Runbook before inspecting or reporting incidents.
INCIDENT_NOT_FOUND	Operational Incident is unavailable.	Inspect the Incident Register and retry with an existing stable Incident ID.
INCIDENT_TOOL_UNAVAILABLE	Incident tool Adapter is unavailable.	Open VenueMind Studio or connect an MCP Project session with Incident Register operations enabled.
INCIDENT_REVISION_CONFLICT	Operational Incident revision conflict.	Refresh the incident and retry only if the transition is still required.
INCIDENT_INVALID	Operational Incident input is invalid.	Use the published severity, category, owner, reason, reference, and transition fields.
INCIDENT_PRIVACY_REJECTED	Incident input contains prohibited person-level data.	Remove identities, contacts, ticket, device, attendee, medical, and free-form person records.
INCIDENT_LOCATION_INVALID	Incident Location Context is invalid.	Anchor the incident to one object or in-room coordinate in the frozen accepted Plan.
INCIDENT_LEDGER_INTEGRITY_FAILED	Incident Register ledger integrity failed.	Restore the last verified register state before inspection or export.