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"
}