Skip to main content

Error code reference

vastframe errors teach. Every error has a stable code and a human message; SDK errors also carry a fix.

  • REST API errors look like { "error": { "code": "READ_ONLY", "message": "…" } } with an HTTP status.
  • SDK errors are TcError instances with .code and .fix (JavaScript), or raised TcError (Python). tc.storage and tc.db.from() return { data, error } instead of throwing.
  • CLI prints CODE: message and exits with status 1.
  • MCP tools return the same code and message to the agent.

Sign-in and access​

CodeStatusMeaning
UNAUTHORIZED / UNAUTHENTICATED401Not signed in. Sign in through the console, or tc login --dev locally
NO_ACCESS403Signed in, but not allowed to open this app; the fix names the owner
FORBIDDEN403Your role doesn't allow this action
READ_ONLY403You have read-only access, for example as an Auditor
ADMIN_ONLY403Only an Org Admin can do this
NOT_A_BUILDER403Creating projects is limited to Builders in your organization
PROJECT_NOT_FOUND / NOT_FOUND404No such project, or you can't see it (projects you can't see answer 404, not 403)

Projects and deploys​

CodeStatusMeaning
INVALID_NAME400The project name doesn't follow the naming rules
NAME_TAKEN409Another project already has that name
NAME_BEING_FREED409A project with that name was just deleted; try again in a few seconds
BAD_BUNDLE, EMPTY_BUNDLE, NO_SOURCE400The uploaded source couldn't be read or was empty
BUNDLE_TOO_LARGE413Source bundles are limited to 50 MB
TOO_LARGE_FOR_MCP413MCP upload_file takes files up to 5 MB; use tc storage put for bigger files
PURPOSE_REQUIRED400MCP deploy: the code uses an integration that needs approval; add a one-line purpose
DEPLOYMENT_NOT_FOUND, NO_DEPLOYMENTS404/409No such deployment, or the project has none yet
NO_ROLLBACK_TARGET409There is no earlier ready deployment to roll back to
NOT_READY, NO_PRODUCTION409The deployment isn't ready, or nothing serves production yet
CONFIRM_MISMATCH400Delete: the confirmation doesn't match the project name
PROJECT_DISABLED, PROJECT_NOT_ACTIVE409The project is disabled by IT or archived
LICENSE_EXPIRED402Deploys are paused: the licence expired past its grace period (running apps keep serving)
LICENSE_LIMIT402New projects are paused: the licence's project cap is reached, or it expired past its grace period
LICENSE_FEATURE402The feature isn't included in your licence

Settings​

CodeStatusMeaning
INVALID_ENV400A variable name is reserved or invalid, or the value is too large
TOO_MANY_ENV400More than 100 variables
ENV_NOT_FOUND404No such variable
STATIC_SITE409Static sites have no runtime, so there's nothing to redeploy with variables
INVALID_ACCESS, INVALID_MEMBER, INVALID_ROLE, UNKNOWN_PRINCIPAL400An access rule names an unknown person, group or invalid role

Database​

CodeMeaning
SQL_TIMEOUTThe query ran longer than the statement timeout
READ_ONLYA write in read-only mode
PERMISSION_DENIEDPostgres refused the operation
SQL_ERRORAny other Postgres error, with its message
TABLE_NOT_FOUND, COLUMN_NOT_FOUNDNo such table or column
DB_PROVISIONINGThe project database is still being created; retry shortly
DB_ERRORSDK: a database error; details.code is the SQLSTATE
NO_REQUESTSDK: server code made a per-person call without the request
SERVER_ONLYSDK: tc.db.sql and similar calls are server-only
NOT_CONFIGUREDSDK: the platform environment isn't present (for example running outside vastframe)

Storage​

CodeMeaning
STORAGE_QUOTA_EXCEEDEDThe project's storage is full
STORAGE_FILE_TOO_LARGEThe file is over the per-file limit
STORAGE_TYPE_NOT_ALLOWEDThe file type isn't allowed
STORAGE_EXISTSA file exists at that path; pass upsert: true
STORAGE_NOT_OWNEROnly the uploader, an editor or an admin may change it
STORAGE_FORBIDDENSomeone else's file in a private bucket
STORAGE_NOT_FOUND, STORAGE_BUCKET_NOT_FOUNDNo such file or bucket
STORAGE_NOT_PUBLICgetPublicUrl on a private bucket
STORAGE_SIGNATURE_EXPIREDThe signed URL has expired
INVALID_BUCKET, INVALID_VISIBILITYBad bucket name or visibility
BUCKET_NOT_EMPTYDeleting a bucket that still has files without forcing it
PROJECT_ARCHIVED, PROJECT_DISABLEDStorage is paused while the project is archived or disabled

Integrations​

CodeMeaning
ACCESS_PENDINGThe grant is waiting for approval; err.request has the request id, approvers and URL. Works once approved, no redeploy
ACCESS_DENIEDRefused, or approved narrower than the call needs
CONNECT_REQUIREDThe person must connect their account (err.connectUrl, tc.int.<name>.connect())
VENDOR_ERRORThe vendor answered with an error; err.details has its body
M365_ACCESS_DENIEDThe person can't open the Microsoft 365 file
INTEGRATION_NOT_FOUNDNo such integration in your catalog
REQUEST_NOT_FOUNDNo such access request

Sign-in configuration (admins)​

CodeMeaning
IDP_UNREACHABLEThe identity provider's discovery document couldn't be fetched
IDP_INVALIDThe discovery document is invalid or its issuer doesn't match
INSTALLATION_SIGN_INThe default organization uses the installation's own sign-in, which isn't changed here
NOT_VERIFIED, NO_VERIFIED_DOMAINThe email domain isn't verified yet
WORKOS_NOT_CONFIGURED, WORKOS_NOT_ENABLEDEnterprise SSO isn't set up for the installation or this organization
DIRECTORY_READ_ONLYPeople are synced from a directory, so they can't be edited by hand
Was this page helpful?