Skip to main content
POST
/
v1
/
team
/
datasources
Create data source without specifying a dataset
curl --request POST \
  --url https://ai.data.cloud/api/v1/team/datasources \
  --header 'Content-Type: application/json' \
  --header 'x-pd-api-key: <api-key>' \
  --data '
{
  "name": "test.csv",
  "fileName": "test.csv",
  "type": "FILE",
  "url": "https://s3.amazonaws.com/powerdrilltest/user/clvl4cad2001q01l1m522hxlu/upload/f9773f1e-cd68-489a-8121-d566ca9218b1.csv?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20240924T143419Z&X-Amz-SignedHeaders=host&X-Amz-Expires=599&X-Amz-Credential=AKIARLSQLXURHEIDN4OZ%2F20240924%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Signature=9ca0c58d508926a5811818041d557ffb53c64025dae94c0855280d457c7089a2",
  "fileKey": "/tmp/sdgsagdsgsadgasdg",
  "userId": "tmm-cm5m7khoz52zh07n4m7x1ut60"
}
'
{
  "code": 0,
  "data": {
    "id": "datasource-cadsgfsdagasgadsg",
    "datasetId": "dataset-dagasdgasgasg",
    "name": "test.csv",
    "fileName": "test.csv",
    "type": "FILE",
    "status": "pending"
  }
}

Authorizations

​
x-pd-api-key
string
header
required

Headers

​
x-pd-external-trace-id
string

The external trace ID. The length ranges from 0 to 128 characters.

Query Parameters

​
userId
string
required

Your user ID.

How to obtain your user ID: Sign in to Powerdrill Enterprise, click Users in the top navigation bar, and find your user ID in the list of users.

Body

application/json
​
name
string

The name of the data source. If not provided, it will default to the value of fileName.

​
fileName
string

The file name, preferably including the file extension.

​
type
string

The type of the data source. Set it to FILE.

​
url
string

The URL of the file for public access.

Only files with the following extensions are supported: .csv, .tsv, .md, .mdx, .json, .txt, .pdf, .pptx, .ppt, .doc, .docx, .xls, or .xlsx.

You must specify either url or fileKey, but not both.

​
fileKey
string

The object storage path to your locally uploaded file.

Only files with the following extensions are supported: .csv, .tsv, .md, .mdx, .json, .txt, .pdf, .pptx, .ppt, .doc, .docx, .xls, or .xlsx.

Each time you upload a file through the Upload file endpoint, its fileKey is returned. For more details, see How to Upload Local Files.

You must specify either url or fileKey, but not both.

​
userId
string

Your user ID.

How to obtain your user ID: Sign in to Powerdrill Enterprise, click Users in the top navigation bar, and find your user ID in the list of users.

Response

200 - application/json
​
code
integer
required

Status code. 0 indicates that the operation is successful. Otherwise, the operation fails. Possible error codes include:

  • 100: Bad request.
  • 201: Request frequency limit.
  • 9999: Internal error.
  • 100001: Invalid operation.
​
data
object
required

The returned data object.