---
title: "Add metadata to doc group"
method: PUT
path: "/v2/document-groups/{document_group_id}/metadata"
---

# Add metadata to doc group

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

## Request

- Base URL: `https://api.signnow.com`
- URL: `https://api.signnow.com/v2/document-groups/{document_group_id}/metadata`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/signnow/apis/signnow-api/docs/v2/document-groups/:document_group_id/metadata/put.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint allows users to add metadata to the selected document group. All added metadata will be linked to the document group during the [invite to sign](/docs/doc-group-field-invite/operations/invite-to-sign-document-group). Also, if you'd like to use this metadata in any event subscription, you can add upon [creating a webhook](/docs/basic-auth/operations/create-event-subscription).

## Request body

- object
  - `content` object: Array of the keys to be added to the metadata.
    - `key` string: Any type of metadata that should be added to the document group. For example,`signer_id`.
    - `key1` string: Any type of metadata that should be added to the document group. For example, `timestamp`.
    - `key2` string: Any type of metadata that should be added to the document group. For example, `document_group_owner_id`.

## Response `204`

Success, no content

- object

## Other responses

- `400`: Incorrect or missing token* request with invalid payload. * Request with empty payload. * Request with `content` which is not an array. * Request with `content` which is more than 20 elements. * Request with empty `content`. * Request with `key` which is not a string. * Request with `key` empty. * Request with `key` which is more than 100 chars. * Request with `key` with a special char. * Request with `key value` which is not a string. * Request with `key value` empty. * Request with `key value` which is more than 100 chars. * Request with `key value` with a 4-byte symbol.
- `403`: * Request with `group_id` in trash. * Request with `group_id` archieved. * Request with bearer token from another user.
- `404`: * Request with `group_id` which does not exist. * Request with `group_id` which is a template.

---

[API](https://skmtc.dev/signnow/apis/signnow-api.md) - [All operations](https://skmtc.dev/signnow/apis/signnow-api/llms.txt) - [OpenAPI document](https://skmtc.dev/signnow/apis/signnow-api/revisions/1c9c30a6142b?raw)