Skip to main content
GET
Requires version 1.1.0 or later of the Archetype platform.

Overview

This endpoint returns a cursor-paginated list of pipelines available in the registry. You can filter by pipeline type, visibility, and status.
Starting in version 1.1.11, this endpoint now pages with cursors instead of an offset. The offset query parameter has been replaced by the mutually exclusive after and before cursors, and the total and offset response fields have been replaced by has_more and next_cursor.

Request

string
Filter by pipeline type: batch or training
string
Filter by visibility: platform (visible to all orgs) or org (visible only to owning org)
string
Filter by registry status: draft, published, deactivated, or deleted
integer
default:"50"
Maximum number of pipelines to return. Minimum 1, maximum 1000. v1.1.11+
string
Forward cursor: return pipelines older than the pipeline with this ID. Pass the next_cursor of the previous page. Mutually exclusive with before; specifying both causes an HTTP 400 response. v1.1.11+
string
Backward cursor: return pipelines newer than the pipeline with this ID. Mutually exclusive with after; specifying both causes an HTTP 400 response. v1.1.11+

Response

The page is newest first in both cursor directions: results are ordered by created_at descending, with id descending as the tiebreak.
integer
Maximum number of items returned
boolean
True when more results exist beyond this page in the direction of travel. v1.1.11+
string
Cursor for the next page in the same direction — pass it as after when paging forward (the default), or as before when the request used before. null when has_more is false. v1.1.11+
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 — Map of input port name to port definition. Each port has name, description, mode (plain_file_list or n_shot_file_list), distribute (scatter or replicate), required (bool), and tracked (bool — whether files on this port participate in per-input lifecycle tracking; false for reference/n-shot ports)
  • outputs — Map of output port name to port definition (name, description)
  • 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