---
updatedAt: 2026-09-17T08:02:12.000Z
agentTools:
  siteIndex: https://developer.n-able.com/llms.txt
  projectIndex: https://developer.n-able.com/takecontrol/llms.txt
---

# Edit device group

Edit device group

# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "title": "Swagger for Take Control RESTful APIs",
    "description": "This document provides a complete reference for all our available RESTful APIs, in the Swagger/OpenAPI 3 specification. You can test most API calls directly from this page. Please verify the correct API endpoint for your account in the product Admin Area, where you will also find our API Key Manager. Note that some APIs might not be enabled for your account.",
    "version": "1.3.02"
  },
  "servers": [
    {
      "url": "https://api.us0.swi-rc.com/rest/"
    },
    {
      "url": "https://api.us3.swi-rc.com/rest/"
    },
    {
      "url": "https://api.eu2.swi-rc.com/rest/"
    }
  ],
  "tags": [
    {
      "name": "Device",
      "description": "Listing, Creating, editing and deleting Device Groups, as well as creating Agent installers for specific Groups."
    }
  ],
  "paths": {
    "/device/group/{groupId}": {
      "put": {
        "tags": [
          "Device"
        ],
        "summary": "Edit device group",
        "description": "Edit device group",
        "operationId": "groupEdit",
        "parameters": [
          {
            "name": "INTEGRATION-KEY",
            "in": "header",
            "description": "Private integration key or User integration key",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "groupId",
            "in": "path",
            "description": "computer group ID",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "requestBody": {
          "description": "Edit device group",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EditDeviceGroup"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Successful operation",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ApiResponseDeviceGroupId"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request"
          },
          "403": {
            "description": "Invalid key"
          },
          "429": {
            "description": "Too many requests"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "EditDeviceGroup": {
        "required": [
          "parent_group_id",
          "group_name"
        ],
        "type": "object",
        "description": "either parent_group_id or group_name (or both) is needed; if parent_group_id is set, group will be moved to another group; if group_name is set, group name will be changed;",
        "properties": {
          "parent_group_id": {
            "type": "integer",
            "example": 0
          },
          "group_name": {
            "type": "string",
            "example": "My Main Group"
          }
        }
      },
      "ApiResponseDeviceGroupId": {
        "type": "object",
        "properties": {
          "result": {
            "type": "string",
            "example": "SUCCESS"
          },
          "details": {
            "type": "integer",
            "example": 12619,
            "description": "added group ID"
          },
          "errorDetails": {
            "type": "object",
            "properties": {
              "errorCode": {
                "type": "integer"
              },
              "errorMsg": {
                "type": "string"
              }
            }
          }
        }
      }
    }
  }
}
```