Add
Add data to a dataset for processing and knowledge graph construction.
This endpoint accepts various types of data (files, URLs, GitHub repositories) and adds them to a specified dataset for processing. The data is ingested, analyzed, and integrated into the knowledge graph.
Request Parameters
- data (List[UploadFile]): List of files to upload. Can also include:
- HTTP URLs (if ALLOW_HTTP_REQUESTS is enabled)
- GitHub repository URLs (will be cloned and processed)
- Regular file uploads
- datasetName (Optional[str]): Name of the dataset to add data to
- datasetId (Optional[UUID]): UUID of an already existing dataset
- node_set Optional[list[str]]: List of node identifiers for graph organization and access control. Used for grouping related data points in the knowledge graph.
- run_in_background (Optional[bool]): Run add pipeline asynchronously (default: False).
Either datasetName or datasetId must be provided.
Response
Returns information about the add operation containing:
- Status of the operation
- Details about the processed data
- Any relevant metadata from the ingestion process
Error Codes
- 400 Bad Request: Neither datasetId nor datasetName provided
- 409 Conflict: Error during add operation
- 403 Forbidden: User doesn’t have permission to add to dataset
Notes
- To add data to datasets not owned by the user, use dataset_id (when ENABLE_BACKEND_ACCESS_CONTROL is set to True)
- datasetId value can only be the UUID of an already existing dataset
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
Name of the target dataset (created if it does not exist). Required unless datasetId is provided.
"default_dataset"
Providing dataset ID is mandatory for sharing a dataset between users. Datasets provided by name will only be resolvable by dataset owner.
""
Response
Successful Response
The response is of type Response Add Api V1 Add Post · object.