Endpoint
GET /api/v1/instances/{id}/health
Parameters path
| Nom | Type | Required | Description |
|---|---|---|---|
id | UUID | yes | ID de l’instance |
Success response 200
{
"data": {
"instanceId": "inst_uuid",
"safetyState": "warming",
"safetyScore": 56,
"firstConnectedAt": "2026-04-10T08:00:00.000Z",
"warmupPolicy": {
"state": "warming",
"instanceAgeDays": 1.4,
"hourlyOutboundCap": 25,
"dailyOutboundCap": 100,
"hourlyUniqueRecipientsCap": 25,
"dailyUniqueRecipientsCap": 100,
"maxCampaignRecipients": 100,
"maxColdRatio": 0.4
},
"usageWindowSummary": {
"outbound1h": 4,
"outbound24h": 18,
"uniqueRecipients1h": 4,
"uniqueRecipients24h": 16,
"inboundReplies24h": 2,
"inboundReplies7d": 3
},
"recommendations": [
"Start with previously engaged contacts before scaling volume."
]
}
}
États possibles
| État | Description |
|---|---|
new | Instance très récente, warmup initial |
warming | Warmup en cours |
stable | Instance plus mature |
at_risk | Signaux récents plus risqués |
restricted | Risque élevé détecté |
Cette V1 retourne uniquement de la guidance. Elle ne bloque pas directement les envois.
Common errors
| HTTP | Code | When |
|---|---|---|
404 | NOT_FOUND | Instance does not exist or is outside your account |