Forwarding groups
Groups that organize forwarding rules for bulk management. Group names are unique per tenant, and a group that still has rules cannot be deleted.
stream-groupsTCP/UDP forwardingAuthentication: User (some parameters admin only)5 endpointsList forwarding groups
GET
/api/v2/stream-groupsAuthentication: User (some parameters admin only)
Query parameters
| Field | Type | Required | Description |
|---|---|---|---|
| page | integer | — | Page number, starting from 1 |
| page_size | integer | — | Items per page |
| sort | string | — | Sort fields, comma-separated; prefix `-` for descending, e.g. `-created_at,id` |
| tenant_id | integer | — | Admin only: filter by tenant. Ignored for tenant credentials, which only see their own tenant's data |
Create forwarding group
POST
/api/v2/stream-groupsAuthentication: User (some parameters admin only)
Query parameters
| Field | Type | Required | Description |
|---|---|---|---|
| tenant_id | integer | — | Owner tenant when an admin creates on behalf of a tenant (required); ignored for tenant callers, where the owner is always the caller. |
Request body application/json
| Field | Type | Required | Description |
|---|---|---|---|
| des | string | — | Description |
| name | string | Required | Name |
Get forwarding group
GET
/api/v2/stream-groups/{id}Authentication: User (some parameters admin only)
Update forwarding group
PUT
/api/v2/stream-groups/{id}Authentication: User (some parameters admin only)
Request body application/json
| Field | Type | Required | Description |
|---|---|---|---|
| des | string | — | Description |
| name | string | Required | Name |
Delete forwarding group
DELETE
/api/v2/stream-groups/{id}Authentication: User (some parameters admin only)
Forwarding groups object
| Field | Type | Required | Description |
|---|---|---|---|
| created_at | string | — | Created at |
| des | string | — | Description |
| id | integer | — | Record ID |
| name | string | — | Name |
| tenant_id | integer | — | Owner tenant (user) ID |
| updated_at | string | — | Updated at |