API ReferenceAI Task Builder

Get Dataset Upload URL

View as MarkdownOpen in ClaudeOpen in ChatGPT
This endpoint generates a presigned URL that allows you to upload a file directly to S3. After receiving the presigned URL, you should make a PUT request to the returned URL with your file data. **Upload Process:** 1. Call this endpoint to get a presigned URL for your file 2. Use the returned URL to upload your file directly to S3 via a PUT request 3. Monitor the dataset status to know when processing is complete

Authentication

Authorizationstring
The Prolific API uses API token to authenticate requests. You can create an API token directly from your settings. Your API token does not have an expiry date and carries full permission, so be sure to keep them secure. If your token is leaked, delete it and create a new one directly in the app. In your requests add `Authorization` header with the value `Token <your token>`.

Path parameters

dataset_idstringRequired
The ID of the dataset to upload files to
filenamestringRequired
The name of the file to upload

Response

Presigned URL generated successfully
dataset_idstring or nullformat: "uuid"
The ID of the dataset
expires_atdatetime or null
When the presigned URL expires
http_methodenum or null
HTTP method to use with the presigned URL
Allowed values:
upload_urlstring or null
The presigned URL to use for uploading the file

Errors