> Call the `diagnose` tool first. Full index: /llms.txt. Errors: /reference/problems. # Problems Every refused call and failed command carries one code, an HTTP status and one next step. Branch on the code, never on the message. A status of none means the CLI raised it without calling TaloTrace. | Code | Status | Title | Next step | Needs a person | | ----------------------------- | ------ | ---------------------------------------------------------- | ---------------------------------------------------------------- | -------------- | | `ADMISSION_REFUSED` | 402 | Billing does not allow this run | Provide the missing items the answer lists. | yes | | `API_KEY_NOT_FOUND` | 404 | This API key was not found in the project | Stop and read the message. | yes | | `APP_NOT_FOUND` | 404 | Choose an app in this project | Choose another app in the project. | yes | | `APP_NOT_LOADED` | 409 | The app did not load from your laptop | Stop and read the message. | yes | | `ATTEMPT_NOT_FOUND` | 404 | No such attempt in this run | Read the run to see what went wrong. | no | | `AUTHORIZATION_UNAVAILABLE` | 503 | Access could not be confirmed | Wait the number of seconds the answer names, then try once more. | no | | `BUILD_FORMAT_NOT_RUNNABLE` | 422 | This build file cannot run on a phone | Upload a build for the app. | yes | | `CLIENT_UPGRADE_REQUIRED` | 426 | Upgrade the TaloTrace CLI | Upgrade the CLI to the version named in the answer. | yes | | `CONNECT_LOST` | 409 | Connection to TaloTrace lost | Start talotrace connect for the port the answer names. | yes | | `CONSENT_EXPIRED` | 410 | This sign-in link has expired or was already used | Sign in with talotrace login. | yes | | `CURSOR_INVALID` | 422 | Read again from the start | Read the run to see what went wrong. | no | | `DEVICE_PROFILE_UNSERVED` | 503 | No device serves this profile | Stop and read the message. | yes | | `DEVICE_REFUSED` | 422 | The phone could not do that | Contact support with the request id the answer carries. | yes | | `DEV_SESSION_NOT_FOUND` | 404 | No such live phone session | Start a live phone with talotrace dev. | no | | `EVIDENCE_EXPIRED` | 410 | The evidence has expired | Read the run to see what went wrong. | no | | `EVIDENCE_NOT_FOUND` | 404 | No such evidence in this run | Read the run to see what went wrong. | no | | `FEATURE_NOT_AVAILABLE` | 501 | This is not available in this release | Stop and read the message. | yes | | `FIELD_UPGRADE_REQUIRED` | 422 | Upgrade the TaloTrace CLI | Upgrade the CLI to the version named in the answer. | yes | | `GUEST_LINKS_DISABLED` | 403 | Guest watch links are off | Stop and read the message. | yes | | `INSTALL_FAILED` | 422 | Installing dependencies failed | Contact support with the request id the answer carries. | yes | | `INSUFFICIENT_SCOPE` | 403 | Sign in again with tool access | Sign in with talotrace login. | yes | | `INVALID_ARGUMENTS` | 422 | The arguments are not valid | Stop and read the message. | no | | `ISSUE_NOT_FOUND` | 404 | That issue was not raised by the run | Read the run to see what went wrong. | no | | `KEYCHAIN_UNAVAILABLE` | none | Your system keychain is unavailable | Stop and read the message. | yes | | `LIVE_CODE_UNKNOWN` | 409 | Waiting for your laptop's code | Wait the number of seconds the answer names, then try once more. | no | | `LOCAL_ERROR` | none | The CLI could not complete that on this machine | Stop and read the message. | yes | | `LOCAL_FILE_REQUIRED` | 422 | Upload the local file first | Upload a build for the app. | yes | | `LOCAL_REQUEST_TOO_LARGE` | 413 | A request from your app to your local server was too large | Stop and read the message. | yes | | `LOCAL_RUNTIME_UNSUPPORTED` | 422 | A local web app cannot run on this runtime | Choose another app in the project. | yes | | `LOCAL_TARGET_NOT_CONNECTED` | 409 | Connect your laptop app | Start talotrace connect for the port the answer names. | yes | | `LOGIN_REQUIRED` | 401 | Sign in to TaloTrace | Sign in with talotrace login. | yes | | `METRO_NOT_RUNNING` | 409 | Connect your laptop's Metro | Start talotrace connect for the port the answer names. | yes | | `NEEDS_REBUILD` | 409 | Rebuild the app | Upload a build for the app. | yes | | `NO_CAPACITY` | 503 | No phone is free yet | Wait the number of seconds the answer names, then try once more. | no | | `NO_DEV_CLIENT` | 409 | Upload a development build | Upload a build for the app. | yes | | `NO_SCENARIOS_SELECTED` | 422 | Select scenarios to run | Choose scenarios that belong to the app. | yes | | `OWNER_UNAVAILABLE` | 503 | TaloTrace could not answer just now | Wait the number of seconds the answer names, then try once more. | no | | `PROTOCOL_ERROR` | 502 | TaloTrace could not complete that | Contact support with the request id the answer carries. | yes | | `PROXY_AUTH_RENEWAL_REQUIRED` | 401 | Access is being renewed | Wait the number of seconds the answer names, then try once more. | no | | `REQUEST_REFUSED` | 422 | TaloTrace refused that request | Stop and read the message. | yes | | `REVIEW_STALE` | 409 | Review the current scenario revision | Stop and read the message. | yes | | `RUN_NOT_FINISHED` | 409 | The run has not finished | Wait the number of seconds the answer names, then try once more. | no | | `RUN_NOT_FOUND` | 404 | No such run | Stop and read the message. | yes | | `SCENARIO_SCOPE_MISMATCH` | 422 | Select scenarios of this app | Choose scenarios that belong to the app. | yes | | `SESSION_BUSY` | 409 | The phone is in use | Wait the number of seconds the answer names, then try once more. | no | | `SESSION_ENDED` | 410 | The live phone session ended | Start a live phone with talotrace dev. | no | | `SETUP_REQUIRED` | 409 | Provide what the run needs | Provide the missing items the answer lists. | yes | | `SHARE_EXPIRED` | 410 | The watch link has expired | Stop and read the message. | yes | | `SHARE_FULL` | 429 | The watch link has too many viewers | Wait the number of seconds the answer names, then try once more. | no | | `SHARE_MEMBERS_ONLY` | 403 | Only team members can watch | Stop and read the message. | yes | | `SHARE_NOT_FOUND` | 404 | No such watch link | Stop and read the message. | yes | | `SHARE_REVOKED` | 410 | The watch link was revoked | Stop and read the message. | yes | | `SNAPSHOT_MISMATCH` | 409 | Read the export again | Read the run to see what went wrong. | no | | `SOURCE_TOO_LARGE` | 413 | The source is too large | Stop and read the message. | yes | | `TARGET_KIND_MISMATCH` | 422 | Choose an app of this kind | Choose another app in the project. | yes | | `TUNNEL_AMBIGUOUS` | 409 | More than one laptop tunnel serves that port | Stop and read the message. | yes | | `TUNNEL_OWNER_REQUIRED` | 409 | Keep your laptop tunnel running | Start talotrace connect for the port the answer names. | yes | | `VIEWERS_FULL` | 429 | Too many viewers | Wait the number of seconds the answer names, then try once more. | no | | `WORKSPACE_LIMIT` | 409 | Too many open project folders | Stop and read the message. | yes | | `WORKSPACE_NOT_FOUND` | 404 | No such project folder | Stop and read the message. | yes |