Get sending seat

Get one sending seat with its health over the rolling window: messages sent, hard bounces and opt-outs (complaints and unsubscribes), the rates, whether it is healthy, messages sent today and today's warm-up cap.

Outcome

Before you start

Verify the intended environment, signed-in credential, authorized organization and the action permission workspace:read.
Discover and select an authorized canonical Engage workspace. Pass resourceType=workspace and resourceId separately from action input.

Discover the target

topolo whoami --json
topolo actions get app_topolo_engage.seats.get --json
topolo workspaces list topolo-engage --json

Set ENGAGE_WORKSPACE_ID to the identifier of the selected authorized workspace.

Input contract

Field	Required	Declared constraints
`id`	Yes	`{"type":"string","minLength":1,"maxLength":128}`

Validate, plan and execute

Build payload.json from the current schema and discovered identifiers. The action description above defines its behavior, limits, side effects and declared errors.

: "${ENGAGE_WORKSPACE_ID:?Set ENGAGE_WORKSPACE_ID to your selected workspace identifier}"
topolo actions validate app_topolo_engage.seats.get --data @payload.json --json
topolo actions plan app_topolo_engage.seats.get --resource-type workspace --resource-id "$ENGAGE_WORKSPACE_ID" --data @payload.json --json

Execute the unchanged validated read.

: "${ENGAGE_WORKSPACE_ID:?Set ENGAGE_WORKSPACE_ID to your selected workspace identifier}"
topolo actions call app_topolo_engage.seats.get --resource-type workspace --resource-id "$ENGAGE_WORKSPACE_ID" --data @payload.json --json

For MCP, use topolo_get_action, topolo_validate_action, topolo_plan_action and topolo_call_action. Pass resource context separately where required; confirm:true is required for mutations.

Captured successful requests and responses

Captured HTTP 200 · sender health enforcement > pauses a seat over the hard-bounce limit with its reason and audits it, once

Action input

{
  "id": "eng_seat_1"
}

Actual local response

{
  "seat": {
    "id": "eng_seat_1",
    "nexusMailboxId": "mbsender_1",
    "mailboxStatus": "active",
    "mailboxCheckedAt": "2026-10-06T08:30:00.000Z",
    "whatsappConnectionId": null,
    "displayName": "Ash",
    "fromAddress": "ash@example.com",
    "status": "paused",
    "pauseReason": "health_hard_bounce_rate",
    "timezone": "Europe/London",
    "warmup": {
      "startDate": "2026-10-01",
      "startLimit": 10,
      "dailyIncrease": 3,
      "maxLimit": 50
    },
    "createdAt": "2026-10-06T08:30:00.000Z",
    "updatedAt": "2026-10-06T08:30:00.000Z",
    "health": {
      "windowDays": 14,
      "sent": 20,
      "bounced": 2,
      "optedOut": 0,
      "bounceRate": 0.1,
      "optOutRate": 0,
      "healthy": false,
      "sentToday": 20,
      "warmupCap": 25
    }
  }
}

Source test: sender health enforcement > pauses a seat over the hard-bounce limit with its reason and audits it, once. Actual route handlers with SQLite repositories; synthetic identity/workspace grants and provider ports.

Captured HTTP 200 · sender health enforcement > leaves a seat under the minimum volume, and never rewrites a manual pause

Action input

{
  "id": "eng_seat_1"
}

Actual local response

{
  "seat": {
    "id": "eng_seat_1",
    "nexusMailboxId": "mbsender_1",
    "mailboxStatus": "active",
    "mailboxCheckedAt": "2026-10-06T08:30:00.000Z",
    "whatsappConnectionId": null,
    "displayName": "Ash",
    "fromAddress": "ash@example.com",
    "status": "active",
    "pauseReason": null,
    "timezone": "Europe/London",
    "warmup": {
      "startDate": "2026-10-01",
      "startLimit": 10,
      "dailyIncrease": 3,
      "maxLimit": 50
    },
    "createdAt": "2026-10-06T08:30:00.000Z",
    "updatedAt": "2026-10-06T08:30:00.000Z",
    "health": {
      "windowDays": 14,
      "sent": 10,
      "bounced": 10,
      "optedOut": 0,
      "bounceRate": 1,
      "optOutRate": 0,
      "healthy": true,
      "sentToday": 10,
      "warmupCap": 25
    }
  }
}

Source test: sender health enforcement > leaves a seat under the minimum volume, and never rewrites a manual pause. Actual route handlers with SQLite repositories; synthetic identity/workspace grants and provider ports.

Captured HTTP 200 · sender health enforcement > pauses on complaints, a soft-bounce streak and a mailbox issue

Action input

{
  "id": "eng_seat_1"
}

Actual local response

{
  "seat": {
    "id": "eng_seat_1",
    "nexusMailboxId": "mbsender_1",
    "mailboxStatus": "active",
    "mailboxCheckedAt": "2026-10-06T08:30:00.000Z",
    "whatsappConnectionId": null,
    "displayName": "Ash",
    "fromAddress": "a@one.io",
    "status": "paused",
    "pauseReason": "health_complaint_rate",
    "timezone": "Europe/London",
    "warmup": {
      "startDate": "2026-10-01",
      "startLimit": 10,
      "dailyIncrease": 3,
      "maxLimit": 50
    },
    "createdAt": "2026-10-06T08:30:00.000Z",
    "updatedAt": "2026-10-06T08:30:00.000Z",
    "health": {
      "windowDays": 14,
      "sent": 50,
      "bounced": 0,
      "optedOut": 1,
      "bounceRate": 0,
      "optOutRate": 0.02,
      "healthy": true,
      "sentToday": 50,
      "warmupCap": 25
    }
  }
}

Source test: sender health enforcement > pauses on complaints, a soft-bounce streak and a mailbox issue. Actual route handlers with SQLite repositories; synthetic identity/workspace grants and provider ports.

Captured HTTP 200 · sender health enforcement > pauses every seat on a breaching sending domain

