Python

from unstructured import UnstructuredClient

client = UnstructuredClient(
    username="My Username",
    password="My Password",
)
data_slice = client.data_slice.create(
    data_connector_name="data_connector_name",
    dataslice_name="dataslice_name",
)
print(data_slice.dataslice_id)

{
  "dataslice_id": "<string>"
}

Data Slices

Create

Create a new data slice based on specified conditions.

Request Body

Field	Type	Description
`dataslice_name`	`str`	The name to assign to the newly created data slice.
`condition`	`Optional[List[Dict]]`	(Legacy) List of file qualifying conditions.
`condition_new`	`Optional[Any]`	New format: advanced file qualifying conditions.
`description`	`Optional[str]`	Description of the data slice.
`status`	`str`	The status of the data slice (e.g., active).
`data_points`	`Optional[int]`	Number of data points in the data slice.
`latest_graph`	`Optional[Dict]`	Most recent graph reference/metadata.
`graph_id`	`Optional[str]`	ID of the related graph, if applicable.
`data_connector_name`	`str`	Name of the data connector (vector database profile).
`parent_dataslice_id`	`Optional[str]`	(Optional) Parent data slice ID, for lineage.

Response

201: Data slice created successfully
- Returns: { "dataslice_id": "<uuid>" }
500: Internal Server Error.

Example

{
  "dataslice_name": "Customer Purchases Q2",
  "condition": [
    { "field": "created_date", "op": "gte", "value": "2024-04-01" }
  ],
  "description": "Purchase data from Q2 2024",
  "status": "active",
  "data_points": 4000,
  "data_connector_name": "prod-warehouse"
}

POST

dataslice

create

Python

from unstructured import UnstructuredClient

client = UnstructuredClient(
    username="My Username",
    password="My Password",
)
data_slice = client.data_slice.create(
    data_connector_name="data_connector_name",
    dataslice_name="dataslice_name",
)
print(data_slice.dataslice_id)

{
  "dataslice_id": "<string>"
}

Body

application/json

dataslice_name

string

required

data_connector_name

string

required

condition

Condition · object

Show child attributes

condition.condition

enum<string> | null

Available options:

AND,

OR

condition.children

any[] | null

condition.tag

BaseTag · object

Show child attributes

condition.tag.name

string

required

condition.tag.values

(string | number | integer)[]

required

condition.tag.operator

string | null

default:any

description

string | null

status

string

default:active

data_points

integer | null

latest_graph

Latest Graph · object

graph_id

string | null

parent_dataslice_id

string | null

Response

Successful Response

dataslice_id

string

required

Get Status List

⌘I

Data Connectors

Tags

Taxonomies

Metadata

Task Tracking

Data Slices

Destinations

Create

Request Body

Response

Example

Body

Response