minimusdocs
Help center

Groups and permissions

Replace a group

PUT/auth/groups/{id}/

manage Delete and money: deletes, credits, servers or panel settings. Scopes

Change a group you manage. You can give only permissions you hold; trial and refund rules are changed by panel operators only.

Path parameters

  • idintegerrequired

Body

  • namestringrequired
  • permissionsinteger[]

    Permission ids. You can give only permissions you hold.

  • parentintegercan be null

    On create: the group it goes under, one of yours. Left out: your own group when you have one.

  • is_resellerboolean

    Its members are resellers who pay with credits.

  • can_customize_packagesboolean

    Members may build their own packages (only if you may).

  • can_customize_bouquetsboolean

    Members may build their own bouquets (only if you may).

  • trials_limitintegercan be null

    Trial lines each member may make per period; null: no limit, 0: none.

  • trials_periodstring
    • day - Per day
    • week - Per 7 days
    • month - Per 30 days

    One of: "day" "week" "month"

  • trials_min_balancestring (decimal)

    The balance a member needs to make a trial line.

  • refund_window_hoursinteger

    A line deleted within this many hours of its payment is refunded; 0: never.

Response

200 OK

  • idintegerrequiredread-only
  • namestringrequired
  • permissionsinteger[]
  • permissions_displaystring[]requiredread-only
  • permissions_countintegerrequiredread-only

    Get count of permissions in this group

  • usersobject[]requiredread-only
    • idstring (uuid)requiredread-only
    • usernamestringrequiredread-only
    • emailstring (email)requiredread-onlycan be null
    • first_namestringrequiredread-only
    • last_namestringrequiredread-only
    • is_staffbooleanrequiredread-only

      Designates whether the user can log into this admin site.

    • is_activebooleanrequiredread-only
    • groupsinteger[]requiredread-only
  • users_countintegerrequiredread-only

    Get count of users in this group

  • parentintegerrequiredread-onlycan be null
  • parent_namestringrequiredread-onlycan be null
  • created_by_usernamestringrequiredread-onlycan be null
  • created_atstring (date-time)requiredread-only
  • is_resellerbooleanrequiredread-only
  • can_customize_packagesbooleanrequiredread-only
  • can_customize_bouquetsbooleanrequiredread-only
  • trials_limitintegerrequiredread-only
  • trials_periodstringrequiredread-only

    Default: "day"

  • trials_min_balancestring (decimal)requiredread-only
  • refund_window_hoursintegerrequiredread-only

    Default: 0

Errors

  • 400 Something sent is not valid. Each field that is wrong is named with what is wrong.
  • 401 No credential, or one that is wrong, expired or revoked.
  • 403 The account, or the key's or app's scopes, may not do this.
  • 404 Nothing with this id, or nothing the account can see.
  • 429 Slow down: wait the seconds in the Retry-After header, then try again.

What each error means