Action input

{
  "id": "eng_seat_1"
}

Actual local response

{
  "seat": {
    "id": "eng_seat_1",
    "nexusMailboxId": "mbsender_1",
    "mailboxStatus": "active",
    "mailboxCheckedAt": "2026-10-06T08:30:00.000Z",
    "whatsappConnectionId": null,
    "displayName": "Ash",
    "fromAddress": "a@shared.io",
    "status": "paused",
    "pauseReason": "health_domain_breach",
    "timezone": "Europe/London",
    "warmup": {
      "startDate": "2026-10-01",
      "startLimit": 10,
      "dailyIncrease": 3,
      "maxLimit": 50
    },
    "createdAt": "2026-10-06T08:30:00.000Z",
    "updatedAt": "2026-10-06T08:30:00.000Z",
    "health": {
      "windowDays": 14,
      "sent": 10,
      "bounced": 1,
      "optedOut": 0,
      "bounceRate": 0.1,
      "optOutRate": 0,
      "healthy": true,
      "sentToday": 10,
      "warmupCap": 25
    }
  }
}

Source test: sender health enforcement > pauses every seat on a breaching sending domain. Actual route handlers with SQLite repositories; synthetic identity/workspace grants and provider ports.

Captured HTTP 200 · sender health enforcement > the scheduled run pauses the seat before sending, so it sends nothing

Action input

{
  "id": "eng_seat_1"
}

Actual local response

{
  "seat": {
    "id": "eng_seat_1",
    "nexusMailboxId": "mbsender_1",
    "mailboxStatus": "active",
    "mailboxCheckedAt": "2026-10-06T08:30:00.000Z",
    "whatsappConnectionId": null,
    "displayName": "Ash",
    "fromAddress": "ash@example.com",
    "status": "paused",
    "pauseReason": "health_hard_bounce_rate",
    "timezone": "Europe/London",
    "warmup": {
      "startDate": "2026-10-01",
      "startLimit": 10,
      "dailyIncrease": 3,
      "maxLimit": 50
    },
    "createdAt": "2026-10-06T08:30:00.000Z",
    "updatedAt": "2026-10-06T08:30:00.000Z",
    "health": {
      "windowDays": 14,
      "sent": 20,
      "bounced": 2,
      "optedOut": 0,
      "bounceRate": 0.1,
      "optOutRate": 0,
      "healthy": false,
      "sentToday": 0,
      "warmupCap": 25
    }
  }
}

Source test: sender health enforcement > the scheduled run pauses the seat before sending, so it sends nothing. Actual route handlers with SQLite repositories; synthetic identity/workspace grants and provider ports.

Captured HTTP 200 · runDueSends > hold order > warm-up cap counts the seat's sends today

Action input

{
  "id": "eng_seat_1"
}

Actual local response

{
  "seat": {
    "id": "eng_seat_1",
    "nexusMailboxId": "mbsender_1",
    "mailboxStatus": "active",
    "mailboxCheckedAt": "2026-10-06T08:30:00.000Z",
    "whatsappConnectionId": null,
    "displayName": "Ash",
    "fromAddress": "ash@example.com",
    "status": "active",
    "pauseReason": null,
    "timezone": "Europe/London",
    "warmup": {
      "startDate": "2026-10-01",
      "startLimit": 1,
      "dailyIncrease": 3,
      "maxLimit": 1
    },
    "createdAt": "2026-10-06T08:30:00.000Z",
    "updatedAt": "2026-10-06T08:30:00.000Z",
    "health": {
      "windowDays": 14,
      "sent": 1,
      "bounced": 0,
      "optedOut": 0,
      "bounceRate": 0,
      "optOutRate": 0,
      "healthy": true,
      "sentToday": 1,
      "warmupCap": 1
    }
  }
}

Source test: runDueSends > hold order > warm-up cap counts the seat's sends today. Actual route handlers with SQLite repositories; synthetic identity/workspace grants and provider ports.

Captured HTTP 200 · sender health enforcement > leaves a seat under the minimum volume, and never rewrites a manual pause

Action input

{
  "id": "eng_seat_2"
}

Actual local response

{
  "seat": {
    "id": "eng_seat_2",
    "nexusMailboxId": "mbsender_1",
    "mailboxStatus": "active",
    "mailboxCheckedAt": "2026-10-06T08:30:00.000Z",
    "whatsappConnectionId": null,
    "displayName": "Ash",
    "fromAddress": "b@other.io",
    "status": "paused",
    "pauseReason": "manual",
    "timezone": "Europe/London",
    "warmup": {
      "startDate": "2026-10-01",
      "startLimit": 10,
      "dailyIncrease": 3,
      "maxLimit": 50
    },
    "createdAt": "2026-10-06T08:30:00.000Z",
    "updatedAt": "2026-10-06T08:30:00.000Z",
    "health": {
      "windowDays": 14,
      "sent": 50,
      "bounced": 0,
      "optedOut": 50,
      "bounceRate": 0,
      "optOutRate": 1,
      "healthy": false,
      "sentToday": 50,
      "warmupCap": 25
    }
  }
}

Captured HTTP 200 · sender health enforcement > pauses on complaints, a soft-bounce streak and a mailbox issue

Action input

{
  "id": "eng_seat_2"
}

Actual local response

{
  "seat": {
    "id": "eng_seat_2",
    "nexusMailboxId": "mbsender_1",
    "mailboxStatus": "active",
    "mailboxCheckedAt": "2026-10-06T08:30:00.000Z",
    "whatsappConnectionId": null,
    "displayName": "Ash",
    "fromAddress": "b@two.io",
    "status": "paused",
    "pauseReason": "health_soft_bounce_streak",
    "timezone": "Europe/London",
    "warmup": {
      "startDate": "2026-10-01",
      "startLimit": 10,
      "dailyIncrease": 3,
      "maxLimit": 50
    },
    "createdAt": "2026-10-06T08:30:00.000Z",
    "updatedAt": "2026-10-06T08:30:00.000Z",
    "health": {
      "windowDays": 14,
      "sent": 1,
      "bounced": 0,
      "optedOut": 0,
      "bounceRate": 0,
      "optOutRate": 0,
      "healthy": true,
      "sentToday": 1,
      "warmupCap": 25
    }
  }
}

