Python

import os
from unstructured import UnstructuredClient

client = UnstructuredClient(
    username=os.environ.get("UNSTRUCTURED_USERNAME"),  # This is the default and can be omitted
    password=os.environ.get("UNSTRUCTURED_PASSWORD"),  # This is the default and can be omitted
)
response = client.taxonomy.generate_from_context(
    user_context="user_context",
)
print(response.taxonomy_data)

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

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

import os
from unstructured import UnstructuredClient

client = UnstructuredClient(
    username=os.environ.get("UNSTRUCTURED_USERNAME"),  # This is the default and can be omitted
    password=os.environ.get("UNSTRUCTURED_PASSWORD"),  # This is the default and can be omitted
)
response = client.taxonomy.generate_from_context(
    user_context="user_context",
)
print(response.taxonomy_data)

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

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

tag_not_found_rates

Tag Not Found Rates · object

Show child attributes

Delete Suggest

⌘I

Documentation Index

Authorizations

Body

Response