scopserv-api-v3 won't start or crashes on startup SCOPLINK connection refused: Request failed with status code 503

scopserv-api-v3 won't start or crashes on startup SCOPLINK connection refused: Request failed with status code 503

If you are seeing this error it is possible that the one or more api services are not running correctly.




Root Cause:
scopserv-api-v3 won't start or crashes on startup

To check the status of the api-v3 service, check the unique http path.

 
To check the status of the api-events service check the unique path.


If api-v3 is not running then:
rm -rf /usr/local/nvm/
This remove all "remaining" files which included a node.js 10 version which ScopSERV no longer supports.


service scopserv_api_v3 restart

Then check with:
pm2 status
Or
pm2 restart scopserv-apiv3

    • Related Articles

    • ScopTEL - API Documentation English

      API This document explains how to use SCOPDEV v3. SCOPDEV v2.5 (a.k.a. xAPI) is still present for legacy integrations, but is turned off by default. If you wish to continue using v2.5, you must to the following: Establish an SSH connection to ScopTel ...

    • Documentation API ScopTEL Français

      API Ce document explique comment se servir de SCOPDEV v3. SCOPDEV v2.5 (alias xAPI) est encore présent pour supporter les intégrations qui en dépendent, mais est inactif par défaut. Si vous désirez utiliser v2.5, faîtes les étapes suivantes: ...

    • ScopTEL ACD Pause Code Usage

      About ACD Pause Codes Pause Codes are used to make a LOGGED agent Unavailable/Available during the course of an agent’s shift. Pause Codes are advantageous because an agent should only LOGIN when they start their shift and LOGOUT when they end their ...

    • SCOPLINK and APA Administrator Guide

      For APA 4.0.2, updated August 26, 2025 Introduction This guide describes how to configure SCOPTEL to enable the use of SCOPLINK and the SCOPLINK Agent Portal Application (APA) for end users in your installation. SCOPLINK provides desktop telephony ...

    • Module 7 - ScopTEL IP PBX Software - Class of Service Configuration

      Class of Service (CoS) | Background The Class of Service Manager is used to create objects with permissions or restrictions to Outgoing Lines, Incoming Lines, Extensions, Feature Codes, or Applications. These CoS objects can then be applied to ...