Group endpoints
===============

  .. http:get:: /api/groups

    Get a list of the groups
    
    :>jsonarr string id: ID of the group
    :>jsonarr string name: Name of the group


  .. http:get:: /api/group/(string groupID)

    Get a list of repositories that belongs to the specified group
    
    :>json string name: Group name
    :>json arrayRepository repositories: List of repositories that belongs to this group
    
  .. http:post:: /api/group/(string groupID)
  
    Add a repository to the group
    
    :>json string name: The name of the new repository
    :>json string type: The type of the repository (``generic`` | ``azure`` | ``bitbucket`` | ``gitlab`` | ``github``)
    :>json dict params: Parameters of the new repository, depends of the type specified
    
    For ``generic`` type:
    
    :>json string origin: Address of the git repository, in HTTP (http://... or https://...) schema or SSH (git@....)
    :>json string username: HTTP basic auth username for repository authentication
    :>json string password: HTTP basic auth passwordfor repository authentication
    
    For ``azure`` type:

    :>json string orgUrl: URL of the Azure organization
    :>json string accessToken: Azure access token 
    :>json string repoName: New repository Azure name 
    :>json string project: New repository Azure project
    
    For ``gitlab`` type:

    :>json string instanceUrl: URL of the instance (https://gitlab.com) if empty
    :>json string group: Group of the repository
    :>json string project: Project name
    :>json string token: Access token

    For ``bitbucket`` type:
    
    :>json string workspace: Workspace of the repository
    :>json string repository: Repository name
    :>json string token: Token for authentication

    For ``github`` type:

    :>json string owner: Owner of the repository
    :>json string repo: Repository to use
    :>json string token: (optional)

  .. http:get:: /api/group/(string groupID)/settings

    Get group settings

    :>json []variable variables: List of defined custom variables
    :>json []variable members: List of the group members

    
    **Repository type**:
    
    :>jsonarr string id: repository ID
    :>jsonarr string name: repository name

  .. http:post:: /api/group/(string groupID)/variables
    
    Create a new custom variable on the group
    
    :<json name string: name of the new group
    :<json value string: value of the new group
    :<json visibility string: (optional) new visibility variable (*always* | *buildtime*)
    
  .. http:delete:: /api/group/(string groupID)/variables/(string varName)
    
    Delete a custom variable on the group
    
  .. http:patch:: /api/group/(string groupID)/variables
    
    Update the value of a custom variable on the group
  
    *Either value or visibility required*
    
    :<json name string: name of the variable 
    :<json value string: (optional) new value of the variable
    :<json visibility string: (optional) new visibility variable (*always* | *buildtime*)
    
  .. http:post:: /api/group/(string groupID)/leave
  
    Remove current authenticated user from the specified group
  
  .. http:post:: /api/group/(string groupID)/members
  
    Add a member to the group
    
    :>json string name: The email of the new member
    
  .. http:delete:: /api/group/(string groupID)/members/(string memberEmail)
  
    Remove a member from the group