Error codes

Every non-2xx response from the control plane returns a stable JSON envelope:

{
  "error": {
    "code": "CP_PROJECT_NOT_FOUND",
    "message": "no active project with that wok_id in this org",
    "hint": "verify the wok_id and that it belongs to your org",
    "correlation_id": "1aee612b1250f276"
  }
}

code is the stable machine-readable identifier — classify on this. message is human-prose. hint is the remediation. correlation_id echoes back TellWang's per-request id; include it when filing a ticket so support can trace the request.

Below: the codes grouped by area, with the side that fixes each (caller = your client code; state = the wok or org needs to be in a different state; platform = open a ticket).

Authentication & authorization

Not found / wrong state

Validation

Capacity & rate limits

Upstream / platform

Private servers

Every paid plan runs on its own private server on Cherry Servers in US-Chicago; Scale + HA and Enterprise add a second server in LT-Siauliai. These codes come from setting up, recovering, resizing, migrating, and retiring those servers. Most describe a step TellWang handles for you.

Managed RAG

Beyond this list

CP_LOLLIPOP_AUDIT_QUESTION_CONFIRMATION_REQUIRED asks the owner to review the inferred buyer questions and exact backlink-discovery plan before any answer source is sampled. It also stops Optimize when the selected Site has no owner-approved questions, or when its retained discovery-plan inputs, version, or provider mode no longer match. CP_LOLLIPOP_AUDIT_QUESTION_DRAFT_EXPIRED asks for a fresh question draft when the prior draft expired, was superseded, or was already used. CP_LOLLIPOP_AUDIT_ANSWERS_FAILED also means a required stale-audit refresh stopped before Optimize began; retrying starts no duplicate optimization. CP_LOLLIPOP_UNLINKED_MENTIONS_PARTIAL means backlink discovery did not establish usable complete coverage: public engines may have produced no external candidate, paid-provider admission or a selected Google Organic/backlink-index request may have failed, or a discovered page could not be read and verified. A legacy audit marked complete with zero usable results is treated as degraded. The report keeps successful discoveries, separate Needs-verification index evidence, and the exact primary, conditional backup, provider, and page-verification coverage; an empty list is not proof that no backlinks exist. The audit score and answer evidence remain valid, and /v1/diag reads the latest durable shared semantic outcome separately from endpoint configuration. CP_LOLLIPOP_AUDIT_COMPETITOR_METADATA_PARTIAL means one or more exact safe citation pages did not return readable public metadata or content; the competitor review keeps the citation title and domain fallback. CP_LOLLIPOP_AUDIT_COMPETITOR_REVIEW_REQUIRED means the owner must select at least one candidate under Are these your competitors?. If none apply, that audit remains hidden, scheduled audits and Optimize stay paused, and the first audit must be run again. CP_LOLLIPOP_SAMPLING_NO_QUERIES asks the owner to add a buyer question before sampling. CP_LOLLIPOP_SAMPLING_MARKET_REQUIRED asks the owner to save the country, city, or region Google AI Overview should measure; this is rejected before queueing or credit debit. Same-named supported markets open a canonical location chooser instead of failing. CP_LOLLIPOP_SAMPLING_LOCATION_UNMATCHED means no supported location matched after applying the Site-domain and fully written country hints; check the spelling or search again with the country. CP_LOLLIPOP_SAMPLING_LOCATION_CATALOG_UNAVAILABLE means the server could not read Google's supported-location catalog; retrying does not duplicate or charge an audit. CP_LOLLIPOP_SAMPLING_NOT_CONFIGURED means no supported visibility source is ready; native Naver AI Briefing needs no credential, while OpenAI, DeepSeek, Google AI Overview, and Naver Search depend on their server-owned collector credentials. Credentials never belong in the browser. CP_LOLLIPOP_SAMPLING_PARTIAL means some question-and-source checks succeeded while others failed; only successful checks are billed, and only successful answer checks enter the two AI percentages. CP_LOLLIPOP_SAMPLING_FAILED means every configured collector failed or its result could not be retained. Failed provider calls are refunded before the run is marked failed.

CP_LOLLIPOP_BACKLINK_PITCH_NOT_READY means the editorial opportunity has no current public contact-email provenance. Run a fresh Site audit instead of guessing an address. CP_LOLLIPOP_BACKLINKS_INCONSISTENT is a platform diagnostic: backlink storage is unavailable, the retained Project/Site scope is broken, or a pitch no longer matches its contact evidence. TellWang repairs the reported record; Lollipop never sends or invents a replacement address.

For every other code emitted by TellWang, the response envelope's hint field gives the same remediation a customer support reply would. Hits to /diag (see Diagnostics) are the canonical "what's wrong" surface; correlation_id ties a single request across TellWang's logs and the audit log.