# mailslurp.api.GroupControllerApi

# Load the API package

import 'package:mailslurp/api.dart';

All URIs are relative to https://api.mailslurp.com

Method	HTTP request	Description
addContactsToGroup	PUT /groups/{groupId}/contacts	Add contacts to a group
createGroup	POST /groups	Create a group
deleteGroup	DELETE /groups/{groupId}	Delete group
getAllGroups	GET /groups/paginated	Get all Contact Groups in paginated format
getGroup	GET /groups/{groupId}	Get group
getGroupWithContacts	GET /groups/{groupId}/contacts	Get group and contacts belonging to it
getGroupWithContactsPaginated	GET /groups/{groupId}/contacts-paginated	Get group and paginated contacts belonging to it
getGroups	GET /groups	Get all groups
removeContactsFromGroup	DELETE /groups/{groupId}/contacts	Remove contacts from a group

# addContactsToGroup

GroupContactsDto addContactsToGroup(groupId, updateGroupContactsOption)

Add contacts to a group

# Example

import 'package:mailslurp/api.dart';
// TODO Configure API key authorization: API_KEY
//defaultApiClient.getAuthentication<ApiKeyAuth>('API_KEY').apiKey = 'YOUR_API_KEY';
// uncomment below to setup prefix (e.g. Bearer) for API key, if needed
//defaultApiClient.getAuthentication<ApiKeyAuth>('API_KEY').apiKeyPrefix = 'Bearer';
var api_instance = GroupControllerApi();
var groupId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // String | groupId
var updateGroupContactsOption = UpdateGroupContacts(); // UpdateGroupContacts | updateGroupContactsOption
try { 
    var result = api_instance.addContactsToGroup(groupId, updateGroupContactsOption);
    print(result);
} catch (e) {
    print("Exception when calling GroupControllerApi->addContactsToGroup: $e\n");
}

# Parameters

Name	Type	Description	Notes
groupId	String	groupId	[default to null]
updateGroupContactsOption	UpdateGroupContacts	updateGroupContactsOption

# Return type

GroupContactsDto

# Authorization

API_KEY

# HTTP request headers

Content-Type: application/json
Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

# createGroup

GroupDto createGroup(createGroupOptions)

Create a group

# Example

import 'package:mailslurp/api.dart';
// TODO Configure API key authorization: API_KEY
//defaultApiClient.getAuthentication<ApiKeyAuth>('API_KEY').apiKey = 'YOUR_API_KEY';
// uncomment below to setup prefix (e.g. Bearer) for API key, if needed
//defaultApiClient.getAuthentication<ApiKeyAuth>('API_KEY').apiKeyPrefix = 'Bearer';
var api_instance = GroupControllerApi();
var createGroupOptions = CreateGroupOptions(); // CreateGroupOptions | createGroupOptions
try { 
    var result = api_instance.createGroup(createGroupOptions);
    print(result);
} catch (e) {
    print("Exception when calling GroupControllerApi->createGroup: $e\n");
}

# Parameters

Name	Type	Description	Notes
createGroupOptions	CreateGroupOptions	createGroupOptions

# Return type

GroupDto

# Authorization

API_KEY

# HTTP request headers

Content-Type: application/json
Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

# deleteGroup

deleteGroup(groupId)

Delete group

# Example

import 'package:mailslurp/api.dart';
// TODO Configure API key authorization: API_KEY
//defaultApiClient.getAuthentication<ApiKeyAuth>('API_KEY').apiKey = 'YOUR_API_KEY';
// uncomment below to setup prefix (e.g. Bearer) for API key, if needed
//defaultApiClient.getAuthentication<ApiKeyAuth>('API_KEY').apiKeyPrefix = 'Bearer';
var api_instance = GroupControllerApi();
var groupId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // String | groupId
try { 
    api_instance.deleteGroup(groupId);
} catch (e) {
    print("Exception when calling GroupControllerApi->deleteGroup: $e\n");
}

# Parameters

Name	Type	Description	Notes
groupId	String	groupId	[default to null]

# Return type

void (empty response body)

# Authorization

API_KEY

# HTTP request headers

