---
title: "Create"
method: POST
path: "/workspaces/{wid}/runs/{rid}/record-groups"
tags: ["records"]
---

# Create

`POST /workspaces/{wid}/runs/{rid}/record-groups`

## Request

- Base URL: `https://app.linerecon.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.linerecon.com/workspaces/{wid}/runs/{rid}/record-groups`
- Auth: none declared

## Path parameters

- `wid` string, uuid, required
- `rid` string, uuid, required

## Request body

- GroupRequest
  - `request_id` string, uuid, required
  - `members` RecordRef[], required
    - `artifact_id` string, uuid, required
    - `record_id` string, required

## Response `200`

Successful Response

- RecordGroup
  - `id` string, uuid, required
  - `run_id` string, uuid, required
  - `document_id` string, uuid, required
  - `created_by` string, uuid, required
  - `created_at` string, date-time, required
  - `inputs_current` boolean, required
  - `scope` 'explicit_same_document_records'
  - `field_resolution` 'preserved_separate'
  - `member_refs` RecordRef[], required
    - `artifact_id` string, uuid, required
    - `record_id` string, required
  - `members` RecordItem[], required
    - `artifact_id` string, uuid, required
    - `document_id` string, uuid, required
    - `filename` string, required
    - `record` Record, required
      - `id` string, required
      - `scope` 'document' | 'record' | 'line_item'
      - `page_ids` string[], required
      - `cells` Cell[], required (unresolved $ref)
    - `pages` Page[], required
      - `id` string, required
      - `document_id` string, required
      - `generation` string, required
      - `page_number` integer, required
      - `render_hash` string, required
      - `width` integer, required
      - `height` integer, required
    - `locations` LocatedEvidence[], required
      - `record_id` string, required
      - `field_id` string, required
      - `evidence_index` integer, required
      - `location` Location, required
        - `page_id` string, required
        - `status` 'candidate' | 'page_only' | 'ambiguous', required
        - `box` Box, required
          - `x0` number, required
          - `y0` number, required
          - `x1` number, required
          - `y1` number, required
        - `method` string, required
        - `reason` string, nullable
        - `source_page` Page
          - `id` string, required
          - `document_id` string, required
          - `generation` string, required
          - `page_number` integer, required
          - `render_hash` string, required
          - `width` integer, required
          - `height` integer, required
        - `quote_sha256` string, nullable

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `413`: Content Too Large
- `422`: Unprocessable Content
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/linerecon/apis/linerecon-api.md) · [All operations](https://skmtc.dev/linerecon/apis/linerecon-api/llms.txt) · [OpenAPI document](https://skmtc.dev/linerecon/apis/linerecon-api/revisions/0650f53a4249?raw)