Initate an import of a tabular file into the platform
imports_post_files(schema, name, remote_host_id, credential_id, max_errors = NULL, existing_table_rows = NULL, diststyle = NULL, distkey = NULL, sortkey1 = NULL, sortkey2 = NULL, column_delimiter = NULL, first_row_is_header = NULL, multipart = NULL, escaped = NULL, hidden = NULL)
string required. The schema of the destination table.
string required. The name of the destination table.
integer required. The id of the destination database host.
integer required. The id of the credentials to be used when performing the database import.
integer optional. The maximum number of rows with errors to remove from the import before failing.
string optional. The behaviour if a table with the requested name already exists. One of "fail", "truncate", "append", or "drop".Defaults to "fail".
string optional. The diststyle to use for the table. One of "even", "all", or "key".
string optional. The column to use as the distkey for the table.
string optional. The column to use as the sort key for the table.
string optional. The second column in a compound sortkey for the table.
string optional. The column delimiter of the file. If column_delimiter is null or omitted, it will be auto-detected. Valid arguments are "comma", "tab", and "pipe".
boolean optional. A boolean value indicating whether or not the first row is a header row. If first_row_is_header is null or omitted, it will be auto-detected.
boolean optional. If true, the upload URI will require a `multipart/form-data` POST request. Defaults to false.
boolean optional. If true, escape quotes with a backslash; otherwise, escape quotes by double-quoting. Defaults to false.
boolean optional. The hidden status of the item.
A list containing the following elements:
integer, The id of the import.
string, The URI which may be used to upload a tabular file for import. You must use this URI to upload the file you wish imported and then inform the Civis API when your upload is complete using the URI given by the runUri field of this response.
string, The URI to POST to once the file upload is complete. After uploading the file using the URI given in the uploadUri attribute of the response, POST to this URI to initiate the import of your uploaded file into the platform.
list, If multipart was set to true, these fields should be included in the multipart upload.