Add Row to Review Table

Adds one or more files to an existing review table as new rows and populates each new row’s cells for every existing visible column.

Send a single file ID in file_ids to add it as its own row. Send two or more file IDs to create a file group — the files are reviewed together and occupy a single row in the table. Pass the optional group_name to name that group; it defaults to the first file’s name.

Every file must belong to the same Vault project the review table was created from and must have finished processing. Use List Files in a Vault Project or Get File Details to check a file’s processing_status before adding it.

The run is asynchronous: a successful response means the request was accepted and the rows were scheduled for execution. Poll Get Review Table Row Details with the same review_table_id and one of the submitted file IDs until the row’s cells are returned. For a file group, requesting any member file returns the group’s single row.

A file that already has a row in the table, or that already belongs to a file group in it, is rejected with 409; the error message names the offending file ID. Adding a file whose row was previously deleted from the table restores that row rather than creating a duplicate.

The review_table_id path parameter is the review table’s integer ID — the same value as review_table_ids entries in Get Vault Project Metadata and as review_table_id in the Get Review Table Metadata response.