Skip to main content
Welcome to the DataLinks API. These endpoints let you bring in data, connect it intelligently, and ask questions that yield grounded results. Expand any group in the left navigation to view its endpoints.

Typical end-to-end flow

  1. Create a dataset
    Use Create new dataset. Supplying a new namespace creates it implicitly.
    POST Create new dataset
  2. Ingest data
    Use Ingest data or the multipart flow for large files. Use Preview to check parsing before committing.
    POST Ingest data
    POST Preview
    Multipart flow:
    POST Prepare multipart upload
    POST Finish multipart upload
    POST Abort multipart upload
  3. Review links
    Use Load links and Preview links. Promote useful suggestions to active links with Add a new link or from the app UI. Rebuild links when data changes.
    GET Load links
    POST Preview links
    POST Add a new link
    POST Rebuild links
  4. Query
    Use Query data to retrieve grounded results across connected datasets.
    POST Query data

Notes and best practices

  • Namespaces: a namespace appears when you create the first dataset that references it.
  • Large files: prefer the multipart upload trio to improve reliability.
  • Performance: Rebuild links after large ingests so suggestions reflect the latest data.
If you’re looking for background to get started, see the explanatory articles for Ingest, Interconnect, and Inquire, then return here to try automating those steps using the API.