group.leave

Known issue — does not currently work on macOS 26.

POST /v1/commands/group.leave

Removes you from a group chat.

This command is accepted and queued, but the underlying macOS call fails on hosts running macOS 26 and the command settles as a failure. It is documented for completeness. Do not build on it until the host issue is resolved.

Routing path: admin. Idempotency-Key is ignored.

Target

Prop

Type

Payload

Empty, but required:

{}

Request

curl $MAPIER_BASE_URL/v1/commands/group.leave \
  -H "Authorization: Bearer $MAPIER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "target": {
      "kind": "conversation",
      "conversationId": "a0000000-0000-4000-8000-000000000001"
    },
    "payload": {}
  }'

Response

202 Accepted

{ "commandId": "cmd-7", "status": "queued", "disposition": "queued" }

On an affected host the settlement is:

event: command

{
  "commandId": "cmd-7",
  "logicalActionId": "cmd-7",
  "status": "failed",
  "errorCode": "group_leave_unverified"
}

Errors

Status	Code	Cause
`400`	`group_command_requires_group_conversation`	Target is a DM
`404`	`conversation_not_found`	Unknown conversation, or another account's
`503`	`no_live_connector`	No Mac available

Capabilities

Requires command.group_leave.v1.