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