---
title: "Rename document group"
url: "https://docs.signnow.com/docs/document-group/operations/put-document-group-v2"
type: "endpoint"
section: "document-group"
slug: "document-group/operations/put-document-group-v2"
method: "PUT"
path: "/v2/document-groups/{document_group_id}"
operation_id: "put-document-group-v2"
authorization: "bearer"
---

# Rename document group

`PUT /v2/document-groups/{document_group_id}`

This endpoint allows API users to rename a document group.

## Authorization

bearer

## Path Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `document_group_id` | string | Yes | The ID of a Document Group |

## Request Body

**Schema**

```json
{
  "type": "object",
  "required": [
    "group_name"
  ],
  "properties": {
    "group_name": {
      "type": "string",
      "description": "New name of the document group. Max: `255` characters."
    }
  }
}
```

**Example** (`Rename document group`)

```json
{
  "group_name": "Contract package"
}
```

## Responses

### 204

The document group has been renamed. No content returned.

### 400

* Wrong, expired, or missing token.
* `group_name` is missing or empty.
* `group_name` isn't a string.
* `group_name` is longer than `255` characters.

**Example** (`Wrong token`)

```json
{
  "code": 1537,
  "error": "invalid_token"
}
```

**Example** (`Name too long`)

```json
{
  "errors": [
    {
      "code": 13020013,
      "message": "The document_group_name must not exceed 255 chars"
    }
  ]
}
```

**Example** (`Missing group_name`)

```json
{
  "errors": [
    {
      "code": 13009015,
      "message": "The `group_name` field is required."
    }
  ]
}
```

**Example** (`group_name not a string`)

```json
{
  "errors": [
    {
      "code": 13009013,
      "message": "The `group_name` field must be a string."
    }
  ]
}
```

### 403

The document group belongs to another user.

**Example** (`Access denied`)

```json
{
  "errors": [
    {
      "code": 13009016,
      "message": "Access to DocumentGroup is denied"
    }
  ]
}
```

### 404

The document group doesn't exist.

**Example** (`Document group not found`)

```json
{
  "errors": [
    {
      "message": "Document group `0d4ad4b1d6a64bf6a8e8b7f0e2f5b5ac0c1f9e3d` not found"
    }
  ]
}
```

## Code Examples

> Replace `$SIGNNOW_ACCESS_TOKEN` and any `{placeholder}` values before running.

### cURL

```bash
curl -X PUT \
  "https://api.signnow.com/v2/document-groups/{document_group_id}" \
  -H "Authorization: Bearer $SIGNNOW_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"group_name": "Contract package"}'
```

---
*Full reference: https://docs.signnow.com/docs/document-group/operations/put-document-group-v2*