GuidesAPI EndpointsAPI Changelog
Live AI Demo
API Endpoints

Update a taxonomy

Update taxonomy fields and/or its tags. Only provided fields are changed.

If tags is provided it replaces the entire tag set: entries are matched by key, then by value, and updated; unmatched entries are created; existing tags not listed are deleted. The "other" tag is never removed. Omit tags to leave tags unchanged.

Pass null for parent_key, base_taxonomy_key or classifier_key to remove them. Setting a public base_taxonomy_key copies its tags (values already present are skipped).

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

Key of the taxonomy to update.

string

Technical, code-like identifier of the taxonomy.

string

Human-readable label of the taxonomy.

string
string
string
subtypes
array of strings | null

Item kinds this taxonomy applies to. Pass null to clear.

subtypes
Allowed:
string
enum
Allowed:
string | null

Pass null to remove the parent taxonomy.

string | null

Pass null to remove the base taxonomy.

string | null

Pass null to detach the classifier.

tags
array of objects

Full replacement tag set. Tags not listed are deleted (except "other").

tags
Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json