DELETE
/
dictionaries
/
{dictionary_id}
curl --request DELETE \
  --url https://client.camb.ai/apis/dictionaries/{dictionary_id} \
  --header 'x-api-key: <api-key>'
{
  "message": "<string>",
  "status": "<string>"
}

Overview

Deleting a dictionary represents one of the most consequential operations you can perform in a dictionary management system. Unlike updating or retrieving information, deletion is permanent and irreversible, making it essential to understand both the technical mechanics and the broader implications of this action before implementing it in your applications. When you delete a dictionary, you’re not simply removing a reference or hiding the content from view. Instead, you’re instructing the system to completely eliminate the dictionary and everything it contains from the database. This includes not only the dictionary’s identifying information and metadata, but also every single term-translation pair that was stored within it.

Understanding the Permanence of Deletion

The irreversible nature of dictionary deletion serves important purposes in data management, but it also creates significant responsibilities for developers and users. From a system perspective, permanent deletion helps maintain database efficiency by truly removing unused data rather than simply marking it as inactive. This approach prevents the accumulation of obsolete records that could slow down queries and consume storage space unnecessarily. However, this permanence also means that any applications, workflows, or users that depend on the deleted dictionary will immediately lose access to that data. References to the dictionary will become invalid, translation lookups will fail, and any cached content based on that dictionary may become inconsistent with the system state. Understanding these cascading effects helps you design better error handling and user communication around deletion operations.

Authorizations

x-api-key
string
header
required

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.

Path Parameters

dictionary_id
integer
required

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.

Response

200
application/json

Successful Response

The response is of type object.