---
title: "Test Group Key"
method: POST
path: "/api/v1/file-folders/{folder_id}/group-key:test"
tags: ["file-folders"]
---

# Test Group Key

`POST /api/v1/file-folders/{folder_id}/group-key:test`

Dry-run a candidate ``batch_key_pattern`` regex against the folder's
already-committed filenames, without persisting anything. Lets the admin
preview capture groups while still authoring the ``full_delivery`` config
(before saving it via the folder PATCH ``batch_key_pattern`` field).
Read-only — VIEWER, like the other GET inspection routes on this resource.

## Path parameters

- `folder_id` string, uuid, required

## Request body

- GroupKeyTestRequest — POST /file-folders/{id}/group-key:test payload — a candidate ``batch_key_pattern`` regex to dry-run (not yet saved).
  - `pattern` string, required

## Response `200`

Successful Response

- object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/netter/apis/dmi-backend.md) · [All operations](https://skmtc.net/netter/apis/dmi-backend/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/netter/dmi-backend/versions/a59877bf911b/schema)