curl --request POST \
--url https://api.harvey.ai/api/v1/vault/add_row/{review_table_id} \
--header 'Content-Type: application/json' \
--data '
{
"file_ids": [
"0199c5c1-50d9-7d60-93aa-cd65c3b7d5a9"
]
}
'{
"response": {
"event_id": 2365724,
"file_ids": [
"0199c5c1-50d9-7d60-93aa-cd65c3b7d5a9"
],
"review_event_run_id": "019f8d8f-fc20-79e0-8b78-980b747c5ef3",
"review_file_group_id": null,
"status": "scheduled"
}
}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.
curl --request POST \
--url https://api.harvey.ai/api/v1/vault/add_row/{review_table_id} \
--header 'Content-Type: application/json' \
--data '
{
"file_ids": [
"0199c5c1-50d9-7d60-93aa-cd65c3b7d5a9"
]
}
'{
"response": {
"event_id": 2365724,
"file_ids": [
"0199c5c1-50d9-7d60-93aa-cd65c3b7d5a9"
],
"review_event_run_id": "019f8d8f-fc20-79e0-8b78-980b747c5ef3",
"review_file_group_id": null,
"status": "scheduled"
}
}Permissions
RequiresVault API permission and permission to modify workspace projects.Path Parameters
The review table ID (integer). This is the same value as review_table_ids entries returned by Get Vault Project Metadata and as review_table_id returned by Get Review Table Metadata.
Body
The IDs of the files to add. One file is added as its own row; two or more are grouped into a file group that occupies a single row. Every file must belong to the review table's Vault project, must have finished processing, and must not already have a row or group membership in the table. Duplicate IDs are rejected with 400. Capped at 25 files per request by default; workspaces with a raised file-group limit may send more.
1 - 25 elementsOptional name for the file group created when two or more files are added. Defaults to the first file's name. Ignored for single-file requests.
Response
Review run scheduled successfully for the new rows
Show child attributes
Show child attributes