FindAll

Extend FindAll Run

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

post/v1beta/findall/runs/{findall_id}/extend

Path parameters

findall_idstring required

Headers

parallel-betastring nullable

Request body

additional_match_limitinteger 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

Successful Response

objectivestring required

Natural language objective of the FindAll run.

entity_typestring required

Type of the entity for the FindAll run.

generator'base' | 'core' | 'pro' | 'preview'

The generator of the FindAll run.

match_limitinteger nullable

Max number of candidates to evaluate

Example response

{
  "objective": "Find all AI companies that raised Series A funding in 2024",
  "match_conditions": [
    {
      "description": "Company must have SOC2 Type II certification (not Type I). Look for evidence in: trust centers, security/compliance pages, audit reports, or press releases specifically mentioning 'SOC2 Type II'. If no explicit SOC2 Type II mention is found, consider requirement not satisfied."
    }
  ],
  "enrichments": [
    {
      "output_schema": {
        "json_schema": {
          "additionalProperties": false,
          "properties": {
            "gdp": {
              "description": "GDP in USD for the year, formatted like '$3.1 trillion (2023)'",
              "type": "string"
            }
          },
          "required": [
            "gdp"
          ],
          "type": "object"
        }
      }
    }
  ]
}

Changes

Changed in 4 of the 21 revisions of this API.318

Jun 8, 2026973957d74ceb1See the full diff
- ○
  header request parameter parallel-beta was deprecated
  request-parameter-deprecated
Apr 21, 202657e1c56be0942See the full diff
- ○
  api tag FindAll added
  api-tag-added
- ○
  api tag FindAll API (Beta) removed
  api-tag-removed
This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jan 13, 2026105d778ad64d314See the full diff
- ▲
  the enrichments/anyOf[subschema #1]/items/output_schema response's property type/format changed from / to object/ for status 200
  response-property-type-changed
- ▲
  the error response's property type/format changed from / to object/ for status 404
  response-property-type-changed
- ▲
  the error response's property type/format changed from / to object/ for status 422
  response-property-type-changed
- ○
  added the optional property enrichments/anyOf[subschema #1]/items/output_schema/type to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property error/detail to the response with the 404 status
  response-optional-property-added
- ○
  added the optional property error/detail to the response with the 422 status
  response-optional-property-added
- ○
  removed Error from the error response property allOf list for the response status 404
  response-property-all-of-removed
- ○
  removed Error from the error response property allOf list for the response status 422
  response-property-all-of-removed
- ○
  removed JsonSchema from the enrichments/anyOf[subschema #1]/items/output_schema response property allOf list for the response status 200
  response-property-all-of-removed
- ○
  removed the error enum value from the type response property for the response status 404
  response-property-enum-value-removed
- ○
  removed the error enum value from the type response property for the response status 422
  response-property-enum-value-removed
- ○
  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
  response-property-enum-value-removed
- ○
  added the required property enrichments/anyOf[subschema #1]/items/output_schema/json_schema to the response with the 200 status
  response-required-property-added
- ○
  added the required property error/message to the response with the 404 status
  response-required-property-added
- ○
  added the required property error/message to the response with the 422 status
  response-required-property-added
- ○
  added the required property error/ref_id to the response with the 404 status
  response-required-property-added
- ○
  added the required property error/ref_id to the response with the 422 status
  response-required-property-added
This revision also has 19 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Nov 13, 202570ca78f3dbac1See the full diff
- ○
  endpoint added
  endpoint-added

Full history