Skip to main content
POST
/
v1
/
operations
Run operation
curl --request POST \
  --url https://api.tokenfactory.nebius.com/v1/operations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "params": {
    "query": "SELECT * FROM {src_0} WHERE condition"
  },
  "src": [
    {
      "id": "<string>",
      "version": "0ed2d94b38fb40b9b61f6a",
      "mapping": {
        "messages": {
          "name": "chat_messages",
          "type": "column"
        },
        "type": "text_messages"
      }
    }
  ],
  "type": "yql",
  "dst": [
    {
      "id": "<string>",
      "version": "0ed2d94b38fb40b9b61f6a"
    }
  ],
  "ai_project_id": "example_project"
}
'
{
  "id": "<string>",
  "type": "yql",
  "params": {
    "query": "SELECT * FROM {src_0} WHERE condition"
  },
  "src": [
    {
      "id": "<string>",
      "version": "0ed2d94b38fb40b9b61f6a",
      "mapping": {
        "messages": {
          "name": "chat_messages",
          "type": "column"
        },
        "type": "text_messages"
      }
    }
  ],
  "dst": [
    {
      "id": "<string>",
      "version": "0ed2d94b38fb40b9b61f6a"
    }
  ],
  "status": "queued",
  "created_at": 123,
  "in_progress_at": 1614807352,
  "finished_at": 1614807352,
  "ai_project_id": "example_project"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
params
YQLParams · object
required

YQL query parameters.

Example:
{
  "query": "SELECT * FROM {src_0} WHERE condition"
}
​
src
OperationSrcDataset · object[]
required

List of source datasets for the operation.

Example:
{
  "id": "example_dataset",
  "version": "0ed2d94b38fb40b9b61f6a01b43d53de"
}
​
type
enum<string>
default:yql
Available options:
yql
Allowed value: "yql"
​
dst
OperationDstDataset · object[]

Optional destination datasets. If not provided, a temporary dataset will be created.

Example:
{
  "id": "example_dataset",
  "version": "0ed2d94b38fb40b9b61f6a01b43d53de"
}
​
ai_project_id
string | null

AI Studio project ID to associate with the dataset.

Example:

"example_project"

Response

Successful Response

​
id
string
required

Operation id

Example:

"3a3fd2317bbe4b3bb9842bc1b5275eb9"

​
type
enum<string>
required

Type of the operation.

Available options:
yql,
materialize_history,
batch_inference,
finetuning
Example:

"yql"

​
params
YQLParams · object
required

Parameters specific to the operation type.

Example:
{
  "query": "SELECT * FROM {src_0} WHERE condition"
}
​
src
(OperationSrcDataset · object | OperationSrcTrainDataset · object | OperationSrcValidationDataset · object)[]
required

List of source datasets for the operation.

Example:
{
  "id": "example_dataset",
  "version": "0ed2d94b38fb40b9b61f6a01b43d53de"
}
​
dst
OperationDstDataset · object[]
required

List of destination datasets for the operation.

Example:
{
  "id": "example_dataset",
  "version": "0ed2d94b38fb40b9b61f6a01b43d53de"
}
​
status
enum<string>
required

Current status of the operation.

Available options:
queued,
running,
succeeded,
failed,
cancelled,
unknown
Example:

"queued"

​
created_at
integer
required

The Unix timestamp (in seconds) for when the operation was created.

Example:

1614807352

​
in_progress_at
integer | null

The Unix timestamp (in seconds) for when the operation started processing.

Example:

1614807352

​
finished_at
integer | null

The Unix timestamp (in seconds) for when the operation was completed.

Example:

1614807352

​
ai_project_id
string | null

AI Studio project ID to associate with the dataset.

Example:

"example_project"