larksuite/cli · error

app registration timed out, please try again

Error message

app registration timed out, please try again

What it means

Terminal outcome sentinel of device-code registration: the client-side polling window elapsed without reaching an approval or denial state (slow user or stalled page), so the flow gives up. Distinguished from explicit denial and from server-side code expiry.

Source

Thrown at internal/auth/app_registration.go:24

import (
	"context"
	"encoding/json"
	"errors"
	"fmt"
	"io"
	"net/http"
	"net/url"
	"strings"
	"time"

	"github.com/larksuite/cli/internal/core"
)

// Terminal registration outcomes, exposed for typed classification by callers.
var (
	ErrRegistrationDenied   = errors.New("app registration denied by user")
	ErrRegistrationExpired  = errors.New("device code expired, please try again")
	ErrRegistrationTimedOut = errors.New("app registration timed out, please try again")
)

// Protocol defaults, mirroring the official SDK registration flow.
const (
	registrationBootstrapBrand = core.BrandFeishu
	defaultPollIntervalSeconds = 5
	defaultExpireInSeconds     = 600
	beginRequestTimeout        = 30 * time.Second
	maxPollIntervalSeconds     = 60
)

// normalizedInterval clamps a non-positive poll interval to the protocol default.
func normalizedInterval(v int) int {
	if v <= 0 {
		return defaultPollIntervalSeconds
	}
	return v
}

View on GitHub (pinned to 7fd6ef3c07)

Solutions

1. Re-run `lark-cli config init --new` and complete the scan promptly

When it happens

Trigger: Thrown at internal/auth/app_registration.go:24 when the library encounters an invalid state.

Common situations: See trigger scenarios.

Understand the failure class

• Timeouts: ETIMEDOUT, deadlines, and hung requests — what actually expires when a request times out.

AI-assisted analysis of larksuite/cli@7fd6ef3c07 (2026-09-04). Data as JSON: /api/errors/211bcb03ac8a3475. Report an issue: GitHub.