Create training job

POST

/api/v1/org/{org}/ws/{workspace}/training/jobs

Authorizations

• OAuth2PasswordBearer
• APIKeyCookie
• APIKeyHeader

Parameters

Path Parameters

org

required

Org

Organization slug

string

Organization slug

workspace

required

Workspace

Workspace slug

string

Workspace slug

Request Body ^required

Any of:

CreateTinkerSFTJobRequest

CreateTinkerSFTJobRequest

Create a hosted Tinker SFT job.

object

backend

Backend

string

default: tinker

Allowed value: tinker

capability_ref

required

CapabilityRef

Capability artifact used as the training policy scaffold

object

name

required

Name

Capability artifact name

string

version

required

Version

Explicit capability version

string

config

required

TinkerSFTJobConfig

Configuration for a hosted Tinker SFT job.

object

batch_size

Any of:

integer

integer

>= 1

null

null

checkpoint_interval

Any of:

integer

integer

>= 1

null

null

dataset_ref

Any of:

DatasetRef

DatasetRef

Stable reference to a versioned dataset artifact.

object

name

required

Name

Dataset artifact name

string

version

required

Version

Explicit dataset version

string

null

null

epochs

Any of:

integer

integer

>= 1

null

null

eval_dataset_ref

Any of:

DatasetRef

DatasetRef

Stable reference to a versioned dataset artifact.

object

name

required

Name

Dataset artifact name

string

version

required

Version

Explicit dataset version

string

null

null

gradient_accumulation_steps

Any of:

integer

integer

>= 1

null

null

learning_rate

Any of:

number

number

> 0

null

null

lora_alpha

Any of:

integer

integer

>= 1

null

null

lora_rank

Any of:

integer

integer

>= 1

null

null

max_sequence_length

Any of:

integer

integer

>= 1

null

null

steps

Any of:

integer

integer

>= 1

null

null

trajectory_dataset_refs

Trajectory Dataset Refs

Optional Worlds trajectory dataset references used for SFT ETL

Array<object>

DatasetRef

Stable reference to a versioned dataset artifact.

object

name

required

Name

Dataset artifact name

string

version

required

Version

Explicit dataset version

string

model

required

Model

Base model or adapter target

string

name

Any of:

string

string

null

null

project_ref

Any of:

string

string

null

null

run_ref

Any of:

string

string

null

null

tags

Tags

Optional job tags

Array<string>

trainer_type

Trainer Type

string

default: sft

Allowed value: sft

CreateTinkerRLJobRequest

CreateTinkerRLJobRequest

Create a hosted Tinker RL job.

object

backend

Backend

string

default: tinker

Allowed value: tinker

capability_ref

required

CapabilityRef

Capability artifact used as the training policy scaffold

object

name

required

Name

Capability artifact name

string

version

required

Version

Explicit capability version

string

config

required

TinkerRLJobConfig

Configuration for a hosted Tinker RL job.

object

algorithm

required

Algorithm

Tinker RL algorithm

string

Allowed values: importance_sampling ppo

batch_size

Any of:

integer

integer

>= 1

null

null

checkpoint_interval

Any of:

integer

integer

>= 1

null

null

execution_mode

Execution Mode

RL execution mode. one_step_off_async keeps one rollout group in flight; fully_async widens the same pipeline to bounded multi-group async training.

string

default: sync

Allowed values: sync one_step_off_async fully_async

learning_rate

Any of:

number

number

> 0

null

null

lora_rank

Any of:

integer

integer

>= 1

null

null

max_episode_steps

Any of:

integer

integer

>= 1

null

null

max_new_tokens

Any of:

integer

integer

>= 1

null

null

max_steps_off_policy

Any of:

integer

integer

>= 1

null

null

max_turns

Any of:

integer

integer

>= 1

null

null

num_rollouts

Any of:

integer

integer

>= 1

null

null

prompt_dataset_ref

Any of:

DatasetRef

DatasetRef

Stable reference to a versioned dataset artifact.

object

name

required

Name

Dataset artifact name

string

version

required

Version

Explicit dataset version

string

null

null

prompt_split

Any of:

string

string

null

null

reward_recipe

Any of:

RewardRecipe

RewardRecipe

Named reward or verification recipe resolved server-side.

object

name

required

Name

Server-side reward recipe name

string

params

Params

Recipe parameters resolved by the training worker

object

key

additional properties

any

null

null

steps

Any of:

integer

integer

>= 1

null

null

stop

Any of:

Array<string>

Array<string>

