Transform Jobs

List Transform Jobs

get

List transform jobs for the authenticated organization

Authorizations

HTTPBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

limitinteger · min: 1 · max: 100OptionalDefault: 10

cursorany ofOptional

stringOptional

or

nullOptional

statusany ofOptional

string · enumOptionalPossible values:

or

nullOptional

configuration_idany ofOptional

stringOptional

or

nullOptional

Responses

200

Successful Response

application/json

next_cursorany ofOptional

stringOptional

or

nullOptional

has_morebooleanRequired

totalintegerRequired

422

Validation Error

application/json

get

/transform-jobs

HTTPcURLJavaScriptPython

GET /api/public/v1/transform-jobs HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "jobs": [
    {
      "id": "text",
      "organization_id": "text",
      "configuration_id": "text",
      "name": "text",
      "status": "RUNNING",
      "error_message": "text",
      "warning_message": "text",
      "modal_function_call_id": "text",
      "modal_app_id": "text",
      "transform_config": "text",
      "input_dataset_id": "text",
      "output_dataset_id": "text",
      "usage": {
        "total": {
          "events": {
            "ANY_ADDITIONAL_PROPERTY": {
              "count": 0,
              "amount": 0,
              "cost": 0,
              "cached_count": 0
            }
          },
          "llm_by_model": {
            "ANY_ADDITIONAL_PROPERTY": {
              "count": 0,
              "input_tokens": 0,
              "output_tokens": 0,
              "cost": 0,
              "cached_count": 0
            }
          },
          "total_cost": 0
        },
        "by_step": {
          "ANY_ADDITIONAL_PROPERTY": {
            "events": {
              "ANY_ADDITIONAL_PROPERTY": {
                "count": 0,
                "amount": 0,
                "cost": 0,
                "cached_count": 0
              }
            },
            "llm_by_model": {
              "ANY_ADDITIONAL_PROPERTY": {
                "count": 0,
                "input_tokens": 0,
                "output_tokens": 0,
                "cost": 0,
                "cached_count": 0
              }
            },
            "total_cost": 0
          }
        },
        "max_cost_dollars": 1,
        "current_cost_dollars": 1,
        "estimated_cost_dollars": 1,
        "pipeline_summary": [
          {
            "step_index": 1,
            "transform_name": "text",
            "input_count": 0,
            "output_count": 0,
            "rejected_count": 0,
            "error_count": 0,
            "rejection_reasons": {
              "ANY_ADDITIONAL_PROPERTY": 1
            }
          }
        ]
      },
      "estimated_cost_dollars": 1,
      "created_at": "2026-03-10T22:59:46.356Z",
      "updated_at": "2026-03-10T22:59:46.356Z"
    }
  ],
  "next_cursor": "text",
  "has_more": true,
  "total": 1
}

Create Transform Job

post

Create a new transform job

Authorizations

HTTPBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

configone ofRequired

or

or

or

or

or

or

or

or

or

input_dataset_idany ofOptional

stringOptional

or

nullOptional

max_questionsany ofOptional

integerOptional

or

nullOptional

max_cost_dollarsany ofOptional

numberOptional

or

nullOptional

configuration_idany ofOptional

stringOptional

or

nullOptional

nameany ofOptional

stringOptional

or

nullOptional

Responses

201

Successful Response

application/json

422

Validation Error

application/json

post

/transform-jobs

HTTPcURLJavaScriptPython

POST /api/public/v1/transform-jobs HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1342

{
  "config": {
    "config_type": "FORWARD_LOOKING_QUESTION_GENERATOR",
    "instructions": "text",
    "examples": [
      "text"
    ],
    "bad_examples": [
      "text"
    ],
    "filter": {
      "rubric": "text",
      "min_score": 0.5,
      "model_name": "google/gemini-3-flash-preview"
    },
    "questions_per_seed": 1,
    "include_default_filter": false,
    "answer_type": {
      "answer_type": "BINARY",
      "answer_format_instruction": "This is a binary yes/no question. You are estimating the probability that the answer is 'Yes'. Provide your confidence as a value between 0 (definitely No) and 1 (definitely Yes). Provide your probability estimate for Yes as a decimal between 0 and 1. Provide your answer between <answer></answer> tags. Example: <answer>0.75</answer>",
      "labeler_instruction": "The answer should be ONLY '1', '0', or 'Undetermined'. '1' means yes, '0' means no, and 'Undetermined' means the answer is not clear. Do not include any other text or explanation.",
      "question_generation_instruction": "Generate questions that can be answered with Yes or No. Frame the question so it has exactly two possible outcomes: Yes or No. The question should start with words like 'Will', 'Is', 'Does', 'Has', 'Can', etc. A clear and unambiguous yes/no question, based on the provided seed_text.",
      "reward_function_type": "binary_brier"
    }
  },
  "input_dataset_id": "text",
  "max_questions": 1,
  "max_cost_dollars": 1,
  "configuration_id": "text",
  "name": "text"
}

