Retrieve distribution groups assigned to application

GET

/v1/organizations/:organizationId/apps/:applicationId/groups

Retrieve distribution groups assigned to application

Required Permission: mad.application.management.listGroups

Retrieves the list of distribution groups or user segments that have been granted access to this application, showing which teams or employee groups can download and install builds.

Request

Add parameter in header authorization

Example: Authorization: Bearer <token>

organizationId string

required

Unique identifier or URL-friendly slug for the organization that owns the applications to operate on, establishing organizational scope for all nested application operations.

Match pattern: ^(([a-fA-F0-9]{24})|([a-zA-Z0-9\\-]{3,}))$

applicationId string

required

Unique identifier or URL-friendly slug for the specific application to retrieve, update, or delete.

Match pattern: ^(([a-fA-F0-9]{24})|([a-zA-Z0-9\\-]{3,}))$

Responses

200 Response application/json

status boolean optional

data object optional

items array [object] optional

Array of distribution groups or user segments that have been granted access to this application.

value string optional

Access control group identifier for organization-level permissions enabling role-based team management.

≤ 256 characters

{
    "status": true,
    "data": {
        "items": [
            {
                "value": "org.administrators"
            }
        ]
    }
}

401 Response application/json

status boolean optional

false

error object optional

code number optional

4001

message string optional

Unauthorized

{
    "status": false,
    "error": {
        "code": 4002,
        "message": "No auth token"
    }
}

404 Response application/json

status boolean optional

false

error object optional

code number optional

3001

message string optional

Entity not found

{
    "status": false,
    "error": {
        "code": 3001,
        "message": "Entity not found"
    }
}