Skip to main content
POST
/
v1
/
accounts
/
{account_id}
/
datasets
Create Dataset
curl --request POST \
  --url https://api.fireworks.ai/v1/accounts/{account_id}/datasets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "dataset": {
    "displayName": "<string>",
    "exampleCount": "<string>",
    "userUploaded": {},
    "evalProtocol": {},
    "externalUrl": "<string>",
    "format": "FORMAT_UNSPECIFIED",
    "sourceJobName": "<string>"
  },
  "datasetId": "<string>",
  "sourceDatasetId": "<string>",
  "filter": "<string>"
}
'
{
  "name": "<string>",
  "displayName": "<string>",
  "createTime": "2023-11-07T05:31:56Z",
  "state": "STATE_UNSPECIFIED",
  "status": {
    "code": "OK",
    "message": "<string>"
  },
  "exampleCount": "<string>",
  "userUploaded": {},
  "evaluationResult": {
    "evaluationJobId": "<string>"
  },
  "transformed": {
    "sourceDatasetId": "<string>",
    "filter": "<string>",
    "originalFormat": "FORMAT_UNSPECIFIED"
  },
  "splitted": {
    "sourceDatasetId": "<string>"
  },
  "evalProtocol": {},
  "externalUrl": "<string>",
  "format": "FORMAT_UNSPECIFIED",
  "createdBy": "<string>",
  "updateTime": "2023-11-07T05:31:56Z",
  "sourceJobName": "<string>",
  "estimatedTokenCount": "<string>",
  "averageTurnCount": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.fireworks.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication using your Fireworks API key. Format: Bearer <API_KEY>

Path Parameters

​
account_id
string
required

The Account Id

Body

application/json
​
dataset
object
required
​
datasetId
string
required
​
sourceDatasetId
string
​
filter
string

Response

200 - application/json

A successful response.

​
name
string
read-only
​
displayName
string
​
createTime
string<date-time>
read-only
​
state
enum<string>
default:STATE_UNSPECIFIED
read-only
Available options:
STATE_UNSPECIFIED,
UPLOADING,
READY
​
status
Mimics [https://github.com/googleapis/googleapis/blob/master/google/rpc/status.proto] · object
read-only
​
exampleCount
string<int64>
​
userUploaded
object
​
evaluationResult
object
​
transformed
object
​
splitted
object
​
evalProtocol
object
​
externalUrl
string
​
format
enum<string>
default:FORMAT_UNSPECIFIED
Available options:
FORMAT_UNSPECIFIED,
CHAT,
COMPLETION,
RL
​
createdBy
string
read-only

The email address of the user who initiated this fine-tuning job.

​
updateTime
string<date-time>
read-only

The update time for the dataset.

​
sourceJobName
string

The resource name of the job that created this dataset (e.g., batch inference job). Used for lineage tracking to understand dataset provenance.

​
estimatedTokenCount
string<int64>
read-only

The estimated number of tokens in the dataset.

​
averageTurnCount
number<float>
read-only

An estimate of the average number of turns per sample in the dataset.