App web IDE
Availability
The web IDE is not available yet. The current endpoints persist an IDE-shaped binding and return a planned URL, but the active provider is a stub. It does not install code-server, start an editor, register a gateway route, or enforce an owner-only editor session.
Do not open or publish the returned URL. A response whose status says running is a stub response and is not proof that an IDE process or private route exists.
Preview contract
The owner-scoped routes are:
| Method | Path | Current behavior |
|---|---|---|
POST | /api/apps/{app_id}/ide | Persists an enabled binding through the stub provider. |
GET | /api/apps/{app_id}/ide | Returns the stored binding or the default off state. |
DELETE | /api/apps/{app_id}/ide | Persists an off state through the stub provider. |
Equivalent MCP tools are enable_app_ide, get_app_ide_status, and disable_app_ide.
The planned URL has the form https://ide-<slug>.apps.openfactory.tech. It is reserved metadata today, not a reachable or authenticated service.
What remains before use
A usable IDE release needs:
- a reviewed code-server build feature baked through the immutable image pipeline;
- real provisioning with trustworthy status transitions;
- a private gateway route that enforces app ownership regardless of requested visibility;
- network restrictions preventing direct access to the editor port;
- a source-control workflow that preserves commits outside the disposable VM;
- resource limits, update handling, and shutdown behavior; and
- an end-to-end test covering edit, commit, redeploy, authorization denial, disable, and recovery.
Until those checks pass, edit the application’s repository using your normal development environment, commit there, and deploy the reviewed revision through App deployment.