# Add Group Role

Creates a new group role for an organization

Endpoint: POST /api/v2.0/orgs/{orgToken}/groups/{groupUuid}/roles
Version: 3.0.1
Security: bearer-key

## Path parameters:

  - `orgToken` (string, required)
    org UUID (by running Entities - Organization > Get User Organizations) or API Key (from the Mend SCA App:  tab > ).

  - `groupUuid` (string, required)
    Group UUID (by running User Management - Groups > Get All Groups of Organization).

## Request fields (application/json):

  - `contextToken` (string, required)
    Depending on the value of contextType, this can be:
+ orgToken (org UUID by running Entities - Organization > Get User Organization) or Api Token (from the Mend SCA App:  tab > ).
+ productToken (product UUID (by running Entities - Organization > Get Organization Products) or Product Token (from the Mend SCA App:  tab > .
+ projectToken (project UUID by running Entities - Product > Get Product Projects) or project Token (from the Mend SCA App:  tab > ).
    Example: "123e4567-e89b-12d3-a456-426655440000"

  - `contextType` (string, required)
    Type of entity the role will be associated with
    Enum: "orgs", "products"

  - `role` (string)
    Enum: "DEFAULT_APPROVER", "ADMIN", "ALERT_EMAIL_RECEIVER", "ALERTS_IGNORER", "LICENSE_AND_COPYRIGHT_ASSIGNER", "AUDITOR", "USER", "PRODUCT_INTEGRATOR", "SBOM_EXPORTER"

## Response 200 fields (application/json):

  - `supportToken` (string)
    Example: "1171c60d"

  - `retVal` (object)

  - `retVal.contextToken` (string)
    Depending on the value of contextType, this can be:
+ orgToken (org UUID by running Entities - Organization > Get User Organization) or Api Token (from the Mend SCA App:  tab > ).
+ productToken (product UUID (by running Entities - Organization > Get Organization Products) or Product Token (from the Mend SCA App:  tab > .
+ projectToken (project UUID by running Entities - Product > Get Product Projects) or project Token (from the Mend SCA App:  tab > ).
    Example: "123e4567-e89b-12d3-a456-426655440000"

  - `retVal.contextName` (string)
    Example: "My Project"

  - `retVal.contextType` (string)
    Type of entity the role will be associated with
    Enum: "orgs", "products"

  - `retVal.role` (string)
    Enum: "DEFAULT_APPROVER", "ADMIN", "ALERT_EMAIL_RECEIVER", "ALERTS_IGNORER", "LICENSE_AND_COPYRIGHT_ASSIGNER", "AUDITOR", "USER", "PRODUCT_INTEGRATOR", "SBOM_EXPORTER"

## Response 400 fields (*/*):

  - `supportToken` (string)
    Example: "1171c60d"

## Response 403 fields (*/*):

  - `supportToken` (string)
    Example: "1171c60d"