Skip to main content
GET
Force a Line Health Check
/api/lines/by-user reports the last health check. This triggers a new one — use it when a line looks unhealthy and you want to know whether it still is.

Endpoint

  • Method: GET
  • Path: /api/lines/check-availability?id={lineId}
  • Auth: Authorization: Bearer tuco_xxxxxxxxxxxxx (workspace key)
The probe pings the line’s server and checks iMessage availability, then writes the result to the line’s healthCheck, so a following /api/lines/by-user shows the fresh state. Only lines in the workspace the key belongs to can be checked. An agency key is refused — pick the client’s own key, since “which line” is a per-workspace question.

Error responses