null

null

task_ref

Any of:

string

string

null

null

temperature

Any of:

number

number

null

null

trajectory_dataset_refs

Trajectory Dataset Refs

Optional Worlds trajectory dataset references used for offline RL ETL

Array<object>

DatasetRef

Stable reference to a versioned dataset artifact.

object

name

required

Name

Dataset artifact name

string

version

required

Version

Explicit dataset version

string

weight_sync_interval

Any of:

integer

integer

>= 1

null

null

world_agent_name

Any of:

string

string

null

null

world_goal

Any of:

string

string

null

null

world_manifest_id

Any of:

string

string

null

null

world_reward

Any of:

WorldRewardPolicy

WorldRewardPolicy

SDK-side reward policy for live Worlds RL rollouts.

object

name

required

Name

Reward policy or preset name

string

params

Params

Optional reward-policy parameters or component definitions

object

key

additional properties

any

null

null

world_runtime_id

Any of:

string

string

null

null

model

required

Model

Base model or adapter target

string

name

Any of:

string

string

null

null

project_ref

Any of:

string

string

null

null

run_ref

Any of:

string

string

null

null

tags

Tags

Optional job tags

Array<string>

trainer_type

Trainer Type

string

default: rl

Allowed value: rl

CreateRayGRPOJobRequest

CreateRayGRPOJobRequest

Create a hosted Ray GRPO job.

object

backend

Backend

string

default: ray

Allowed value: ray

capability_ref

required

CapabilityRef

Capability artifact used as the training policy scaffold

object

name

required

Name

Capability artifact name

string

version

required

Version

Explicit capability version

string

config

required

RayGRPOJobConfig

Configuration for a hosted Ray GRPO job.

object

algorithm

Algorithm

Ray RL algorithm

string

default: grpo

Allowed value: grpo

batch_size

Any of:

integer

integer

>= 1

null

null

buffer_size

Any of:

integer

integer

>= 1

null

null

checkpoint_interval

Any of:

integer

integer

>= 1

null

null

execution_mode

Execution Mode

Ray execution mode

string

default: async

Allowed values: async colocated distributed

learning_rate

Any of:

number

number

> 0

null

null

max_episode_steps

Any of:

integer

integer

>= 1

null

null

max_turns

Any of:

integer

integer

>= 1

null

null

num_rollout_workers

Any of:

integer

integer

>= 1

null

null

num_rollouts

Any of:

integer

integer

>= 1

null

null

prompt_dataset_ref

required

DatasetRef

Prompt dataset used to seed RL episodes

object

name

required

Name

Dataset artifact name

string

version

required

Version

Explicit dataset version

string

reward_recipe

Any of:

RewardRecipe

RewardRecipe

Named reward or verification recipe resolved server-side.

object

name

required

Name

Server-side reward recipe name

string

params

Params

Recipe parameters resolved by the training worker

object

key

additional properties

any

null

null

task_ref

required

Task Ref

Task/environment definition reference

string

model

required

Model

Base model or adapter target

string

name

Any of:

string

string

null

null

project_ref

Any of:

string

string

null

null

run_ref

Any of:

string

string

null

null

tags

Tags

Optional job tags

Array<string>

trainer_type

Trainer Type

string

default: rl

Allowed value: rl

Responses

200

Successful Response

TrainingJobResponse

Training job detail returned by hosted training endpoints.

object

algorithm

Any of:

string

string

Allowed values: grpo importance_sampling ppo

null

null

artifacts

Artifacts

object

key

additional properties

any

backend

required

Backend

string

Allowed values: tinker ray

cancel_requested_at

Any of:

string

string

null

null

capability

required

TrainingCapabilitySnapshot

Resolved capability metadata persisted onto a training job.

object

artifact_id

Any of:

string

string

null

null

name

required

Name

Capability artifact name

string

runtime_digest

Any of:

string

string

null

null

version

required

Version

Resolved capability version

string

completed_at

Any of:

string

string

null

null

created_at

required

Created At

string

created_by

Any of:

string

string

null

null

created_by_email

Any of:

string

string

null

null

dataset_ref

Any of:

DatasetRef

DatasetRef

Stable reference to a versioned dataset artifact.

object

name

required

Name

Dataset artifact name

string

version

required

Version

Explicit dataset version

string

null

null

error

Any of:

string

string

null

null

id

required

Id

string

metrics

Metrics

object

key

additional properties

any

model

required

Model

string

name

Any of:

string

string

null

null

organization_id

required

Organization Id

