listOrganizationInvitations method

Future<OrganizationInvitations?> listOrganizationInvitations(String organizationId, { String? status, String? emailAddress, String? orderBy, int? limit, int? offset, })

Get a list of organization invitations

This request returns the list of organization invitations. Results can be paginated using the optional limit and offset query parameters. You can filter them by providing the 'status' query parameter, that accepts multiple values. The organization invitations are ordered by descending creation date. Most recent invitations will be returned first. Any invitations created as a result of an Organization Domain are not included in the results.

Parameters:

• String organizationId (required): The organization ID.

• String status: Filter organization invitations based on their status

• String emailAddress: Returns organization invitations inviting the specified email address.

• String orderBy: Allows to return organization invitations in a particular order. You can order the returned organization invitations either by their created_at or email_address. In order to specify the direction, you can use the +/- symbols prepended in the property to order by. For example, if you want organization invitations to be returned in descending order according to their created_at property, you can use -created_at. If you don't use + or -, then + is implied. Defaults to -created_at.

• int limit: Applies a limit to the number of results returned. Can be used for paginating the results together with offset.

• int offset: Skip the first offset results when paginating. Needs to be an integer greater or equal to zero. To be used in conjunction with limit.

Implementation

Future<OrganizationInvitations?> listOrganizationInvitations(
  String organizationId, {
  String? status,
  String? emailAddress,
  String? orderBy,
  int? limit,
  int? offset,
}) async {
  final response = await listOrganizationInvitationsWithHttpInfo(
    organizationId,
    status: status,
    emailAddress: emailAddress,
    orderBy: orderBy,
    limit: limit,
    offset: offset,
  );
  if (response.statusCode >= HttpStatus.badRequest) {
    throw ApiException(response.statusCode, await _decodeBodyBytes(response));
  }
  // When a remote server returns no body with a status of 204, we shall not decode it.
  // At the time of writing this, `dart:convert` will throw an "Unexpected end of input"
  // FormatException when trying to decode an empty string.
  if (response.body.isNotEmpty &&
      response.statusCode != HttpStatus.noContent) {
    return await apiClient.deserializeAsync(
      await _decodeBodyBytes(response),
      'OrganizationInvitations',
    ) as OrganizationInvitations;
  }
  return null;
}