Skip to Content
Skip to Content
Limitations and troubleshooting

Limitations and troubleshooting

If a command fails, check your service environment, sign-in, organization, and permissions in that order. Read the error code and accompanying instructions.

Check available commands

aipctl --version aipctl --help aipctl skill --help

Find commands and options in the Command reference. Available features can vary with account permissions and the environment you connect to.

TaskHow to proceed
Upload or download skill files; connect organization skills to GitHubUse the skill commands in this guide.
Agent chat, Drive transfers, agent exportCheck command version and server requirements. Use the web interface if restricted.
Integration tests, updates, and deletion; automation execution and cancellation; key or URL regenerationCheck command version and server requirements. Use supported web operations if restricted.
New messages in regular conversations, model execution, image generationUse the web interface.
Prepare connection tokensFollow the web interface’s PC connection instructions.

For CLI_OPERATION_NOT_ENABLED, check your version and whether the organization provides the feature. Installing a development CLI alone does not resolve it.

Browser sign-in does not finish

  • If the sign-in page does not open, open the URL printed in the terminal in a browser on the same PC.
  • If sign-in times out, run aipctl auth login again.
  • If port 8484 is in use, stop other sign-in or organization-selection operations and retry.
  • Do not switch service environments or sign out in another terminal during sign-in.
aipctl config status aipctl auth status aipctl org current

CLI_AUTH_SESSION_CHANGED can mean another operation changed your sign-in, organization, or environment. Check the current state and sign in to the intended environment again.

Signed in but cannot access an organization

Check accessible organizations with org list. If none appear, check your invitation and membership. Organizations with IP restrictions require an allowed network.

aipctl org list aipctl org use ORG_SLUG

Permission denied or resource not found

  • 401: Check sign-in and service URL, then sign in again.
  • 403: Check your organization role and permission to use or manage the resource.
  • 404: Check the organization and ID against the list. Also confirm server support for the feature.

Commands containing admin do not all require the same permissions. Shared organization skill and agent management requires AI Operator permissions, while organization usage requires administrator permissions.

Too many requests

429 means a request or execution limit was exceeded. If the error includes a waiting period (Retry-After), wait and reduce query frequency.

  • Avoid querying the same list repeatedly at short intervals.
  • Reduce concurrent scripts if several are running.
  • A shared organization limit may apply in addition to personal limits.
  • Daily limits or executions awaiting confirmation of termination may not resolve after a short wait. Contact your administrator or support if restrictions persist.

503 can mean the service is temporarily unavailable. Check the error, retry the query later, or contact support.

Cannot see every list item or message

Standard queries have response-size and processing-time limits. Large results may return an error rather than presenting part of the data as the complete result.

SituationNext step
A list has subsequent pagesContinue using the page options.
A list supports search or folder criteriaNarrow the query scope.
Messages are truncated or a query limit is exceededRead the full conversation in the web interface.
More than 50 automationsCheck the list in the web interface.
Deleting a large folder is rejectedCheck its contents and clean up in smaller batches.

Connection lost during a change

After outcome=unknown, a timeout, or Ctrl+C, the server may already have applied a change.

  1. Query the list and details of the item you created, edited, or deleted.
  2. Check the actual state.
  3. Retry only after confirming the change was not applied.

Ctrl+C and sign-out do not guarantee cancellation of remote work or changes. Enabling or disabling an automation also does not mean a running task has finished canceling.

409 can mean the target state changed or a name conflicts. Retrieve the latest state and review the intended change. --force confirms operations such as deletion; it does not override permission or state conflicts.

Information to include in a support request

  • Output of aipctl --version, your OS and CPU, and Node.js version
  • The command and the time of the error
  • Error code, message, and any displayed request ID
  • Service environment, resource type, and state checked after a change

Hide tokens, PATs, credential files, and private data. Also check command arguments visible in screenshots.

Last updated on