Captured HTTP 200 · sender health enforcement > pauses on complaints, a soft-bounce streak and a mailbox issue

Action input

{
  "id": "eng_seat_3"
}

Actual local response

{
  "seat": {
    "id": "eng_seat_3",
    "nexusMailboxId": "mbsender_1",
    "mailboxStatus": "needs_reauth",
    "mailboxCheckedAt": "2026-10-06T08:30:00.000Z",
    "whatsappConnectionId": null,
    "displayName": "Ash",
    "fromAddress": "c@three.io",
    "status": "paused",
    "pauseReason": "mailbox_needs_reauth",
    "timezone": "Europe/London",
    "warmup": {
      "startDate": "2026-10-01",
      "startLimit": 10,
      "dailyIncrease": 3,
      "maxLimit": 50
    },
    "createdAt": "2026-10-06T08:30:00.000Z",
    "updatedAt": "2026-10-06T08:30:00.000Z",
    "health": {
      "windowDays": 14,
      "sent": 0,
      "bounced": 0,
      "optedOut": 0,
      "bounceRate": 0,
      "optOutRate": 0,
      "healthy": true,
      "sentToday": 0,
      "warmupCap": 25
    }
  }
}

Captured HTTP 200 · sender health enforcement > pauses every seat on a breaching sending domain

Action input

{
  "id": "eng_seat_2"
}

Actual local response

{
  "seat": {
    "id": "eng_seat_2",
    "nexusMailboxId": "mbsender_1",
    "mailboxStatus": "active",
    "mailboxCheckedAt": "2026-10-06T08:30:00.000Z",
    "whatsappConnectionId": null,
    "displayName": "Ash",
    "fromAddress": "b@shared.io",
    "status": "paused",
    "pauseReason": "health_domain_breach",
    "timezone": "Europe/London",
    "warmup": {
      "startDate": "2026-10-01",
      "startLimit": 10,
      "dailyIncrease": 3,
      "maxLimit": 50
    },
    "createdAt": "2026-10-06T08:30:00.000Z",
    "updatedAt": "2026-10-06T08:30:00.000Z",
    "health": {
      "windowDays": 14,
      "sent": 10,
      "bounced": 1,
      "optedOut": 0,
      "bounceRate": 0.1,
      "optOutRate": 0,
      "healthy": true,
      "sentToday": 10,
      "warmupCap": 25
    }
  }
}

Source test: sender health enforcement > pauses every seat on a breaching sending domain. Actual route handlers with SQLite repositories; synthetic identity/workspace grants and provider ports.

Captured HTTP 200 · sender health enforcement > pauses every seat on a breaching sending domain

Action input

{
  "id": "eng_seat_3"
}

Actual local response

{
  "seat": {
    "id": "eng_seat_3",
    "nexusMailboxId": "mbsender_1",
    "mailboxStatus": "active",
    "mailboxCheckedAt": "2026-10-06T08:30:00.000Z",
    "whatsappConnectionId": null,
    "displayName": "Ash",
    "fromAddress": "c@other.io",
    "status": "active",
    "pauseReason": null,
    "timezone": "Europe/London",
    "warmup": {
      "startDate": "2026-10-01",
      "startLimit": 10,
      "dailyIncrease": 3,
      "maxLimit": 50
    },
    "createdAt": "2026-10-06T08:30:00.000Z",
    "updatedAt": "2026-10-06T08:30:00.000Z",
    "health": {
      "windowDays": 14,
      "sent": 10,
      "bounced": 1,
      "optedOut": 0,
      "bounceRate": 0.1,
      "optOutRate": 0,
      "healthy": true,
      "sentToday": 10,
      "warmupCap": 25
    }
  }
}

Source test: sender health enforcement > pauses every seat on a breaching sending domain. Actual route handlers with SQLite repositories; synthetic identity/workspace grants and provider ports.

Captured HTTP 200 · runner with the Nexus transport contract > outreach_requires_mailbox_sender marks the seat misconfigured, pauses it and holds

Action input

{
  "id": "eng_seat_1"
}

Actual local response

{
  "seat": {
    "id": "eng_seat_1",
    "nexusMailboxId": "mbsender_1",
    "mailboxStatus": "misconfigured",
    "mailboxCheckedAt": "2026-10-06T08:30:00.000Z",
    "whatsappConnectionId": null,
    "displayName": "Ash",
    "fromAddress": "ash@example.com",
    "status": "paused",
    "pauseReason": "outreach_requires_mailbox_sender",
    "timezone": "Europe/London",
    "warmup": {
      "startDate": "2026-10-01",
      "startLimit": 10,
      "dailyIncrease": 3,
      "maxLimit": 50
    },
    "createdAt": "2026-10-06T08:30:00.000Z",
    "updatedAt": "2026-10-06T08:30:00.000Z",
    "health": {
      "windowDays": 14,
      "sent": 0,
      "bounced": 0,
      "optedOut": 0,
      "bounceRate": 0,
      "optOutRate": 0,
      "healthy": true,
      "sentToday": 0,
      "warmupCap": 25
    }
  }
}

Source test: runner with the Nexus transport contract > outreach_requires_mailbox_sender marks the seat misconfigured, pauses it and holds. Actual route handlers with SQLite repositories; synthetic identity/workspace grants and provider ports.

Captured HTTP 200 · sender health on delivery events > a hard bounce that crosses the limit pauses the seat at once

Action input

{
  "id": "eng_seat_1"
}

Actual local response

