Version 2.1.1792967583 · latest Download OpenAPI Markdown

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 endpoints

List forwarding groups

GET/api/v2/stream-groups
Authentication: User (some parameters admin only)

Query parameters

FieldTypeRequiredDescription
pageinteger— Page number, starting from 1
Default 1
page_sizeinteger— Items per page
Default 20
sortstring— Sort fields, comma-separated; prefix `-` for descending, e.g. `-created_at,id`
tenant_idinteger— Admin only: filter by tenant. Ignored for tenant credentials, which only see their own tenant's data

Create forwarding group

POST/api/v2/stream-groups
Authentication: User (some parameters admin only)

Query parameters

FieldTypeRequiredDescription
tenant_idinteger— 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

FieldTypeRequiredDescription
desstring— Description
namestringRequired 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

FieldTypeRequiredDescription
desstring— Description
namestringRequired Name

Delete forwarding group

DELETE/api/v2/stream-groups/{id}
Authentication: User (some parameters admin only)

Forwarding groups object

FieldTypeRequiredDescription
created_atstring— Created at
read-only
desstring— Description
idinteger— Record ID
read-only
namestring— Name
tenant_idinteger— Owner tenant (user) ID
read-only
updated_atstring— Updated at
read-only