# Databox

Connect your data from any tool and track it from any device. Build and share reports, monitor trends, and discover insights.

- **Category:** analytics
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 7
- **Triggers:** 0
- **Slug:** `DATABOX`
- **Version:** 00000000_00

## Tools

### Create Dataset

**Slug:** `DATABOX_CREATE_DATASET`

Tool to create a new dataset in Databox data source. Use when you need to initialize a dataset with a title, data source ID, and primary keys for unique record identification.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `title` | string | Yes | Name of the dataset. |
| `primaryKeys` | array | Yes | Array of field names used to uniquely identify records in the dataset. Each record must have unique values for these fields. |
| `dataSourceId` | integer | Yes | ID of the parent data source. This identifies which data source the dataset belongs to. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Data Source

**Slug:** `DATABOX_CREATE_DATA_SOURCE`

Tool to create a new data source in Databox. Use when you need to create a logical container for datasets within a Databox account. Requires accountId, title, and timezone parameters.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `title` | string | Yes | A descriptive name for the data source (e.g., 'ERP System', 'Test Data Source'). |
| `timezone` | string | Yes | The timezone for the data source in standard format. Available timezones can be retrieved via GET /v1/timezones. Common values include 'UTC', 'America/New_York', 'Europe/London'. |
| `accountId` | integer | Yes | The unique identifier of the Databox account where the data source will be created. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Dataset

**Slug:** `DATABOX_DELETE_DATASET`

Tool to delete a dataset by ID in Databox. Use when you need to permanently remove a dataset. This operation is irreversible.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `datasetId` | string | Yes | The unique identifier of the dataset to delete in UUID format. This operation permanently removes the dataset and is irreversible. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Data Source

**Slug:** `DATABOX_DELETE_DATA_SOURCE`

Tool to delete a data source by ID in Databox. Use when you need to permanently remove a data source. This operation is irreversible and will delete all associated datasets.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `dataSourceId` | integer | Yes | The unique identifier of the data source to delete. This operation is permanent and irreversible. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Dataset Ingestion Status

**Slug:** `DATABOX_GET_DATASET_INGESTION_STATUS`

Tool to check the status of a specific data ingestion for a dataset. Use when you need to verify whether a data ingestion was successful by providing the dataset ID and ingestion ID returned from the initial POST request.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `datasetId` | string | Yes | The unique identifier of the dataset (e.g., '06feef1f-460d-49a1-b296-3e6c73511358'). |
| `ingestionId` | string | Yes | The unique identifier returned from the data ingestion request (e.g., '8f0e9bba-f11b-46ae-8f60-8ff3ea878be9'). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Accounts

**Slug:** `DATABOX_LIST_ACCOUNTS`

Tool to retrieve all Databox accounts accessible to the authenticated user. Use to identify account IDs required for subsequent API operations like data source creation.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Push Data to Dataset (V1)

**Slug:** `DATABOX_PUSH_DATA_V1`

Tool to push data points to a Databox dataset using the v1 API. Use when you need to ingest data records into a specific dataset by providing the dataset ID and an array of records matching the dataset schema.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `records` | array | Yes | Collection of data records to ingest. Each record's structure depends on your dataset schema and must include all primary key fields defined during dataset creation. |
| `datasetId` | string | Yes | The unique identifier of the target dataset (UUID format). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |