approve_proposal · VenueMind Docs

Contract

Permission approval.approve.
Retry-safe mutation with a required idempotency key.
Human authority is required.

Input

Field	Type	Required	Default	Bounds	Meaning
type	const "approve_proposal"	yes	—	—	Stable command discriminator.
proposalId	string	yes	—	—	Stable Proposal ID.
baseVersion	string	yes	—	—	Accepted Plan Version on which the Proposal is based.
actor	const "human"	yes	—	—	Claimed action source; policy verifies it against the principal.
emergencyReview	object	no	—	—	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.
source	studio \| webmcp \| mcp \| system \| agent-tool	no	—	—	Surface that submitted the command.
sessionId	string	no	—	min 1 chars	Calling session identity.
actorId	string	no	—	min 1 chars	Authenticated or local stable actor identity.

json

{
  "type": "approve_proposal",
  "proposalId": "proposal-example",
  "baseVersion": "3.2",
  "actor": "human",
  "idempotencyKey": "example-command-001"
}

Output

Human Approval creating the next immutable Plan Version.

Output field	Meaning
planId	Stable identifier.
planVersion	Published result field.
proposalId	Stable identifier.
status	Published result field.
validation	Published result field.

Stable ID: planId
Stable ID: proposalId
Stable ID: validation.validationId

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.
PROPOSAL_MISMATCH	Proposal ID does not match the active Proposal.	Inspect the active Proposal and retry with its stable ID.
PROPOSAL_EMPTY	Proposal contains no executable Changes.	Keep accepted truth unchanged; create a Proposal only after at least one planning Change exists.
PLAN_VERSION_CONFLICT	Plan version conflict.	Inspect the latest Plan Version and create or rebase the Proposal before retrying.
VALIDATION_FAILED	Proposal validation failed.	Resolve every hard Constraint failure and validate again.
WARNING_WAIVER_REQUIRED	Proposal has warnings that require a human Warning Waiver.	Have a human record a reason-coded waiver for every open warning.
EMERGENCY_REVIEW_REQUIRED	Emergency Plan Change requires an authorized human Emergency Review.	Supply a reviewer ID, authorized reviewer role, and explicit assumption acceptance in VenueMind Studio.

Complete error catalog

Input

Field	Type	Required	Default	Bounds	Meaning
type	const "approve_proposal"	yes	—	—	Stable command discriminator.
proposalId	string	yes	—	—	Stable Proposal ID.
baseVersion	string	yes	—	—	Accepted Plan Version on which the Proposal is based.
actor	const "human"	yes	—	—	Claimed action source; policy verifies it against the principal.
emergencyReview	object	no	—	—	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.
source	studio \| webmcp \| mcp \| system \| agent-tool	no	—	—	Surface that submitted the command.
sessionId	string	no	—	min 1 chars	Calling session identity.
actorId	string	no	—	min 1 chars	Authenticated or local stable actor identity.

json

{
  "type": "approve_proposal",
  "proposalId": "proposal-example",
  "baseVersion": "3.2",
  "actor": "human",
  "idempotencyKey": "example-command-001"
}

Output field

Meaning

planId

Stable identifier.

planVersion

Published result field.

proposalId

Stable identifier.

status

Published result field.

validation

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.
PROPOSAL_MISMATCH	Proposal ID does not match the active Proposal.	Inspect the active Proposal and retry with its stable ID.
PROPOSAL_EMPTY	Proposal contains no executable Changes.	Keep accepted truth unchanged; create a Proposal only after at least one planning Change exists.
PLAN_VERSION_CONFLICT	Plan version conflict.	Inspect the latest Plan Version and create or rebase the Proposal before retrying.
VALIDATION_FAILED	Proposal validation failed.	Resolve every hard Constraint failure and validate again.
WARNING_WAIVER_REQUIRED	Proposal has warnings that require a human Warning Waiver.	Have a human record a reason-coded waiver for every open warning.
EMERGENCY_REVIEW_REQUIRED	Emergency Plan Change requires an authorized human Emergency Review.	Supply a reviewer ID, authorized reviewer role, and explicit assumption acceptance in VenueMind Studio.