Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

Authorization: Bearer <your API key> -- the same key as inference. A key reaches the account it belongs to and no other.

Path Parameters

account
string
required

Your account id -- the one in the console's address bar (my-account for this key). It must be the account the key belongs to.

Maximum string length: 64

Query Parameters

datasetId
string

The id to give the dataset: lowercase letters, digits and hyphens, up to 64. It becomes part of the dataset's name and can never be changed or reused, even after the dataset is deleted. Leave it out to derive one from displayName.

Maximum string length: 64

Body

application/json
displayName
string
required

A human-readable name for the dataset, up to 128 characters.

Maximum string length: 128

Response

Created.

name
string
datasetId
string
displayName
string
source
enum<string>
Available options:
DATASET_SOURCE_UPLOAD,
DATASET_SOURCE_JOB_OUTPUT,
DATASET_SOURCE_SPLIT
sourceJob
string
parentVersion
string
state
enum<string>
Available options:
DATASET_STATE_CREATING,
DATASET_STATE_UPLOADING,
DATASET_STATE_VALIDATING,
DATASET_STATE_READY,
DATASET_STATE_FAILED,
DATASET_STATE_DELETED
latestVersionNo
integer
totalBytes
string<int64>
activeReferenceCount
integer
createdBy
string
createTime
string<date-time>
updateTime
string<date-time>
deleteTime
string<date-time>
versions
object[]
lineage
object