Permanently removes a specific term and all its associated translations from a dictionary, providing precise control over dictionary content while maintaining the integrity of remaining terms.
Deleting individual terms from dictionaries represents a fundamentally different operation from deleting entire dictionaries, though both share the characteristic of permanent data removal. When you delete a term, you’re performing linguistic surgery - carefully removing specific content while preserving the broader dictionary structure and all other terms that users and applications depend upon.
The endpoint’s design emphasizes surgical precision through its dual-parameter approach, requiring you to specify both the dictionary context and the exact term to be removed. This two-level targeting system prevents the kind of broad, accidental deletions that could damage valuable linguistic resources while ensuring that removal operations affect exactly the content you intend to eliminate.
Like dictionary deletion, term deletion is permanent and irreversible, but the scope of impact differs significantly. When you delete a term, you’re removing not just the source language entry, but all associated translations, usage examples, metadata, and any other linguistic information connected to that term concept. This comprehensive removal ensures that no orphaned data remains in the system, but it also means that recovery requires rebuilding the entire term entry from scratch.
Consider how term deletion might affect users who have grown accustomed to finding specific terminology in your dictionary. Applications that cache dictionary content might need updates to reflect the removal, and any bookmarks or saved references to the deleted term will become invalid. Understanding these downstream effects helps you plan term deletion operations as part of broader dictionary maintenance strategies rather than isolated removal actions.
The x-api-key
is a custom header required for authenticating requests to our API. Include this header in your request with the appropriate API key value to securely access our endpoints. You can find your API key(s) in the 'API' section of our studio website.
This parameter tells the API exactly which dictionary you're interested in. Each dictionary in the system has a unique numerical ID that serves as its primary identifier.
The unique identifier of the term. This must be a positive integer that corresponds to an existing term in the system.
x > 0
Successful Response
The response is of type object
.