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
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.
| Code | Meaning |
|---|---|
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 |
PROBE_CONSENT_REQUIRED | Running the model needs your explicit consent. |
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} |
| Code | Meaning |
|---|---|
AUTH_REQUIRED | This server accepts only the TALOS window that started it (or, for shutdown, the right token). POST /admin/shutdown |
| Code | Meaning |
|---|---|
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. |
| Code | Meaning |
|---|---|
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. |
| Code | Meaning |
|---|---|
METHOD_NOT_ALLOWED | The address exists, but not with this method; the Allow header lists the methods it takes. |
| Code | Meaning |
|---|---|
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. |
| Code | Meaning |
|---|---|
WORKSPACE_LAUNCH_NOT_AVAILABLE | This launch is no longer available: open the folder with TALOS again. |
| Code | Meaning |
|---|---|
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. |
| Code | Meaning |
|---|---|
BROWSER_PROXY_NON_HTML | It is not an HTML page. |
| Code | Meaning |
|---|---|
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. |
| Code | Meaning |
|---|---|
BROWSER_VIVO_TROPPE_SCHEDE | Too many pages are open at once in the live browser. |
| Code | Meaning |
|---|---|
HF_IMAGE_ABORTED | The image request was cancelled. |
| Code | Meaning |
|---|---|
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} |
| Code | Meaning |
|---|---|
PLATFORM_UNSUPPORTED | Not available on this operating system. |
| Code | Meaning |
|---|---|
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. |
| Code | Meaning |
|---|---|
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} |
| Code | Meaning |
|---|---|
GIT_TIMEOUT | Git did not answer in time. |
GH_TIMEOUT | GitHub did not answer in time. |