# Documentation - [DataLinks Docs and API/SDK Resources](https://docs.landfall.ai/index.md): Access the tools and guides you need to build and explore connected data using DataLinks. - [Introduction to DataLinks](https://docs.landfall.ai/get-started/intro-datalinks.md) - [DataLinks Web Platform QuickStart Guide](https://docs.landfall.ai/get-started/quickstart.md): Learn how to ingest data, view connections, and query using the DataLinks web platform. - [DataLinks API/SDK QuickStart Guide](https://docs.landfall.ai/get-started/quickstart-api.md): Learn how to ingest data, view connections, and query using both the DataLinks web platform and API. - [How To Create a New Dataset](https://docs.landfall.ai/how-to/create-dataset.md): Create a new dataset using the DataLinks web platform or API. - [How To Create a New Namespace](https://docs.landfall.ai/how-to/create-namespace.md) - [How to Get a DataLinks API Token](https://docs.landfall.ai/how-to/get-api-token.md): Connect third-party applications to DataLinks using a token. - [How To Share a Dataset or Namespace](https://docs.landfall.ai/how-to/share-data.md): Grant another DataLinks user read or write access to your data. - [How To View and Manage Connections](https://docs.landfall.ai/how-to/manage-connections.md) - [How to Use AutoRAG to query data](https://docs.landfall.ai/how-to/use-autorag.md) - [How To Query Your Data](https://docs.landfall.ai/how-to/query-data.md) - [How to Connect DataLinks to a Third-Party Web App Builder](https://docs.landfall.ai/how-to/connect-app-builder.md): Learn how to connect DataLinks to your preferred web app builder. - [How to Connect to the DataLinks MCP Server (General Guide)](https://docs.landfall.ai/mcp/general-mcp.md): General instructions on how to connect to the DataLinks MCP server - [DataLinks Docs MCP Server](https://docs.landfall.ai/mcp/docs-mcp.md): Access the DataLinks docs via MCP as well as the AP - [How to Connect Claude Desktop to the DataLinks MCP Server](https://docs.landfall.ai/mcp/claude-desktop.md): Learn how to connect to the DataLinks server using Claude Desktop. - [Connect an Agent to DataLinks over A2A](https://docs.landfall.ai/a2a/general-a2a.md): Connect any A2A-compliant client or agent framework to a DataLinks agent using the Agent2Agent protocol. - [Understanding the UI: Home Page](https://docs.landfall.ai/ui/home.md): Move between tasks quickly, review your recent activity, and navigate to other areas of the platform - [Understanding the UI: Create a New Dataset](https://docs.landfall.ai/ui/new-dataset.md): The Create a new dataset window defines the properties of your new dataset - [Understanding the UI: Connections Overview](https://docs.landfall.ai/ui/ontology-explorer.md): View and manage connections at the namespace level. - [Understanding the UI: Settings](https://docs.landfall.ai/ui/settings.md): Find your official DataLinks username and generate API tokens. - [AI Inference](https://docs.landfall.ai/reference/ai_inference.md) - [Automodeler](https://docs.landfall.ai/reference/automodeler.md) - [Query Language](https://docs.landfall.ai/reference/query_commands.md) - [A2A Protocol Reference](https://docs.landfall.ai/reference/a2a-protocol.md): Endpoints, AgentCard, agent catalog, and streaming event types for the DataLinks Agent2Agent (A2A) interface. - [Datasets and Namespaces](https://docs.landfall.ai/concepts/datasets-namespaces.md) - [Data Ingestion and Cleaning](https://docs.landfall.ai/concepts/ingest-clean.md) - [Interconnection (Knowledge Maps)](https://docs.landfall.ai/concepts/interconnection.md) - [Querying Data and Insights](https://docs.landfall.ai/concepts/query-insights.md) - [API Reference](https://docs.landfall.ai/api-reference/index.md) - [List the agents exposed over A2A](https://docs.landfall.ai/api-reference/a2a/list-the-agents-exposed-over-a2a.md): Convenience listing of the available A2A agents and their AgentCard URLs. Public, no authentication. - [Fetch an agent's AgentCard](https://docs.landfall.ai/api-reference/a2a/fetch-an-agents-agentcard.md): Returns the A2A AgentCard describing the agent's skills, capabilities, security schemes and JSON-RPC endpoint. Public (unauthenticated) discovery document. - [A2A JSON-RPC endpoint for an agent](https://docs.landfall.ai/api-reference/a2a/a2a-json-rpc-endpoint-for-an-agent.md): JSON-RPC 2.0 endpoint implementing the A2A methods `SendMessage`, `SendStreamingMessage`, `GetTask`, `CancelTask` and `GetExtendedAgentCard`. `SendStreamingMessage` responds with `text/event-stream`; the others with a single JSON-RPC response. `GetExtendedAgentCard` returns the authenticated, richer… - [Get code files for a cleaning task](https://docs.landfall.ai/api-reference/agents/get-code-files-for-a-cleaning-task.md): Retrieve metadata for all code files generated by the cleaning agent for the specified task. - [Request cleaning on a dataset](https://docs.landfall.ai/api-reference/agents/request-cleaning-on-a-dataset.md): Request a cleaning job for the specified dataset. - [Fetch datasets](https://docs.landfall.ai/api-reference/datasets/fetch-datasets.md): Retrieve all available datasets. - [Fetch datasets in namespace](https://docs.landfall.ai/api-reference/datasets/fetch-datasets-in-namespace.md): Retrieve all datasets for the specified namespace. - [List ingestions for a dataset](https://docs.landfall.ai/api-reference/data/list-ingestions-for-a-dataset.md): Lists ingestion attempts for a dataset. - [Get dataset information](https://docs.landfall.ai/api-reference/dataset/get-dataset-information.md): Get dataset metadata for the specified user, namespace, and dataset. - [Rename a namespace](https://docs.landfall.ai/api-reference/dataset/rename-a-namespace.md): Rename the specified namespace. - [Rename a dataset](https://docs.landfall.ai/api-reference/dataset/rename-a-dataset.md): Rename the specified dataset. - [Update inference definition](https://docs.landfall.ai/api-reference/dataset/update-inference-definition.md): Update the saved inference definition for the dataset. - [Clear all data for a dataset](https://docs.landfall.ai/api-reference/dataset/clear-all-data-for-a-dataset.md): Remove all data and links from the specified dataset. This action is irreversible. - [Delete all data and metadata for a dataset (balefire)](https://docs.landfall.ai/api-reference/dataset/delete-all-data-and-metadata-for-a-dataset-balefire.md): Remove all data, links, and metadata for the specified dataset. This action is irreversible. - [Update dataset sort order](https://docs.landfall.ai/api-reference/dataset/update-dataset-sort-order.md): Update the sort order of columns in a dataset. - [Delete all data and metadata for a namespace (balefire)](https://docs.landfall.ai/api-reference/namespace/delete-all-data-and-metadata-for-a-namespace-balefire.md): Remove all data, links, and metadata for the specified namespace. This action is irreversible. Can remove dataset if flag 'deleteDatasets' is set to true - [Preview](https://docs.landfall.ai/api-reference/ingest/preview.md): Process data using ingestion logic without saving it to a dataset. - [Infer dataset description](https://docs.landfall.ai/api-reference/ingest/infer-dataset-description.md): Ask an agent to infer a data description based on sampled data. - [Schema](https://docs.landfall.ai/api-reference/ingest/schema.md): Ask an agent to infer a schema based on sampled data. - [Create new dataset](https://docs.landfall.ai/api-reference/ingest/create-new-dataset.md): Creates a new dataset within a specified namespace. - [Ingest data](https://docs.landfall.ai/api-reference/ingest/ingest-data.md): Load data into the specified dataset. - [List the caller's BuildSpecs](https://docs.landfall.ai/api-reference/buildspecs/list-the-callers-buildspecs.md): Returns every BuildSpec owned by the authenticated user. - [Create a BuildSpec](https://docs.landfall.ai/api-reference/buildspecs/create-a-buildspec.md): Create a derived-dataset transformation definition. Datasets are addressed by user/namespace/dataset name. The caller must have access to every source and every destination. - [Get a BuildSpec](https://docs.landfall.ai/api-reference/buildspecs/get-a-buildspec.md) - [Edit a BuildSpec](https://docs.landfall.ai/api-reference/buildspecs/edit-a-buildspec.md): Replace the declared sources and destinations and bump the version. Datasets are addressed by name. `code` is optional: when omitted, a CodeBlob keeps its current code. A GitPipeline must omit `code` because its transform lives in the repo. Editing never rewrites a GitPipeline's repo manifest; call… - [Delete a BuildSpec](https://docs.landfall.ai/api-reference/buildspecs/delete-a-buildspec.md) - [Schedule a build (create a BuildRun)](https://docs.landfall.ai/api-reference/buildspecs/schedule-a-build-create-a-buildrun.md): Schedule a build of the BuildSpec. Re-checks the caller's access to the spec's datasets and rejects the request if the spec already has an active run. Returns the new run in status `scheduled`. - [Preview a build (dry run)](https://docs.landfall.ai/api-reference/buildspecs/preview-a-build-dry-run.md): Run the BuildSpec against a small sample of each source (capped at 100 rows) and present the output to the caller WITHOUT ingesting it into any dataset. Requires read (QUERY) access to the sources and destination datasets. The saved code may be overridden with inline code for this preview. At most o… - [List a BuildSpec's runs](https://docs.landfall.ai/api-reference/buildspecs/list-a-buildspecs-runs.md) - [Get a BuildRun](https://docs.landfall.ai/api-reference/buildspecs/get-a-buildrun.md) - [List the ingestions a BuildRun performed](https://docs.landfall.ai/api-reference/buildspecs/list-the-ingestions-a-buildrun-performed.md): One entry per dataset ingestion the run started, oldest first. `dataset` is absent when the target dataset can no longer be resolved. - [List a preview run's outputs](https://docs.landfall.ai/api-reference/buildspecs/list-a-preview-runs-outputs.md): A code-blob preview returns one entry per destination slot (each with an href to fetch its download URL). A GitPipeline preview returns every produced output (declared, computed and discovered), each with an inline presigned download URL. Only available for preview runs. - [Fetch a preview output's download URL](https://docs.landfall.ai/api-reference/buildspecs/fetch-a-preview-outputs-download-url.md): Returns a time-limited presigned S3 URL to download one destination slot's produced rows (JSONL) directly from the bucket. Only available for preview runs. - [List a pipeline's file-input slot bindings](https://docs.landfall.ai/api-reference/buildspecs/list-a-pipelines-file-input-slot-bindings.md): The uploaded files currently bound to each file-input slot of a GitPipeline BuildSpec. - [Set (replace) the files bound to a file-input slot](https://docs.landfall.ai/api-reference/buildspecs/set-replace-the-files-bound-to-a-file-input-slot.md): Replaces the slot's bound files with the given set. An empty set unbinds the slot. - [Unbind a file-input slot](https://docs.landfall.ai/api-reference/buildspecs/unbind-a-file-input-slot.md): Removes all files bound to the slot. - [Add a file to a batch file-input slot](https://docs.landfall.ai/api-reference/buildspecs/add-a-file-to-a-batch-file-input-slot.md): Adds one uploaded file to the slot's bound set (for batch slots). - [Remove a file from a file-input slot](https://docs.landfall.ai/api-reference/buildspecs/remove-a-file-from-a-file-input-slot.md): Removes one uploaded file from the slot's bound set. - [List a pipeline repo's files](https://docs.landfall.ai/api-reference/buildspecs/list-a-pipeline-repos-files.md): The paths of every file in the GitPipeline repo at the default branch's HEAD. - [Save edits to a pipeline repo](https://docs.landfall.ai/api-reference/buildspecs/save-edits-to-a-pipeline-repo.md): Commits an atomic set of file upserts and deletions to the default branch. Carries the base commit sha for optimistic concurrency; a stale base is rejected with 409. `.dvc/config` is platform-owned and cannot be written or deleted. - [Read one file from a pipeline repo](https://docs.landfall.ai/api-reference/buildspecs/read-one-file-from-a-pipeline-repo.md): The content and commit sha of a single file at the default branch's HEAD. - [Validate a pipeline repo](https://docs.landfall.ai/api-reference/buildspecs/validate-a-pipeline-repo.md): Runs advisory checks on the repo at HEAD (dvc.yaml present, manifests parse, sources reconcile). Advisory only; it never blocks saving. - [Sync a pipeline repo's manifest with the spec](https://docs.landfall.ai/api-reference/buildspecs/sync-a-pipeline-repos-manifest-with-the-spec.md): Rewrites dsl_input.json and dsl_output.json so they wire exactly the spec's declared sources, file slots and destinations. Existing mappings are kept, new sources get a fresh folder (data/in_N, or data/ for a file slot), new destinations get a fresh out/out_N.jsonl, and entries that are no lon… - [Retry ingestion](https://docs.landfall.ai/api-reference/ingestiontracking/retry-ingestion.md): Creates a new ingestion record copying data from the original and starts the ingestion process in the background. Returns the new ingestion ID. - [Mark ingestion as seen](https://docs.landfall.ai/api-reference/ingestiontracking/mark-ingestion-as-seen.md): Update seenAt timestamp for the specified ingestion. - [Load links](https://docs.landfall.ai/api-reference/links/load-links.md): Load the links for the specified dataset. - [Rebuild links](https://docs.landfall.ai/api-reference/links/rebuild-links.md): Recalculate links for a specified dataset. - [Preview links](https://docs.landfall.ai/api-reference/links/preview-links.md): Shows what recalculating links would look like without saving changes. - [Add a new link](https://docs.landfall.ai/api-reference/links/add-a-new-link.md): Create a new link between two dataset columns. - [Get dataset ontology](https://docs.landfall.ai/api-reference/ontology/get-dataset-ontology.md): Load the ontology for the specified dataset. - [Save dataset ontology](https://docs.landfall.ai/api-reference/ontology/save-dataset-ontology.md): Save the ontology for the specified dataset. - [Curate ontology links](https://docs.landfall.ai/api-reference/ontology/curate-ontology-links.md): Curate the computed links for a dataset or all datasets in a namespace. When a link judge is configured it decides the pairs it can and the OntologyCurator agent judges the rest; otherwise the agent judges every link. When activate is true, the curated links are added to the ontology. When activate… - [List all datasets](https://docs.landfall.ai/api-reference/schema/list-all-datasets.md): Retrieve all datasets visible to the authenticated user. - [List user namespaces](https://docs.landfall.ai/api-reference/schema/list-user-namespaces.md): Retrieve namespaces for a specific user. Use 'self' for the current user. - [List datasets within namespace](https://docs.landfall.ai/api-reference/schema/list-datasets-within-namespace.md): Retrieve datasets within a specific namespace for a user. Use 'self' for the current user. - [List users with access to a dataset](https://docs.landfall.ai/api-reference/permissions/list-users-with-access-to-a-dataset.md): List the per-user grants on a dataset. Only the dataset owner may list. - [Share a dataset with a user](https://docs.landfall.ai/api-reference/permissions/share-a-dataset-with-a-user.md): Grant another user viewer or editor access to a dataset. Only the dataset owner may share. - [Revoke a user's access to a dataset](https://docs.landfall.ai/api-reference/permissions/revoke-a-users-access-to-a-dataset.md): Remove a previously granted viewer or editor access from a user. Only the dataset owner may revoke. - [List users with access to a namespace](https://docs.landfall.ai/api-reference/permissions/list-users-with-access-to-a-namespace.md): List the per-user grants on a namespace. Only the namespace owner may list. - [Share a namespace with a user](https://docs.landfall.ai/api-reference/permissions/share-a-namespace-with-a-user.md): Grant another user viewer or editor access to a namespace. The grant cascades to all datasets within the namespace. Only the namespace owner may share. - [Revoke a user's access to a namespace](https://docs.landfall.ai/api-reference/permissions/revoke-a-users-access-to-a-namespace.md): Remove a previously granted viewer or editor access from a user. Only the namespace owner may revoke. - [Query data](https://docs.landfall.ai/api-reference/query/query-data.md): Execute an ontology query. - [Run AutoRAG agent over all data](https://docs.landfall.ai/api-reference/autorag/run-autorag-agent-over-all-data.md): Uses the AutoRAG agent to answer a question about any data that the user can access. - [Run AutoRAG agent with streaming response](https://docs.landfall.ai/api-reference/autorag/run-autorag-agent-with-streaming-response.md): Uses the AutoRAG agent to answer a question about any data that the user can access. Returns results as a Server-Sent Events (SSE) stream with incremental updates. - [Get the status of an agent run](https://docs.landfall.ai/api-reference/agentruns/get-the-status-of-an-agent-run.md): Returns the current status of an agent run, the original question, and (for completed runs) the rendered result. Use this to discover whether a run is still running, completed, failed, or expired (e.g. after a dropped SSE connection). - [Delete an agent run and any resume cache associated with it](https://docs.landfall.ai/api-reference/agentruns/delete-an-agent-run-and-any-resume-cache-associated-with-it.md): Permanently removes the run record and its checkpoint blob. Returns 404 for both "never existed" and "owned by someone else" to avoid leaking existence of other users' conversations. - [Resume a previously paused or crashed agent run](https://docs.landfall.ai/api-reference/agentruns/resume-a-previously-paused-or-crashed-agent-run.md): Resumes a run from its last checkpoint. The response is an SSE stream whose first event is `run-started`, followed by the same domain events as the original streaming endpoint (e.g. `plan`, `step`, `answer` for AutoRag). - [Submit thumbs up/down feedback on a completed agent run](https://docs.landfall.ai/api-reference/agentruns/submit-thumbs-updown-feedback-on-a-completed-agent-run.md): Records user feedback (thumbs up/down plus an optional comment) as a score on the Langfuse trace that produced the run's answer. Only completed runs can be rated. Resubmitting overwrites the previous feedback for the same run. - [List the caller's conversations within a namespace](https://docs.landfall.ai/api-reference/conversations/list-the-callers-conversations-within-a-namespace.md): Returns the caller's conversations in the given namespace, most-recently-updated first. A conversation groups the agent runs (turns) the user sees as a single thread. - [Get a conversation and its turns](https://docs.landfall.ai/api-reference/conversations/get-a-conversation-and-its-turns.md): Returns the conversation's turns (oldest first), each with the original question, its status, and — for completed turns — the rendered result. Returns 404 for both "never existed" and "owned by someone else" to avoid leaking existence of other users' conversations. - [List user tokens](https://docs.landfall.ai/api-reference/user/list-user-tokens.md): List all tokens for the authenticated user. - [Add a new user token](https://docs.landfall.ai/api-reference/user/add-a-new-user-token.md): Create a new token for the authenticated user. - [Delete user token](https://docs.landfall.ai/api-reference/user/delete-user-token.md): Delete the specified user token. - [List token permissions](https://docs.landfall.ai/api-reference/user/list-token-permissions.md): List all permissions assigned to the specified token. - [Get user usage history](https://docs.landfall.ai/api-reference/user/get-user-usage-history.md): Retrieve historical usage data for the authenticated user. - [Get user usage aggregated by day](https://docs.landfall.ai/api-reference/user/get-user-usage-aggregated-by-day.md): Retrieve usage data aggregated by day for the authenticated user, with timezone support. - [Get the current user](https://docs.landfall.ai/api-reference/user/get-the-current-user.md): Returns the identity of the authenticated user resolved from the presented bearer token. - [Prepare multipart upload](https://docs.landfall.ai/api-reference/multipart-upload/prepare-multipart-upload.md): Initiate a multipart upload and get presigned URLs for all parts. - [Finish multipart upload](https://docs.landfall.ai/api-reference/multipart-upload/finish-multipart-upload.md): Finish a multipart upload by providing all part ETags. - [Abort multipart upload](https://docs.landfall.ai/api-reference/multipart-upload/abort-multipart-upload.md): Abort a multipart upload and clean up partial data. - [Prepare session for file upload](https://docs.landfall.ai/api-reference/fileupload/prepare-session-for-file-upload.md): Initiate a file upload session and get the upload URLs. - [Finish file upload](https://docs.landfall.ai/api-reference/fileupload/finish-file-upload.md): Finish a single file upload - [Abort file upload](https://docs.landfall.ai/api-reference/fileupload/abort-file-upload.md): Abort a single file upload - [List completed files in an upload session](https://docs.landfall.ai/api-reference/fileupload/list-completed-files-in-an-upload-session.md): Returns S3 bucket and key for every completed file in the session. Caller must own the session. - [List the committed, non-deleted data assets in a namespace](https://docs.landfall.ai/api-reference/data-assets/list-the-committed-non-deleted-data-assets-in-a-namespace.md) - [Create a data asset and start its first version upload](https://docs.landfall.ai/api-reference/data-assets/create-a-data-asset-and-start-its-first-version-upload.md) - [Get a data asset's latest metadata and a presigned download URL](https://docs.landfall.ai/api-reference/data-assets/get-a-data-assets-latest-metadata-and-a-presigned-download-url.md) - [Soft-delete a data asset (retained briefly, then hard-purged)](https://docs.landfall.ai/api-reference/data-assets/soft-delete-a-data-asset-retained-briefly-then-hard-purged.md) - [Update a data asset's name and/or description](https://docs.landfall.ai/api-reference/data-assets/update-a-data-assets-name-andor-description.md) - [List the versions of a data asset, newest first](https://docs.landfall.ai/api-reference/data-assets/list-the-versions-of-a-data-asset-newest-first.md): Returns the asset's versions, newest first. By default only `committed` ones - a version list is normally a history of what landed, and in-flight or abandoned uploads are noise. Widen it with the `status` parameter. - [Start uploading a new version of a data asset](https://docs.landfall.ai/api-reference/data-assets/start-uploading-a-new-version-of-a-data-asset.md) - [Get a presigned download URL for a specific version](https://docs.landfall.ai/api-reference/data-assets/get-a-presigned-download-url-for-a-specific-version.md) - [Complete a version upload from the client's part manifest](https://docs.landfall.ai/api-reference/data-assets/complete-a-version-upload-from-the-clients-part-manifest.md): Commits the version in a single S3 CompleteMultipartUpload call, using the ETags supplied in the request body. The server does not list the upload's parts, so the manifest must be complete: it verifies the part numbers cover 1..totalParts before calling S3, because S3 itself assembles exactly the pa… - [Acknowledge an uploaded chunk, extending the deadline and getting the next chunk's URL](https://docs.landfall.ai/api-reference/data-assets/acknowledge-an-uploaded-chunk-extending-the-deadline-and-getting-the-next-chunks-url.md) - [Recover a pending upload - what landed, with ETags, and URLs for what did not](https://docs.landfall.ai/api-reference/data-assets/recover-a-pending-upload--what-landed-with-etags-and-urls-for-what-did-not.md): The recovery path, for a client that lost its part manifest or its place. This is the only endpoint that asks S3 what it actually stored, so it is deliberately off the happy path: a normal upload never calls it, and a LIST request per upload is negligible. It returns the ETag of every part S3 holds… - [Re-issue upload URLs for specific parts, extending the deadline](https://docs.landfall.ai/api-reference/data-assets/re-issue-upload-urls-for-specific-parts-extending-the-deadline.md): Mints fresh presigned URLs for the part numbers given, and pushes the upload's deadline out like an acknowledgement does. Use it when the client knows which parts it needs - typically a URL that expired mid-transfer on a slow link. It performs no S3 listing, so it stays as cheap as an acknowledgemen… - [Abort a pending version upload](https://docs.landfall.ai/api-reference/data-assets/abort-a-pending-version-upload.md) - [Roll back to a retained version by copying it as a new version](https://docs.landfall.ai/api-reference/data-assets/roll-back-to-a-retained-version-by-copying-it-as-a-new-version.md) - [DataLinks Python SDK](https://docs.landfall.ai/pythonsdk/index.md): Simplify data ingestion, normalization, linking, and querying with the DataLinks Python SDK. - [Installation](https://docs.landfall.ai/pythonsdk/sdk-install.md): Install the DataLinks Python SDK using pip or uv. - [SDK QuickStart](https://docs.landfall.ai/pythonsdk/sdk-quickstart.md): Get started with SDK with a few simple steps. - [Components](https://docs.landfall.ai/pythonsdk/components.md): Core building blocks of the DataLinks Python SDK. - [Examples](https://docs.landfall.ai/pythonsdk/examples.md): End-to-end examples demonstrating common DataLinks SDK usage patterns. - [Modules](https://docs.landfall.ai/pythonsdk/modules.md) - [Reference](https://docs.landfall.ai/pythonsdk/datalinks.md) ## OpenAPI Specs - [openapi](/api-reference/openapi.yml) - [openapi](/api-tariffs/openapi.yml) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.