string

project_ref

Any of:

string

string

null

null

prompt_dataset_ref

Any of:

DatasetRef

DatasetRef

Stable reference to a versioned dataset artifact.

object

name

required

Name

Dataset artifact name

string

version

required

Version

Explicit dataset version

string

null

null

run_ref

Any of:

string

string

null

null

started_at

Any of:

string

string

null

null

status

required

Status

string

Allowed values: pending queued running completed failed cancelled

tags

Tags

Array<string>

task_ref

Any of:

string

string

null

null

trainer_type

required

Trainer Type

string

Allowed values: sft rl

trajectory_dataset_refs

Trajectory Dataset Refs

Array<object>

DatasetRef

Stable reference to a versioned dataset artifact.

object

name

required

Name

Dataset artifact name

string

version

required

Version

Explicit dataset version

string

workspace_id

required

Workspace Id

string

world_agent_name

Any of:

string

string

null

null

world_goal

Any of:

string

string

null

null

world_manifest_id

Any of:

string

string

null

null

world_runtime_id

Any of:

string

string

null

null

400

Invalid request

APIErrorPayload

Canonical API error envelope returned by the API.

object

code

required

Code

HTTP status code

integer

Allowed values: 400 401 403 404 409 422 426 429 500 502 504

detail

required

Detail

Human-readable error message

string

errors

Any of:

Array<object>

Array<object>

ValidationErrorItem

object

loc

required

Loc

Where the validation error occurred

Array

msg

required

Msg

Human-readable validation message

string

type

required

Type

Machine-readable validation error type

string

null

null

type

required

Type

Stable machine-readable error type

string

Allowed values: already_exists_error app_error authentication_error conflict_error aws_error configuration_error database_error dynamodb_error e2b_error e2b_rate_limit_error expired_signature_error expired_token_error forbidden_error group_error invalid_error invalid_flag_error invalid_username_error mail_error member_exists_error member_limit_exceeded_error migration_lock_timeout_error not_found_error oauth_config_error org_sandbox_capacity_exceeded_error bad_gateway_error gateway_timeout_error s3_error server_error task_error stripe_error token_error upgrade_required_error usage_limit_exceeded_error user_verification_error validation_error

401

Authentication failed

APIErrorPayload

Canonical API error envelope returned by the API.

object

code

required

Code

HTTP status code

integer

Allowed values: 400 401 403 404 409 422 426 429 500 502 504

detail

required

Detail

Human-readable error message

string

errors

Any of:

Array<object>

Array<object>

ValidationErrorItem

object

loc

required

Loc

Where the validation error occurred

Array

msg

required

Msg

Human-readable validation message

string

type

required

Type

Machine-readable validation error type

string

null

null

type

required

Type

Stable machine-readable error type

string

Allowed values: already_exists_error app_error authentication_error conflict_error aws_error configuration_error database_error dynamodb_error e2b_error e2b_rate_limit_error expired_signature_error expired_token_error forbidden_error group_error invalid_error invalid_flag_error invalid_username_error mail_error member_exists_error member_limit_exceeded_error migration_lock_timeout_error not_found_error oauth_config_error org_sandbox_capacity_exceeded_error bad_gateway_error gateway_timeout_error s3_error server_error task_error stripe_error token_error upgrade_required_error usage_limit_exceeded_error user_verification_error validation_error

403

Access forbidden

APIErrorPayload

Canonical API error envelope returned by the API.

object

code

required

Code

HTTP status code

integer

Allowed values: 400 401 403 404 409 422 426 429 500 502 504

detail

required

Detail

Human-readable error message

string

errors

Any of:

Array<object>

Array<object>

ValidationErrorItem

object

loc

required

Loc

Where the validation error occurred

Array

msg

required

Msg

Human-readable validation message

string

type

required

Type

Machine-readable validation error type

string

null

null

type

required

Type

Stable machine-readable error type

string

Allowed values: already_exists_error app_error authentication_error conflict_error aws_error configuration_error database_error dynamodb_error e2b_error e2b_rate_limit_error expired_signature_error expired_token_error forbidden_error group_error invalid_error invalid_flag_error invalid_username_error mail_error member_exists_error member_limit_exceeded_error migration_lock_timeout_error not_found_error oauth_config_error org_sandbox_capacity_exceeded_error bad_gateway_error gateway_timeout_error s3_error server_error task_error stripe_error token_error upgrade_required_error usage_limit_exceeded_error user_verification_error validation_error

404

Not found

APIErrorPayload

