Data

Connect data, pick a dataset, and make it queryable.

post/v1/data/connect

Request

  • Base URL: https://api.algenta.ai
  • URL: https://api.algenta.ai/v1/data/connect
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Request body

connection_typestring nullable

database | api | object_storage | file_upload

dataset_namestring required

Public dataset name.

providerstring nullable

Specific provider such as postgres, snowflake, s3, rest.

connectorobject nullable

Canonical connector envelope with type/location/auth/options. Preferred for cross-SDK and MCP compatibility.

connection_idstring nullable

Reuse an existing saved connection.

connection_namestring nullable

Optional saved connection label.

connection_configobject nullable

Connector credentials/config.

selectionobject nullable

Chosen table/query/path.

descriptionstring nullable
visibilitystring nullable

private | shared

recordsobject[] nullable
csvstring nullable
json_strstring nullable
urlstring nullable
excel_b64string nullable
parquet_b64string nullable

Response

Successful Response

object required

Changes

No recorded changes to this operation across all 1 revision of this API.