| Missing endpoint or token | Configure FLEX_STUDIO_URL and FLEX_STUDIO_TOKEN for the current process. Dry runs work without either. |
| Unknown command or option | Compare the invocation with command reference. |
| Workspace or entry must be a ULID | Use the public Studio ID and check copied whitespace. |
| HTTP 401 or 403 | Check token expiry, managed tool grants, workspace allowlist and actor permissions. |
| MCP tool reports a failure | Verify that tool’s inputs, feature configuration and migrations using MCP troubleshooting. |
| Largest resolution is ambiguous | Mark the intended original in the manifest. |
| Different aspect ratios | Mark an explicit source so the retained crops are deliberate. |
| Relative path or regular-file error | Use nonempty files inside the import directory and supported relative components. Check for symlinks. |
| Directory grouping limit reached | Use a streamed JSONL manifest for the large flat directory. |
| Local file changed after planning | Freeze the source directory and repeat the dry run before importing. |
| Bundle exceeds ordinary upload limit | Use rebuild mode or adjust the host’s ordinary upload policy. |
| Source exceeds ordinary upload limit | Configure resumable sessions on the host. |
| Unknown transport or invalid chunk size | Verify that CLI and server versions implement the same upload contract. |
| Direct storage PUT fails | Check role permissions, checksum support and signed endpoint reachability. S3 multipart |
| Download fails to publish | Check existing output, directory permissions, space and hard-link support. |
| Search returns no files | Check workspace scope, visibility and search indexing. |