Content-Type: Not defined
Accept: Not defined

[Back to top] [Back to API list] [Back to Model list] [Back to README]

# getAllGroups

PageGroupProjection getAllGroups(page, size, sort)

Get all Contact Groups in paginated format

# Example

import 'package:mailslurp/api.dart';
// TODO Configure API key authorization: API_KEY
//defaultApiClient.getAuthentication<ApiKeyAuth>('API_KEY').apiKey = 'YOUR_API_KEY';
// uncomment below to setup prefix (e.g. Bearer) for API key, if needed
//defaultApiClient.getAuthentication<ApiKeyAuth>('API_KEY').apiKeyPrefix = 'Bearer';
var api_instance = GroupControllerApi();
var page = 56; // int | Optional page index in inbox list pagination
var size = 56; // int | Optional page size in inbox list pagination
var sort = sort_example; // String | Optional createdAt sort direction ASC or DESC
try { 
    var result = api_instance.getAllGroups(page, size, sort);
    print(result);
} catch (e) {
    print("Exception when calling GroupControllerApi->getAllGroups: $e\n");
}

# Parameters

Name	Type	Description	Notes
page	int	Optional page index in inbox list pagination	[optional] [default to 0]
size	int	Optional page size in inbox list pagination	[optional] [default to 20]
sort	String	Optional createdAt sort direction ASC or DESC	[optional] [default to "ASC"]

# Return type

PageGroupProjection

# Authorization

API_KEY

# HTTP request headers

Content-Type: Not defined
Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

# getGroup

GroupDto getGroup(groupId)

Get group

# Example

import 'package:mailslurp/api.dart';
// TODO Configure API key authorization: API_KEY
//defaultApiClient.getAuthentication<ApiKeyAuth>('API_KEY').apiKey = 'YOUR_API_KEY';
// uncomment below to setup prefix (e.g. Bearer) for API key, if needed
//defaultApiClient.getAuthentication<ApiKeyAuth>('API_KEY').apiKeyPrefix = 'Bearer';
var api_instance = GroupControllerApi();
var groupId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // String | groupId
try { 
    var result = api_instance.getGroup(groupId);
    print(result);
} catch (e) {
    print("Exception when calling GroupControllerApi->getGroup: $e\n");
}

# Parameters

Name	Type	Description	Notes
groupId	String	groupId	[default to null]

# Return type

GroupDto

# Authorization

API_KEY

# HTTP request headers

Content-Type: Not defined
Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

# getGroupWithContacts

GroupContactsDto getGroupWithContacts(groupId)

Get group and contacts belonging to it

# Example

import 'package:mailslurp/api.dart';
// TODO Configure API key authorization: API_KEY
//defaultApiClient.getAuthentication<ApiKeyAuth>('API_KEY').apiKey = 'YOUR_API_KEY';
// uncomment below to setup prefix (e.g. Bearer) for API key, if needed
//defaultApiClient.getAuthentication<ApiKeyAuth>('API_KEY').apiKeyPrefix = 'Bearer';
var api_instance = GroupControllerApi();
var groupId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // String | groupId
try { 
    var result = api_instance.getGroupWithContacts(groupId);
    print(result);
} catch (e) {
    print("Exception when calling GroupControllerApi->getGroupWithContacts: $e\n");
}

# Parameters

Name	Type	Description	Notes
groupId	String	groupId	[default to null]

# Return type

GroupContactsDto

# Authorization

API_KEY

# HTTP request headers

Content-Type: Not defined
Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

# getGroupWithContactsPaginated

PageContactProjection getGroupWithContactsPaginated(groupId, page, size, sort)

Get group and paginated contacts belonging to it

# Example

import 'package:mailslurp/api.dart';
// TODO Configure API key authorization: API_KEY
//defaultApiClient.getAuthentication<ApiKeyAuth>('API_KEY').apiKey = 'YOUR_API_KEY';
// uncomment below to setup prefix (e.g. Bearer) for API key, if needed
//defaultApiClient.getAuthentication<ApiKeyAuth>('API_KEY').apiKeyPrefix = 'Bearer';
var api_instance = GroupControllerApi();
var groupId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // String | groupId
var page = 56; // int | Optional page index in group contact pagination
var size = 56; // int | Optional page size in group contact pagination
var sort = sort_example; // String | Optional createdAt sort direction ASC or DESC
try { 
    var result = api_instance.getGroupWithContactsPaginated(groupId, page, size, sort);
    print(result);
} catch (e) {
    print("Exception when calling GroupControllerApi->getGroupWithContactsPaginated: $e\n");
}