{
  "id": "text",
  "organization_id": "text",
  "configuration_id": "text",
  "name": "text",
  "status": "RUNNING",
  "error_message": "text",
  "warning_message": "text",
  "modal_function_call_id": "text",
  "modal_app_id": "text",
  "transform_config": "text",
  "input_dataset_id": "text",
  "output_dataset_id": "text",
  "usage": {
    "total": {
      "events": {
        "ANY_ADDITIONAL_PROPERTY": {
          "count": 0,
          "amount": 0,
          "cost": 0,
          "cached_count": 0
        }
      },
      "llm_by_model": {
        "ANY_ADDITIONAL_PROPERTY": {
          "count": 0,
          "input_tokens": 0,
          "output_tokens": 0,
          "cost": 0,
          "cached_count": 0
        }
      },
      "total_cost": 0
    },
    "by_step": {
      "ANY_ADDITIONAL_PROPERTY": {
        "events": {
          "ANY_ADDITIONAL_PROPERTY": {
            "count": 0,
            "amount": 0,
            "cost": 0,
            "cached_count": 0
          }
        },
        "llm_by_model": {
          "ANY_ADDITIONAL_PROPERTY": {
            "count": 0,
            "input_tokens": 0,
            "output_tokens": 0,
            "cost": 0,
            "cached_count": 0
          }
        },
        "total_cost": 0
      }
    },
    "max_cost_dollars": 1,
    "current_cost_dollars": 1,
    "estimated_cost_dollars": 1,
    "pipeline_summary": [
      {
        "step_index": 1,
        "transform_name": "text",
        "input_count": 0,
        "output_count": 0,
        "rejected_count": 0,
        "error_count": 0,
        "rejection_reasons": {
          "ANY_ADDITIONAL_PROPERTY": 1
        }
      }
    ]
  },
  "estimated_cost_dollars": 1,
  "created_at": "2026-03-10T22:59:46.356Z",
  "updated_at": "2026-03-10T22:59:46.356Z"
}

Cost Estimation

post

Estimate maximum cost for a transform job before execution

Authorizations

HTTPBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

configone ofRequired

or

or

or

or

or

or

or

or

or

max_questionsany ofOptional

integerOptional

or

nullOptional

Responses

200

Successful Response

application/json

total_cost_dollarsnumberRequired

llm_cost_dollarsnumberRequired

web_search_cost_dollarsnumberRequired

url_download_cost_dollarsnumberRequired

gemini_grounding_cost_dollarsnumberOptionalDefault: 0

bigquery_cost_dollarsnumberOptionalDefault: 0

422

Validation Error

application/json

post

/transform-jobs/cost-estimation

HTTPcURLJavaScriptPython

POST /api/public/v1/transform-jobs/cost-estimation HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 1255

{
  "config": {
    "config_type": "FORWARD_LOOKING_QUESTION_GENERATOR",
    "instructions": "text",
    "examples": [
      "text"
    ],
    "bad_examples": [
      "text"
    ],
    "filter": {
      "rubric": "text",
      "min_score": 0.5,
      "model_name": "google/gemini-3-flash-preview"
    },
    "questions_per_seed": 1,
    "include_default_filter": false,
    "answer_type": {
      "answer_type": "BINARY",
      "answer_format_instruction": "This is a binary yes/no question. You are estimating the probability that the answer is 'Yes'. Provide your confidence as a value between 0 (definitely No) and 1 (definitely Yes). Provide your probability estimate for Yes as a decimal between 0 and 1. Provide your answer between <answer></answer> tags. Example: <answer>0.75</answer>",
      "labeler_instruction": "The answer should be ONLY '1', '0', or 'Undetermined'. '1' means yes, '0' means no, and 'Undetermined' means the answer is not clear. Do not include any other text or explanation.",
      "question_generation_instruction": "Generate questions that can be answered with Yes or No. Frame the question so it has exactly two possible outcomes: Yes or No. The question should start with words like 'Will', 'Is', 'Does', 'Has', 'Can', etc. A clear and unambiguous yes/no question, based on the provided seed_text.",
      "reward_function_type": "binary_brier"
    }
  },
  "max_questions": 1
}

{
  "total_cost_dollars": 1,
  "llm_cost_dollars": 1,
  "web_search_cost_dollars": 1,
  "url_download_cost_dollars": 1,
  "gemini_grounding_cost_dollars": 0,
  "bigquery_cost_dollars": 0,
  "usage": {
    "events": {
      "ANY_ADDITIONAL_PROPERTY": {
        "count": 0,
        "amount": 0,
        "cost": 0,
        "cached_count": 0
      }
    },
    "llm_by_model": {
      "ANY_ADDITIONAL_PROPERTY": {
        "count": 0,
        "input_tokens": 0,
        "output_tokens": 0,
        "cost": 0,
        "cached_count": 0
      }
    },
    "total_cost": 0
  },
  "steps": [
    {
      "step_name": "text",
      "step_type": "NEWS_SEED_GENERATOR",
      "total_cost_dollars": 1,
      "usage": {
        "events": {
          "ANY_ADDITIONAL_PROPERTY": {
            "count": 0,
            "amount": 0,
            "cost": 0,
            "cached_count": 0
          }
        },
        "llm_by_model": {
          "ANY_ADDITIONAL_PROPERTY": {
            "count": 0,
            "input_tokens": 0,
            "output_tokens": 0,
            "cost": 0,
            "cached_count": 0
          }
        },
        "total_cost": 0
      },
      "output_count": 1,
      "cost_per_output": 1
    }
  ]
}

