RIriveterhq
Dataset CRUD

set input values

Changed on

Set a row's input values and / or cells by hand. Nothing runs. A cell set this way is manual: fills skip it unless force. null clears a value. input is refused with 409 row_in_use while a fill is on the row; cells land during a fill, and a cell set by hand while its row runs stands over the run's answer for it.

patch/datasets/{id}/rows/{row_id}

Request

  • Base URL
    https://api.riveterhq.com/v1
  • Auth
    HTTP bearer

Path parameters

idstring required

The dataset id (ds_...)

row_idstring required

The row id (row_...) or its position (an integer from 1)

Request body

inputobject

Input column name → value, or null to clear

cellsobject

Output column name → value, or null to clear

Response

The row after the write

idstring

row_...

positioninteger

Insertion order, from 1 (the row number a user sees); stable, and the paging cursor

inputobject

Input values by column name

cellsobject

Cells by output column name (every output column is present; in a run's output.rows, only the columns the fill covered)

creditsnumber

Credits fills have charged for this row so far (each row run counted once)

not_found_reasonstring nullable

The agent's one sentence on what it could not find on this row and why, from its last successful run; null when it found every column or has not run

created_atstring date-time
updated_atstring date-time

Example response

{
  "id": "row_018f6a70-aaaa-7abc-89ab-0123456789ab",
  "position": 1,
  "input": {
    "Company": "Apple",
    "Website": "apple.com"
  },
  "cells": {
    "CEO": {
      "value": "Tim Cook",
      "state": "ok",
      "sources": [
        "https://www.apple.com/leadership/"
      ]
    },
    "HQ city": {
      "value": null,
      "state": "pending"
    }
  },
  "credits": 1.2,
  "not_found_reason": null,
  "created_at": "2026-10-01T12:00:00Z",
  "updated_at": "2026-10-01T12:07:00Z"
}

Changes

  • fac56b649559Revision changes
    • info

      api tag Dataset CRUD added

    • info

      api tag Datasets removed

  • dcb4d45ade1aRevision changes
    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status

    • info

      added the optional property /////// to the response with the status