{
  "seat": {
    "id": "eng_seat_1",
    "nexusMailboxId": "mbsender_1",
    "mailboxStatus": "active",
    "mailboxCheckedAt": "2026-10-06T08:30:00.000Z",
    "whatsappConnectionId": null,
    "displayName": "Ash",
    "fromAddress": "ash@example.com",
    "status": "active",
    "pauseReason": null,
    "timezone": "Europe/London",
    "warmup": {
      "startDate": "2026-10-01",
      "startLimit": 10,
      "dailyIncrease": 3,
      "maxLimit": 50
    },
    "createdAt": "2026-10-06T08:30:00.000Z",
    "updatedAt": "2026-10-06T08:30:00.000Z",
    "health": {
      "windowDays": 14,
      "sent": 20,
      "bounced": 1,
      "optedOut": 0,
      "bounceRate": 0.05,
      "optOutRate": 0,
      "healthy": false,
      "sentToday": 20,
      "warmupCap": 25
    }
  }
}

Source test: sender health on delivery events > a hard bounce that crosses the limit pauses the seat at once. Actual route handlers with SQLite repositories; synthetic identity/workspace grants and provider ports.

Captured HTTP 200 · sender health on delivery events > the third consecutive day of soft bounces pauses the seat

Action input

{
  "id": "eng_seat_1"
}

Actual local response

{
  "seat": {
    "id": "eng_seat_1",
    "nexusMailboxId": "mbsender_1",
    "mailboxStatus": "active",
    "mailboxCheckedAt": "2026-10-06T08:30:00.000Z",
    "whatsappConnectionId": null,
    "displayName": "Ash",
    "fromAddress": "ash@example.com",
    "status": "active",
    "pauseReason": null,
    "timezone": "Europe/London",
    "warmup": {
      "startDate": "2026-10-01",
      "startLimit": 10,
      "dailyIncrease": 3,
      "maxLimit": 50
    },
    "createdAt": "2026-10-06T08:30:00.000Z",
    "updatedAt": "2026-10-06T08:30:00.000Z",
    "health": {
      "windowDays": 14,
      "sent": 1,
      "bounced": 0,
      "optedOut": 0,
      "bounceRate": 0,
      "optOutRate": 0,
      "healthy": true,
      "sentToday": 1,
      "warmupCap": 25
    }
  }
}

Source test: sender health on delivery events > the third consecutive day of soft bounces pauses the seat. Actual route handlers with SQLite repositories; synthetic identity/workspace grants and provider ports.

Captured HTTP 200 · runner with the Nexus transport contract > outreach_domain_reserved marks the seat misconfigured, pauses it and holds

Action input

{
  "id": "eng_seat_1"
}

Actual local response

{
  "seat": {
    "id": "eng_seat_1",
    "nexusMailboxId": "mbsender_1",
    "mailboxStatus": "misconfigured",
    "mailboxCheckedAt": "2026-10-06T08:30:00.000Z",
    "whatsappConnectionId": null,
    "displayName": "Ash",
    "fromAddress": "ash@example.com",
    "status": "paused",
    "pauseReason": "outreach_domain_reserved",
    "timezone": "Europe/London",
    "warmup": {
      "startDate": "2026-10-01",
      "startLimit": 10,
      "dailyIncrease": 3,
      "maxLimit": 50
    },
    "createdAt": "2026-10-06T08:30:00.000Z",
    "updatedAt": "2026-10-06T08:30:00.000Z",
    "health": {
      "windowDays": 14,
      "sent": 0,
      "bounced": 0,
      "optedOut": 0,
      "bounceRate": 0,
      "optOutRate": 0,
      "healthy": true,
      "sentToday": 0,
      "warmupCap": 25
    }
  }
}

Source test: runner with the Nexus transport contract > outreach_domain_reserved marks the seat misconfigured, pauses it and holds. Actual route handlers with SQLite repositories; synthetic identity/workspace grants and provider ports.

Captured HTTP 200 · sender health on delivery events > the third consecutive day of soft bounces pauses the seat

Action input

{
  "id": "eng_seat_1"
}

Actual local response

{
  "seat": {
    "id": "eng_seat_1",
    "nexusMailboxId": "mbsender_1",
    "mailboxStatus": "active",
    "mailboxCheckedAt": "2026-10-06T08:30:00.000Z",
    "whatsappConnectionId": null,
    "displayName": "Ash",
    "fromAddress": "ash@example.com",
    "status": "paused",
    "pauseReason": "health_soft_bounce_streak",
    "timezone": "Europe/London",
    "warmup": {
      "startDate": "2026-10-01",
      "startLimit": 10,
      "dailyIncrease": 3,
      "maxLimit": 50
    },
    "createdAt": "2026-10-06T08:30:00.000Z",
    "updatedAt": "2026-10-06T08:30:00.000Z",
    "health": {
      "windowDays": 14,
      "sent": 1,
      "bounced": 0,
      "optedOut": 0,
      "bounceRate": 0,
      "optOutRate": 0,
      "healthy": true,
      "sentToday": 1,
      "warmupCap": 25
    }
  }
}

Captured HTTP 200 · runDueSends > hold order > an unsubscribe ends the enrollment and counts as an opt-out of the previous message

Action input

{
  "id": "eng_seat_1"
}

Actual local response

{
  "seat": {
    "id": "eng_seat_1",
    "nexusMailboxId": "mbsender_1",
    "mailboxStatus": "active",
    "mailboxCheckedAt": "2026-10-06T08:30:00.000Z",
    "whatsappConnectionId": null,
    "displayName": "Ash",
    "fromAddress": "ash@example.com",
    "status": "active",
    "pauseReason": null,
    "timezone": "Europe/London",
    "warmup": {
      "startDate": "2026-10-01",
      "startLimit": 10,
      "dailyIncrease": 3,
      "maxLimit": 50
    },
    "createdAt": "2026-10-06T08:30:00.000Z",
    "updatedAt": "2026-10-06T08:30:00.000Z",
    "health": {
      "windowDays": 14,
      "sent": 1,
      "bounced": 0,
      "optedOut": 1,
      "bounceRate": 0,
      "optOutRate": 1,
      "healthy": true,
      "sentToday": 0,
      "warmupCap": 46
    }
  }
}

