Taxonomies

Generate from Context

Generate a taxonomy structure from user-provided context using AI.

This endpoint allows users to describe their data and use case, and the system will generate an appropriate taxonomy structure (hierarchical or flat) without requiring actual data files.

Request Body

Field	Type	Description
`user_context`	`str`	Free-form description of the data and intended use
`industry`	`Optional[str]`	Industry context (e.g., “Healthcare”, “Finance”, “Legal”)
`data_type`	`Optional[str]`	Type of data (e.g., “documents”, “customer records”)
`use_case`	`Optional[str]`	Specific use case description
`taxonomy_type`	`str`	Type of taxonomy: “hierarchical” or “flat”. Default: “hierarchical”
`max_depth`	`Optional[int]`	Maximum depth for hierarchical taxonomies. Default: 3
`llm_profile_name`	`Optional[str]`	LLM profile to use. Defaults to system default if not specified

Response

200: Taxonomy generated successfully
- Returns: { "taxonomy_data": Dict, "taxonomy_description": str }
400: Invalid request or LLM configuration error
500: Internal Server Error

Example

{
  "user_context": "I have customer support tickets with priority levels, categories, and resolution status",
  "industry": "Technology",
  "data_type": "support tickets",
  "use_case": "categorize and analyze support requests",
  "taxonomy_type": "hierarchical",
  "max_depth": 3
}

POST

taxonomy

generate_from_context

Python

# pip install deasy-sdk
import os
from deasy import DeasyClient

client = DeasyClient(
    base_url=os.environ["UNSTRUCTURED_CLIENT_BASE_URL"],
    username=os.environ["UNSTRUCTURED_USERNAME"],
    password=os.environ["UNSTRUCTURED_PASSWORD"],
    auth_method="basic",
)

response = client.taxonomy.generate_from_context(
    user_context="example_user_context",
)
print(response.taxonomy_data)

{
  "taxonomy_data": {},
  "taxonomy_description": "<string>",
  "suggested_tags": {},
  "tag_not_found_rates": {}
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

Authorizations

Authorization

string

header

required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

application/json

user_context

string

required

taxonomy_name

string | null

industry

string | null

data_type

string | null

use_case

string | null

taxonomy_type

string

default:hierarchical

max_depth

integer | null

default:3

llm_profile_name

string | null

data_connector_name

string | null

validate_tags

boolean | null

default:false

Response

Successful Response

taxonomy_data

Taxonomy Data · object

required

taxonomy_description

string | null

suggested_tags

Suggested Tags · object | null

tag_not_found_rates

Tag Not Found Rates · object | null

Show child attributes

⌘I

Python

# pip install deasy-sdk
import os
from deasy import DeasyClient

client = DeasyClient(
    base_url=os.environ["UNSTRUCTURED_CLIENT_BASE_URL"],
    username=os.environ["UNSTRUCTURED_USERNAME"],
    password=os.environ["UNSTRUCTURED_PASSWORD"],
    auth_method="basic",
)

response = client.taxonomy.generate_from_context(
    user_context="example_user_context",
)
print(response.taxonomy_data)

{
  "taxonomy_data": {},
  "taxonomy_description": "<string>",
  "suggested_tags": {},
  "tag_not_found_rates": {}
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

Overview

Data Connectors

Tags

Taxonomies

Metadata

Data Slices

Deduplication

Destinations

Projects

Workflows

Versioning

Task Tracking

Generate from Context

Request Body

Response

Example

Authorizations

Body

Response