---
title: "Extend FindAll Run"
method: POST
path: "/v1beta/findall/runs/{findall_id}/extend"
tags: ["FindAll"]
---

# Extend FindAll Run

`POST /v1beta/findall/runs/{findall_id}/extend`

Extend a FindAll run by adding additional matches to the current match limit.

## Path parameters

- `findall_id` string, required

## Headers

- `parallel-beta` string, nullable

## Request body

- FindAllExtendInput — Input model for FindAll extend.
  - `additional_match_limit` integer, required — Additional number of matches to find for this FindAll run. This value will be added to the current match limit to determine the new total match limit. Must be greater than 0.

## 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

- `404` — FindAll run not found
- `422` — Additional match limit must be greater than 0

## Changes

- **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` — 3 breaking, 14 info
  - the `enrichments/anyOf[subschema #1]/items/output_schema` response's property type/format changed from ``/`` to `object`/`` for status `200`
  - the `error` response's property type/format changed from ``/`` to `object`/`` for status `404`
  - the `error` response's property type/format changed from ``/`` to `object`/`` for status `422`
  - added the optional property `enrichments/anyOf[subschema #1]/items/output_schema/type` to the response with the `200` status
  - …13 more
- **2025-11-13** `70ca78f3dbac` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/parallel-web/apis/parallel-api/changes/v1beta/findall/runs/:findall_id/extend/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)