Skip to main content
GET
/
batch
/
registry
/
pipelines
/
{id}
curl https://api.u1.archetypeai.app/v0.5/batch/registry/pipelines/ppl_abc123def456 \
  -H "Authorization: Bearer $ATAI_API_KEY"

{
  "id": "ppl_abc123def456",
  "pipeline_key": "machine-state-classification",
  "pipeline_version": "1.1.1",
  "name": "Machine State Classification",
  "description": "Identify labeled states in time series sensor data",
  "pipeline_type": "batch",
  "components": {
    "worker": "cmp_xyz789"
  },
  "default_config": {
    "worker": {
      "parallelism": 1,
      "config": {
        "model_type": "omega_1_4_base",
        "batch_size": 32,
        "classifier_config": {
          "n_neighbors": 5,
          "metric": "euclidean",
          "weights": "uniform",
          "normalize_embeddings": false
        }
      }
    }
  },
  "config_schema": {},
  "user_config_schema": {},
  "edges": [],
  "inputs": {
    "worker.inference": {
      "name": "Input files",
      "description": "CSV files for machine-state classification",
      "mode": "plain_file_list",
      "distribute": "scatter",
      "required": true,
      "tracked": true
    },
    "worker.n_shots": {
      "name": "N-Shot example files",
      "description": "Labeled few-shot training files (class declared via input metadata)",
      "mode": "n_shot_file_list",
      "distribute": "replicate",
      "required": true,
      "tracked": false
    }
  },
  "outputs": {
    "worker.results": {
      "name": "Output files",
      "description": "Machine-state classification results"
    }
  },
  "retry_policy": {},
  "visibility": "platform",
  "org_id": "org_1abc2def3ghi4jkl",
  "status": "published",
  "created_at": "2026-03-01T00:00:00Z",
  "updated_at": "2026-04-01T00:00:00Z"
}

​
Overview

This endpoint returns the full details of a specific pipeline, including its components, configuration schema, input/output port definitions, and graph edges.

​
Request

​
id
string
required
The unique pipeline identifier

​
Response

​
id
string
Unique pipeline identifier
​
pipeline_key
string
Pipeline key
​
pipeline_version
string
Pipeline version
​
name
string
Human-readable pipeline name
​
description
string
Pipeline description
​
pipeline_type
string
Pipeline type (batch or training)
​
components
object
Map of component names to component IDs
​
default_config
object
Default configuration per component, each with parallelism and config fields
​
config_schema
object
JSON Schema for the full pipeline configuration
​
user_config_schema
object
User-facing JSON Schema for configurable parameters
​
edges
array
Pipeline graph edges, each with from, output, to, and input fields describing component connections
​
inputs
object
Input port definitions, each with:
  • name — Display name
  • description — Human-readable description
  • mode — plain_file_list (a simple list of inputs) or n_shot_file_list (labeled few-shot example files where each item carries metadata.class)
  • distribute — scatter (fan inputs across workers) or replicate (every worker receives the full list)
  • required — Whether the port must be supplied
  • tracked — Whether files attached to this port participate in per-input lifecycle tracking (pending → processing → completed/failed). false for reference ports like n-shot examples — those inputs land in the terminal reference status and never transition.
​
outputs
object
Output port definitions, each with name and description fields
​
retry_policy
object
Retry policy configuration
​
visibility
string
Visibility level: platform (all orgs) or org (owning org only)
​
org_id
string
Owning organization identifier
​
status
string
Registry status: draft, published, deactivated, or deleted
​
created_at
string
Creation timestamp
​
updated_at
string
Last update timestamp
curl https://api.u1.archetypeai.app/v0.5/batch/registry/pipelines/ppl_abc123def456 \
  -H "Authorization: Bearer $ATAI_API_KEY"

{
  "id": "ppl_abc123def456",
  "pipeline_key": "machine-state-classification",
  "pipeline_version": "1.1.1",
  "name": "Machine State Classification",
  "description": "Identify labeled states in time series sensor data",
  "pipeline_type": "batch",
  "components": {
    "worker": "cmp_xyz789"
  },
  "default_config": {
    "worker": {
      "parallelism": 1,
      "config": {
        "model_type": "omega_1_4_base",
        "batch_size": 32,
        "classifier_config": {
          "n_neighbors": 5,
          "metric": "euclidean",
          "weights": "uniform",
          "normalize_embeddings": false
        }
      }
    }
  },
  "config_schema": {},
  "user_config_schema": {},
  "edges": [],
  "inputs": {
    "worker.inference": {
      "name": "Input files",
      "description": "CSV files for machine-state classification",
      "mode": "plain_file_list",
      "distribute": "scatter",
      "required": true,
      "tracked": true
    },
    "worker.n_shots": {
      "name": "N-Shot example files",
      "description": "Labeled few-shot training files (class declared via input metadata)",
      "mode": "n_shot_file_list",
      "distribute": "replicate",
      "required": true,
      "tracked": false
    }
  },
  "outputs": {
    "worker.results": {
      "name": "Output files",
      "description": "Machine-state classification results"
    }
  },
  "retry_policy": {},
  "visibility": "platform",
  "org_id": "org_1abc2def3ghi4jkl",
  "status": "published",
  "created_at": "2026-03-01T00:00:00Z",
  "updated_at": "2026-04-01T00:00:00Z"
}