Upload

List

1
{
2
"kind": "upload",
3
"uri": string,
4
"url": string,
5
"id": integer,
6
"name": string,
7
"status": string("queued","running","completed","failed"),
8
"hash": string,
9
"size": integer,
10
"numRows": integer,
11
"numBytes": integer,
12
}
Copied!

Get

In addition to the base definition, any upload resource returned by a get request will contain the following properties:
1
{
2
"type": string("delimited", "stream", "avro", "ndjson", "parquet", "orc", "xls", "xlsx", "dta", "sas7bdat", "sav"),
3
"hasHeaderRow": bool,
4
"delimiter": string,
5
"quoteCharacter": string,
6
"skipBadRecords": bool,
7
"badRecordsCount": integer,
8
"hasQuotedNewlines": bool,
9
"errorMessage": string
10
}
Copied!

Documentation

field
List
kind
string
The resource type. Will always be "variable".
uri
string
The fully qualified reference to this upload, for use in generating calls to this API.
For example, /tables/imathews.example:123.test:456/uploads/789
url
string
The qualified URL to the upload
id
integer
The unique identifier for the upload
name
string
The name of the file. Defaults to untitled_upload.{type}
status
string
The current import status of the upload. Will be one of "queued", "running", "completed", "failed"
hash
string
The md5 hash of the upload's file content.
size
integer
The size, in bytes, of the uploaded file..
numRows
integer
The number of rows in the uploaded content
numBytes
integer
The number of bytes stored in Redivis's tabular representation of the upload. This will likely be different than size, which reflects the number of bytes in the file that was uploaded.
Get
type
string
The type of file being uploaded. Must be on of: csv | avro | ndjson | parquet | orc | xls | xlsx, dta | sas7bdat | sav | stream
hasHeaderRow
boolean
Whether the first row contains a list of variable names. Defaults to true. Only relevant for types csv,xls,xlsx
delimiter
string
The delimiter used to separate cells in file. Only relevant for type csv. If null (the default), the delimiter will be auto-computed based on an analysis of a preview of the file.
quoteCharacter
string
The quote sequence used to escape cells in a csv , not relevant for other types. Defaults to ". In order to escape a quote character, it must be doubled — e.g.:
"She said, ""Hello"""
skipBadRecords
boolean
Defaults to false. If true, upload will succeed even if some records cannot be parsed.
hasQuotedNewlines
boolean
Whether newline characters exist in cells. Only relevant for types csv | ndjson | xls | xlsx | dta | sas7bdat | sav.
errorMessage
string
If status == "failed", will provide additional information about what cause the upload failure.
Copy link