POST
/
api
/
v1
/
categorize
/
job
/
start

Authorizations

Authorization
string
headerrequired

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

categories
string[]
required

the categories that the system should select from

name
string | null

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

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

records
object[]

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

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

send_completion_email
boolean
default: true

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

user_instructions
string | null

custom instructions for the system to follow when completing 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

confidence
boolean
default: false

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

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 categories as lists

Response

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