Troubleshoot access and commands
Resolve connection, permission and incomplete-result issues with clear next steps.
“The key service is unavailable”
This means Developer keys could not reach an available key service; it does not mean you have no keys. Ask your administrator to check that Open API is enabled and configured, the required database tables exist and the backend dependencies are healthy. Refresh after the underlying problem is resolved.
Share the time, affected page and non-secret error details. Do not share the full key, password or session token. Administrators should preserve the existing signing secret when keys have already been issued.
Authentication fails or a key has expired
- Check the backend URL, tenant and selected profile. A website URL is not always the backend URL.
- Run auth validate for that profile. In Developer keys, check the key’s status and expiry.
- If the secret was rotated, import the replacement. If the key was revoked or expired, use an authorized replacement.
- For an imported user session, obtain a fresh token through the existing sign-in flow when the session expires. The CLI cannot renew it automatically.
cynexio auth validate --profile work
cynexio auth whoami --profile workA resource is missing or permission is denied
New keys follow your current account permissions in their team, including newly created tables. Check the team, resource ID and current account role. Relations also require read access to their target table. Only older SCOPED keys add separate saved resource and action restrictions.
Understand key permissionsResults are incomplete or a write times out
| What you see | What to do |
|---|---|
| PAGED or TRUNCATED | Inspect completeness metadata. A page or truncated snapshot is not the full dataset; narrow the task or use a supported complete read. |
| UNKNOWN / timeout after a write | Inspect the original resource and request. Keep the original idempotency key; do not blindly submit the same write under a new one. |
| Unsupported operation | Check capabilities and the command help. A command in the catalog can be disabled in the current version. |
| No records | Check the selected table and filters. CLI-created tables start empty. A successful empty result differs from a load error. |
A formula result looks wrong
Check the field types, relation targets and the row used by the preview. Save both the formula editor and field settings. The Formula guide covers working days, cross-table conditions, AI generation and stale results in detail.
Troubleshoot formula results