archive_branch · VenueMind Docs

Field	Type	Required	Default	Bounds	Meaning
type	const "archive_branch"	yes	—	—	Stable command discriminator.
branchId	string	yes	—	min 1 chars	Stable Proposal Branch ID.
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	no	—	min 1 chars	Authenticated or local stable actor identity.

json

{
  "type": "archive_branch",
  "branchId": "branch-example",
  "idempotencyKey": "example-command-001"
}

Output field

Meaning

status

Published result field.

branchId

Stable identifier.

activeBranchId

Stable identifier.

receipt

Published result field.

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.
BRANCH_NOT_FOUND	Proposal Branch not found.	List Proposal Branches and retry with an existing stable Branch ID.

DOCS

Contract

Field	Type	Required	Default	Bounds	Meaning
type	const "archive_branch"	yes	—	—	Stable command discriminator.
branchId	string	yes	—	min 1 chars	Stable Proposal Branch ID.
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	no	—	min 1 chars	Authenticated or local stable actor identity.

json

{
  "type": "archive_branch",
  "branchId": "branch-example",
  "idempotencyKey": "example-command-001"
}

Archived Branch state and safe active fallback.

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.
BRANCH_NOT_FOUND	Proposal Branch not found.	List Proposal Branches and retry with an existing stable Branch ID.