Resource Group Endpoints
Endpoints are under /v1/teams.
Base URL: https://api.gpcn.com/v1
The API uses teams in endpoint paths and field names (e.g., /teams, teamId, parentTeamId). In the GPCN™ platform, these correspond to resource groups.
See the API Reference → for examples in TypeScript, Python, Go, and C#.
List Resource Groups
GET /teams
Query Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
page |
integer | 1 |
Page number |
limit |
integer | 10 |
Items per page (max 100) |
sort |
string | name:asc |
Sort field and direction |
search |
string | — | Search by name |
filter[entityId] |
UUID | — | Filter by entity |
Response meta includes unassignedUsers and unassignedVMs counts.
Create Resource Group
POST /teams
Request Body
{ "name": "Engineering", "parentTeamId": 1 }
parentTeamId is optional. When provided, the resource group is created as a child of the specified group. This is an API-only capability — parent assignment is not available through the portal UI.
Response (201 Created)
{ "success": true, "data": { "teamId": 5 } }
Get Resource Group Details
GET /teams/{id}
Returns resource group info with paginated members list. Supports page, limit, sort, search for members.
Update Resource Group
PUT /teams/{id}
{ "name": "Platform Engineering", "parentTeamId": 2 }
Delete Resource Group
DELETE /teams/{id}
Response (204 No Content)
Add Member
POST /teams/{id}/members
{ "userId": "user-uuid" }
Remove Member
DELETE /teams/{id}/members/{userId}
Response (204 No Content)
Bulk Delete Resource Groups
POST /teams/bulk/delete
{ "ids": [1, 2, 3] }
1–50 IDs.
Bulk Add Members
POST /teams/bulk/add-members
{ "userIds": ["user-uuid-1", "user-uuid-2"], "teamIds": [1, 2, 3] }
Creates all user–resource group combinations.
Next Steps
- Manage Resource Groups in the Portal → — create and manage resource groups from the dashboard
- User Endpoints → — manage users and role assignments via API
- Authentication → — API keys and permission scoping
.png)