Skip to main content
POST
Create token group

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

Idempotency-Key
string<uuid>
required

Client-generated unique key per operation intent (UUID). Same key + identical body replays the original response; same key + different body returns 409.

Body

application/json
name
string
required

Display name of the group

Required string length: 1 - 255
description
string

Free-text description of the group

Maximum string length: 1000
emsp_identity_id
string

The EMSP identity the group belongs to

Required string length: 1 - 64
network_ids
string<uuid>[]

Networks to assign to the group on creation

Maximum array length: 100

Response

The created group

group_id
string<uuid>
required

Stable token group id

tenant_id
string
required

Owning tenant, set by the platform

emsp_identity_id
string
required

The EMSP identity the group belongs to

Required string length: 1 - 64
name
string
required
Required string length: 1 - 255
token_count
integer
required

Number of member tokens

Required range: x >= 0
status_summary
object
required

Number of member tokens in each status. The counts add up to token_count

audit
object
required
description
string | null
Maximum string length: 1000
network_ids
string<uuid>[]

Networks assigned to the group. Managed through the network assignment operations