# Estimate records count for all structures using three-tier resolution (request -> job overrides -> dataset baseline). Read-only; does not persist anything. Empty request returns estimates based on job overrides and dataset baseline.

Endpoint: POST /synthetic/jobs/{syntheticJobId}/records-count/estimate
Version: 3.30.0
Security: ApiKeyAuth

## Security:

  - `ApiKeyAuth` (unknown)
    apiKey in header Authorization

## Path parameters:

  - `syntheticJobId` (string, required)
    The ID of the synthetic data generation job.

## Request body:

  - `application/json` (unknown)
    Optional request-level overrides. Empty object is valid.

## Request fields (application/json):

  - `structures` (array)
    List of structure records count updates. Each item must set either records_count (for top-level structures) or records_count_multiplier (for child structures), not both.

  - `structures.structure_id` (string, required)
    The id of the structure to update.
    Example: 101

  - `structures.records_count` (integer)
    Absolute record count. Only valid for top-level structures (parent_structure_id IS NULL). Minimum value is 0.
    Example: 5000

  - `structures.records_count_multiplier` (number)
    Ratio of child records to parent records. Only valid for child structures (parent_structure_id IS NOT NULL). Minimum value is 0.
    Example: 3.5

## Response 200:

  - `200` (unknown)
    Estimated records counts for all structures using three-tier resolution.

## Response 200 fields (application/json):

  - `dataset_total_records_estimate` (integer)
    Sum of estimated records counts across all structures in the dataset.
    Example: 22500

  - `structures` (array)
    Estimated records count details for every structure in the dataset.

  - `structures.structure_id` (string)
    The id of the structure.
    Example: 101

  - `structures.structure_name` (string)
    The name of the structure.
    Example: orders

  - `structures.records_count` (integer)
    Estimated number of records to be generated for this structure.
    Example: 5000

  - `structures.records_count_multiplier` (number)
    The effective multiplier applied (null for top-level structures).
    Example: 2.5

  - `structures.parent_structure_id` (string)
    The id of the immediate parent structure. Null for top-level structures.
    Example: 10

  - `structures.parent_structure_name` (string)
    The name of the immediate parent structure. Null for top-level structures.
    Example: customers

  - `structures.parent_schema_name` (string)
    The schema name of the parent structure's connector mapping for child structures; own schema name for top-level structures.
    Example: public

  - `structures.connector_name` (string)
    The name of the connector this structure belongs to. Null if no connector mapping exists.
    Example: source-db