Skip to content
PIE V2 API

Create model

POST
/v2/models
 
curl --request POST \
  --url https://pie.streamline.enterprises/v2/models \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "name": "Price recommendation", "description": "Domain-level price model", "metadata": { "team": "pricing" }, "handlers": { "training": { "type": "lambda", "arn": "arn:aws:lambda:us-west-2:123456789012:function:train", "version": "1" }, "inference": { "type": "lambda", "arn": "arn:aws:lambda:us-west-2:123456789012:function:infer" } } }'

Authorizations

Section titled “Authorizations ”

Request Body required

Section titled “Request Body required ”
Media type application/json
object
id

Optional model id. If omitted, the server assigns a new UUIDv7.

string
name
required
string
version
string
description
required
string
metadata
required
object
handlers
required
object
training
required
One of:
object
type
required
string
Allowed value: lambda
arn
required
string
version
string
inference
required
One of:
object
type
required
string
Allowed value: lambda
arn
required
string
version
string
Example 
{
  "training": {
    "type": "lambda",
    "arn": "arn:aws:lambda:us-west-2:123456789012:function:train-model",
    "version": "1"
  },
  "inference": {
    "type": "lambda",
    "arn": "arn:aws:lambda:us-west-2:123456789012:function:infer-model"
  }
}
handler_contracts

Typed input/output contracts per handler type. Controls which subscriptions become stale when handlers change. Contract fields are JSON Schema Draft 2020-12 documents.

object
training
object
input_schema

JSON Schema Draft 2020-12 document for the payload accepted by this handler. When set on inference, direct inference requests validate input against this schema before dispatch. Stored event-subscription payloads are validated against the target’s schema for the action (warnings-only on mismatch).

object
output_schema

JSON Schema Draft 2020-12 document for the handler’s successful output on job completion. Mismatches are logged as warnings but do not fail completion (external handlers may diverge).

object
inference
object
input_schema

JSON Schema Draft 2020-12 document for the payload accepted by this handler. When set on inference, direct inference requests validate input against this schema before dispatch. Stored event-subscription payloads are validated against the target’s schema for the action (warnings-only on mismatch).

object
output_schema

JSON Schema Draft 2020-12 document for the handler’s successful output on job completion. Mismatches are logged as warnings but do not fail completion (external handlers may diverge).

object
Example 
{
  "name": "Price recommendation",
  "description": "Domain-level price model",
  "metadata": {
    "team": "pricing"
  },
  "handlers": {
    "training": {
      "type": "lambda",
      "arn": "arn:aws:lambda:us-west-2:123456789012:function:train",
      "version": "1"
    },
    "inference": {
      "type": "lambda",
      "arn": "arn:aws:lambda:us-west-2:123456789012:function:infer"
    }
  }
}

Responses

Section titled “ Responses ”

201

Section titled “201 ”

Model created

Media type application/json
object
version
required
object
version
required
string
description
required
string
metadata
required
object
status
required
string
Allowed values: pending training active failed
model
required
object
id
required
string
name
required
string
description
required
string
handlers
required
object
training
required
One of:
object
type
required
string
Allowed value: lambda
arn
required
string
version
string
inference
required
One of:
object
type
required
string
Allowed value: lambda
arn
required
string
version
string
handler_contracts

Typed input/output contracts per handler type. When set, subscription staleness is driven by changes to these schemas rather than the handlers field. Contract fields are JSON Schema Draft 2020-12 documents.

object
training
object
input_schema

JSON Schema Draft 2020-12 document for the payload accepted by this handler. When set on inference, direct inference requests validate input against this schema before dispatch. Stored event-subscription payloads are validated against the target’s schema for the action (warnings-only on mismatch).

object
output_schema

JSON Schema Draft 2020-12 document for the handler’s successful output on job completion. Mismatches are logged as warnings but do not fail completion (external handlers may diverge).

object
inference
object
input_schema

JSON Schema Draft 2020-12 document for the payload accepted by this handler. When set on inference, direct inference requests validate input against this schema before dispatch. Stored event-subscription payloads are validated against the target’s schema for the action (warnings-only on mismatch).

object
output_schema

JSON Schema Draft 2020-12 document for the handler’s successful output on job completion. Mismatches are logged as warnings but do not fail completion (external handlers may diverge).

object
metadata
required
object
status
required
string
Allowed values: pending active
Example 
{
  "version": {
    "status": "pending"
  },
  "model": {
    "id": "model_price_reco_v1",
    "name": "Price recommendation",
    "description": "Domain-level price model",
    "handlers": {
      "training": {
        "type": "lambda",
        "arn": "arn:aws:lambda:us-west-2:123456789012:function:train",
        "version": "1"
      },
      "inference": {
        "type": "lambda",
        "arn": "arn:aws:lambda:us-west-2:123456789012:function:infer"
      }
    },
    "handler_contracts": null,
    "metadata": {
      "team": "pricing"
    },
    "status": "active"
  }
}

400

Section titled “400 ”

Validation error — malformed input, invalid path parameters, or request that fails syntactic validation.

Media type application/json
object
success
required
boolean
message
required

Human-readable error message

string
Example 
{
  "success": false
}

401

Section titled “401 ”

Missing or invalid Authorization bearer token, expired token, or token rejected by the authorization layer (e.g. API Gateway JWT authorizer or application validation).

Media type application/json
object
success
required
boolean
message
required

Human-readable error message

string
Example 
{
  "success": false
}

403

Section titled “403 ”

Authenticated caller lacks the permission required for this operation.

Media type application/json
object
success
required
boolean
message
required

Human-readable error message

string
Example 
{
  "success": false
}

422

Section titled “422 ”

Semantically invalid request — e.g. domain not active, no model assigned, feature contract mismatch, or invalid feature definitions.

Media type application/json
object
success
required
boolean
message
required

Human-readable error message

string
Example 
{
  "success": false
}