Skip to main content
POST
/
v1beta
/
findall
/
runs
/
{findall_id}
/
enrich
Python
from parallel import Parallel

client = Parallel(api_key="API Key")

class CompanyEnrichment(BaseModel):
    ceo_name: str = Field(
        description="Name of the CEO"
    )
    founding_year: str = Field(
        description="Year the company was founded"
    )

run = client.beta.findall.enrich(
    findall_id="findall_40e0ab8c10754be0b7a16477abb38a2f",
    processor="core",
    output_schema=CompanyEnrichment
)

print(f"FindAll run {run.findall_id} enriched: {run.model_dump_json(indent=2)}")
{
  "objective": "<string>",
  "entity_type": "<string>",
  "match_conditions": [
    {
      "name": "<string>",
      "description": "<string>"
    }
  ],
  "enrichments": [
    {
      "output_schema": {
        "json_schema": {},
        "type": "json"
      },
      "processor": "core",
      "mcp_servers": [
        {
          "url": "<string>",
          "name": "<string>",
          "type": "url",
          "headers": {},
          "allowed_tools": [
            "<string>"
          ]
        }
      ]
    }
  ],
  "generator": "core",
  "match_limit": 123
}

Authorizations

x-api-key
string
header
required

Headers

parallel-beta
string | null

Path Parameters

findall_id
string
required

Body

application/json

Input model for FindAll enrich.

output_schema
JsonSchema · object
required

JSON schema for the enrichment output schema for the FindAll run.

processor
string
default:core

Processor to use for the task.

mcp_servers
McpServer · object[] | null

List of MCP servers to use for the task.

Response

Successful Response

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 · object[]
required

List of match conditions for the FindAll run.

enrichments
FindAllEnrichInput · object[] | null

List of enrichment inputs for the FindAll run.

generator
enum<string>
default:core

The generator of the FindAll run.

Available options:
base,
core,
pro,
preview
match_limit
integer | null

Max number of candidates to evaluate