Environment endpoints
=====================

  .. http:get:: /api/environment/(string environmentID)
  
    Get details about the environment, including existing services

    :<json boolean build: (optional) option for trigger building (default true)
    
    **Example response**
    
    .. sourcecode:: http
    
      HTTP/1.1 200 OK
      
      {
        "id":"[environment-id]",
        "rid":"[repository-id]",
        "gitRef": {
          "name":"develop",
          "type":"branch"
        }
        "status":"built",
        "weburl":"[webproxy_url]",
        "aliases":{
            "[alias]":"[env_alias_address]"
        }
        "buildTime":1234,
        "createdAt":[datetime],
        "ttl":120,
        "builtAt":[datetime],
        "size":1234,
        "services":[
          "id":"[service-id]",
          "name":"web"
        ]
      }
      
    :>json string weburl: Environment accessible URL
    :>json string status: Environment status (``empty`` | ``created`` | ``building`` | ``built``)
    :>json integer createdAt: Datetime when environment was created
    :>json integer buildTime: Environment build process duration, in seconds
    :>json integer buildAt: Datetime when environment finished last build process
    :>json integer ttl: Time to life, its omitted if zero
    :>json integer size: Environment size in bytes
    :>json dict aliases: Environment aliases
      
  .. http:put:: /api/environment/(string environmentID)
  
    Create the environment. The object itself previously exists, this method
    setup all the services according to config. The status of the environment
    will go from `empty` to `created`.
	
    :query build: Option for create and build an environment (default to true)
    :query ttl: Option for set a custom time to live
	
    :<json string build: Option for create and build an environment (default to true)
    :<json integer ttl: Option for set a custom time to live
    
  .. http:delete:: /api/environment/(string environmentID)
  
    Delete the environment. It wont delete the object but it will remove all 
    the resources related, like services. The status of the environment will
    be set to `empty` except if there are more environments with the same git reference (clones).
    
    
  .. http:post:: /api/environment/(string environmentID)/build
  
    Trigger the build process. To get the logs refer to other endpoint.
    
  .. http:post:: /api/environment/(string environmentID)/rebuild
  
    Deletes (if not deleted), creates and build a given environment
    
  .. http:get:: /api/environment/(string environmentID)/build/logs
  
    Get a WebSocket stream in real-time of the build process.
	
  .. http:post:: /api/environment/(string environmentID)/ttl
  
    Update a running environment TTL
	
    :>json integer ttl: New TTl to set