Skip to main content

Endpoint

GET /api/v1/instances/{id}/health

Paramètres path

NomTypeRequisDescription
idUUIDouiID de l’instance

Réponse succès 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

ÉtatDescription
newInstance très récente, warmup initial
warmingWarmup en cours
stableInstance plus mature
at_riskSignaux récents plus risqués
restrictedRisque élevé détecté
Cette V1 retourne uniquement de la guidance. Elle ne bloque pas directement les envois.

Erreurs courantes

HTTPCodeQuand
404NOT_FOUNDInstance inexistante ou hors de votre compte