Reference
Error codes
Every failure from the command or an MCP tool has the same shape: a stable code, a plain message, a fix an AI can act on, the file to edit when known, and a link to the page for that code. Your AI reads these so you don’t have to.
| Code | What it means | Retry after fix |
|---|---|---|
| DETECT_NO_PROJECT | No deployable project found in this directory. | yes |
| DETECT_UNSUPPORTED_FRAMEWORK | The framework in this project is not supported yet. | yes |
| DETECT_PORT_FIXED | The start command forces a fixed port, so the app would never answer on the port the platform gives it. | yes |
| ENGINE_CONVERSION_REQUIRED | This app uses a database engine the platform does not host. | yes |
| AUTH_PROVIDER_AVAILABLE | This app has its own sign-in, but the platform already signs people in to a private app and tells the app who they are. | yes |
| SCHEDULED_WORK_IN_APP | This app runs work on a timer inside itself, and a copy of the app is paused between visits, so that work runs late, all at once, or not at all. | yes |
| ASTRO_FORMS_REFUSED | This Astro app runs as a server, and its config does not let it read the address visitors open, so here it would refuse every form its own pages send ("Cross-site POST form submissions are forbidden") and Astro.url would say http://localhost. | yes |
| PARTS_MIGRATE_AFTER_MAIN | The main part goes live and is checked before another part runs its migrations, so on the first deploy its home page meets a database with no tables yet. | yes |
| BUILD_FAILED | The build failed. | yes |
| BUILD_MISSING_DEPENDENCY | Build failed: a module the code imports is not in package.json. | yes |
| BUILD_TIMEOUT | The build ran longer than the limit and was stopped. | yes |
| BUILD_IMAGE_TOO_LARGE | The built app is larger than the runtime limit. | yes |
| BUILD_SETTING_MISSING | A setting the app reads while it is being built is not set, so the built app has it empty. | yes |
| MIGRATE_FAILED | The database migration failed. | yes |
| PROVISION_FAILED | The platform could not create a resource this app needs. | yes |
| ROUTE_FAILED | The app was built but could not be given an address. | yes |
| ADDRESS_STILL_STARTING | The app is live, but its new address is still being set up at the edge and can take up to a minute more to answer. | no |
| DOMAIN_INVALID | That is not a domain name the platform can attach. | yes |
| HEALTHCHECK_FAILED | The new version started but did not answer a request. | yes |
| DEPLOY_IN_PROGRESS | Another deploy of this project is already running. | yes |
| DEPLOY_STILL_RUNNING | The app is still deploying. This command stopped watching, but the platform is still working on it. | no |
| REQUEST_TOO_LARGE | The request carried more than 1 MB, which is more than an app can be sent in one request. | no |
| APP_PAUSED | This app is paused, so it cannot answer right now. | yes |
| NOTHING_CHANGED | The live version already has these files, settings and deploy.json, built on the platform as it is now. | no |
| SCHEMA_DRIFT | Rolling back code only: the database schema changed after the target version. | yes |
| UNAUTHORIZED | No valid credential was presented. | yes |
| FORBIDDEN | This credential cannot act on that project. | no |
| BIND_TOKEN_EXPIRED | This link has expired. | yes |
| BIND_TOKEN_CONSUMED | This app is already in use on another device. | no |
| PROJECT_NOT_FOUND | No project with that id exists. | no |
| PROJECT_EXPIRED | This app was never claimed and has been removed. | yes |
| ACCOUNT_REQUIRED | This action needs a claimed account. | yes |
| SPEND_CAP_REACHED | This would cost more than the account's spending limit allows this month, so it was not started. | no |
| CREDIT_NEEDED | This is paid from Uarpie credit, and the account has none left, so it was not started. | no |
| RATE_LIMITED | Too many requests in a short time. | yes |
| DEPLOY_LIMIT_REACHED | Today's limit for deploying without an account has been reached: this address's own, or, when Uarpie is busy, the one shared by everyone. | yes |
| MAIL_UNDELIVERABLE | The email could not be sent. | yes |
| EGRESS_NOT_ALLOWED | The app tried to reach a service it is not allowed to reach. | no |
| EGRESS_BLOCKED | This app has been stopped from calling outside services. | no |
| EGRESS_LIMIT_REACHED | This app has reached how much it may call outside services. | yes |
| EGRESS_NEEDS_KEEP | The app's home page calls a service that an app nobody has kept yet cannot reach. | no |
| DESKTOP_SHELL_UNAVAILABLE | Desktop apps cannot be made for that system right now. | yes |
| PLAN_LIMIT_REACHED | The account's plan does not allow this. | no |
| USAGE_LIMIT_REACHED | This account has used the build minutes its plan includes this month, so new builds wait. | no |
| SECRETS_TOO_LARGE | The app's settings exceed the 4 KB runtime limit. | yes |
| STORAGE_ALMOST_FULL | The file space in this app's plan is almost used up. All the apps on one account share it. | yes |
| STORAGE_FULL | The file space in this app's plan is used up, so no upload link was given for that file. All the apps on one account share it. | yes |
| FILE_LINK_EXPIRED | This link to one of the app's files has expired. | no |
| FILE_LINK_INVALID | This link to one of the app's files is not one the platform made, or it was changed after it was made. | no |
| SOURCE_UNAVAILABLE | The source for that version is no longer stored. | no |
| VERSION_UNAVAILABLE | That version can no longer be brought back: each app keeps its last 10 builds ready. | no |
| LOGIN_CODE_INVALID | That sign-in code is not valid or has expired. | yes |
| MOBILE_STORE_STEP_REQUIRED | This is a phone app: every deploy makes the version phones run, and its address shows a page saying so. For now it opens on a phone in Expo Go, Expo's free app, and the platform does not publish to the App Store or Google Play. | no |
| MOBILE_NO_SERVER_FOUND | This is a phone app with no server in the folder, so there is nothing to host yet. | yes |
| PHONE_VERSION_MISSING | This app has no phone version yet. | yes |
| PHONE_LINK_INVALID | This link to the app's phone version has expired or was taken back. | no |
| VIEWER_CODE_UNKNOWN | No app has this code. | yes |
| VIEWER_SIGN_IN_REQUIRED | This app is private. Sign in with the email it was shared with to open it. | yes |
| VIEWER_NOT_INVITED | This email has not been invited to this app. | yes |
| SIGN_IN_CODE_INVALID | That code is not right, or it has expired. | yes |
| PUBLISH_NOT_CONFIRMED | Making an app public is not something to do on someone's behalf without asking. | yes |
| STORE_ACCOUNT_REQUIRED | Uploading to the App Store or Google Play for the person is not available. | no |
| STORE_CREDENTIAL_REJECTED | Apple or Google refused the connected developer credential. | no |
| RELEASE_IN_PROGRESS | A phone build for that platform is already under way for this app. | yes |
| PHONE_BUILD_LIMIT_REACHED | This account has made the 10 Android builds an account may make in a month, so this one was not started. | no |
| RELEASE_PLATFORM_UNAVAILABLE | That phone build is not available yet. | no |
| RELEASE_NOT_CONFIRMED | A phone build needs a current price quote, and that exact amount confirmed, before it starts. | yes |
| RELEASE_QUOTE_EXPIRED | That price quote is no longer current. | yes |
| DOMAIN_UNAVAILABLE | That domain cannot be bought here. | no |
| DOMAIN_QUOTE_EXPIRED | That price quote is no longer current. | yes |
| DOMAIN_ORDER_IN_PROGRESS | A domain is already being bought for this app. | yes |
| AI_CREDITS_EMPTY | This account has used all its Uarpie credit, so Uarpie Builder stopped before this step. | no |
| AI_UNAVAILABLE | Drafting with AI is not set up on this server. | no |
| SITE_PAGE_PROTECTED | That page is part of the site itself and cannot be deleted or given a different address. | no |
| SITE_SLUG_TAKEN | Another page or post already uses that address. | yes |
| INTEGRATION_NOT_CONFIGURED | That figure comes from an outside service that is not connected. | no |
| EDGE_NOT_UPDATED | The change is saved, but the edge that checks who may open the app has not caught up yet. | yes |
| VALIDATION_FAILED | The request was malformed. | yes |
| INTERNAL | Something went wrong on the platform. | yes |
This page as Markdown: /docs/errors.mdllms.txt