---
title: "Update Imported Row"
method: PATCH
path: "/v1/rows"
---

# Update Imported Row

`PATCH /v1/rows`

Partially update an imported row.

Requires the **Import** permission (`ingest` scope). The `fields` map follows
RFC 7396 merge-patch behavior: supplied keys replace values, omitted keys
remain unchanged, and `null` deletes a field. `null` values for top-level
fields are ignored.

## Query parameters

- `remoteId` string, required
- `sourceId` string, uuid, required

## Request body

- UpdateRowRequest — Partial update for a row, identified by ``source_id`` and ``remote_id``. All top-level fields are optional; only fields set to a non-None value in the request body are applied. Top-level fields (``name``, ``public``, ``owner_emails``, ``updated_at``) are NOT nullable: an explicit JSON ``null`` is treated as "field absent" and silently ignored by the service. This matches the convention used by ``UpdateDocumentRequest`` and prevents callers from accidentally clearing values they meant to leave unchanged. To unset a top-level field, callers should delete and re-ingest the row. The ``fields`` map (key-value row data) IS nullable per RFC 7396: keys present in the request overwrite existing values, keys absent are preserved, and an explicit ``None`` value deletes the key from the row's ``fields`` map. Unknown keys, type mismatches, and deleting a required field are rejected.
  - `version` integer
  - `name` string, nullable
  - `public` boolean, nullable
  - `ownerEmails` string[], nullable
  - `updatedAt` union
    - string
    - integer
    - number
  - `fields` object, nullable

## Response `200`

Successful Response

- RecordResponse
  - `status` 'created' | 'updated', required
  - `recordId` string, required
  - `id` string, required
  - `sourceId` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/sybill/apis/sybill-api.md) · [All operations](https://skmtc.net/sybill/apis/sybill-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sybill/sybill-api/revisions/f499ec011b17/schema)