Error codes

Every failure response has the same shape:

json

{
  "code": "QUOTA_EXCEEDED",
  "message": "scaling to 12 replicas needs 12 CPU but the project quota is 8",
  "hint": "Scale another service down, or request a quota increase.",
  "retryable": false
}

The hint is written for a reader — human or agent — to know the next action.

Code	Meaning	What to do
`NO_PROVIDER_DETECTED`	no Dockerfile and no buildable stack found	add a Dockerfile, or use a conventional layout (package.json, go.mod, requirements.txt…)
`BUILD_COMMAND_FAILED`	the build itself failed	read `log_tail`, fix the source, redeploy
`IMAGE_PUSH_FAILED`	built but couldn't push	retry (`retryable: true`)
`SOURCE_TOO_LARGE`	upload exceeds 512MB	exclude artifacts via `.conwayignore`
`TIMEOUT`	build exceeded 30 minutes	reduce build work, retry
`HEALTH_CHECK_FAILED`	app never became ready on `$PORT`	bind `0.0.0.0:$PORT`; check `log_tail`
`UNAUTHENTICATED`	missing/invalid token	send `Authorization: Bearer <token>`
`CAPABILITY_MISSING`	token lacks the required capability	get a token with that capability
`QUOTA_EXCEEDED`	project resource quota hit	scale down or request more
`NOT_FOUND`	no such project/service/release	check `conway status`
`INVALID_INPUT`	request shape wrong	follow the `hint`
`CONFLICT`	state conflict (e.g. nothing to roll back to)	follow the `hint`
`INTERNAL_ERROR`	platform-side fault	retry once; report if it persists

Error codes ​

Error codes