Source test: runDueSends > hold order > an unsubscribe ends the enrollment and counts as an opt-out of the previous message. Actual route handlers with SQLite repositories; synthetic identity/workspace grants and provider ports.

Captured HTTP 200 · runner with the Nexus transport contract > mailbox_not_allowed_for_engage pauses the seat with that reason and holds

Action input

{
  "id": "eng_seat_1"
}

Actual local response

{
  "seat": {
    "id": "eng_seat_1",
    "nexusMailboxId": "mbsender_1",
    "mailboxStatus": "active",
    "mailboxCheckedAt": "2026-10-06T08:30:00.000Z",
    "whatsappConnectionId": null,
    "displayName": "Ash",
    "fromAddress": "ash@example.com",
    "status": "paused",
    "pauseReason": "mailbox_not_allowed_for_engage",
    "timezone": "Europe/London",
    "warmup": {
      "startDate": "2026-10-01",
      "startLimit": 10,
      "dailyIncrease": 3,
      "maxLimit": 50
    },
    "createdAt": "2026-10-06T08:30:00.000Z",
    "updatedAt": "2026-10-06T08:30:00.000Z",
    "health": {
      "windowDays": 14,
      "sent": 0,
      "bounced": 0,
      "optedOut": 0,
      "bounceRate": 0,
      "optOutRate": 0,
      "healthy": true,
      "sentToday": 0,
      "warmupCap": 25
    }
  }
}

Source test: runner with the Nexus transport contract > mailbox_not_allowed_for_engage pauses the seat with that reason and holds. Actual route handlers with SQLite repositories; synthetic identity/workspace grants and provider ports.

Captured HTTP 200 · sender health on delivery events > without the sender health port, or when enforcement fails, the delivery still succeeds

Action input

{
  "id": "eng_seat_1"
}

Actual local response

{
  "seat": {
    "id": "eng_seat_1",
    "nexusMailboxId": "mbsender_1",
    "mailboxStatus": "active",
    "mailboxCheckedAt": "2026-10-06T08:30:00.000Z",
    "whatsappConnectionId": null,
    "displayName": "Ash",
    "fromAddress": "ash@example.com",
    "status": "active",
    "pauseReason": null,
    "timezone": "Europe/London",
    "warmup": {
      "startDate": "2026-10-01",
      "startLimit": 10,
      "dailyIncrease": 3,
      "maxLimit": 50
    },
    "createdAt": "2026-10-06T08:30:00.000Z",
    "updatedAt": "2026-10-06T08:30:00.000Z",
    "health": {
      "windowDays": 14,
      "sent": 20,
      "bounced": 2,
      "optedOut": 0,
      "bounceRate": 0.1,
      "optOutRate": 0,
      "healthy": false,
      "sentToday": 20,
      "warmupCap": 25
    }
  }
}

Source test: sender health on delivery events > without the sender health port, or when enforcement fails, the delivery still succeeds. Actual route handlers with SQLite repositories; synthetic identity/workspace grants and provider ports.

Captured HTTP 200 · runner with the Nexus transport contract > mailbox_needs_reauth pauses the seat with that reason and holds

Action input

{
  "id": "eng_seat_1"
}

Actual local response

{
  "seat": {
    "id": "eng_seat_1",
    "nexusMailboxId": "mbsender_1",
    "mailboxStatus": "active",
    "mailboxCheckedAt": "2026-10-06T08:30:00.000Z",
    "whatsappConnectionId": null,
    "displayName": "Ash",
    "fromAddress": "ash@example.com",
    "status": "paused",
    "pauseReason": "mailbox_needs_reauth",
    "timezone": "Europe/London",
    "warmup": {
      "startDate": "2026-10-01",
      "startLimit": 10,
      "dailyIncrease": 3,
      "maxLimit": 50
    },
    "createdAt": "2026-10-06T08:30:00.000Z",
    "updatedAt": "2026-10-06T08:30:00.000Z",
    "health": {
      "windowDays": 14,
      "sent": 0,
      "bounced": 0,
      "optedOut": 0,
      "bounceRate": 0,
      "optOutRate": 0,
      "healthy": true,
      "sentToday": 0,
      "warmupCap": 25
    }
  }
}

Source test: runner with the Nexus transport contract > mailbox_needs_reauth pauses the seat with that reason and holds. Actual route handlers with SQLite repositories; synthetic identity/workspace grants and provider ports.

Captured HTTP 200 · runner with the Nexus transport contract > mailbox_unavailable pauses the seat with that reason and holds

Action input

{
  "id": "eng_seat_1"
}

Actual local response

{
  "seat": {
    "id": "eng_seat_1",
    "nexusMailboxId": "mbsender_1",
    "mailboxStatus": "active",
    "mailboxCheckedAt": "2026-10-06T08:30:00.000Z",
    "whatsappConnectionId": null,
    "displayName": "Ash",
    "fromAddress": "ash@example.com",
    "status": "paused",
    "pauseReason": "mailbox_unavailable",
    "timezone": "Europe/London",
    "warmup": {
      "startDate": "2026-10-01",
      "startLimit": 10,
      "dailyIncrease": 3,
      "maxLimit": 50
    },
    "createdAt": "2026-10-06T08:30:00.000Z",
    "updatedAt": "2026-10-06T08:30:00.000Z",
    "health": {
      "windowDays": 14,
      "sent": 0,
      "bounced": 0,
      "optedOut": 0,
      "bounceRate": 0,
      "optOutRate": 0,
      "healthy": true,
      "sentToday": 0,
      "warmupCap": 25
    }
  }
}

Source test: runner with the Nexus transport contract > mailbox_unavailable pauses the seat with that reason and holds. Actual route handlers with SQLite repositories; synthetic identity/workspace grants and provider ports.

Captured HTTP 200 · runDueSends > seat health auto-pause > pauses a seat over the bounce limit and resumes it once the 14-day window recovers

