# G-Forge Select CSV Columns

> G-Forge Select CSV Columns is a paid API for AI agents from api.getretold.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-24).

Selects and reorders a specified subset of named columns from CSV text, returning a clean CSV with only those columns.

## Facts

- Endpoint: POST https://api.getretold.com/services/agent-auto-launch-csv-columns/invoke?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-24
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/g-forge-select-csv-columns-d135b02e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_sHKw3M-msRkrAhzDDHVJX

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 g-forge-select-csv-columns-d135b02e -d '<json body>'
```

Example prompt: Take this CSV text and give me back a new CSV with only the 'name', 'email', and 'signup_date' columns — in that order.

## When to prefer this

Choose this endpoint when you need to quickly reduce a CSV to a known set of named columns and optionally reorder them, especially in agent pipelines where downstream APIs or spreadsheets expect a specific column layout. It is purpose-built for CSV column selection with strict validation of missing columns, making it safer than generic text manipulation. Prefer it over JSON field projection endpoints when your data is already in CSV form.

## Known failure modes

- Requested column name not found in CSV header — request rejected with error listing the missing column
- Malformed CSV input that cannot be parsed — returns error
- Fewer than 1 or more than 32 column names specified — schema validation error
- Empty CSV with no rows — may return header-only output or error
- Column names are case-sensitive mismatches — rejected as missing

## How this service works

Create a focused CSV export with only the columns you need. Select and reorder 1–32 named columns from supplied CSV text. Preserves row order and decoded cell text, then writes correctly quoted CSV. Missing columns are rejected. Useful for cleaner spreadsheet and API handoffs.

## Output

A correctly quoted CSV string containing only the requested columns in the specified order, with all original rows preserved and cell text decoded. Missing column names cause the request to be rejected with an error.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "value": {
   "type": "object",
   "required": [
    "csv",
    "fields"
   ],
   "properties": {
    "csv": {
     "type": "string"
    },
    "fields": {
     "type": "array",
     "items": {
      "type": "string"
     },
     "maxItems": 32,
     "minItems": 1
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/g-forge-select-csv-columns-d135b02e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.getretold.com](https://www.zero.xyz/host/api.getretold.com/llms.txt)