Uploading a File for File-based Search
This API helps you to upload a file with a list of values.
These values are uploaded to the internal cloud storage. You can use them in the search filters.
Request
POST https://{env}.reltio.com/reltio/api/{tenantID}/valueList| Parameters | Name | Required | Details | Type |
|---|---|---|---|---|
| Headers | Authorization | Yes | The Headers provides information about authentication
access token in the format of "Bearer accessToken".
For more information, see Authentication API. | String |
Content-Type | Yes | You must add the Content-Type as Content-Type:
multipart/form-data. | ||
| Form | file | Yes |
You must specify a TXT or CSV file as a Form parameter. Note: Limitation for supported file size is 10 MB or 5000 rows.
Before selecting a file, make sure that the number of rows in
the file does not exceed 5000. You can upload multiple files, but ensure the combined file size of all the files does not exceed 10 MB, and the total number of rows in all files does not exceed 5000.
| File |
Response
Check the fields and description that are listed in Table 2: Response.
| Field Name | Type | Description |
|---|---|---|
| path | String | The field represents the internal file path used in the search filter. |
| downloadLink | String | The field represents the Presigned URL for direct file access, valid for a limited time interval till the expiry date. |
| expirationDate | Date and time | The field represents the expiry date for the Presigned URL. |
Example
Request
POST {TenantURL}/valueList
Headers:Authorization:Bearer 204938ca-2cf7-44b0-b11a-1b4c59984512,
Content-Type:multipart/form-data
Form: file.txt
Response
{
"path": "s3://bucketName/envName/valueListFiles/01-Jan-2021/TenantID/data053231.txt",
"downloadLink": "https://bucketName.s3.amazonaws.com/envName/valueListFiles/01-Jan-2021/TenantID/data053231.txt?presignedURLInfo",
"expirationDate": "2021-01-01T12:32:33.608+0000"
}