POST
/
api
/
v1
/
transform
/
job
/
start

Authorizations

Authorization
string
header
required

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

Body

application/json
dataset_id
string
required

the dataset id of the dataset whose records will be transformed

user_instructions
string
required

the instructions for the system to follow when transforming the records

batch_size
integer | null

if you want to process a subset of the records in the dataset, pass the batch size here, otherwise all records will be processed

callback_url
string | null

a post request will be sent to this url when the job is completed

confidence
boolean
default:
false

If true, the model will return the confidence of the prediction

job_id
string | null

if you want to run an existing job (e.g. because more records have been added to the dataset), pass the existing job id here

name
string | null

name of the job, this must be provided if the job_id is not provided

provided_labels
object | null

if you want to provide labels for the model to use, pass them here. The keys should be the ids of the records and the values should be the desired outputs as dictionaries

records
object[]

additional records that will be added to the dataset and processed as part of the job

reprocess_records
boolean
default:
false

Existing records that have already been processed by the job will be reprocessed. You may want to do this if you've labeled some more data and want the job to be re-run

send_completion_email
boolean
default:
true

email sent to the user triggering the job when the job is completed

Response

200 - application/json
job_id
string
required
job_type
enum<string>
required
Available options:
match,
transform,
categorize
progress
object | null
required
status
enum<string>
required
Available options:
processing,
completed,
failed,
cancelled