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 --helpFind commands and options in the Command reference. Available features can vary with account permissions and the environment you connect to.
| Task | How to proceed |
|---|---|
| Upload or download skill files; connect organization skills to GitHub | Use the skill commands in this guide. |
| Agent chat, Drive transfers, agent export | Check command version and server requirements. Use the web interface if restricted. |
| Integration tests, updates, and deletion; automation execution and cancellation; key or URL regeneration | Check command version and server requirements. Use supported web operations if restricted. |
| New messages in regular conversations, model execution, image generation | Use the web interface. |
| Prepare connection tokens | Follow 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 loginagain. - If port
8484is 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 currentCLI_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_SLUGPermission 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.
| Situation | Next step |
|---|---|
| A list has subsequent pages | Continue using the page options. |
| A list supports search or folder criteria | Narrow the query scope. |
| Messages are truncated or a query limit is exceeded | Read the full conversation in the web interface. |
| More than 50 automations | Check the list in the web interface. |
| Deleting a large folder is rejected | Check 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.
- Query the list and details of the item you created, edited, or deleted.
- Check the actual state.
- 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.