# Parameters

Name	Type	Description	Notes
groupId	String	groupId	[default to null]
page	int	Optional page index in group contact pagination	[optional] [default to 0]
size	int	Optional page size in group contact pagination	[optional] [default to 20]
sort	String	Optional createdAt sort direction ASC or DESC	[optional] [default to "ASC"]

# Return type

PageContactProjection

# Authorization

API_KEY

# HTTP request headers

Content-Type: Not defined
Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

# getGroups

List getGroups()

Get all groups

# Example

import 'package:mailslurp/api.dart';
// TODO Configure API key authorization: API_KEY
//defaultApiClient.getAuthentication<ApiKeyAuth>('API_KEY').apiKey = 'YOUR_API_KEY';
// uncomment below to setup prefix (e.g. Bearer) for API key, if needed
//defaultApiClient.getAuthentication<ApiKeyAuth>('API_KEY').apiKeyPrefix = 'Bearer';
var api_instance = GroupControllerApi();
try { 
    var result = api_instance.getGroups();
    print(result);
} catch (e) {
    print("Exception when calling GroupControllerApi->getGroups: $e\n");
}

# Parameters

This endpoint does not need any parameter.

# Return type

List

# Authorization

API_KEY

# HTTP request headers

Content-Type: Not defined
Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

# removeContactsFromGroup

GroupContactsDto removeContactsFromGroup(groupId, updateGroupContactsOption)

Remove contacts from a group

# Example

import 'package:mailslurp/api.dart';
// TODO Configure API key authorization: API_KEY
//defaultApiClient.getAuthentication<ApiKeyAuth>('API_KEY').apiKey = 'YOUR_API_KEY';
// uncomment below to setup prefix (e.g. Bearer) for API key, if needed
//defaultApiClient.getAuthentication<ApiKeyAuth>('API_KEY').apiKeyPrefix = 'Bearer';
var api_instance = GroupControllerApi();
var groupId = 38400000-8cf0-11bd-b23e-10b96e4ef00d; // String | groupId
var updateGroupContactsOption = UpdateGroupContacts(); // UpdateGroupContacts | updateGroupContactsOption
try { 
    var result = api_instance.removeContactsFromGroup(groupId, updateGroupContactsOption);
    print(result);
} catch (e) {
    print("Exception when calling GroupControllerApi->removeContactsFromGroup: $e\n");
}

# Parameters

Name	Type	Description	Notes
groupId	String	groupId	[default to null]
updateGroupContactsOption	UpdateGroupContacts	updateGroupContactsOption

# Return type

GroupContactsDto

# Authorization

API_KEY

# HTTP request headers

Content-Type: application/json
Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

# mailslurp.api.GroupControllerApi

# Load the API package

# addContactsToGroup

# Example

# Parameters

# Return type

# Authorization

# HTTP request headers

# createGroup

# Example

# Parameters

# Return type

# Authorization

# HTTP request headers

# deleteGroup

# Example

# Parameters

# Return type

# Authorization

# HTTP request headers

# getAllGroups

# Example

# Parameters

# Return type

# Authorization

# HTTP request headers

# getGroup

# Example

# Parameters

# Return type

# Authorization

# HTTP request headers

# getGroupWithContacts

# Example

# Parameters

# Return type

# Authorization

# HTTP request headers

# getGroupWithContactsPaginated

# Example

# Parameters

# Return type

# Authorization

# HTTP request headers

# getGroups

# Example

# Parameters

# Return type

# Authorization

# HTTP request headers

# removeContactsFromGroup

# Example

# Parameters

# Return type

# Authorization

# HTTP request headers

Modern email APIs. Free for personal use.

About

Developers

Code samples

Social