Models Endpoints
List Models
Headers
Header | Value | Description |
---|---|---|
Authorization | Bearer TOKEN | Required. Your API access token |
Query Parameters
Parameter | Type | Required | Description |
---|---|---|---|
limit | integer | No | Maximum number of models to return (default: 20, max: 100) |
offset | integer | No | Number of models to skip (default: 0) |
status | string | No | Filter by status: DRAFT , BUILDING , READY , ERROR |
sort_by | string | No | Field to sort by: created_at , name (default: created_at ) |
sort_dir | string | No | Sort direction: asc or desc (default: desc ) |
Response
Get Model
Headers
Header | Value | Description |
---|---|---|
Authorization | Bearer TOKEN | Required. Your API access token |
Path Parameters
Parameter | Type | Required | Description |
---|---|---|---|
model_name | string | Yes | Name of the model to get |
Response
Create Model
Headers
Header | Value | Description |
---|---|---|
Authorization | Bearer TOKEN | Required. Your API access token |
Content-Type | application/json | Required |
Path Parameters
Parameter | Type | Required | Description |
---|---|---|---|
model_name | string | Yes | Name for the new model |
Request Body
Field | Type | Required | Description |
---|---|---|---|
intent | string | Yes | Natural language description of the model purpose |
name | string | No | Display name for the model (default: generated) |
description | string | No | Detailed description of the model |
dataset_id | string | Yes | ID of the dataset to use for training |
input_schema | object | No | Schema of input fields (inferred if not provided) |
output_schema | object | No | Schema of output fields (inferred if not provided) |
tags | array | No | List of tags for organizing models |
Response
Deploy Model
Headers
Header | Value | Description |
---|---|---|
Authorization | Bearer TOKEN | Required. Your API access token |
Content-Type | application/json | Required |
Path Parameters
Parameter | Type | Required | Description |
---|---|---|---|
model_name | string | Yes | Name of the model to deploy |
Request Body
Field | Type | Required | Description |
---|---|---|---|
environment | string | No | Deployment environment (default: production ) |
replicas | integer | No | Number of replicas to deploy (default: 1) |
auto_scale | boolean | No | Whether to enable auto-scaling (default: true ) |
Response
Make Prediction
Headers
Header | Value | Description |
---|---|---|
x-api-key | YOUR_API_KEY | Required. Your API access key |
Content-Type | application/json | Required |
Path Parameters
Parameter | Type | Required | Description |
---|---|---|---|
model_name | string | Yes | Name of the model to use |
model_version | string | Yes | Version of the model to use |
Request Body
Input data matching the model’s input schema. Example:Response
Output data matching the model’s output schema. Example:Get Model Status
Headers
Header | Value | Description |
---|---|---|
Authorization | Bearer TOKEN | Required. Your API access token |
Path Parameters
Parameter | Type | Required | Description |
---|---|---|---|
model_name | string | Yes | Name of the model |
model_version | string | Yes | Version of the model |
Response
Update Model
Headers
Header | Value | Description |
---|---|---|
Authorization | Bearer TOKEN | Required. Your API access token |
Content-Type | application/json | Required |
Path Parameters
Parameter | Type | Required | Description |
---|---|---|---|
model_name | string | Yes | Name of the model to update |
Request Body
Field | Type | Required | Description |
---|---|---|---|
name | string | No | New display name for the model |
description | string | No | New description of the model |
tags | array | No | Updated list of tags |
Response
Delete Model
Headers
Header | Value | Description |
---|---|---|
Authorization | Bearer TOKEN | Required. Your API access token |
Path Parameters
Parameter | Type | Required | Description |
---|---|---|---|
model_name | string | Yes | Name of the model to delete |
Response
Retrain Model
Headers
Header | Value | Description |
---|---|---|
x-api-key | YOUR_API_KEY | Required. Your API access key |
Content-Type | application/json | Required |
Path Parameters
Parameter | Type | Required | Description |
---|---|---|---|
model_name | string | Yes | Name of the model to retrain |
Request Body
Field | Type | Required | Description |
---|---|---|---|
upload_id | string | No | ID of new dataset for retraining |
goal | string | No | Updated natural language description |
metric | string | No | Primary metric to optimize |
max_iterations | integer | No | Maximum training iterations |
Response
Get Build Logs
Headers
Header | Value | Description |
---|---|---|
x-api-key | YOUR_API_KEY | Required. Your API access key |
Query Parameters
Parameter | Type | Required | Description |
---|---|---|---|
limit | integer | No | Maximum number of log entries to return (default: 100) |
offset | integer | No | Number of log entries to skip (default: 0) |
job_id | string | No | Filter logs by specific build job ID |
Response
Model Versions
List Model Versions
Headers
Header | Value | Description |
---|---|---|
Authorization | Bearer TOKEN | Required. Your API access token |
Path Parameters
Parameter | Type | Required | Description |
---|---|---|---|
model_name | string | Yes | Name of the model to list versions for |
Response
Create Model Version
Headers
Header | Value | Description |
---|---|---|
Authorization | Bearer TOKEN | Required. Your API access token |
Content-Type | application/json | Required |
Path Parameters
Parameter | Type | Required | Description |
---|---|---|---|
model_name | string | Yes | Name of the model to create version for |
Request Body
Field | Type | Required | Description |
---|---|---|---|
dataset_id | string | Yes | ID of the dataset to use for training |
intent | string | No | Updated intent (defaults to original if omitted) |
input_schema | object | No | Updated input schema (defaults to original) |
output_schema | object | No | Updated output schema (defaults to original) |
Response
Model Deployments
List Deployments
Headers
Header | Value | Description |
---|---|---|
Authorization | Bearer TOKEN | Required. Your API access token |
Path Parameters
Parameter | Type | Required | Description |
---|---|---|---|
model_name | string | Yes | Name of the model to list deployments for |
Response
Undeploy Model
Headers
Header | Value | Description |
---|---|---|
Authorization | Bearer TOKEN | Required. Your API access token |
Path Parameters
Parameter | Type | Required | Description |
---|---|---|---|
model_id | string | Yes | ID of the model |
deployment_id | string | Yes | ID of the deployment to remove |
Response
Describe Model
Headers
Header | Value | Description |
---|---|---|
x-api-key | YOUR_API_KEY | Required. Your API access key |
Path Parameters
Parameter | Type | Required | Description |
---|---|---|---|
model_name | string | Yes | Name of the model |
model_version | string | Yes | Version of the model |
Response
Batch Predictions
Batch Predictions
Headers
Header | Value | Description |
---|---|---|
x-api-key | YOUR_API_KEY | Required. Your API access key |
Content-Type | application/json | Required |
Path Parameters
Parameter | Type | Required | Description |
---|---|---|---|
model_name | string | Yes | Name of the model to use |
model_version | string | Yes | Version of the model to use |
Request Body
Array of input objects matching the model’s input schema. Example:Response
Array of prediction results corresponding to each input:Error Codes
HTTP Status | Error Code | Description |
---|---|---|
400 | invalid_request | Malformed request or missing parameters |
401 | unauthorized | Missing or invalid API key |
403 | forbidden | Insufficient permissions for operation |
404 | not_found | Model, deployment, or resource not found |
409 | conflict | Resource conflict (e.g., duplicate name) |
422 | validation_error | Invalid input data or schema |
429 | rate_limit_exceeded | API rate limit exceeded |
500 | internal_error | Server-side error |
503 | service_unavailable | Service temporarily unavailable |