group.leave

Leave a group chat — a command that settles ambiguous on current hosts and cannot confirm it worked.

Known issue

This 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 does not complete on hosts running macOS 26, so the leave is never confirmed. 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": "ambiguous",
  "errorCode": "group_leave_unverified"
}

Errors

Status	Code	Cause
`400`	`invalid_conversationId`	Malformed or missing conversation id
`400`	`group_command_requires_group_conversation`	Target is a DM
`404`	`conversation_not_found`	Unknown conversation, or another account's
`503`	`connector_unavailable`	No Mac holds a live lease