Get Transform Job

get

Get a transform job by ID

Authorizations

HTTPBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

job_idstringRequired

Responses

200

Successful Response

application/json

idstringRequired

organization_idstringRequired

configuration_idany ofOptional

stringOptional

or

nullOptional

nameany ofOptional

stringOptional

or

nullOptional

statusstring · enumRequiredPossible values:

error_messageany ofOptional

stringOptional

or

nullOptional

warning_messageany ofOptional

stringOptional

or

nullOptional

modal_function_call_idstringRequired

modal_app_idstringRequired

transform_configstringRequired

input_dataset_idany ofRequired

stringOptional

or

nullOptional

output_dataset_idany ofRequired

stringOptional

or

nullOptional

usageany ofOptional

or

nullOptional

estimated_cost_dollarsany ofOptional

numberOptional

or

nullOptional

created_atstring · date-timeRequired

updated_atstring · date-timeRequired

422

Validation Error

application/json

get

/transform-jobs/{job_id}

HTTPcURLJavaScriptPython

GET /api/public/v1/transform-jobs/{job_id} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "text",
  "organization_id": "text",
  "configuration_id": "text",
  "name": "text",
  "status": "RUNNING",
  "error_message": "text",
  "warning_message": "text",
  "modal_function_call_id": "text",
  "modal_app_id": "text",
  "transform_config": "text",
  "input_dataset_id": "text",
  "output_dataset_id": "text",
  "usage": {
    "total": {
      "events": {
        "ANY_ADDITIONAL_PROPERTY": {
          "count": 0,
          "amount": 0,
          "cost": 0,
          "cached_count": 0
        }
      },
      "llm_by_model": {
        "ANY_ADDITIONAL_PROPERTY": {
          "count": 0,
          "input_tokens": 0,
          "output_tokens": 0,
          "cost": 0,
          "cached_count": 0
        }
      },
      "total_cost": 0
    },
    "by_step": {
      "ANY_ADDITIONAL_PROPERTY": {
        "events": {
          "ANY_ADDITIONAL_PROPERTY": {
            "count": 0,
            "amount": 0,
            "cost": 0,
            "cached_count": 0
          }
        },
        "llm_by_model": {
          "ANY_ADDITIONAL_PROPERTY": {
            "count": 0,
            "input_tokens": 0,
            "output_tokens": 0,
            "cost": 0,
            "cached_count": 0
          }
        },
        "total_cost": 0
      }
    },
    "max_cost_dollars": 1,
    "current_cost_dollars": 1,
    "estimated_cost_dollars": 1,
    "pipeline_summary": [
      {
        "step_index": 1,
        "transform_name": "text",
        "input_count": 0,
        "output_count": 0,
        "rejected_count": 0,
        "error_count": 0,
        "rejection_reasons": {
          "ANY_ADDITIONAL_PROPERTY": 1
        }
      }
    ]
  },
  "estimated_cost_dollars": 1,
  "created_at": "2026-03-10T22:59:46.356Z",
  "updated_at": "2026-03-10T22:59:46.356Z"
}

Cancel Transform Job

delete

Cancel a running transform job

Authorizations

HTTPBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

job_idstringRequired

Responses

200

Successful Response

application/json

anyOptional

400

Cannot cancel job with current status

404

Transform job not found

422

Validation Error

application/json

delete

/transform-jobs/{job_id}

HTTPcURLJavaScriptPython

DELETE /api/public/v1/transform-jobs/{job_id} HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Get Transform Job Metrics

get

Get pipeline metrics for a transform job

Authorizations

HTTPBearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

job_idstringRequired

Responses

200

Successful Response

application/json

total_input_rowsintegerRequired

total_output_rowsintegerRequired

total_duration_secondsnumberRequired

404

Pipeline metrics not found

422

Validation Error

application/json

get

/transform-jobs/{job_id}/metrics

HTTPcURLJavaScriptPython

GET /api/public/v1/transform-jobs/{job_id}/metrics HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "total_input_rows": 1,
  "total_output_rows": 1,
  "total_duration_seconds": 1,
  "steps": [
    {
      "step_index": 1,
      "transform_name": "text",
      "input_rows": 1,
      "output_rows": 1,
      "rejected_count": 1,
      "error_count": 1,
      "duration_seconds": 1,
      "progress": 1,
      "summary": "text"
    }
  ]
}