Repair Data

Start Mosaic CSV healing

Changed on

Starts an asynchronous Mosaic job that heals and enriches an arbitrary CSV, TXT, XLSX, or public Google Sheet. Pass a public HTTPS URL (Google Drive / Sheets, Dropbox, OneDrive, or a direct file link). The file is securely fetched and stored before processing. Credits are charged inside the background job after the file is parsed (based on row count and selected options). The first Mosaic run for an organization may be a free trial (first 1,000 rows free; overage billed against normal credits). Use the polling endpoint with the returned run ID to retrieve status and download links.

<span>⚡ <strong>Rate limit:</strong> 20 requests per 1 minute</span>

<span>💰 <strong>Cost:</strong> Credits are charged after the file is parsed inside the background job. Cost is based on the number of billable rows plus any optional enrichments (contact details, company details) you enable. The first Mosaic run for an organization may be a free trial (first 1,000 rows free; overage billed against normal credits). <span title="Pricing shown is default pricing. Actual pricing may vary. Final charge depends on parsed row count and the options you select.">ⓘ</span></span>

post/v1/mosaic/start

Request

  • Base URL
    https://api.fiber.ai
  • URL
    https://api.fiber.ai/v1/mosaic/start
  • Auth
    none declared

Request body

apiKeystring required

Your Fiber API key

sourceUrlstring uri required

HTTPS URL of the input file. Supported formats: CSV, TXT (one LinkedIn profile URL per line), XLSX, or a public Google Sheet. You may also pass a public Google Drive file link, Dropbox share link, or OneDrive / SharePoint share link. The link must be publicly accessible (e.g. Google Sheets / Drive: "Anyone with the link can view"; Dropbox / OneDrive: link allows direct download) or the fetch will fail. Google Sheets export the first tab only. For XLSX workbooks we auto-detect the most likely worksheet and header row; if detection is unavailable we use the sheet with the most rows and treat row 1 as the header. Maximum file size is 50 MiB. The file is securely fetched and stored before processing.

customInstructionsstring nullable

Optional additional instructions for the AI on top of our system prompt — not a replacement for it. Use this to steer enrichment when your file needs extra context. Examples: "I really want personal emails but I don't care about phones"; "These are all doctors — make sure you get office phones, not home phones".

Response

Default Response

advicestring[] nullable

Tips, recommendations, and suggestions for using this API effectively.

Changes

    • warning

      the / request property's max was set to 20000.00

    • warning

      removed the request property

    • info

      added the new optional request property

    • info

      the request property / became nullable

    • breaking

      the response property became nullable for the status

    • breaking

      the response property became optional for the status

    • info

      the response's property default value was removed for the status