DialNexa API fundamentals

curl https://api.dialnexa.com/v1/voices \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "message": "API key is missing or invalid. You can generate this by logging in into dashboard"
}

curl "https://api.dialnexa.com/v1/workflows?page=2&limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

async function fetchAllWorkflows(apiKey: string) {
  const workflows = [];
  let page = 1;

  while (true) {
    const response = await fetch(
      `https://api.dialnexa.com/v1/workflows?page=${page}&limit=100`,
      { headers: { Authorization: `Bearer ${apiKey}` } }
    );
    if (!response.ok) throw new Error(`List workflows failed: ${response.status}`);

    const { data: { data, meta } } = await response.json();
    workflows.push(...data);
    if (page >= meta.totalPages) break;
    page += 1;
  }

  return workflows;
}

{
  "message": "Request validation failed: Agent agent_abc123 has 2 outbound numbers. Pass phone_number_id to choose which one to dial from.",
  "data": {
    "code": "PHONE_NUMBER_REQUIRED",
    "phone_number_ids": ["phn_abc123", "phn_def456"]
  }
}

{
  "statusCode": 400,
  "error": true,
  "success": false,
  "data": [],
  "message": "url must be a URL address, events should not be empty",
  "errors": [
    "url must be a URL address",
    "events should not be empty"
  ]
}

async function dialNexaRequest(path: string, init: RequestInit = {}) {
  const response = await fetch(`https://api.dialnexa.com/v1${path}`, init);
  const text = await response.text();
  let body: any = null;
  try {
    body = text ? JSON.parse(text) : null;
  } catch {
    // A proxy or gateway can answer with a non-JSON page.
    body = { message: text };
  }

  if (!response.ok) {
    // data is an object with code for a coded refusal, otherwise [] or absent.
    const code = body?.data?.code;
    throw new Error(`DialNexa ${response.status}${code ? ` ${code}` : ""}: ${body?.message}`);
  }

  return body;
}

async function getWithRetry(url: string, apiKey: string, attempts = 5) {
  for (let attempt = 0; attempt < attempts; attempt += 1) {
    const response = await fetch(url, {
      headers: { Authorization: `Bearer ${apiKey}` },
      signal: AbortSignal.timeout(15_000),
    });

    if (response.ok) return response.json();
    if (response.status !== 429 && response.status < 500) {
      throw new Error(`Non-retryable response: ${response.status}`);
    }

    const retryAfterHeader = response.headers.get("retry-after");
    const retryAfter = retryAfterHeader ? Number(retryAfterHeader) : NaN;
    const delayMs = Number.isFinite(retryAfter) && retryAfter > 0
      ? retryAfter * 1000
      : Math.min(30_000, 500 * 2 ** attempt) + Math.random() * 250;
    await new Promise((resolve) => setTimeout(resolve, delayMs));
  }

  throw new Error("Retry budget exhausted");
}