The Archive · Desktop reference · Local API

Error codes

The 272 error codes of the TALOS Desktop local API, with their HTTP status and meaning.

Reference for TALOS Desktop 0.1.25 generated from the source of the release · released

An error answer carries one of these codes in error.code. The code is what a program should read; the sentences next to it are for people.

CodeMeaning
DOVE_NON_VALIDO Where commands run must be wsl2, windows or null.
SCELTA_NON_VALIDA The choice sent for a command setting is not valid.
BROWSER_VIVO_GESTO_IGNOTO The gesture is not recognized.
BROWSER_VIVO_SENZA_SESSIONE The session the page belongs to is needed.
QUERY_INVALID The request is not valid: a query parameter or a body field is missing, unknown or malformed. 239 operations
MODEL_ID_INVALID The model name is not one this server recognizes (expected vendor/model-name). POST /sessionsPOST /sessions/customPOST /sessions/{sessionId}/settings
REASONING_INVALID The reasoning level is not one of those allowed. POST /sessionsPOST /sessions/customPOST /sessions/{sessionId}/settings
PERMISSIONS_INVALID The permissions are not among those allowed. POST /sessionsPOST /sessions/customPOST /sessions/{sessionId}/settings
NOTE_INVALID The note is not valid.
TASK_INVALID The task is not valid.
MEMORY_INVALID The memory is not valid.
RESEARCH_INVALID The request is not valid for deep research. 10 operations
ELICITATION_ANSWER_INVALID Not yet described.
LIBRARY_NAME_EMPTY A name needs at least one letter or digit.
LIBRARY_INVALID The request is not valid for the library.
MODE_WORKFLOW_RETIRED The Workflow mode no longer exists: choose normale or piano.
WORKFLOW_REVISION_INVALID The revision is not valid.
WORKFLOW_REVISION_EMPTY The revision changes nothing.
HOST_FORBIDDEN Not yet described.
FIT_INVALID The parameters of the check are not valid. GET /local-models/{modelId}/fitPOST /local-models/{modelId}/qualify
OAUTH_ATTESA_IGNOTA This sign-in request is no longer valid: start again from “Sign in with OpenRouter”.
OAUTH_CODICE_MANCANTE The confirmation code is missing: start again. POST /auth/openrouter/iniziaPOST /auth/openrouter/codiceGET /auth/openrouter/ritornoGET /auth/openrouter/ritorno/{state}
CodeMeaning
AUTH_REQUIRED This server accepts only the TALOS window that started it (or, for shutdown, the right token). POST /admin/shutdown
CodeMeaning
AUTOMATION_ORIGIN_FORBIDDEN Not yet described. POST /automations
APPROVAL_ANSWER_FORBIDDEN Not yet described.
QUESTION_ANSWER_FORBIDDEN Not yet described.
PLAN_APPROVAL_ORIGIN_FORBIDDEN A decision on a plan must come from this TALOS window (or carry the token).
WORKFLOW_APPROVAL_ORIGIN_FORBIDDEN A workflow approval must come from this TALOS window (or carry the token).
WORKFLOW_COMMAND_ORIGIN_FORBIDDEN A workflow command must come from this TALOS window (or carry the token).
WORKSPACE_LAUNCH_UNAUTHORIZED The local launcher is not authorized: restart TALOS and try again.
PROVIDER_SETTINGS_ORIGIN_FORBIDDEN Not yet described.
CHAT_FILE_ORIGIN_FORBIDDEN Upload the file from the TALOS window of this session.
PAGE_ORIGIN_FORBIDDEN Not yet described.
ORIGIN_FORBIDDEN Not yet described.
BROWSER_PROXY_SOLO_LOCALE The annotating proxy works only for a development server on this computer.
CodeMeaning
REPORT_UNAVAILABLE The report or service asked for is not available on this server yet. GET /providers/{providerId}/modelsGET /modelsGET /model-lab/capacityGET /toolsGET /setup/statoGET /doctor
NOT_FOUND Nothing answers at this address, or the resource it names does not exist. 168 operations
TASK_NOT_ALLOWED This task template is not allowed.
COMPACTION_NOT_FOUND This compaction does not exist (or was already undone).
AUTOMATION_PROPOSAL_NOT_FOUND Not yet described.
FILE_NOT_FOUND The file does not exist.
NOTE_NOT_FOUND The note no longer exists.
TASK_NOT_FOUND The task no longer exists.
MEMORY_NOT_FOUND The memory no longer exists.
RESEARCH_NOT_FOUND The research run no longer exists. 10 operations
LIBRARY_NOT_FOUND The library item no longer exists.
WORKFLOW_PROPOSAL_NOT_FOUND The workflow proposal does not exist.
OPENROUTER_PROVIDER_NOT_FOUND Not yet described.
PROVIDER_KEY_NOT_FOUND No key in the pool has this fingerprint.
GIT_COMMIT_UNKNOWN The repository has no such commit.
MODEL_NOT_FOUND The local model does not exist.
CodeMeaning
METHOD_NOT_ALLOWED The address exists, but not with this method; the Allow header lists the methods it takes.
CodeMeaning
BROWSER_VIVO_SCHEDA_ASSENTE This session has no page open in the live browser.
SESSION_NOT_READY The session is not ready for this action.
AUTOMATION_LEGACY Not yet described.
AUTOMATION_PROPOSAL_DECIDED Not yet described.
AUTOMATION_PROPOSAL_STALE Not yet described.
AUTOMATION_RUN_IN_PROGRESS Not yet described.
AUTOMATION_NO_RUN_IN_PROGRESS Not yet described.
FILE_EXISTS A file with this name already exists.
RESEARCH_CONFLICT The research run is not in the right state for this action. 9 operations
RESEARCH_RECHECK_UNAVAILABLE This research run cannot be checked again yet. POST /sessions/{sessionId}/research/{researchId}/pausaPOST /sessions/{sessionId}/research/{researchId}/ripresaPOST /sessions/{sessionId}/research/{researchId}/riverificaGET /sessions/{sessionId}/research/{researchId}DELETE /sessions/{sessionId}/research/{researchId}
PROCESS_NOT_RUNNING Not yet described. POST /sessions/{sessionId}/processes/{processeId}/stopPOST /sessions/{sessionId}/processes/{processeId}/sfondo
ELICITATION_NOT_PENDING Not yet described.
SESSION_STILL_RUNNING The session is still running: stop it first.
WORKFLOW_RUN_NOT_FINISHED A workflow of this conversation is still running: cancel it first. POST /sessions/{sessionId}/delete
APPROVAL_NOT_PENDING This approval request is no longer waiting: the session has moved on.
QUESTION_NOT_PENDING This question is no longer waiting: the session has moved on.
PLAN_NOT_PENDING This plan no longer waits for a decision: the session has moved on.
PLAN_STALE The plan on screen is not the latest: read the updated version and decide on that one.
WORKFLOW_DEFINITION_HASH_MISMATCH The plan changed since it was read: its fingerprint does not match.
WORKFLOW_COMMAND_CONFLICT The same command id was already used with different content.
WORKFLOW_APPROVAL_CONFLICT The same approval id was already used with different content.
WORKFLOW_RUN_STATE_CONFLICT The run’s state does not allow this command (for example, a pause of a paused run).
WORKFLOW_DEFINITION_NOT_APPROVED This version has not been approved yet.
WORKFLOW_VERSION_NOT_LATEST This is not the latest version of the proposal.
WORKFLOW_ALREADY_STARTED This version has already been started.
WORKFLOW_VERSION_SUPERSEDED A newer version replaced this one.
WORKSPACE_ALREADY_EXISTS A file or folder with this name already exists.
SEARCH_NOT_READY The search source is not ready. POST /search-sourcePOST /search-source/keyPOST /search-source/key/removePOST /search-source/test
TERMINAL_LIMIT_REACHED This session already has the most terminals open: close one and try again.
GIT_NOT_A_REPOSITORY The folder is not a Git repository.
GIT_ALREADY_A_REPOSITORY The folder is already inside a Git repository.
GIT_INIT_NEEDS_CONFIRM The folder contains your user folder: a confirmation is needed.
GIT_NOTHING_TO_COMMIT There is nothing to commit on these paths.
GIT_WORKTREE_DIFFERS Some files changed after they were staged.
GIT_PATH_UNCHANGED The file has no changes to show in this area.
GIT_NOTHING_TO_DISCARD There is nothing to discard on these files.
GIT_CONFLICTS The conflicts must be resolved first.
GIT_NESTED_REPO It is another repository: it is not touched from here.
GIT_STAGED_CHANGED What is staged changed: look again and retry.
GIT_NOTHING_STAGED There is nothing staged to commit.
GIT_STAGED_OUTSIDE Some staged files are outside the session’s folder.
GIT_HEAD_CHANGED The last commit changed: look again and retry.
GIT_COMMIT_PUSHED The last commit has already been pushed: it is not rewritten.
GIT_MERGE_COMMIT The last commit is a merge: it is not undone from here.
GIT_COMMIT_OUTSIDE The last commit touches files outside the session’s folder.
GIT_BRANCH_EXISTS A branch with this name already exists.
GIT_BRANCH_NOT_FOUND The branch does not exist.
GIT_BRANCH_CURRENT The current branch cannot be deleted.
GIT_BRANCH_NOT_MERGED The branch has commits that are in no other branch.
GIT_SWITCH_BLOCKED Switching branch would overwrite changes.
GIT_NOTHING_TO_STASH There are no changes to set aside.
GIT_STASH_CHANGED The stash changed: look again.
GIT_STASH_OUTSIDE This stash touches files outside the session’s folder.
GIT_STASH_CONFLICT Bringing the stash back created conflicts; the stash is kept.
GIT_NO_REMOTE The repository has no remote.
GIT_REMOTE_MISMATCH The branch follows another remote.
GIT_NO_UPSTREAM The branch follows no remote branch: publish it first.
GIT_UPSTREAM_GONE The remote branch no longer exists.
GIT_DETACHED There is no branch: HEAD is detached.
GIT_BEHIND The remote branch has commits that are not here: pull first.
GIT_WORKTREE_DIRTY Pulling would overwrite files with uncommitted changes.
GIT_FETCH_RUNNING A fetch is already running.
GIT_ABORTED Stopped.
GH_NOT_INSTALLED The GitHub CLI is not installed.
GH_NOT_LOGGED_IN No GitHub account is connected.
GH_UNSUPPORTED_PLATFORM TALOS cannot install the GitHub CLI on this system.
GH_NOT_GITHUB The branch’s remote is not on github.com.
GH_BRANCH_NOT_PUSHED The branch must be pushed to GitHub first.
GIT_DIFF_CHANGED The file changed: look at the diff again.
GIT_HUNK_UNSUPPORTED This file is staged whole: it has no hunks.
GIT_HUNK_FAILED Git cannot apply this hunk.
SESSION_MODEL_UNKNOWN The model this session uses is not known.
RUNTIME_OPERATION_UNSUPPORTED The local runtime does not support this operation.
HF_TRANSFER_COLLISION This model is already installed: remove it before downloading it again.
RUNTIME_ALREADY_RUNNING The local runtime already has a model loaded: free it before loading another.
MODEL_NOT_READY The model is not ready yet (being downloaded or verified).
MODEL_NOT_COMPATIBLE The model is not compatible with this profile.
CodeMeaning
WORKSPACE_LAUNCH_NOT_AVAILABLE This launch is no longer available: open the folder with TALOS again.
CodeMeaning
PAYLOAD_LIMIT The body is larger than the server accepts: shorten it, or put the text in a file and attach it. 8 operations
FILE_TOO_LARGE The file is too large to preview.
LIBRARY_TOO_LARGE The file is too large to download.
BROWSER_PROXY_TROPPO_GRANDE The page is larger than 5 MB.
GIT_OUTPUT_TOO_LARGE Git’s output is larger than the limit.
HF_IMAGE_TOO_LARGE The image is too large.
LOCAL_IMPORT_TOO_LARGE The model is larger than the space allowed.
CodeMeaning
BROWSER_PROXY_NON_HTML It is not an HTML page.
CodeMeaning
AUTOMATION_INVALID The automation’s parameters are not valid.
AUTOMATION_SCHEDULE_INVALID Not yet described.
AUTOMATION_SCHEDULE_TOO_FREQUENT Not yet described.
AUTOMATION_SCHEDULE_PAST Not yet described.
AUTOMATION_CRON_FIELDS Not yet described.
AUTOMATION_CRON_INVALID Not yet described.
AUTOMATION_TIMEZONE_INVALID Not yet described.
AUTOMATION_FOLDER_UNAVAILABLE Not yet described.
AUTOMATION_RUN_NOT_STARTED Not yet described.
CATALOG_CONFIGURATION_REQUIRED Configure the models, or the external agent, in Providers first.
HOOK_INVALID The hook configuration is not valid.
MCP_INVALID The MCP server configuration is not valid.
PLUGIN_INVALID The plugin configuration is not valid.
WORKFLOW_START_UNSUPPORTED This workflow has steps this server cannot run.
WORKFLOW_DEFINITION_INVALID The workflow definition is not valid.
WORKSPACE_NOT_AVAILABLE The folder is not available: check that it exists and that TALOS can work in it. GET /workspace-browserPOST /workspace-browser/folders
PROVIDER_INVALID The provider is not recognized.
PROVIDER_KEY_REQUIRED Enter a key before saving it.
PROVIDER_KEY_INVALID The key is not valid.
PROVIDER_RUNTIME_INVALID Check the provider’s address and timeout.
PROVIDER_POOL_FULL The provider’s pool of keys is full.
PROVIDER_FALLBACK_INVALID The fallback providers are not valid.
PROVIDER_FALLBACK_TOOLS_UNSUPPORTED A fallback provider cannot use tools, which this session needs.
SEARCH_SOURCE_INVALID The search source is not valid.
SEARCH_KEY_REQUIRED This search source needs a key.
SEARCH_KEY_INVALID The search key is not valid.
SEARCH_ENDPOINT_INVALID The search source’s address is not valid.
GIT_PATH_INVALID The path is not valid for this session.
GIT_PATHS_REQUIRED At least one explicit path is needed.
GIT_MESSAGE_REQUIRED A commit needs a message.
GIT_DIFF_AREA_INVALID The diff area must be preparato or lavoro.
GIT_BRANCH_INVALID The branch name is not valid.
GIT_REMOTE_UNKNOWN The remote is not known.
GIT_REMOTE_REQUIRED Choose the remote to publish the branch to.
GIT_COMMIT_INVALID A commit is named by its full hash.
GH_BASE_UNKNOWN The base branch is not on the remote.
GH_INPUT_INVALID The pull request’s title, description or base is not valid.
GIT_HUNK_INVALID The hunk or the action is not valid.
HF_TRANSFER_INVALID The model transfer is not valid.
HF_IMAGE_URL_INVALID The image address is not valid.
HF_IMAGE_HOST_REJECTED The image’s origin is not authorized.
HF_IMAGE_REDIRECT_REJECTED The image’s redirect is not authorized.
HF_IMAGE_PRIVATE_ADDRESS The image resolves to a private address.
HF_IMAGE_MIME_REJECTED The image format is not supported.
LOCAL_IMPORT_INVALID Check the GGUF file chosen and try again. POST /local-models/import
LOCAL_IMPORT_SIZE_MISMATCH The file’s size is not the one declared.
LOCAL_IMPORT_EMPTY The file is empty.
LOCAL_IMPORT_NOT_GGUF The file is not a GGUF model.
MODEL_HEADER_INVALID The model’s GGUF file is not valid.
MODEL_HEADER_UNREADABLE The model’s GGUF file cannot be read.
CodeMeaning
BROWSER_VIVO_TROPPE_SCHEDE Too many pages are open at once in the live browser.
CodeMeaning
HF_IMAGE_ABORTED The image request was cancelled.
CodeMeaning
BROWSER_VIVO_SENZA_CONNESSIONE There is no way to connect to the live browser.
CONFIG_INVALID The server’s configuration is not valid.
SESSION_STORE_HEADER_FAILED The session file’s header could not be written.
SESSION_STORE_FS_UNSUPPORTED The file system does not support what the session store needs.
SESSION_STORE_DELETE_FAILED The session could not be deleted from disk.
INTERNAL_ERROR An unexpected error on the server; the Doctor has the detail, under the reference shown. POST /automations/{automationId}/modificaPOST /automations/{automationId}/eseguiPOST /automations/{automationId}/fermaPOST /automations/{automationId}/runs/{runId}/lettaPOST /automations/{automationId}/runs/{runId}/proposta
LIBRARY_MALFORMED The record of this library item cannot be read.
LIBRARY_READ_FAILED The library item cannot be read.
QUESTION_ANSWER_NOT_SAVED The answer was not saved: the question was closed without it.
PLAN_DECISION_NOT_SAVED The decision was not saved; the plan is still waiting, and you can try again.
GIT_COMMAND_FAILED Git could not complete the operation.
HF_HUB_INVALID The request to Hugging Face is not valid.
HF_HUB_UPSTREAM Hugging Face cannot be reached.
HF_HUB_RESPONSE_INVALID Hugging Face’s answer is not valid.
HF_REPOSITORY_GATED The repository is gated or not authorized.
HF_RATE_LIMITED The Hugging Face request limit was reached.
HF_REDIRECT_INVALID A Hugging Face redirect is not valid.
HF_REDIRECT_HOST_REJECTED The download host is not an authorized Hugging Face host.
HF_RESOLVE_INVALID The Hugging Face download address is not valid.
HF_DOWNLOAD_FAILED The Hugging Face download failed.
HF_PATH_REJECTED The model path is not authorized.
CHECKSUM_MISMATCH The model file failed its checksum.
MODEL_FILE_UNREADABLE The model file cannot be read.
CANCELLED_BY_OWNER The download was cancelled.
PAUSED_BY_OWNER The download is paused.
HF_IMAGE_CONFIG_INVALID The image proxy is not configured.
LOCAL_RUNTIME_PROBE_MISCONFIGURED The local runtime’s probe is not configured correctly.
OAUTH_CUSTODIA_FALLITA The sign-in succeeded, but the key could not be stored safely: open the Doctor. POST /auth/openrouter/iniziaPOST /auth/openrouter/codiceGET /auth/openrouter/ritornoGET /auth/openrouter/ritorno/{state}
CodeMeaning
PLATFORM_UNSUPPORTED Not available on this operating system.
CodeMeaning
BROWSER_VIVO_CONNESSIONE_FALLITA The browser started but does not answer its control protocol.
OPENROUTER_ENDPOINTS_UNAVAILABLE Not yet described.
SEARCH_BLOCKED The search source refused the request.
SEARCH_UNREACHABLE The search source cannot be reached.
SEARCH_FAILED The search did not succeed.
BROWSER_PROXY_IRRAGGIUNGIBILE The page does not answer.
GIT_PULL_FAILED The pull did not succeed.
GIT_PUSH_REJECTED The remote did not accept the push.
GH_DOWNLOAD_FAILED The download of the GitHub CLI did not succeed.
GH_CHECKSUM_MISMATCH The downloaded file does not have the expected fingerprint: the GitHub CLI was not installed.
GH_EXTRACT_FAILED The GitHub CLI could not be extracted.
GH_COMMAND_FAILED GitHub answered with an error.
GH_OUTPUT_INVALID GitHub’s answer cannot be read.
GH_OUTPUT_TOO_LARGE GitHub’s answer is larger than the limit.
GH_LOGIN_FAILED The GitHub CLI gave no sign-in code.
GH_GIT_FAILED Git did not succeed.
MODEL_CALL_FAILED The model did not answer.
MODEL_LOAD_UNCONFIRMED The runtime did not confirm the model was loaded.
MODEL_UNLOAD_UNCONFIRMED The runtime did not confirm the model was unloaded.
LOCAL_RUNTIME_FAILED The local runtime failed.
HF_IMAGE_DNS_FAILED The image’s origin cannot be reached.
HF_IMAGE_UPSTREAM The image service is not available.
PROBE_GENERATION_FAILED The test generation failed.
PROBE_GENERATION_INCOMPLETE The test generation did not finish.
OAUTH_SCAMBIO_RIFIUTATO OpenRouter did not accept this confirmation: start again.
OAUTH_RETE OpenRouter could not be reached: check the connection and try again.
OAUTH_RISPOSTA_INATTESA OpenRouter answered in an unexpected way: try again later.
CodeMeaning
BROWSER_VIVO_NON_CONFIGURATO The live browser is not configured on this TALOS.
BROWSER_VIVO_ASSENTE No Chromium browser was found on this computer (TALOS uses an installed Chrome or Edge).
TASK_CATALOG_UNAVAILABLE The catalog of task templates is not available.
SESSION_STORE_WRITE_FAILED The session could not be written to disk.
SESSION_STORE_AMBIGUOUS The session store found more than one record for this session.
SESSION_STORE_BUSY The session store is busy: try again.
SERVER_SHUTTING_DOWN The server is shutting down.
CATALOG_UNREACHABLE The model catalog cannot be reached.
CATALOG_UPSTREAM_ERROR The model catalog is not available.
WORKFLOW_STORE_UNAVAILABLE Workflows are not available on this server. 24 operations
WORKFLOW_STORE_NEEDS_ATTENTION The workflow store needs attention before it can be used.
WORKFLOW_RUNTIME_NOT_READY The workflow runtime is not ready. POST /workflows/{workflowId}/versions/{version}/startPOST /sessions/{sessionId}/workflows/{runId}/pausePOST /sessions/{sessionId}/workflows/{runId}/resumePOST /sessions/{sessionId}/workflows/{runId}/cancelPOST /sessions/{sessionId}/workflows/{runId}/retryGET /sessions/{sessionId}/workflows/{runId}/retry-preview
PROVIDER_STORE_UNAVAILABLE The computer’s key store is not available: check the Doctor. 12 operations
PROVIDER_RUNTIME_UNAVAILABLE The provider’s preferences could not be saved: check the Doctor. POST /sessions/{sessionId}/migliora-prompt
SEARCH_STORE_UNAVAILABLE The search key store is not available. GET /search-sourcePOST /search-sourcePOST /search-source/keyPOST /search-source/key/removePOST /search-source/test
WSL_STORE_UNAVAILABLE Not yet described. GET /wslPOST /wsl
TERMINAL_STORE_UNAVAILABLE Terminals are not available on this server. POST /sessions/{sessionId}/terminalsPOST /sessions/{sessionId}/terminals/{terminalId}/close
GIT_STORE_UNAVAILABLE Git functions are not available on this server. 21 operations
GH_STORE_UNAVAILABLE GitHub is not available on this server. POST /github/installPOST /github/loginPOST /github/login-cancelPOST /sessions/{sessionId}/github/pulls
RUNTIME_NOT_AVAILABLE The local runtime is not available. 17 operations
RUNTIME_UNREACHABLE The local runtime cannot be reached.
RUNTIME_PROBE_FAILED The local runtime did not answer the check.
OAUTH_NON_CONFIGURATO Signing in with an account is not possible on this server: paste a key in Settings. POST /auth/openrouter/iniziaPOST /auth/openrouter/codiceGET /auth/openrouter/ritornoGET /auth/openrouter/ritorno/{state}
CodeMeaning
GIT_TIMEOUT Git did not answer in time.
GH_TIMEOUT GitHub did not answer in time.

Type to search the guides.