Repository endpoints
====================
    
  .. http:get:: /api/repository/(string repoID)
  
    Get data about the specified repository, including environments

    **Example response**
    
    .. sourcecode:: http
    
      HTTP/1.1 200 OK
      
      {
        "id":"[repository-id]",
        "name":"drupal-test",
        "type:"gitlab",
        "gid":"[group-id]",
        "size":1234,
        "details":{
          "url":"https://...."
        }
        "environments":[
          {
            "id":"[environment-id]",
            "name":"[environment-name]",
            "gitRef":{
              "name":"develop",
              "type":"branch"
            }
          }
        ],
        "reusableEnvironments":[
          {
            "label":"reusable1",
            "buildAt":"[datetime]",
            "from":{
              "name":"develop"
            }
          }
        ]
      }
      
    :>json string id: Repository ID
    :>json string gid: Group ID
    :>json string name: Repository name
    :>json string url: Repository URL
    :>json dict details: Details, depends on the type of repository
    :>json string details.url: URL of the code platform repository
    :>json integer size: Repository size (the sum of environment sizes)
    :>json string type: Type of repository (``generic`` | ``azure``)
    :>json []environment environemnts: Environments that belongs to this repository
    :>json []reusableEnvironment reusableEnvironemnts: Reusable environments that are available in the repository

  .. http:post:: /api/repository/(string repoID)

    Update repository data

    :<json string name: new name of the repository

  .. http:get:: /api/repository/(string repoID)/settings
    
    Get repository settings

    :>json []variable variables: List of defined custom variables
    :>json string sshPublicKey: repository SSH public key
    :>json number environmentTTL: default environment ttl set to new environments, omitted if zero
    :>json string scheduledRebuild.mode: (``all`` | ``notclones`` | ``reusables`` |  ``disabled``) mode to use for scheduled rebuild
    :>json string scheduledRebuild.hour: hour to trigger the rebuild, in hh:mm format
    :>json string qaackFile.mode: (``repo`` | ``panel`` | ``both``) mode to use for qaack file generation, repo by default
    :>json string qaackFile.qaackFile: qaack file content string, yaml format is expected. Encoded as base64

  .. http:post:: /api/repository/(string repoID)/settings

    Update repository settings

    :<json string environmentTTL: new ttl of the repository
    :<json string scheduledRebuild.mode: (``all`` | ``reusables`` |  ``disabled``) mode to use for scheduled rebuild
    :<json string scheduledRebuild.hour: hour to trigger the rebuild, in hh:mm format
    :<json string qaackFile.mode: (``repo`` | ``panel`` | ``both``) mode to use for qaack file generation, repo by default
    :<json string qaackFile.qaackFile: qaack file content string, yaml format is expected. Encoded as base64
    
  .. http:delete:: /api/repository/(string repoID)
   
    Delete the repository

  .. _clone-endpoint:

  .. http:post:: /api/repository/(string repoID)/spawn
  
    This endpoint spawns a new environment (like a clone) from a Git reference.
    
    :<json string name: (optional) add a custom name to the new environment
    :<json boolean build: (optional) create a new environment and build (default to true)
    :<json integer ttl: (optional) custom time to live for the new environment
    :<json dict gitRef dict:
    :<json string gitRef.name: name of the Git the reference
    :<json string gitRef.type: type of the Git the reference (``branch`` | ``pull request`` | ``tag``)
    
    :>json string id: new environment id
    :>json string name: new environment name
    :>json string status: new environment status
    :>json string weburl: new environment public url

  .. http:post:: /api/repository/(string repoID)/sync
  
    Sync the remote VCS references with the local environments
    
  .. http:delete:: /api/repository/(string repoID)/reusable/(string reusableLabel)
  
    Delete reusable environment
    
  .. http:post:: /api/repository/(string repoID)/variables
    
    Create a new custom variable on the repository
    
    :<json string name: name of the new variable 
    :<json string value: value of the new variable
    :<json string visibility: (optional) visibility of the new variable (*always* | *buildtime*)
    
  .. http:delete:: /api/repository/(string repoID)/variables/(string varName)
    
    Delete a custom variable on the repository
    
  .. http:patch:: /api/repository/(string repoID)/variables
    
    Update the value of a custom variable on the repository
    
    *Either value or visibility required*
    
    :<json string name: name of the variable 
    :<json string value: (optional) new value of the variable
    :<json string visibility: (optional) new visibility variable (*always* | *buildtime*)