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

{
  "id": "pip_abc123def456",
  "pipeline_key": "image-classifier",
  "pipeline_version": "1.2.0",
  "name": "Image Classifier",
  "description": "Classifies images using a pre-trained model",
  "pipeline_type": "batch",
  "components": {
    "classifier": "cmp_xyz789"
  },
  "default_config": {
    "classifier": {
      "parallelism": 1,
      "config": {}
    }
  },
  "config_schema": {},
  "user_config_schema": {},
  "edges": [],
  "inputs": {
    "images": {
      "name": "images",
      "description": "Input images to classify",
      "mode": "plain_file_list",
      "distribute": "scatter",
      "required": true
    }
  },
  "outputs": {
    "results": {
      "name": "results",
      "description": "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"
}

Documentation Index

Fetch the complete documentation index at: https://docs.archetypeai.app/llms.txt

Use this file to discover all available pages before exploring further.

​
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, description, mode, distribute, and required fields
​
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/pip_abc123def456 \
  -H "Authorization: Bearer $ATAI_API_KEY"

{
  "id": "pip_abc123def456",
  "pipeline_key": "image-classifier",
  "pipeline_version": "1.2.0",
  "name": "Image Classifier",
  "description": "Classifies images using a pre-trained model",
  "pipeline_type": "batch",
  "components": {
    "classifier": "cmp_xyz789"
  },
  "default_config": {
    "classifier": {
      "parallelism": 1,
      "config": {}
    }
  },
  "config_schema": {},
  "user_config_schema": {},
  "edges": [],
  "inputs": {
    "images": {
      "name": "images",
      "description": "Input images to classify",
      "mode": "plain_file_list",
      "distribute": "scatter",
      "required": true
    }
  },
  "outputs": {
    "results": {
      "name": "results",
      "description": "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"
}