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)

import UnstructuredClient from 'unstructured-sdk';

const client = new UnstructuredClient({
  authMethod: 'My Auth Method',
  username: process.env['UNSTRUCTURED_USERNAME'], // This is the default and can be omitted
  password: process.env['UNSTRUCTURED_PASSWORD'], // This is the default and can be omitted
});

const response = await client.taxonomy.generateFromContext({ user_context: 'user_context' });

console.log(response.taxonomy_data);

A valid request URL is required to generate request examples

A valid request URL is required to generate request examples

A valid request URL is required to generate request examples

A valid request URL is required to generate request examples

A valid request URL is required to generate request examples

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

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

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

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

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)

import UnstructuredClient from 'unstructured-sdk';

const client = new UnstructuredClient({
  authMethod: 'My Auth Method',
  username: process.env['UNSTRUCTURED_USERNAME'], // This is the default and can be omitted
  password: process.env['UNSTRUCTURED_PASSWORD'], // This is the default and can be omitted
});

const response = await client.taxonomy.generateFromContext({ user_context: 'user_context' });

console.log(response.taxonomy_data);

A valid request URL is required to generate request examples

A valid request URL is required to generate request examples

A valid request URL is required to generate request examples

A valid request URL is required to generate request examples

A valid request URL is required to generate request examples

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

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

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

{
  "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

Delete Suggest

⌘I

Data Connectors

Destinations

Tags

Taxonomies

Metadata

Task Tracking

Data Slices

Workflows

Projects

Versioning

Generate from Context

Request Body

Response

Example

Authorizations

Body

Response