cloudflare/cloudflared · error

REST request failed

Error message

REST request failed

What it means

Generic wrapper error in cfapi fetchPage: the HTTP request for one page of a paginated Tunnelstore listing (routes, vnets, etc.) failed at the transport level (network error, TLS failure, connection refused). fetchExhaustively stops pagination and surfaces this wrapped error for the page number involved.

Source

Thrown at cfapi/base_client.go:169

		page += 1
		envelope, parsedBody, err := fetchPage[T](requestFn, page)

		if err != nil {
			return nil, errors.Wrap(err, fmt.Sprintf("Error Parsing page %d", page))
		}

		fullResponse = append(fullResponse, parsedBody...)
		if envelope.Pagination.Count < envelope.Pagination.PerPage || len(fullResponse) >= envelope.Pagination.TotalCount {
			break
		}
	}
	return fullResponse, nil
}

func fetchPage[T any](requestFn func(int) (*http.Response, error), page int) (*response, []*T, error) {
	pageResp, err := requestFn(page)
	if err != nil {
		return nil, nil, errors.Wrap(err, "REST request failed")
	}
	defer pageResp.Body.Close()
	if pageResp.StatusCode == http.StatusOK {
		envelope, err := parseResponseEnvelope(pageResp.Body)
		if err != nil {
			return nil, nil, err
		}
		var parsedRspBody []*T
		return envelope, parsedRspBody, parseResponseBody(envelope, &parsedRspBody)
	}
	return nil, nil, errors.New(fmt.Sprintf("Failed to fetch page. Server returned: %d", pageResp.StatusCode))
}

type response struct {
	Success    bool            `json:"success,omitempty"`
	Errors     []apiError      `json:"errors,omitempty"`
	Messages   []string        `json:"messages,omitempty"`
	Result     json.RawMessage `json:"result,omitempty"`

View on GitHub (pinned to 2253eeeb25)

Solutions

1. Check network connectivity to the Cloudflare API endpoint.
2. Inspect the wrapped cause for timeouts vs DNS vs TLS problems and retry transient ones.
3. Verify proxy/firewall settings if the API is reachable from a browser.

When it happens

Trigger: Thrown at cfapi/base_client.go:169 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of cloudflare/cloudflared@2253eeeb25 (2026-09-06). Data as JSON: /api/errors/2ba6077c35e19ffc. Report an issue: GitHub.