--- title: "Start Incubator Batch" method: POST path: "/api/incubator-batch/start" tags: ["growth-artifact-jobs"] --- # Start Incubator Batch `POST /api/incubator-batch/start` ## Request - Base URL: `https://platform.verbiflow.com/api/bridge` - URL: `https://platform.verbiflow.com/api/bridge/api/incubator-batch/start` - Auth: one of: - HTTP bearer and API key in header `x-flage-org-id` - HTTP bearer and API key in header `x-flage-org-slug` ## Request body - StartIncubatorBatchRequest - `batch_ids` string[], required - `contract_version` 'incubator-batch.v2', required - `incubator_name` string, required - `max_companies` integer - `result_mode` 'companies' ## Response `200` Successful Response - StartIncubatorBatchResponse - `accepted_pricing` AcceptedJobPricing, required: Immutable rule used to rate this job; final usage determines the actual charge. - `basis` 'none' | 'successful_execution' | 'successful_provider_attempt' | 'requested_record' | 'delivered_record' | 'successful_record' | 'provider_unit' | 'provider_cost_usd' | 'resolver_reported', required - `billing_owner` 'none' | 'growth_capability' | 'source_execution' | 'enrichment_reservation', required - `credits_per_unit` string, required: Exact Decimal customer-credit rate per unit, encoded as a string. This is not the final charge. - `pricing_version` string, required: Immutable published rate-book revision captured when the job was admitted. - `unit` string, required: Unit counted by basis, such as a record or execution. - `artifact_id` string, required: Durable artifact identity when admitted. - `execution_contract_digest` string, required: Reviewed execution-contract digest. - `execution_id` string, required: Accounting execution identity. - `failed` boolean, required: Whether the terminal snapshot failed. - `finished` boolean, required: Whether this snapshot is terminal. - `generation_id` string, required: Immutable semantic output generation identity. - `job_id` string, required: Durable status and progress identity. - `operation_key` string, required: Stable logical call identity within the managed run. - `phase` string, required: Latest persisted execution phase. - `progress_current` integer, required: Rows committed or current work-unit progress. - `progress_total` integer, required: Known work-unit total when available. - `request_digest` string, required: Digest of the admitted request. - `result_kind` 'incubator_batch_companies', required: Typed result discriminator once persisted. - `rows` IncubatorCompanyRow[], required: Bounded committed preview; the artifact owns the complete rows. - `batch_id` string, required: Exact cohort or batch id. - `company_country` string, required: Observed company country text. - `company_description` string, required: Best available long company description. - `company_domain` string, required: Normalized domain when the website could be resolved. - `company_employee_count` union, required: Observed team size; empty string means unavailable. - integer - string - `company_industry` string, required: Observed company industry label. - `company_linkedin_url` string, required: Observed LinkedIn company URL. - `company_location` string, required: Observed company location text. - `company_logo_url` string, required: Observed company logo URL. - `company_name` string, required: Observed company name. - `company_short_description` string, required: Observed one-line company description. - `company_tags` string, required: JSON-encoded source tag array in the artifact row. - `company_website` string, required: Observed company website URL. - `incubator_name` string, required: Canonical incubator/accelerator name. - `incubator_row_id` string, required: Persisted source-row identity in the incubator catalog. - `row_identifier` string, required: Stable row key; normally the persisted incubator row id. - `semantic_fingerprint` string, required: Semantic request fingerprint, populated by durable admission. - `source_digest` string, nullable, required: Managed runner source-snapshot digest when available. - `status` 'queued' | 'running' | 'blocked' | 'completed' | 'failed', required: Latest persisted lifecycle status in this snapshot. - `summary` IncubatorBatchProgress, required: Incremental admission and work metadata; fields appear as work commits. - `accepted_pricing` AcceptedJobPricing, required: Immutable rule used to rate this job; final usage determines the actual charge. - `basis` 'none' | 'successful_execution' | 'successful_provider_attempt' | 'requested_record' | 'delivered_record' | 'successful_record' | 'provider_unit' | 'provider_cost_usd' | 'resolver_reported', required - `billing_owner` 'none' | 'growth_capability' | 'source_execution' | 'enrichment_reservation', required - `credits_per_unit` string, required: Exact Decimal customer-credit rate per unit, encoded as a string. This is not the final charge. - `pricing_version` string, required: Immutable published rate-book revision captured when the job was admitted. - `unit` string, required: Unit counted by basis, such as a record or execution. - `artifact_id` string, required: Durable artifact containing committed rows. - `auth_scope_id` string, nullable, required: Authorization scope used to access this artifact. - `batch_ids` string[], required: Exact selected cohorts. - `capability_id` 'incubator.batch_companies', required: Capability responsible for the work. - `columns` string[], required: Ordered committed artifact column names. - `company` integer, required: Company rows committed. - `completeness` 'complete' | 'capped', required: Complete means source exhaustion; capped means the company limit stopped collection. - `contact` integer, required: Contact rows; zero for company-only jobs. - `contact_error` integer, required: Contact errors; zero for company-only jobs. - `contact_skip` integer, required: Contact skips; zero for company-only jobs. - `error` string, required: Persisted failure explanation when work failed. - `execution_contract_digest` string, required: Digest of the pinned execution contract. - `generation_id` string, required: Immutable result generation identity. - `incubator_name` string, required: Canonical selected incubator. - `max_companies` integer, required: Admitted row ceiling. - `max_contacts` integer, required: Contact ceiling; zero for company-only jobs. - `max_per_company` integer, required: Contact-per-company ceiling; zero for company-only jobs. - `operation_key` string, required: Stable logical operation identity. - `processed_rows` integer, required: Source rows processed so far. - `replayed` boolean, required: Whether admission adopted an existing logical job. - `request_digest` string, required: Digest of the admitted provider request. - `requested_units` integer, required: Work units admitted before execution. - `result_kind` 'incubator_batch_companies', required: Terminal result discriminator. - `result_manifest_digest` string, required: Digest of the committed terminal result manifest. - `result_mode` 'companies', required: Public cohort jobs return companies. - `row_count` integer, required: Company rows committed. - `semantic_fingerprint` string, required: Digest of the canonical business request. - `source_digest` string, nullable, required: Optional managed source-snapshot digest. - `target_title_tags` string[], required: Contact-title scope; empty for company-only jobs. - `terminal_result` boolean, required: Whether the producer committed its terminal result. - `termination` 'source_exhausted' | 'max_companies_reached', required: Why collection stopped. - `tool_kind` 'incubator_batch', required: Artifact producer identity. - `workflow_status` unknown, required ## Other responses - `422`: Validation Error --- [API](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract.md) - [All operations](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/llms.txt) - [OpenAPI document](https://skmtc.dev/verbiflow/apis/verbiflow-sdk-http-contract/revisions/c80e903ef8f3?raw)