---
title: "Ingest FindAll Run"
method: POST
path: "/v1beta/findall/ingest"
tags: ["FindAll"]
---

# Ingest FindAll Run

`POST /v1beta/findall/ingest`

Transforms a natural language search objective into a structured FindAll spec.

The generated specification serves as a suggested starting point and can be further
customized by the user.

## Headers

- `parallel-beta` string, nullable

## Request body

- IngestInput — Input model for FindAll ingest.
  - `objective` string, required — Natural language objective to create a FindAll run spec.

## Response `200`

Successful Response

- FindAllSchema — Response model for FindAll ingest.
  - `objective` string, required — Natural language objective of the FindAll run.
  - `entity_type` string, required — Type of the entity for the FindAll run.
  - `match_conditions` MatchCondition[], required — List of match conditions for the FindAll run.
    - `name` string, required — Name of the match condition.
    - `description` string, required — Detailed description of the match condition. Include as much specific information as possible to help improve the quality and accuracy of Find All run results.
  - `enrichments` FindAllEnrichInput[], nullable — List of enrichment inputs for the FindAll run.
    - `processor` string — Processor to use for the task.
    - `output_schema` JsonSchema, required — JSON schema for a task input or output.
      - `json_schema` object, required — A JSON Schema object. Only a subset of JSON Schema is supported.
      - `type` 'json' — The type of schema being defined. Always `json`.
    - `mcp_servers` McpServer[], nullable — List of MCP servers to use for the task.
      - `type` 'url' — Type of MCP server being configured. Always `url`.
      - `url` string, required — URL of the MCP server.
      - `headers` object, nullable — Headers for the MCP server.
      - `name` string, required — Name of the MCP server.
      - `allowed_tools` string[], nullable — List of allowed tools for the MCP server.
  - `generator` 'base' | 'core' | 'pro' | 'preview' — The generator of the FindAll run.
  - `match_limit` integer, nullable — Max number of candidates to evaluate

## Other responses

- `422` — Validation Error

## Changes

> 21 revisions in range; 2 could not be searched.

- **2026-06-08** `973957d74ceb` — 1 info
  - `header` request parameter `parallel-beta` was deprecated
- **2026-04-21** `57e1c56be094` — 2 info
  - api tag `FindAll` added
  - api tag `FindAll API (Beta)` removed
- **2026-01-13** `105d778ad64d` — 1 breaking, 4 info
  - the `enrichments/anyOf[subschema #1]/items/output_schema` response's property type/format changed from ``/`` to `object`/`` for status `200`
  - added the optional property `enrichments/anyOf[subschema #1]/items/output_schema/type` to the response with the `200` status
  - removed `#/components/schemas/JsonSchema` from the `enrichments/anyOf[subschema #1]/items/output_schema` response property `allOf` list for the response status `200`
  - removed the `url` enum value from the `enrichments/anyOf[subschema #1]/items/mcp_servers/anyOf[subschema #1]/items/type` response property for the response status `200`
  - …1 more
- **2025-11-13** `70ca78f3dbac` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/parallel-web/apis/parallel-api/changes/v1beta/findall/ingest/post.md)

---

[API](https://skmtc.dev/parallel-web/apis/parallel-api.md) · [All operations](https://skmtc.dev/parallel-web/apis/parallel-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/parallel-web/parallel-api/revisions/1595294c8795/schema)