Action input

{
  "id": "eng_seat_1"
}

Actual local response

{
  "seat": {
    "id": "eng_seat_1",
    "nexusMailboxId": "mbsender_1",
    "mailboxStatus": "active",
    "mailboxCheckedAt": "2026-10-06T08:30:00.000Z",
    "whatsappConnectionId": null,
    "displayName": "Ash",
    "fromAddress": "ash@example.com",
    "status": "paused",
    "pauseReason": "health_bounce_rate",
    "timezone": "Europe/London",
    "warmup": {
      "startDate": "2026-10-01",
      "startLimit": 100,
      "dailyIncrease": 3,
      "maxLimit": 100
    },
    "createdAt": "2026-10-06T08:30:00.000Z",
    "updatedAt": "2026-10-06T08:30:00.000Z",
    "health": {
      "windowDays": 14,
      "sent": 20,
      "bounced": 1,
      "optedOut": 0,
      "bounceRate": 0.05,
      "optOutRate": 0,
      "healthy": false,
      "sentToday": 0,
      "warmupCap": 100
    }
  }
}

Source test: runDueSends > seat health auto-pause > pauses a seat over the bounce limit and resumes it once the 14-day window recovers. Actual route handlers with SQLite repositories; synthetic identity/workspace grants and provider ports.

Captured HTTP 200 · runDueSends > seat health auto-pause > pauses a seat over the bounce limit and resumes it once the 14-day window recovers

Action input

{
  "id": "eng_seat_1"
}

Actual local response

{
  "seat": {
    "id": "eng_seat_1",
    "nexusMailboxId": "mbsender_1",
    "mailboxStatus": "active",
    "mailboxCheckedAt": "2026-10-06T08:30:00.000Z",
    "whatsappConnectionId": null,
    "displayName": "Ash",
    "fromAddress": "ash@example.com",
    "status": "active",
    "pauseReason": null,
    "timezone": "Europe/London",
    "warmup": {
      "startDate": "2026-10-01",
      "startLimit": 100,
      "dailyIncrease": 3,
      "maxLimit": 100
    },
    "createdAt": "2026-10-06T08:30:00.000Z",
    "updatedAt": "2026-10-15T09:30:00.000Z",
    "health": {
      "windowDays": 14,
      "sent": 1,
      "bounced": 0,
      "optedOut": 0,
      "bounceRate": 0,
      "optOutRate": 0,
      "healthy": true,
      "sentToday": 1,
      "warmupCap": 100
    }
  }
}

Captured HTTP 200 · runDueSends > seat health auto-pause > pauses on opt-outs, and never lifts a manual pause

Action input

{
  "id": "eng_seat_1"
}

Actual local response

{
  "seat": {
    "id": "eng_seat_1",
    "nexusMailboxId": "mbsender_1",
    "mailboxStatus": "active",
    "mailboxCheckedAt": "2026-10-06T08:30:00.000Z",
    "whatsappConnectionId": null,
    "displayName": "Ash",
    "fromAddress": "ash@example.com",
    "status": "paused",
    "pauseReason": "health_opt_out_rate",
    "timezone": "Europe/London",
    "warmup": {
      "startDate": "2026-10-01",
      "startLimit": 10,
      "dailyIncrease": 3,
      "maxLimit": 50
    },
    "createdAt": "2026-10-06T08:30:00.000Z",
    "updatedAt": "2026-10-06T08:30:00.000Z",
    "health": {
      "windowDays": 14,
      "sent": 20,
      "bounced": 0,
      "optedOut": 2,
      "bounceRate": 0,
      "optOutRate": 0.1,
      "healthy": false,
      "sentToday": 0,
      "warmupCap": 25
    }
  }
}

Source test: runDueSends > seat health auto-pause > pauses on opt-outs, and never lifts a manual pause. Actual route handlers with SQLite repositories; synthetic identity/workspace grants and provider ports.

Captured HTTP 200 · runDueSends > seat health auto-pause > pauses on opt-outs, and never lifts a manual pause

Action input

{
  "id": "eng_seat_1"
}

Actual local response

{
  "seat": {
    "id": "eng_seat_1",
    "nexusMailboxId": "mbsender_1",
    "mailboxStatus": "active",
    "mailboxCheckedAt": "2026-10-06T08:30:00.000Z",
    "whatsappConnectionId": null,
    "displayName": "Ash",
    "fromAddress": "ash@example.com",
    "status": "paused",
    "pauseReason": "manual",
    "timezone": "Europe/London",
    "warmup": {
      "startDate": "2026-10-01",
      "startLimit": 10,
      "dailyIncrease": 3,
      "maxLimit": 50
    },
    "createdAt": "2026-10-06T08:30:00.000Z",
    "updatedAt": "2026-10-06T08:30:00.000Z",
    "health": {
      "windowDays": 14,
      "sent": 0,
      "bounced": 0,
      "optedOut": 0,
      "bounceRate": 0,
      "optOutRate": 0,
      "healthy": true,
      "sentToday": 0,
      "warmupCap": 50
    }
  }
}

Captured HTTP 200 · seat WhatsApp number > sets, trims and clears the number, audited with the previous value, and only for writers

Action input

{
  "id": "eng_seat_1"
}

Actual local response

{
  "seat": {
    "id": "eng_seat_1",
    "nexusMailboxId": "mbsender_1",
    "mailboxStatus": "active",
    "mailboxCheckedAt": "2026-10-06T08:30:00.000Z",
    "whatsappConnectionId": null,
    "displayName": "Ash",
    "fromAddress": "ash@example.com",
    "status": "active",
    "pauseReason": null,
    "timezone": "Europe/London",
    "warmup": {
      "startDate": "2026-10-01",
      "startLimit": 10,
      "dailyIncrease": 3,
      "maxLimit": 50
    },
    "createdAt": "2026-10-06T08:30:00.000Z",
    "updatedAt": "2026-10-06T08:30:00.000Z",
    "health": {
      "windowDays": 14,
      "sent": 0,
      "bounced": 0,
      "optedOut": 0,
      "bounceRate": 0,
      "optOutRate": 0,
      "healthy": true,
      "sentToday": 0,
      "warmupCap": 25
    }
  }
}

