# Pipe0 Allowlisted Workflow Pass-Through (pipes/run/sync)

> Pipe0 Allowlisted Workflow Pass-Through (pipes/run/sync) is a paid API for AI agents from pipe0.withzero.xyz, paid per call via MPP, $0.01/call, status unknown (last checked 2026-09-15).

Executes allowlisted Pipe0-native composable workflow pipelines synchronously via POST /v1/pipes/run/sync, settling at cost based on bounded pipe/input estimates.

## Facts

- Endpoint: POST https://pipe0.withzero.xyz/api/v1/pipes/run/sync
- Price: $0.01/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Provider: pipe0.withzero.xyz
- Website: https://pipe0.withzero.xyz
- Canonical page: https://www.zero.xyz/c/pipe0-withzero-xyz-pipe0-allowlisted-workflow-pass-through-pipes-run-a70a29ae
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xTMuv1WTWQHsBJd4qKhMp

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability pipe0-withzero-xyz-pipe0-allowlisted-workflow-pass-through-pipes-run-a70a29ae -d '<json body>'
```

Example prompt: Run a Pipe0 sync workflow using pipe IDs 'company:identity@2' and 'company:overview@2' against these 3 company records (ids: 1, 2, 3) in production mode — it's a custom composable pipeline not available directly through Crustdata.

## When to prefer this

Use this endpoint when you need to run a Pipe0-native composable workflow that is not exposed as a direct named endpoint (e.g. not company:identity, company:overview, or companies:profiles:crustdata search). Prefer this over individual Crustdata or Wiza endpoints when your use case requires chaining multiple Pipe0 pipes in a single synchronous call, or when you need access to a pipe_id that only exists natively in Pipe0. Not suitable for search-type workflows (use the search pass-through instead).

## Known failure modes

- Pipe ID not in allowlist — request rejected with error indicating unauthorized pipe_id
- Input array empty or exceeds 25 items — schema validation failure
- Pipes array empty or exceeds 5 items — schema validation failure
- Pipe0 upstream error — raw error propagated from Pipe0 API
- Invalid environment enum value — schema validation error
- Pipe0 credits exhausted — upstream rejection returned in response
- Missing required 'id' field in input records — validation error

## How this service works

Composable Pipe0-native workflow pass-through for allowlisted pipe IDs only. Runs POST /v1/pipes/run/sync for workflows that are not exposed directly by Crustdata or Wiza. Settles at cost from the bounded pipe/input estimate because Pipe0 does not return actual credits charged.

## Output

Returns a JSON object with 'data' (raw Pipe0 response for all processed records) and 'billing' (pipe0Credits used, maxPipe0Credits, planUsdcMicro, planCredits, pricingVersion, settledUsdcMicro) so the caller can audit cost and credit consumption.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "example": {
  "input": [
   {
    "id": "1",
    "company_name": "Acme"
   }
  ],
  "pipes": [
   {
    "pipe_id": "company:identity@3"
   }
  ]
 },
 "required": [
  "pipes",
  "input"
 ],
 "properties": {
  "input": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "id"
    ],
    "properties": {
     "id": {
      "anyOf": [
       {
        "type": "string",
        "minLength": 1
       },
       {
        "type": "number"
       }
      ],
      "description": "Unique record id within this Pipe0 request."
     }
    },
    "additionalProperties": {}
   },
   "maxItems": 1,
   "minItems": 1
  },
  "pipes": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "pipe_id"
    ],
    "properties": {
     "config": {
      "type": "object",
      "propertyNames": {
       "type": "string"
      },
      "additionalProperties": {}
     },
     "run_if": {},
     "pipe_id": {
      "type": "string",
      "minLength": 1,
      "description": "Pipe0 pipe id, for example company:identity@3."
     },
     "connector": {}
    },
    "additionalProperties": {}
   },
   "maxItems": 1,
   "minItems": 1
  },
  "config": {
   "type": "object",
   "properties": {
    "widgets": {
     "type": "object",
     "propertyNames": {
      "type": "string"
     },
     "additionalProperties": {}
    },
    "environment": {
     "enum": [
      "production",
      "sandbox"
     ],
     "type": "string",
     "description": "Pipe0 environment. Production consumes Pipe0 credits; sandbox uses mock/test behavior."
    },
    "field_definitions": {
     "type": "object",
     "propertyNames": {
      "type": "string"
     },
     "additionalProperties": {}
    }
   },
   "additionalProperties": {}
  },
  "scopes": {
   "type": "array",
   "items": {
    "type": "string",
    "minLength": 1
   }
  },
  "field_annotations": {
   "type": "object",
   "propertyNames": {
    "type": "string"
   },
   "additionalProperties": {}
  }
 },
 "additionalProperties": {}
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "data",
  "billing"
 ],
 "properties": {
  "data": {
   "description": "Raw JSON response returned by Pipe0."
  },
  "billing": {
   "type": "object",
   "required": [
    "pipe0Credits",
    "maxPipe0Credits",
    "planUsdcMicro",
    "planCredits",
    "pricingVersion",
    "settledUsdcMicro"
   ],
   "properties": {
    "planCredits": {
     "type": "string"
    },
    "pipe0Credits": {
     "type": "number"
    },
    "planUsdcMicro": {
     "type": "string"
    },
    "pricingVersion": {
     "type": "number"
    },
    "maxPipe0Credits": {
     "type": "number"
    },
    "settledUsdcMicro": {
     "type": "string"
    }
   },
   "additionalProperties": false
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/pipe0-withzero-xyz-pipe0-allowlisted-workflow-pass-through-pipes-run-a70a29ae/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from pipe0.withzero.xyz](https://www.zero.xyz/host/pipe0.withzero.xyz/llms.txt)