Report completion of a model job. Fires inference_complete event subscriptions on successful inference jobs.

POST

/v2/models/{model_id}/versions/{model_version}/jobs/{model_job_id}/complete

curl --request POST \
  --url https://test-pie.streamline.enterprises/v2/models/example-model/versions/1/jobs/123456789012/complete \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "status": "success", "output": {}, "error": {} }'

• Production
• Staging
• Testing
• Local

Authorizations

• BearerAuth

Parameters

Path Parameters

model_id

required

string

Example

example-model

model_version

required

string

Example

1

model_job_id

required

string

Example

123456789012

Request Body ^required

Media type application/json

object

status

required

string

Allowed values: success failure

output

Output metadata from the completed job (e.g. S3 paths). Passed as trigger_output to downstream event subscriptions.

object

error

Structured failure details from the handler. Stored on the durable job when status is failure.

object

Responses

200

Job completed; all triggered subscriptions (if any) dispatched cleanly.

Media type application/json

object

job_id

Durable model job identifier.

string

model_id

Model registry identifier.

string

model_version

Model version string within the registry.

string

status

string

triggered_events

required

Event subscriptions triggered by this job completion. Empty for failures or non-inference jobs.

Array<object>

object

subscription_id

required

string format: uuid

job_id

Present when the target action was successfully triggered

string

error

Present when the target action failed to trigger

string

Example ^generated

{
  "job_id": "example",
  "model_id": "example",
  "model_version": "example",
  "status": "example",
  "triggered_events": [
    {
      "subscription_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
      "job_id": "example",
      "error": "example"
    }
  ]
}

207

Job completed, but one or more cascade subscriptions failed. Inspect triggered_events[*].error for per-subscription detail.

Media type application/json

object

job_id

Durable model job identifier.

string

model_id

Model registry identifier.

string

model_version

Model version string within the registry.

string

status

string

triggered_events

required

Event subscriptions triggered by this job completion. Empty for failures or non-inference jobs.

Array<object>

object

subscription_id

required

string format: uuid

job_id

Present when the target action was successfully triggered

string

error

Present when the target action failed to trigger

string

Example ^generated

{
  "job_id": "example",
  "model_id": "example",
  "model_version": "example",
  "status": "example",
  "triggered_events": [
    {
      "subscription_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
      "job_id": "example",
      "error": "example"
    }
  ]
}

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

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

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
}

404

Requested resource was not found.

Media type application/json

object

success

required

boolean

message

required

Human-readable error message

string

Example

{
  "success": false
}