Get account recovery details

POST

https://api.plusvibe.ai/api/v1/account/recovery

Returns, for up to 100 email accounts, whether an email-account automation rule is holding the account in recovery and, if so, which rule, why it fired, the throttled limits in force, when the recovery period ends (recovery_ends_at) and what limits apply after it. Accounts not in recovery come back with in_recovery: false only, so you can send your whole list without filtering first. Emails that are not in the workspace are listed under not_found. GET /account/list keeps the plain in_recovery boolean; use this endpoint for the detail. Available from 23 Oct 2026.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Body Params application/json

Examples

Responses

🟢200OK

application/json

Successful

Bodyapplication/json

🟠400Bad Request

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.plusvibe.ai/api/v1/account/recovery' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "workspace_id": "65f3c92d3dbe5dbb35374a9a",
    "emails": [
        "bob.johnson@example.com",
        "alice.smith@example.com"
    ]
}'

Response Example

200 - Example 1

{
    "accounts": [
        {
            "email": "bob.johnson@example.com",
            "in_recovery": true,
            "rule": {
                "id": "6a6c75494e018bc225c093ec",
                "name": "High bounce rate guard",
                "priority": 1
            },
            "why_triggered": {
                "reason": "Rule **High bounce rate guard** matched because **Bounce Rate (3 days): 8% > 5%**",
                "triggered_at": "2026-10-20T06:50:17.950Z"
            },
            "sending_plan": {
                "before_recovery": {
                    "daily_limit": 30,
                    "warmup_max_daily_limit": 14,
                    "warmup_reply_rate": 0.74
                },
                "recovery_period": {
                    "current_day": 2,
                    "total_days": 3,
                    "recovery_ends_at": "2026-10-23T06:50:17.950Z",
                    "daily_limit": 5,
                    "warmup_max_daily_limit": 5,
                    "warmup_reply_rate": 0.3
                },
                "after_recovery": {
                    "restore_type": "ORIGINAL",
                    "camp_limit": "FIXED",
                    "daily_limit": 30,
                    "warmup_max_daily_limit": 14,
                    "warmup_reply_rate": 0.74,
                    "ramp_up": null
                }
            },
            "message": "Rule linked with this recovery was deleted."
        }
    ],
    "not_found": [
        "unknown@example.com"
    ]
}

Modified at 2026-10-23 13:43:07

Duplicate automation rule

Get Workspace Settings