Skip to main content

Group


List groups

Get a list of groups.

const response = await geocore.Group.groupList({
name: "name",
parent: "parent",
description: "description",
createdRange: {
start: "2025-01-01",
end: "2025-01-01",
}
updatedRange: {
start: "2025-01-01",
end: "2025-01-01",
}
page: 1,
limit: 10,
});

Prerequisites

Successfully get the IdToken with superAdmin, companyAdmin or groupAdmin access level from login API.

Parameters

nametypedata typedescription
nameoptionalstringSearch by group name
parentoptionalstringSearch by parent group ID
descriptionoptionalstringSearch by group description
createdRange[start]optionaldateSearch by createdAt timestamp
createdRange[end]optionaldateSearch by createdAt timestamp
updatedRange[start]optionaldateSearch by modifiedAt timestamp
updatedRange[end]optionaldateSearch by modifiedAt timestamp
pageoptionalnumberPage ordinal number
limitoptionalnumberNumber of records per page
Get a group

Get a group.

const response = await geocore.Group.getGroup(groupId);

Prerequisites

Successfully get the IdToken with superAdmin, companyAdmin or groupAdmin access level from login API.

Parameters

nametypedata typedescription
groupIdrequiredstringGroup ID
Get managers

Get a list of group managers.

const response = await geocore.Group.findManagers({
name: "name",
username: "username",
email: "email",
lastLoginRange: {
start: "2025-01-01",
end: "2025-01-01",
}
createdRange: {
start: "2025-01-01",
end: "2025-01-01",
}
updatedRange: {
start: "2025-01-01",
end: "2025-01-01",
}
page: 1,
limit: 10,
});

Prerequisites

Successfully get the IdToken with superAdmin access level from login API.

Parameters

nametypedata typedescription
usernameoptionalstringSearch by username
nameoptionalstringSearch by full name
emailoptionalstringSearch by email
lastLoginRange[start]optionaldateSearch by lastLoginTime timestamp
lastLoginRange[end]optionaldateSearch by lastLoginTime timestamp
createdRange[start]optionaldateSearch by createdAt timestamp
createdRange[end]optionaldateSearch by createdAt timestamp
updatedRange[start]optionaldateSearch by modifiedAt timestamp
updatedRange[end]optionaldateSearch by modifiedAt timestamp
pageoptionalnumberPage ordinal number
limitoptionalnumberNumber of records per page
Create group

Create a new group.

const response = await geocore.Group.createGroup({
name: "string",
description: "string",
userIds: ["string"],
managerIds: ["string"],
parent: "string"
});

Prerequisites

Successfully get the IdToken with superAdmin or companyAdmin access level from login API.

Parameters

nametypedata typedescription
namerequiredstringGroup name
descriptionrequiredstringGroup description
userIdsrequiredarray<string>ID of group members
managerIdsrequiredarray<string>ID of group managers
parentrequiredstringID of parent group
Update group

Update a group.

const response = await geocore.Group.updateGroup(
groupId,
{
name: "string",
description: "string",
aiIntegration: "OpenAI" | "SageMaker",
}
);

Prerequisites

Successfully get the IdToken with superAdmin or companyAdmin access level from login API.

Parameters

nametypedata typedescription
groupIdrequiredstringGroup ID
namerequiredstringGroup name
descriptionrequiredstringGroup description
aiIntegrationrequiredstringAI integration option of company groups, not apply to subgroups
Delete group

Delete a group.

const response = await geocore.Group.deleteGroup(groupId);

Prerequisites

Successfully get the IdToken with superAdmin or companyAdmin access level from login API.

Parameters

nametypedata typedescription
groupIdrequiredstringGroup ID
Add users to a group

Add users to a group

const response = await geocore.Group.addUsers(
groupId,
{
userIds: ["string"],
}
);

Prerequisites

Successfully get the IdToken with superAdmin, companyAdmin or groupAdmin access level from login API.

Parameters

nametypedata typedescription
groupIdrequiredstringGroup ID
userIdsrequiredarray<string>ID of users
Remove users from a group

Remove users from a group

const response = await geocore.Group.removeUsers(
groupId,
{
userIds: ["string"],
}
);

Prerequisites

Successfully get the IdToken with superAdmin, companyAdmin or groupAdmin access level from login API.

Parameters

nametypedata typedescription
groupIdrequiredstringGroup ID
userIdsrequiredarray<string>ID of users
Add managers to a group

Add managers to a group

const response = await geocore.Group.addManagers(
groupId,
{
userIds: ["string"],
}
);

Prerequisites

Successfully get the IdToken with superAdmin or companyAdmin access level from login API.

Parameters

nametypedata typedescription
groupIdrequiredstringGroup ID
userIdsrequiredarray<string>ID of users
Remove managers from a group

Remove managers from a group

const response = await geocore.Group.removeManagers(
groupId,
{
userIds: ["string"],
}
);

Prerequisites

Successfully get the IdToken with superAdmin or companyAdmin access level from login API.

Parameters

nametypedata typedescription
groupIdrequiredstringGroup ID
userIdsrequiredarray<string>ID of users
Update group platform configuration

Update group platform configuration.

const response = await geocore.Group.updatePlatformConfig(
groupId,
{
platformId: "string",
enabled: true,
bandwidthLimit: 0,
storagePlan: 0
}
);

Prerequisites

Successfully get the IdToken with superAdmin access level from login API.

Parameters

nametypedata typedescription
groupIdrequiredstringGroup ID
platformIdrequiredstringPlatform ID
enabledrequiredbooleanEnable platform usage
bandwidthLimitrequirednumberBandwidth limit
storagePlanrequirednumberStorage plan
Add whitelist IP access

Add a new whitelist IP to a company group

const response = await geocore.Request.addWhitelistIpAddress(
groupId,
{
ipAddress: "1.2.3.4",
description: "string",
}
);

Prerequisites

Successfully get the IdToken with superAdmin access level from login API.

Parameters

nametypedata typedescription
groupIdrequiredstringGroup ID
ipAddressrequiredstringWhitelist IP address (v4)
descriptionrequiredstringIP address description
Remove whitelist IP access

Remove whitelist IP access from a company group

const response = await geocore.Group.removeWhitelistIpAddress(
groupId,
{
ipAddresses: ["1.2.3.4"],
}
);

Prerequisites

Successfully get the IdToken with or superAdmin access level from login API.

Parameters

nametypedata typedescription
groupIdrequiredstringGroup ID
ipAddressesrequiredarray<string>IP addresses to be removed