Archive a Channel Partner
partners.archive.v2
Use when: The user explicitly approved archiving one exact Partner after reviewing its network-account impact.
Avoid when: You intend only to deactivate one route; use partners.network.route.set.v2 with an appropriate relationship status.
Effects: Archives the Partner version chain and linked Partner Account; its network routes stop contributing to access. Destructive.
Cost: No gateway rate is configured. Check the Core workflow preview/quote for downstream charges and final settlement. Gateway rate code: none; downstream billing may apply.
Access: actions:execute. Approval: exact_scope_single_action. A stable operation UUID is required.
Keep the same operation and operation_id when retrying identical work. Reconcile an uncertain result before new work; never replay an old V1 write under a new V2 ID.
Check status, execution_state, error_code, output and evidence/resource references. Queued work is not complete: poll jobs.status.get.v2 in domain.workspace.v2. For read-back verification require read_back_verified=true where returned; reconcile failures without creating another object.
Invocation example using fictional fixtures
{
"tool": "domain.partners.v2",
"arguments": {
"params": {
"action": "invoke",
"operation": "partners.archive.v2",
"arguments": {
"partner_id": "00000000-0000-4000-8000-000000000001"
},
"operation_id": "00000000-0000-4000-8000-000000000003"
}
},
"notice": "Fictional fixture IDs and example text. Resolve real IDs, use returned preview tokens and approve exact side effects before execution. Input validation is not proof of provider readiness or a successful business outcome."
}Input schema: fields, defaults and constraints
{
"additionalProperties": false,
"properties": {
"partner_id": {
"description": "Exact Partner UUID returned by partners.list.v2.",
"format": "uuid",
"title": "Partner Id",
"type": "string"
},
"reason": {
"anyOf": [
{
"maxLength": 2000,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Reason used by the partner archive input v2 operation.",
"title": "Reason"
},
"action_proposal_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional. Hivekind fills this from the MCP consent grant.",
"title": "Action Proposal Id"
}
},
"required": [
"partner_id"
],
"title": "McpMcpPartnerArchiveInputV2",
"type": "object"
}Output schema inside the result envelope
{
"additionalProperties": false,
"properties": {
"partner_id": {
"format": "uuid",
"title": "Partner Id",
"type": "string"
},
"workspace_id": {
"format": "uuid",
"title": "Workspace Id",
"type": "string"
},
"account_id": {
"format": "uuid",
"title": "Account Id",
"type": "string"
},
"name": {
"maxLength": 160,
"minLength": 1,
"title": "Name",
"type": "string"
},
"domain": {
"anyOf": [
{
"maxLength": 255,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Domain"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Description"
},
"partner_type": {
"const": "Channel",
"default": "Channel",
"title": "Partner Type",
"type": "string"
},
"status": {
"enum": [
"Active",
"Inactive"
],
"title": "Status",
"type": "string"
},
"owner_id": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Owner Id"
},
"owner_name": {
"anyOf": [
{
"maxLength": 255,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Owner Name"
},
"network_account_count": {
"default": 0,
"minimum": 0,
"title": "Network Account Count",
"type": "integer"
},
"version_number": {
"minimum": 1,
"title": "Version Number",
"type": "integer"
},
"version_label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Version Label"
},
"archived_at": {
"anyOf": [
{
"format": "date-time",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Archived At"
},
"archived_by": {
"anyOf": [
{
"format": "uuid",
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Archived By"
},
"created_at": {
"format": "date-time",
"title": "Created At",
"type": "string"
},
"updated_at": {
"format": "date-time",
"title": "Updated At",
"type": "string"
}
},
"required": [
"partner_id",
"workspace_id",
"account_id",
"name",
"status",
"version_number",
"created_at",
"updated_at"
],
"title": "PartnerArchiveResultV2",
"type": "object"
}