# Docs - PhanomCloud

## Docs

- [Check Subdomain](https://docs.phanomcloud.online/api/apps/check-subdomain.md): Checks if a subdomain name is available. Public endpoint — no authentication required.
- [Create Backup](https://docs.phanomcloud.online/api/backups/create.md): Creates a ZIP backup of all files in the bot's directory. Excludes node_modules, __pycache__, and .git.
- [Delete Backup](https://docs.phanomcloud.online/api/backups/delete.md): Permanently deletes a backup. Only allowed after the backup is at least 1 hour old.
- [Download Backup](https://docs.phanomcloud.online/api/backups/download.md): Downloads the ZIP file of a backup using a signed URL. No session token required — uses an HMAC token from the list endpoint.
- [List Backups](https://docs.phanomcloud.online/api/backups/list.md): Lists all backups for a bot. Maximum of 8 backups per bot.
- [Restore Backup](https://docs.phanomcloud.online/api/backups/restore.md): Restores a backup, overwriting the bot's current files. The bot must be offline.
- [Execute Console Command](https://docs.phanomcloud.online/api/bots/console.md): Executes a command inside the bot's Docker container via docker exec.
- [Create Bot](https://docs.phanomcloud.online/api/bots/create.md): Creates a new bot. Does NOT start it automatically — use POST /bots/start after uploading your files.
- [Delete Bot](https://docs.phanomcloud.online/api/bots/delete.md): Permanently deletes a bot, stops its container, and frees its memory allocation.
- [Get Bot](https://docs.phanomcloud.online/api/bots/get.md): Returns a single bot by ID. Only returns bots owned by the authenticated user.
- [List Bots](https://docs.phanomcloud.online/api/bots/list.md): Returns all bots belonging to the authenticated user.
- [Get Logs](https://docs.phanomcloud.online/api/bots/logs.md): Returns the last N lines of stdout/stderr logs captured from the bot's Docker container.
- [Reinstall Dependencies](https://docs.phanomcloud.online/api/bots/reinstall-deps.md): Clears installed dependencies so they are fully reinstalled on the next bot start. The bot must be offline.
- [Restart Bot](https://docs.phanomcloud.online/api/bots/restart.md): Stops and restarts a bot. Returns immediately — the restart happens in the background.
- [Start Bot](https://docs.phanomcloud.online/api/bots/start.md): Starts a bot by creating and launching its Docker container. Returns immediately — startup happens in the background.
- [Stop Bot](https://docs.phanomcloud.online/api/bots/stop.md): Stops a running bot. Returns immediately — shutdown happens in the background.
- [Update Memory](https://docs.phanomcloud.online/api/bots/update-memory.md): Resizes the RAM allocation of a bot. A restart is required for the new limit to be applied in Docker.
- [Update Startup Command](https://docs.phanomcloud.online/api/bots/update-startup.md): Updates the command used to start the bot. A restart is required to apply the change.
- [Delete File](https://docs.phanomcloud.online/api/files/delete.md): Permanently removes a file or folder from the bot's directory.
- [List Files](https://docs.phanomcloud.online/api/files/list.md): Lists all files in the bot's directory along with total disk usage.
- [Move File](https://docs.phanomcloud.online/api/files/move.md): Moves or renames a file or folder within the bot's directory.
- [Read File](https://docs.phanomcloud.online/api/files/read.md): Returns the text content of a specific file in the bot's directory.
- [Rename File](https://docs.phanomcloud.online/api/files/rename.md): Renames a file or folder within a specific directory.
- [Upload Files](https://docs.phanomcloud.online/api/files/upload.md): Uploads a .zip or .rar archive and extracts its contents into the bot's directory.
- [Write File](https://docs.phanomcloud.online/api/files/write.md): Creates or overwrites a file in the bot's directory with the given content.
- [Current Metrics](https://docs.phanomcloud.online/api/metrics/current.md): Returns the latest resource usage snapshot for a bot. Collected every 30 seconds automatically.
- [Metrics History](https://docs.phanomcloud.online/api/metrics/history.md): Returns up to 30 minutes of metrics history. One data point every 30 seconds (max 60 points).
- [Authentication](https://docs.phanomcloud.online/authentication.md): How to authenticate your requests to the PhanomCloud API.
- [Errors](https://docs.phanomcloud.online/errors.md): Standard HTTP error codes returned by the PhanomCloud API.
- [Introduction](https://docs.phanomcloud.online/introduction.md): Welcome to the PhanomCloud API — host and manage your bots in the cloud.

## OpenAPI Specs

- [openapi](https://docs.phanomcloud.online/api-reference/openapi.json)

## Optional

- [Support](https://discord.gg/VjvDkzRNxA)
- [Status](https://status.phanomcloud.app)