POST
/
v2
/
team
/
file
/
init-multipart-upload
curl --request POST \
  --url https://ai.data.cloud/api/v2/team/file/init-multipart-upload \
  --header 'Content-Type: application/json' \
  --header 'x-pd-api-key: <api-key>' \
  --data '{
  "user_id": "tmm-cm8gt41kuxxxx1l1d1n2wz8v",
  "file_name": "sales_data.csv",
  "file_size": 1024
}'
{
  "code": 0,
  "data": {
    "upload_id": "5k3EJxAYgtHW1fkbF54ppKEiTWSBeFBQ_01DnFEDSSHChV7w1jpw7SM_KWLkHYXm6Wzaw_NOpMG_OFsi9D5R8Csx9xxxx_m.YuWNjbTMWYIwVKG5rw0VXJZzgWbwSfe",
    "file_object_key": "temp/user/tmm-cm8gt41kuxxxx1l1d1n2wz8v/26f6272c-a847-4589-b352-a85471bb5121.csv",
    "part_items": [
      {
        "number": 1,
        "size": 1024,
        "upload_url": "https://s3.amazonaws.com/powerdrilltest/temp/user/tmm-cm8gt41kuxxxx1l1d1n2wz8v/26f6272c-a847-4589-b352-a85471bb5121.csv?uploadId=5k3EJxAYgtHW1fkbF54ppKEiTWxxxxxx_01DnFEDSSHChV7w1jpw7SM_KWLkHYXm6Wzaw_NOpMG_OFsi9D5R8Csx9DUHbQ_m.YuWNjbTMWYIwVKG5rw0VXJZzgWbwSfe&partNumber=1&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20250402T085840Z&X-Amz-SignedHeaders=host&X-Amz-Expires=86399&X-Amz-Credential=AKIARLSQLXURHEIDN4OZ%2F20250402%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Signature=b7be59679910fabd6603af6b7eb003094498ec7d6ceb47af93253540e734dba3"
      }
    ]
  }
}

Authorizations

x-pd-api-key
string
header
required

Headers

Content-Type
string
x-pd-external-trace-id
string

The trace ID you set in your system to trace this request. It can be up to 128 characters in length. If the request fails, you can provide it to the Powerdrill team to help with troubleshooting.

Body

application/json
file_name
string
required

The complete name of the file, including its extension, for example sales_data.csv.​

file_size
integer
required

The size of the file, in the units of bytes.

user_id
string
required

Your user ID, which uniquely identifies you within your team. To obtain your ID:

Response

200 - application/json
code
integer
required

Status code. 0 indicates that the operation is successful. Otherwise, the operation fails. For error troubleshooting, refer to Error Codes.

data
object
required