---
updatedAt: 2025-09-14T23:44:05.000Z
agentTools:
  siteIndex: https://developer.jamf.com/llms.txt
  projectIndex: https://developer.jamf.com/jamf-pro/v11.14.0/llms.txt
---

# Updates an existing computer group by name

One or more computers can be added by using "computer_additions" instead of "computers". One or more computers can be deleted by using "computer_deletions" instead of "computers"

## Sample Request Bodies

This endpoint supports additional XML request bodies that act similar to the HTTP PATCH method, allowing for the addition and deletion of individual devices from an existing static group. Notice that multiple device identifier types are listed for each device, however only one is required. Use of the `name` element is not recommended for identifying devices as there are no requirements for unique names and the API will perform the action on the first record it encounters a matching identify for.

```xml Static Group Addition
<computer_group>
  <computer_additions>
    <computer>
      <id>1</id>
      <name>string</name>
      <mac_address>string</mac_address>
      <alt_mac_address>string</alt_mac_address>
      <serial_number>string</serial_number>
    </computer>
    <computer>
      <id>2</id>
      <name>string2</name>
      <mac_address>string2</mac_address>
      <alt_mac_address>string2</alt_mac_address>
      <serial_number>string2</serial_number>
    </computer>
  </computer_additions>
</computer_group>
```
```xml Static Group Removal
<computer_group>
  <computer_deletions>
    <computer>
      <id>1</id>
      <name>string</name>
      <mac_address>string</mac_address>
      <alt_mac_address>string</alt_mac_address>
      <serial_number>string</serial_number>
    </computer>
    <computer>
      <id>2</id>
      <name>string2</name>
      <mac_address>string2</mac_address>
      <alt_mac_address>string2</alt_mac_address>
      <serial_number>string2</serial_number>
    </computer>
  </computer_deletions>
</computer_group>
```
```text Smart Group
<computer_group>
	<name>Group Name</name>
	<is_smart>true</is_smart>
	<site>
		<id>-1</id>
		<name>None</name>
	</site>
	<criteria>
		<criterion>
			<name>Last Inventory Update</name>
			<priority>0</priority>
			<and_or>and</and_or>
			<search_type>more than x days ago</search_type>
			<value>7</value>
			<opening_paren>false</opening_paren>
			<closing_paren>false</closing_paren>
		</criterion>
	</criteria>
</computer_group>
```

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "version": "11.12.0",
    "title": "Classic API",
    "license": {
      "name": "Jamf API License Agreement",
      "url": "https://developer.jamf.com/developer-guide/docs/api-license-agreement"
    }
  },
  "security": [
    {
      "basicAuth": []
    }
  ],
  "x-readme": {
    "samples-languages": [
      "curl",
      "swift",
      "ruby",
      "python"
    ],
    "explorer-enabled": false,
    "proxy-enabled": true
  },
  "paths": {
    "/computergroups/name/{name}": {
      "put": {
        "x-explorer-enabled": false,
        "tags": [
          "computergroups"
        ],
        "summary": "Updates an existing computer group by name",
        "description": "One or more computers can be added by using \"computer_additions\" instead of \"computers\". One or more computers can be deleted by using \"computer_deletions\" instead of \"computers\"",
        "operationId": "updateComputerGroupByName",
        "parameters": [
          {
            "description": "Name value to filter by",
            "in": "path",
            "name": "name",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "201": {
            "description": "Created"
          }
        }
      }
    }
  },
  "x-si-base": "swagger.yaml",
  "x-github-repo": "jamf/Classic-API-Swagger-Specification",
  "x-github-sha": "070fac498a589aaa0958641a68e4065584fc244a",
  "servers": [
    {
      "url": "https://yourServer.jamfcloud.com/JSSResource"
    }
  ],
  "components": {
    "securitySchemes": {
      "basicAuth": {
        "type": "http",
        "scheme": "basic"
      }
    }
  }
}
```