servers/groups_remove

Namespace Name Admin Only Log Summary Generates Event Version Added
servers groups_remove yes no no 1

Description

Simplification for removing existing servers from existing groups

NOTE: Administrator access only - all others will get a 403/Forbidden error

Input Arguments

  • Required:
    • “[server_id]” : String or array of strings for groups which need to be removed from this server
  • Optional:
    • none ({})

Request Example Arguments

ARGUMENTS ONLY: See the basics of API requests for additional formatting information.

{
  "server_id_1" : "previous_group_1",
  "server_id_2" : [ "previous_group_2", "previous_group_3" ]
}
  • Example Group Assignments (initial, before example request)

    "server_id_1" : [ "previous_group_1", "previous_group_2" ],
    "server_id_2" : [ "previous_group_1", "previous_group_2" ]
    

Reply Example

{
  "server_id_1" : [ "previous_group_2" ],
  "server_id_2" : [ "previous_group_1" ]
}

#

Events

Events from this change will be sent to all administrators and any user with read access to this server.

Example:

{
"namespace" : "event",
"name" : "servers/edit",
"id" : "",
"args" : {}
}

Log Summary

This API call does not generate a detailed log summary item

See Also