Roles List
GET
https://backend.networked.co/api/v1/global/tags/community
🏷️ Get Community Tags
HTTP Method
GETEndpoint
/api/v1/global/tags/communityHeaders
| Name | Type | Required | Description |
|---|---|---|---|
| x-api-key | String | ✅ Yes | A confidential API key provided by the Networked Team for authenticated use. |
Sample Response
{
"data": [
{
"tagId": "67959032****ea0012fdc676",
"name": "Moderator",
"description": "",
"type": 1
},
{
"tagId": "67959032****0012fdc677",
"name": "Contributor",
"description": "",
"type": 2
},
{
"tagId": "67959032bc****0012fdc675",
"name": "Admin",
"description": "",
"type": 0
},
{
"tagId": "67959032bc6bea****fdc678",
"name": "Viewer",
"description": "",
"type": 3
}
],
"error": false,
"message": "Success"
}
Response Interface
interface GetCommunityTagsResponse {
data: Tag[];
error: boolean;
message: string;
}
interface Tag {
tagId: string;
name: string;
description: string;
type: number;
}
Response Field Descriptions
| Field | Type | Description |
|---|---|---|
| data | Array | List of tag objects configured globally for community roles. |
| error | Boolean | Indicates whether the request resulted in an error. |
| message | String | Human-readable message about the result. |
Tag Object
| Field | Type | Description |
|---|---|---|
| tagId | String | Unique identifier for the tag. |
| name | String | Display name of the tag. |
| description | String | Description for the tag (can be empty). |
| type | Number | Numeric value representing the role type. |
Type Mapping (see Role Types)
| Type | Role Name |
|---|---|
| 0 | Admin |
| 1 | Moderator |
| 2 | Member (communities may rename it, e.g. Customer) |
| 3 | Viewer (communities may rename it, e.g. Donor, Student) |
| 20 | Custom role created by the community |
Reference
Notes
Request
Header Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://backend.networked.co/api/v1/global/tags/community' \
--header 'x-api-key: <your-api-key>'Response Response Example
{
"data": [
{
"tagId": "67959032bc6bea0012fdc675",
"name": "Admin",
"description": "",
"type": 0
},
{
"tagId": "67959032bc6bea0012fdc676",
"name": "Moderator",
"description": "",
"type": 1
},
{
"tagId": "67959032bc6bea0012fdc677",
"name": "Contributor",
"description": "",
"type": 2
},
{
"tagId": "67959032bc6bea0012fdc678",
"name": "Viewer",
"description": "",
"type": 3
},
{
"tagId": "68739cdd8bf6c100121117f2",
"name": "Architect ",
"description": "",
"type": 1
}
],
"error": false,
"message": "Operation completed successfully"
}Modified at 2026-10-23 11:10:26