Documentation
Error codes, and what to do next.
Every code the AdvisorSEO connector returns, what it means, and the next step that fixes it.
Reading an error
When a step cannot finish, AdvisorSEO answers with one short error: a stable code, a plain message, whether trying again can help, a suggested next step for the assistant, and a link to the matching section on this page. Paths, tokens and remote error text are removed before the error reaches the conversation.
Your assistant usually reads the code and recovers on its own. This page is for when you want to know what happened. If a code here does not match what you see, tell support.
Not connected
Code: not_connected
What it means
AdvisorSEO could not use an account the request needs. Either the request carries no valid AdvisorSEO sign-in, because the assistant connection was never completed, was removed or needs signing in again, or the website’s Google connection is missing, incomplete or was revoked.
What to do
If the message says the request carries no valid AdvisorSEO access token, follow the steps on Connect AdvisorSEO and start authorization from your AI host. If it is about Google, ask your assistant to check the website’s Google connection and to give you a fresh Google link, then open that link yourself.
Will trying again help? No. Trying again without reconnecting returns the same answer.
Website not found
Code: site_not_found
What it means
The website named in the request is not in the workspace this connection is bound to. The id may be mistyped, the site may have been removed, or it belongs to a different workspace.
What to do
Ask your assistant to list the websites in your workspace and choose the exact one. If the site belongs to another workspace, reconnect and select that workspace on the consent screen.
Will trying again help? No.
Request not accepted
Code: bad_args
What it means
The request did not match what the capability accepts: a required value was missing, empty or outside the allowed choices, or Google refused the request as written.
What to do
Your assistant should correct the request and try once more. Check the values it used, such as the website, the date range or the record, and say which one is right.
Will trying again help? Not unchanged. Retrying with the same values returns the same answer.
Confirmation required
Code: confirm_required
What it means
The step would change something, so it waits for your explicit confirmation.
What to do
Read the preview your assistant shows. If the site, record and change are right, tell it to go ahead. If anything is wrong, ask for a corrected preview instead.
Will trying again help? Yes, once you have confirmed.
Too many requests
Code: rate_limited
What it means
A request limit was reached, either in AdvisorSEO or at a provider such as Google.
What to do
Wait about a minute, then try again. Ask for fewer or smaller reads at once if it keeps happening.
Will trying again help? Yes, after a short wait.
A service did not answer
Code: upstream_error
What it means
Something AdvisorSEO relies on for this step failed, timed out or was unavailable: for example Google, your website, or a page measurement. The detail stays in our server log and is not shown in the conversation.
What to do
Wait about 30 seconds and try again. If it keeps failing, contact support with the approximate time, your timezone and the code. Never send a token or password.
Will trying again help? Yes, after a short wait.
Not included in your plan
Code: not_entitled
What it means
Your workspace’s plan does not include this step.
What to do
Ask your assistant for a workspace overview to see what is available. Pricing lists the plans; support can confirm what your workspace includes.
Will trying again help? No.
Record not found
Code: not_found
What it means
The record named in the request is not in your workspace: a draft, lead, job, audit run, proposal, answer, prompt or topic.
What to do
Ask your assistant to list that kind of record for the website and pick the right one, or ask for a workspace overview.
Will trying again help? No.
Plan change needed
Code: plan_required
What it means
Your workspace’s plan does not cover this step right now. The free trial may have ended or used up its calls, the plan’s allowance for this period may be used up, the workspace may have no plan yet, or the subscription may be overdue or canceled. Nothing ran. The message names the reason and, when one exists, the plan that includes this step.
What to do
Compare the plans on Pricing and pick the one the message names. If the message says the payment is overdue or the subscription is canceled, update billing in your AdvisorSEO account settings. Support can confirm what your workspace includes.
Will trying again help? No, not until the plan or billing changes.
Still stuck
Send [email protected] the code, the approximate time and timezone, and the host you use. Remove authorization codes and token-bearing URLs first. The troubleshooting guide covers connection, consent and publishing problems.