Canonical API error envelope returned by the API.

object

code

required

Code

HTTP status code

integer

Allowed values: 400 401 403 404 409 422 426 429 500 502 504

detail

required

Detail

Human-readable error message

string

errors

Any of:

Array<object>

Array<object>

ValidationErrorItem

object

loc

required

Loc

Where the validation error occurred

Array

msg

required

Msg

Human-readable validation message

string

type

required

Type

Machine-readable validation error type

string

null

null

type

required

Type

Stable machine-readable error type

string

Allowed values: already_exists_error app_error authentication_error conflict_error aws_error configuration_error database_error dynamodb_error e2b_error e2b_rate_limit_error expired_signature_error expired_token_error forbidden_error group_error invalid_error invalid_flag_error invalid_username_error mail_error member_exists_error member_limit_exceeded_error migration_lock_timeout_error not_found_error oauth_config_error org_sandbox_capacity_exceeded_error bad_gateway_error gateway_timeout_error s3_error server_error task_error stripe_error token_error upgrade_required_error usage_limit_exceeded_error user_verification_error validation_error

409

Already exists

APIErrorPayload

Canonical API error envelope returned by the API.

object

code

required

Code

HTTP status code

integer

Allowed values: 400 401 403 404 409 422 426 429 500 502 504

detail

required

Detail

Human-readable error message

string

errors

Any of:

Array<object>

Array<object>

ValidationErrorItem

object

loc

required

Loc

Where the validation error occurred

Array

msg

required

Msg

Human-readable validation message

string

type

required

Type

Machine-readable validation error type

string

null

null

type

required

Type

Stable machine-readable error type

string

Allowed values: already_exists_error app_error authentication_error conflict_error aws_error configuration_error database_error dynamodb_error e2b_error e2b_rate_limit_error expired_signature_error expired_token_error forbidden_error group_error invalid_error invalid_flag_error invalid_username_error mail_error member_exists_error member_limit_exceeded_error migration_lock_timeout_error not_found_error oauth_config_error org_sandbox_capacity_exceeded_error bad_gateway_error gateway_timeout_error s3_error server_error task_error stripe_error token_error upgrade_required_error usage_limit_exceeded_error user_verification_error validation_error

422

Validation error

APIErrorPayload

Canonical API error envelope returned by the API.

object

code

required

Code

HTTP status code

integer

Allowed values: 400 401 403 404 409 422 426 429 500 502 504

detail

required

Detail

Human-readable error message

string

errors

Any of:

Array<object>

Array<object>

ValidationErrorItem

object

loc

required

Loc

Where the validation error occurred

Array

msg

required

Msg

Human-readable validation message

string

type

required

Type

Machine-readable validation error type

string

null

null

type

required

Type

Stable machine-readable error type

string

Allowed values: already_exists_error app_error authentication_error conflict_error aws_error configuration_error database_error dynamodb_error e2b_error e2b_rate_limit_error expired_signature_error expired_token_error forbidden_error group_error invalid_error invalid_flag_error invalid_username_error mail_error member_exists_error member_limit_exceeded_error migration_lock_timeout_error not_found_error oauth_config_error org_sandbox_capacity_exceeded_error bad_gateway_error gateway_timeout_error s3_error server_error task_error stripe_error token_error upgrade_required_error usage_limit_exceeded_error user_verification_error validation_error

426

Upgrade required

APIErrorPayload

Canonical API error envelope returned by the API.

object

code

required

Code

HTTP status code

integer

Allowed values: 400 401 403 404 409 422 426 429 500 502 504

detail

required

Detail

Human-readable error message

string

errors

Any of:

Array<object>

Array<object>

ValidationErrorItem

object

loc

required

Loc

Where the validation error occurred

Array

msg

required

Msg

Human-readable validation message

string

type

required

Type

Machine-readable validation error type

string

null

null

type

required

Type

Stable machine-readable error type

string

Allowed values: already_exists_error app_error authentication_error conflict_error aws_error configuration_error database_error dynamodb_error e2b_error e2b_rate_limit_error expired_signature_error expired_token_error forbidden_error group_error invalid_error invalid_flag_error invalid_username_error mail_error member_exists_error member_limit_exceeded_error migration_lock_timeout_error not_found_error oauth_config_error org_sandbox_capacity_exceeded_error bad_gateway_error gateway_timeout_error s3_error server_error task_error stripe_error token_error upgrade_required_error usage_limit_exceeded_error user_verification_error validation_error

429

Rate limited

