# CloudCLI Dev Environments

## Docs
- [CloudCLI API Documentation](https://developer.cloudcli.ai/cloudcli-api-documentation-356294m0.md): 

## API Docs
- Environments [List environments](https://developer.cloudcli.ai/list-environments-3998767e0.md): Get all environments for the authenticated user
- Environments [Get environment](https://developer.cloudcli.ai/get-environment-3998769e0.md): Fetch the full record for a single CloudCLI environment by its UUID. This returns everything the dashboard displays for that environment: lifecycle status, access URL, SSH port, GitHub repository (if one was cloned), timestamps, and the underlying server assignment.
- Environments [Create environment](https://developer.cloudcli.ai/create-environment-3998768e0.md): The request body for POST /environments, which provisions a new CloudCLI development container on your account. Only name and subdomain are required. Everything else (GitHub clone, tokens) is optional and can be configured later via  the dashboard.                                         
- Environments [Delete environment](https://developer.cloudcli.ai/delete-environment-3998770e0.md): Permanently delete a CloudCLI environment, destroying its container, persistent storage, and all associated metadata. This operation is irreversible so once deleted,  code on /workspace/, installed packages, shell history, and SSH keys are gone forever, and the subdomain is released back to the pool for reuse by other accounts.
- Environments [Get SSH credentials](https://developer.cloudcli.ai/get-ssh-credentials-3998773e0.md): Retrieve the credentials needed to SSH into a running CloudCLI environment. Returns a ready-to-paste ssh_command, plus the individual pieces (username, password, host, port) so you can wire them into your IDE, SFTP client, or connection manager of choice.
- Environments [Start environment](https://developer.cloudcli.ai/start-environment-3998771e0.md): Start a previously stopped CloudCLI environment and bring it back online. When an environment has been stopped - manually, automatically after its idle window, or at the end of a trial - this endpoint boots its container on the assigned server, reconnects the network routes, and makes the environment reachable again at its subdomain.
- Environments [Stop environment](https://developer.cloudcli.ai/stop-environment-3998772e0.md): Gracefully stop a running CloudCLI environment. The container is paused and SSH and HTTPS access are disabled, but all data on /workspace/ is preserved on the server disk. You can restart the environment any time with POST  /environments/{id}/start and get back exactly as you left it.
- Agents [Execute AI agent](https://developer.cloudcli.ai/execute-ai-agent-3998774e0.md): Run Claude Code, Codex CLI or Cursor CLI agent on a running environment.
- Agents [AI Agent models](https://developer.cloudcli.ai/ai-agent-models-4026679e0.md): Returns the list of supported AI providers and their available models.

## Schemas
- Schemas [AgentModels](https://developer.cloudcli.ai/agentmodels-706148d0.md): 
- Schemas [Environment](https://developer.cloudcli.ai/environment-686464d0.md): 
- Schemas [CreateEnvironmentRequest](https://developer.cloudcli.ai/createenvironmentrequest-686465d0.md): 
- Schemas [SSHCredentials](https://developer.cloudcli.ai/sshcredentials-686466d0.md): 
- Schemas [AgentExecuteRequest](https://developer.cloudcli.ai/agentexecuterequest-686467d0.md): 
- Schemas [Error](https://developer.cloudcli.ai/error-686468d0.md):