> ## Documentation Index > Fetch the complete documentation index at: https://syncupai-robbalian-cleanup-deprecated-docs.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Reprocess a batch > Reprocess jobs in a specific batch. You can specify which attributes to process by providing: - 'attributes': A list of specific attributes to enrich (e.g., ["websites", "phoneNumbers", "categories"]) If not provided, "core" attributes will be processed: websites, phoneNumbers, openingHours, names, address, categories, placekey, closed_permanently Options: - failed_only: When true, only reprocess jobs with 'failed' status. When false, reprocess all jobs in the batch. - incomplete_only: When true, only reprocess jobs with 'pending' or 'in_progress' status. When false, reprocess all jobs in the batch (unless failed_only is true). ## OpenAPI ````yaml /openapi-v1.json post /place_enrichment/batches/{batch_id}/reprocess openapi: 3.1.0 info: title: Reprompt Place Enrichment API description: > ## Batch Processing Guide The `/place_enrichment/batches` endpoint allows you to submit multiple places in a single batch for attribute enrichment. The batch will be processed asynchronously, and you can track its status using the returned batch ID. #### Typical workflow: 1. Prepare your batch payload with: - A unique batch name for identification - List of places with their IDs and input data - Optional attribute set specification 2. Submit the batch using the POST `/place_enrichment/batches` endpoint 3. Use the returned batch ID to: - Check batch status at GET `/place_enrichment/batches/{batch_id}` - Retrieve results at GET `/place_enrichment/jobs?batchId={batch_id}` #### Submitting a Batch: Use POST `/place_enrichment/batches` to submit a batch. **Example Batch Payload:** ```json { "batch_name": "NYC Restaurants March 2024", "attributes": ["websites", "phoneNumbers", "socialHandles", "openingHours", "categories", "closed_permanently"], "jobs": [ { "place_id": "place_nyc_123", "inputs": { "name": "Joe's Pizza", "latitude": 40.7359, "longitude": -73.9911, "full_address": "7 Carmine St, New York, NY 10014", "street": "Carmine St", "city": "New York", "state": "NY", "postalCode": "10014", "house": "7", "country": "United States", "country_code": "US", "type": "restaurant", "website": "http://www.joespizzanyc.com", "phone": "+12122555803" } } ] } ``` **Place Input Parameters:** For more details on the place input parameters, see the ```UniversalPlace``` schema in the schemas section below. **Attributes:** The `attributes` parameter in your request specifies which attributes will be enriched. You can specify individual attributes like: - `["websites", "phoneNumbers"]` - Only enrich website and phone information - `["closed_permanently"]` - Only check if the business is permanently closed - `["websites", "phoneNumbers", "socialHandles", "openingHours", "categories", "closed_permanently"]` - Core business attributes - `["websites", "phoneNumbers", "socialHandles", "openingHours", "categories", "closed_permanently", "cuisine", "price_tier", "user_reviews", "menu_url"]` - Comprehensive enrichment For a full list of available attributes, see the enrichment schema documentation below. #### Tracking Batch Status: Use GET `/place_enrichment/batches/{batch_id}` to monitor the progress of your batch. The response includes: ```json { "id": "batch_2024_03_15_123456", "batch_name": "NYC Restaurants March 2024", "status": "in_progress", "jobs": { "pending": ["place_id_2", "place_id_3"], "in_progress": ["place_id_1"], "completed": ["place_id_4", "place_id_5"], "failed": [] }, "created_at": "2024-03-15T10:30:00Z", "updated_at": "2024-03-15T10:35:00Z" } ``` The status field will be one of: - `pending`: Batch is queued but not yet started - `in_progress`: Batch is currently being processed - `completed`: All jobs in the batch are finished - `failed`: Batch encountered critical errors #### Retrieving Job Results: Once jobs are completed, use GET `/place_enrichment/jobs?batchId={batch_id}` to get the enrichment results. The response includes: ```json { "jobs": [ { "place_id": "place_nyc_123", "status": "completed", "outputs": { "website": "https://www.joespizzanyc.com", "phone": "+12122555803", "social_profiles": { "instagram": "joespizzanyc", "facebook": "joespizzanyc" }, "open_closed_status": "Open", "price_tier": "$$", "last_enriched": "2024-03-15T10:35:00Z" }, "job_metadata": { "created_at": "2024-03-15T10:30:00Z", "completed_at": "2024-03-15T10:35:00Z", "processing_time_seconds": 300 } } ], "total_count": 1, "completed_count": 1 } ``` Each job result includes: - Original place ID for tracking - Enrichment outputs based on the requested attribute set - Job metadata including timing information - Processing status and any error details if failed **Attribute Statuses:** Attributes like name, address, phone number, and website include an `attribute_status` field indicating the verification state: | Status | Description | |--------|-------------| | NOT_RUN | The attribute was not processed | | RUN_CONDITION_FAILED | The attribute was processed but failed the run condition | | RUN | The attribute was processed | | ERROR | The attribute processing failed | Example response with attribute statuses: ```json { "outputs": { "website": "https://www.joespizzanyc.com", "phone": "+12122555803" }, "job_metadata": { "attribute_status": { "website": "RUN", "phone": "RUN", "address": "RUN", "name": "RUN" } } } ``` version: '1.0' servers: - url: https://api.repromptai.com/v1/{org} variables: org: default: reprompt description: The organization slug to use for the API security: [] paths: /place_enrichment/batches/{batch_id}/reprocess: post: tags: - batches summary: Reprocess a batch description: >- Reprocess jobs in a specific batch. You can specify which attributes to process by providing: - 'attributes': A list of specific attributes to enrich (e.g., ["websites", "phoneNumbers", "categories"]) If not provided, "core" attributes will be processed: websites, phoneNumbers, openingHours, names, address, categories, placekey, closed_permanently Options: - failed_only: When true, only reprocess jobs with 'failed' status. When false, reprocess all jobs in the batch. - incomplete_only: When true, only reprocess jobs with 'pending' or 'in_progress' status. When false, reprocess all jobs in the batch (unless failed_only is true). operationId: >- reprocess_batch_endpoint__org_slug__place_enrichment_batches__batch_id__reprocess_post parameters: - name: batch_id in: path required: true schema: type: string title: Batch Id - name: apiKey in: header required: false schema: anyOf: - type: string - type: 'null' title: Apikey requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/ReprocessBatchRequest' properties: failed_only: type: boolean description: >- When true, only reprocess jobs with 'failed' status. When false, reprocess all jobs in the batch. default: true incomplete_only: type: boolean description: >- When true, only reprocess jobs with 'pending' or 'in_progress' status. When false, reprocess all jobs in the batch (unless failed_only is true). default: false refresh: type: boolean description: When true, force fresh enrichment ignoring cached data. default: false attributes: type: array items: type: string description: >- List of specific attributes to enrich (e.g. 'websites', 'phoneNumbers'). example: failed_only: true incomplete_only: false refresh: false attributes: - websites - phoneNumbers - categories use_turbo: true responses: '200': description: Successfully initiated batch reprocessing content: application/json: schema: {} example: status: success message: >- Started reprocessing 42 FAILED jobs from batch batch_2024_04_01_123456 job_count: 42 batch_id: batch_2024_04_01_123456 excluded_deferred_count: 5 '400': description: No jobs found in batch '401': description: Invalid API credentials '404': description: Batch not found security: - HTTPBearer: [] components: schemas: ReprocessBatchRequest: properties: failed_only: type: boolean title: Failed Only description: >- When true, only reprocess jobs with 'failed' status. When false, reprocess all jobs in the batch. default: true incomplete_only: type: boolean title: Incomplete Only description: >- When true, only reprocess jobs with 'pending', 'queued' or 'in_progress' status. When false, reprocess all jobs in the batch (unless failed_only is true). default: false refresh: type: boolean title: Refresh description: When true, force fresh enrichment ignoring cached data. default: false attributes: anyOf: - items: type: string type: array - type: 'null' title: Attributes description: >- List of specific attributes to enrich (e.g. 'websites', 'phoneNumbers'). If provided, overrides attribute_set. attribute_set: anyOf: - type: string - type: 'null' title: Attribute Set description: >- Predefined group of attributes to enrich: 'core', 'all', or 'open_closed' use_previous_invocation_params: type: boolean title: Use Previous Invocation Params description: >- When true, use the parameters from the last invocation for each job. Attributes passed in this request will be ignored. default: false use_turbo: type: boolean title: Use Turbo description: When true, use the turbo queue for processing. default: true type: object title: ReprocessBatchRequest securitySchemes: HTTPBearer: type: http scheme: bearer ````