APIErrorPayload

Canonical API error envelope returned by the API.

object

code

required

Code

HTTP status code

integer

Allowed values: 400 401 403 404 409 422 426 429 500 502 504

detail

required

Detail

Human-readable error message

string

errors

Any of:

Array<object>

Array<object>

ValidationErrorItem

object

loc

required

Loc

Where the validation error occurred

Array

msg

required

Msg

Human-readable validation message

string

type

required

Type

Machine-readable validation error type

string

null

null

type

required

Type

Stable machine-readable error type

string

Allowed values: already_exists_error app_error authentication_error conflict_error aws_error configuration_error database_error dynamodb_error e2b_error e2b_rate_limit_error expired_signature_error expired_token_error forbidden_error group_error invalid_error invalid_flag_error invalid_username_error mail_error member_exists_error member_limit_exceeded_error migration_lock_timeout_error not_found_error oauth_config_error org_sandbox_capacity_exceeded_error bad_gateway_error gateway_timeout_error s3_error server_error task_error stripe_error token_error upgrade_required_error usage_limit_exceeded_error user_verification_error validation_error

500

Internal server error

APIErrorPayload

Canonical API error envelope returned by the API.

object

code

required

Code

HTTP status code

integer

Allowed values: 400 401 403 404 409 422 426 429 500 502 504

detail

required

Detail

Human-readable error message

string

errors

Any of:

Array<object>

Array<object>

ValidationErrorItem

object

loc

required

Loc

Where the validation error occurred

Array

msg

required

Msg

Human-readable validation message

string

type

required

Type

Machine-readable validation error type

string

null

null

type

required

Type

Stable machine-readable error type

string

Allowed values: already_exists_error app_error authentication_error conflict_error aws_error configuration_error database_error dynamodb_error e2b_error e2b_rate_limit_error expired_signature_error expired_token_error forbidden_error group_error invalid_error invalid_flag_error invalid_username_error mail_error member_exists_error member_limit_exceeded_error migration_lock_timeout_error not_found_error oauth_config_error org_sandbox_capacity_exceeded_error bad_gateway_error gateway_timeout_error s3_error server_error task_error stripe_error token_error upgrade_required_error usage_limit_exceeded_error user_verification_error validation_error

502

Bad gateway

APIErrorPayload

Canonical API error envelope returned by the API.

object

code

required

Code

HTTP status code

integer

Allowed values: 400 401 403 404 409 422 426 429 500 502 504

detail

required

Detail

Human-readable error message

string

errors

Any of:

Array<object>

Array<object>

ValidationErrorItem

object

loc

required

Loc

Where the validation error occurred

Array

msg

required

Msg

Human-readable validation message

string

type

required

Type

Machine-readable validation error type

string

null

null

type

required

Type

Stable machine-readable error type

string

Allowed values: already_exists_error app_error authentication_error conflict_error aws_error configuration_error database_error dynamodb_error e2b_error e2b_rate_limit_error expired_signature_error expired_token_error forbidden_error group_error invalid_error invalid_flag_error invalid_username_error mail_error member_exists_error member_limit_exceeded_error migration_lock_timeout_error not_found_error oauth_config_error org_sandbox_capacity_exceeded_error bad_gateway_error gateway_timeout_error s3_error server_error task_error stripe_error token_error upgrade_required_error usage_limit_exceeded_error user_verification_error validation_error

504

Gateway timeout

APIErrorPayload

Canonical API error envelope returned by the API.

object

code

required

Code

HTTP status code

integer

Allowed values: 400 401 403 404 409 422 426 429 500 502 504

detail

required

Detail

Human-readable error message

string

errors

Any of:

Array<object>

Array<object>

ValidationErrorItem

object

loc

required

Loc

Where the validation error occurred

Array

msg

required

Msg

Human-readable validation message

string

type

required

Type

Machine-readable validation error type

string

null

null

type

required

Type

Stable machine-readable error type

string

Allowed values: already_exists_error app_error authentication_error conflict_error aws_error configuration_error database_error dynamodb_error e2b_error e2b_rate_limit_error expired_signature_error expired_token_error forbidden_error group_error invalid_error invalid_flag_error invalid_username_error mail_error member_exists_error member_limit_exceeded_error migration_lock_timeout_error not_found_error oauth_config_error org_sandbox_capacity_exceeded_error bad_gateway_error gateway_timeout_error s3_error server_error task_error stripe_error token_error upgrade_required_error usage_limit_exceeded_error user_verification_error validation_error