DocsError codesMIGRATE_FAILEDFor AI agents
Error code

MIGRATE_FAILED

1 minute to read

What it means. The database migration failed.

What to do. Fix what the migration reported, then re-run deploy. When the platform could read the migration's output, message quotes the error it printed and details.excerpt holds its last lines. The version that was live before, if any, is still serving.

  • HTTP status: 422
  • Retryable after applying the fix: yes

Every failure from the CLI or an MCP tool has this shape:

JSON
{
  "ok": false,
  "code": "MIGRATE_FAILED",
  "message": "The database migration failed.",
  "fix": "Fix what the migration reported, then re-run deploy. When the platform could read the migration's output, message quotes the error it printed and details.excerpt holds its last lines. The version that was live before, if any, is still serving.",
  "file": "<where to edit, when known>",
  "retryable": true,
  "docs": "https://docs.uarpie.app/errors/MIGRATE_FAILED"
}

Apply fix (edit file when it is given), then run the same command again.

↑ ↓ to moveEnter to open