Skip to main content
POST
/
uploads
/
{upload_path}
Upload a file
curl --request POST \
  --url https://api-dev.narrative.io/uploads/{upload_path} \
  --header 'Authorization: Bearer <token>'
{
  "path": "/lists/idlist.csv",
  "url": "https://narrative-file-upload-dev.s3.amazonaws.com/companyId%3D1/my-list.csv?X-Amz-Security-Token=IQoJb3JpZ2luX2VjEOf%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaCXVzLWVhc3QtMSJGMEQCIB9EYPohJtbK0vb0LUjfcDrYqZ2tiAHfXb5xMcsRFFL7AiAlwUx2GBk3OOUTGWm6ZXZyOdpqugz77%2BT3JhoX3qY3HCrbAQjA%2F%2F%2F%2F%2F%2F%2F%2F%2F%2F8BEAIaDDcwNDM0OTMzNTcxNiIM5AqrwaG45z1X6auTKq8BlknYqJBV04Ss%2BsI61g1OlKX0VuAMIvcmDdUcvz5RyjAwuzxqUDy4f84GOFoqkkyjpWTTdvgfrXDmXVTHkskocn0HqYeUpaWTfI72HySnKPx%2B%2FPoINQG%2FgbD%2Bl2Ds%2FspvpAsDs6fFa9NjLHIcntjrxQ62zr1%2Bb0eAfEAcyTxXhHzAna1%2B5GZ8lxcQlFTdFwTg2iDhXbDJ3lM04ws%2BuLqSGpRnkdP0p3iz9cDbscfH0DDb0quABjrhAQFZ90e7%2FxqPpIPD2j7ai8VRvwn3F8l7VOlSmDvnmjcGiMYZiAvbrHFcRVJa5YMdvGlFSCjCAeGIe7G47R%2Ftpqk27ckcYLfJCEsb38I%2F7TA6bq39S4oKQfaO%2FHubPcHaOZgatrS%2BhH4%2BzjJT87nY06SWJiV8sfZR3Vmqrfg9%2F9gjshRkTHwsGGhhyYYpQ6LdzO00nMXzusaPKWucZ7rBN5hWG2PgtNWObkCwq1OCANmGQYHJyi%2FOZDr2Gr1sRCU%2FUm%2FsmTYpGVPjDJgz3tibv8iPiXa%2FrZpd4hbT%2BocYwFdDYQ%3D%3D&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20210122T151716Z&X-Amz-SignedHeaders=host&X-Amz-Expires=1799&X-Amz-Credential=ASIA2H7T56CSK7QLIP6S%2F20210122%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Signature=3c1e45b6d8827b7158a6157dbc548fdf263c2f23f731117056058f489b26c64b",
  "expiry": "2021-01-22T15:47:16.036Z"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
upload_path
string
required

A slash-separated path where the uploaded file should be stored

Response

200 - application/json

The upload url

​
path
string

The path where the file will be uploaded to

Example:

"/lists/idlist.csv"

​
url
string

The upload url to be called to actually do the file upload

Example:

"https://narrative-file-upload-dev.s3.amazonaws.com/companyId%3D1/my-list.csv?X-Amz-Security-Token=IQoJb3JpZ2luX2VjEOf%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaCXVzLWVhc3QtMSJGMEQCIB9EYPohJtbK0vb0LUjfcDrYqZ2tiAHfXb5xMcsRFFL7AiAlwUx2GBk3OOUTGWm6ZXZyOdpqugz77%2BT3JhoX3qY3HCrbAQjA%2F%2F%2F%2F%2F%2F%2F%2F%2F%2F8BEAIaDDcwNDM0OTMzNTcxNiIM5AqrwaG45z1X6auTKq8BlknYqJBV04Ss%2BsI61g1OlKX0VuAMIvcmDdUcvz5RyjAwuzxqUDy4f84GOFoqkkyjpWTTdvgfrXDmXVTHkskocn0HqYeUpaWTfI72HySnKPx%2B%2FPoINQG%2FgbD%2Bl2Ds%2FspvpAsDs6fFa9NjLHIcntjrxQ62zr1%2Bb0eAfEAcyTxXhHzAna1%2B5GZ8lxcQlFTdFwTg2iDhXbDJ3lM04ws%2BuLqSGpRnkdP0p3iz9cDbscfH0DDb0quABjrhAQFZ90e7%2FxqPpIPD2j7ai8VRvwn3F8l7VOlSmDvnmjcGiMYZiAvbrHFcRVJa5YMdvGlFSCjCAeGIe7G47R%2Ftpqk27ckcYLfJCEsb38I%2F7TA6bq39S4oKQfaO%2FHubPcHaOZgatrS%2BhH4%2BzjJT87nY06SWJiV8sfZR3Vmqrfg9%2F9gjshRkTHwsGGhhyYYpQ6LdzO00nMXzusaPKWucZ7rBN5hWG2PgtNWObkCwq1OCANmGQYHJyi%2FOZDr2Gr1sRCU%2FUm%2FsmTYpGVPjDJgz3tibv8iPiXa%2FrZpd4hbT%2BocYwFdDYQ%3D%3D&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20210122T151716Z&X-Amz-SignedHeaders=host&X-Amz-Expires=1799&X-Amz-Credential=ASIA2H7T56CSK7QLIP6S%2F20210122%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Signature=3c1e45b6d8827b7158a6157dbc548fdf263c2f23f731117056058f489b26c64b"

​
expiry
string

The expiry time after which the upload won't be accepted

Example:

"2021-01-22T15:47:16.036Z"