Source test: seat WhatsApp number > sets, trims and clears the number, audited with the previous value, and only for writers. Actual route handlers with SQLite repositories; synthetic identity/workspace grants and provider ports.

Captured HTTP 200 · seat WhatsApp number > sets, trims and clears the number, audited with the previous value, and only for writers

Action input

{
  "id": "eng_seat_1"
}

Actual local response

{
  "seat": {
    "id": "eng_seat_1",
    "nexusMailboxId": "mbsender_1",
    "mailboxStatus": "active",
    "mailboxCheckedAt": "2026-10-06T08:30:00.000Z",
    "whatsappConnectionId": "wac_ash",
    "displayName": "Ash",
    "fromAddress": "ash@example.com",
    "status": "active",
    "pauseReason": null,
    "timezone": "Europe/London",
    "warmup": {
      "startDate": "2026-10-01",
      "startLimit": 10,
      "dailyIncrease": 3,
      "maxLimit": 50
    },
    "createdAt": "2026-10-06T08:30:00.000Z",
    "updatedAt": "2026-10-06T08:30:00.000Z",
    "health": {
      "windowDays": 14,
      "sent": 0,
      "bounced": 0,
      "optedOut": 0,
      "bounceRate": 0,
      "optOutRate": 0,
      "healthy": true,
      "sentToday": 0,
      "warmupCap": 25
    }
  }
}

Captured HTTP 200 · seat WhatsApp number > keeps the number through other seat edits

Action input

{
  "id": "eng_seat_1"
}

Actual local response

{
  "seat": {
    "id": "eng_seat_1",
    "nexusMailboxId": "mbsender_1",
    "mailboxStatus": "active",
    "mailboxCheckedAt": "2026-10-06T08:30:00.000Z",
    "whatsappConnectionId": "wac_ash",
    "displayName": "Ashley",
    "fromAddress": "ash@example.com",
    "status": "active",
    "pauseReason": null,
    "timezone": "Europe/London",
    "warmup": {
      "startDate": "2026-10-01",
      "startLimit": 10,
      "dailyIncrease": 3,
      "maxLimit": 50
    },
    "createdAt": "2026-10-06T08:30:00.000Z",
    "updatedAt": "2026-10-06T08:30:00.000Z",
    "health": {
      "windowDays": 14,
      "sent": 0,
      "bounced": 0,
      "optedOut": 0,
      "bounceRate": 0,
      "optOutRate": 0,
      "healthy": true,
      "sentToday": 0,
      "warmupCap": 25
    }
  }
}

Source test: seat WhatsApp number > keeps the number through other seat edits. Actual route handlers with SQLite repositories; synthetic identity/workspace grants and provider ports.

Captured HTTP 200 · transport events > a hard bounce records hard_bounce and ends the enrollment as bounced

Action input

{
  "id": "eng_seat_1"
}

Actual local response

{
  "seat": {
    "id": "eng_seat_1",
    "nexusMailboxId": "mbsender_1",
    "mailboxStatus": "active",
    "mailboxCheckedAt": "2026-10-06T08:30:00.000Z",
    "whatsappConnectionId": null,
    "displayName": "Ash",
    "fromAddress": "ash@example.com",
    "status": "active",
    "pauseReason": null,
    "timezone": "Europe/London",
    "warmup": {
      "startDate": "2026-10-01",
      "startLimit": 10,
      "dailyIncrease": 3,
      "maxLimit": 50
    },
    "createdAt": "2026-10-06T08:30:00.000Z",
    "updatedAt": "2026-10-06T08:30:00.000Z",
    "health": {
      "windowDays": 14,
      "sent": 1,
      "bounced": 1,
      "optedOut": 0,
      "bounceRate": 1,
      "optOutRate": 0,
      "healthy": true,
      "sentToday": 1,
      "warmupCap": 25
    }
  }
}

Source test: transport events > a hard bounce records hard_bounce and ends the enrollment as bounced. Actual route handlers with SQLite repositories; synthetic identity/workspace grants and provider ports.

Captured HTTP 200 · seat mailbox actions > a new seat has no mailbox until one is bound

Action input

{
  "id": "eng_seat_1"
}

Actual local response

{
  "seat": {
    "id": "eng_seat_1",
    "nexusMailboxId": null,
    "mailboxStatus": null,
    "mailboxCheckedAt": null,
    "whatsappConnectionId": null,
    "displayName": "Ash",
    "fromAddress": "ash@example.com",
    "status": "active",
    "pauseReason": null,
    "timezone": "Europe/London",
    "warmup": {
      "startDate": "2026-10-01",
      "startLimit": 10,
      "dailyIncrease": 3,
      "maxLimit": 50
    },
    "createdAt": "2026-10-06T08:30:00.000Z",
    "updatedAt": "2026-10-06T08:30:00.000Z",
    "health": {
      "windowDays": 14,
      "sent": 0,
      "bounced": 0,
      "optedOut": 0,
      "bounceRate": 0,
      "optOutRate": 0,
      "healthy": true,
      "sentToday": 0,
      "warmupCap": 25
    }
  }
}

Source test: seat mailbox actions > a new seat has no mailbox until one is bound. Actual route handlers with SQLite repositories; synthetic identity/workspace grants and provider ports.

Captured HTTP 200 · seat routes > creates a seat with OpenClaw warm-up defaults counted from today in its zone

Action input

{
  "id": "eng_seat_1"
}

Actual local response

