Skip to main content
GET
/
batch
/
registry
/
pipelines
curl "https://api.u1.archetypeai.app/v0.5/batch/registry/pipelines?pipeline_type=batch&status=published" \
  -H "Authorization: Bearer $ATAI_API_KEY"

{
  "total": 5,
  "offset": 0,
  "limit": 20,
  "pipelines": [
    {
      "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 a paginated list of pipelines available in the registry. You can filter by pipeline type, visibility, and status.

​
Request

​
pipeline_type
string
Filter by pipeline type: batch or training
​
visibility
string
Filter by visibility: platform (visible to all orgs) or org (visible only to owning org)
​
status
string
Filter by registry status: draft, published, deactivated, or deleted
​
offset
integer
Number of items to skip for pagination (default: 0)
​
limit
integer
Maximum number of items to return per page

​
Response

​
total
integer
Total number of pipelines matching the filter criteria
​
offset
integer
Current pagination offset
​
limit
integer
Maximum number of items returned
​
pipelines
array
Array of pipeline objects, each containing:
  • id — Unique pipeline identifier
  • pipeline_key — Pipeline key
  • pipeline_version — Pipeline version
  • name — Human-readable pipeline name
  • description — Pipeline description
  • pipeline_type — Pipeline type (batch or training)
  • components — Map of component names to component IDs
  • default_config — Default configuration per component
  • config_schema — JSON Schema for pipeline configuration
  • user_config_schema — User-facing JSON Schema
  • edges — Pipeline graph edges connecting components
  • inputs — Input port definitions
  • outputs — Output port definitions
  • retry_policy — Retry policy configuration
  • visibility — Visibility level (platform or org)
  • org_id — Owning organization ID
  • status — Registry status
  • created_at — Creation timestamp
  • updated_at — Last update timestamp
curl "https://api.u1.archetypeai.app/v0.5/batch/registry/pipelines?pipeline_type=batch&status=published" \
  -H "Authorization: Bearer $ATAI_API_KEY"

{
  "total": 5,
  "offset": 0,
  "limit": 20,
  "pipelines": [
    {
      "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"
    }
  ]
}