{
  "seat": {
    "id": "eng_seat_1",
    "nexusMailboxId": null,
    "mailboxStatus": null,
    "mailboxCheckedAt": null,
    "whatsappConnectionId": null,
    "displayName": "Ash",
    "fromAddress": "ash@example.com",
    "status": "active",
    "pauseReason": null,
    "timezone": "Europe/London",
    "warmup": {
      "startDate": "2026-10-06",
      "startLimit": 10,
      "dailyIncrease": 3,
      "maxLimit": 50
    },
    "createdAt": "2026-10-06T08:30:00.000Z",
    "updatedAt": "2026-10-06T08:30:00.000Z",
    "health": {
      "windowDays": 14,
      "sent": 0,
      "bounced": 0,
      "optedOut": 0,
      "bounceRate": 0,
      "optOutRate": 0,
      "healthy": true,
      "sentToday": 0,
      "warmupCap": 10
    }
  }
}

Source test: seat routes > creates a seat with OpenClaw warm-up defaults counted from today in its zone. Actual route handlers with SQLite repositories; synthetic identity/workspace grants and provider ports.

Effects and response meaning

Get one sending seat with its health over the rolling window: messages sent, hard bounces and opt-outs (complaints and unsubscribes), the rates, whether it is healthy, messages sent today and today's warm-up cap.

Verify the outcome

Check the response against the declared output schema and the requested operation. For mutations, use the action-specific read described in the action description before any dependent operation.

Recover

For an uncertain result, inspect current retained state with a read action before retrying. Do not replay a mutation unless its contract explicitly guarantees idempotency.

Refused requests

Captured HTTP 404 · seat routes > keeps seats inside their workspace and organization

Action input

{
  "id": "eng_seat_1"
}

Actual local response

{
  "error": {
    "code": "not_found",
    "message": "Seat was not found in this workspace."
  }
}

Source test: seat routes > keeps seats inside their workspace and organization. Actual route handlers with SQLite repositories; synthetic identity/workspace grants and provider ports.

Error recovery

HTTP 404 not_found: Rediscover the identifier using the related list or get action in the same authorized resource. Do not guess identifiers or change organization context.

Evidence and limits

/api/seats/{id}
Actual route handlers with SQLite repositories; synthetic identity/workspace grants and provider ports.
Widget/bootstrap use actual app handler but mocked worker runtime and app identity.
No gateway execution, live permissions, external delivery or deployed proof.

These are local route captures with synthetic identity and simulated dependencies. They do not prove live authorization, gateway execution, production state, or external delivery.

Outcome

Before you start

Discover the target

Input contract

Validate, plan and execute

Captured successful requests and responses

Captured HTTP 200 · sender health enforcement > pauses a seat over the hard-bounce limit with its reason and audits it, once

Captured HTTP 200 · sender health enforcement > leaves a seat under the minimum volume, and never rewrites a manual pause

Captured HTTP 200 · sender health enforcement > pauses on complaints, a soft-bounce streak and a mailbox issue

Captured HTTP 200 · sender health enforcement > pauses every seat on a breaching sending domain

Captured HTTP 200 · sender health enforcement > the scheduled run pauses the seat before sending, so it sends nothing

Captured HTTP 200 · runDueSends > hold order > warm-up cap counts the seat's sends today

Captured HTTP 200 · sender health enforcement > leaves a seat under the minimum volume, and never rewrites a manual pause

Captured HTTP 200 · sender health enforcement > pauses on complaints, a soft-bounce streak and a mailbox issue

Captured HTTP 200 · sender health enforcement > pauses on complaints, a soft-bounce streak and a mailbox issue

Captured HTTP 200 · sender health enforcement > pauses every seat on a breaching sending domain

Captured HTTP 200 · sender health enforcement > pauses every seat on a breaching sending domain

Captured HTTP 200 · runner with the Nexus transport contract > outreach_requires_mailbox_sender marks the seat misconfigured, pauses it and holds

Captured HTTP 200 · sender health on delivery events > a hard bounce that crosses the limit pauses the seat at once

Captured HTTP 200 · sender health on delivery events > the third consecutive day of soft bounces pauses the seat

Captured HTTP 200 · runner with the Nexus transport contract > outreach_domain_reserved marks the seat misconfigured, pauses it and holds

Captured HTTP 200 · sender health on delivery events > the third consecutive day of soft bounces pauses the seat

Captured HTTP 200 · runDueSends > hold order > an unsubscribe ends the enrollment and counts as an opt-out of the previous message

Captured HTTP 200 · runner with the Nexus transport contract > mailbox_not_allowed_for_engage pauses the seat with that reason and holds

Captured HTTP 200 · sender health on delivery events > without the sender health port, or when enforcement fails, the delivery still succeeds

Captured HTTP 200 · runner with the Nexus transport contract > mailbox_needs_reauth pauses the seat with that reason and holds

Captured HTTP 200 · runner with the Nexus transport contract > mailbox_unavailable pauses the seat with that reason and holds

Captured HTTP 200 · runDueSends > seat health auto-pause > pauses a seat over the bounce limit and resumes it once the 14-day window recovers

Captured HTTP 200 · runDueSends > seat health auto-pause > pauses a seat over the bounce limit and resumes it once the 14-day window recovers

Captured HTTP 200 · runDueSends > seat health auto-pause > pauses on opt-outs, and never lifts a manual pause

Captured HTTP 200 · runDueSends > seat health auto-pause > pauses on opt-outs, and never lifts a manual pause

Captured HTTP 200 · seat WhatsApp number > sets, trims and clears the number, audited with the previous value, and only for writers

Captured HTTP 200 · seat WhatsApp number > sets, trims and clears the number, audited with the previous value, and only for writers

Captured HTTP 200 · seat WhatsApp number > keeps the number through other seat edits

Captured HTTP 200 · transport events > a hard bounce records hard_bounce and ends the enrollment as bounced

Captured HTTP 200 · seat mailbox actions > a new seat has no mailbox until one is bound

Captured HTTP 200 · seat routes > creates a seat with OpenClaw warm-up defaults counted from today in its zone

Effects and response meaning

Verify the outcome

Recover

Refused requests

Captured HTTP 404 · seat routes > keeps seats inside their workspace and organization

Error recovery

Related actions

Evidence and limits