Simplicity Is the Ultimate Sophistication

At Transparent Edge, our commitment lies in providing our customers with the technical and human resources needed to ensure both the performance and security of their websites and web applications. And 2026, which has only just begun to take its first steps, is certainly no exception.

Any sufficiently advanced technology is indistinguishable from magic—or at least that is what Arthur C. Clarke, the renowned science fiction writer and author of notable works such as 2001: A Space Odyssey, stated back in 1962. More than sixty years have passed since then, and that statement currently holds, if anything, even greater relevance following the dizzying revolution that artificial intelligence is bringing about today. Like an explosion, it has burst onto the scene shaking the very foundations of our industry. In short, poor HAL 9000, the AI that governed the Discovery One in 2001:…, has been overtaken by the likes of ChatGPT, Claude, Copilot and Gemini; what until recently was nothing more than science fiction has inexorably—and almost irreverently—become reality.

At Transparent Edge, we are by no means strangers to this new reality. As an example, consider the inclusion of our brand-new AI agent to assist our customers with VCL code recommendations which, in conjunction with our recently incorporated easy setup, facilitates the deployment of new configuration adjustments, thereby minimising the learning curve involved in using the Varnish Enterprise DSL (domain-specific language) and contributing to the continuous improvement of our product, of which our dashboard is the most visible face.

In any case, contrary to what one might think and with Arthur C. Clarke's permission, the real magic does not reside in technology but in human talent—and at Transparent Edge, we know a great deal about that. Under this premise, the expertise of our front-end and user experience teams, who are responsible for developing our dashboard, plays a crucial role, as does, above all and most especially, our back-end team, which is responsible for developing our API: an API upon which our dashboard is built, feeding it with data and logic. As Winston Churchill would say: never have so many owed so much to so few. For if our dashboard is the visible face, our API is the brain that orchestrates our infrastructure and our services. An API that, moreover, Transparent Edge makes available to its customers.

Thus, until now, our customers had the ability to interact with our API, consuming its endpoints, to perform tasks such as: analysing traffic in real time, consulting historical data, provisioning new sites or backends, adjusting configuration, managing digital certificates, administering users, invalidating content, and more. Furthermore, Transparent Edge has long offered integration with tools such as Terraform through our own provider, Prometheus, or WordPress via the W3 Total Cache plugin.

What Is TE-API?

Today, Transparent Edge is also offering a new free command-line tool or CLI (command line interface): TE-API. TE-API is developed in Python and is designed to encapsulate, structure and unify our API, enabling interaction with all the services it offers in an outrageously simple, secure and efficient way. Moreover, thanks to the OpenAPI specification, TE-API will always be up to date with all available endpoints.

This tool handles user authentication on its own through the OAuth2 delegated authorisation standard, meaning there is no longer any need to previously request a token by consuming the endpoint '/v1/oauth2/access_token/'; now it is only necessary to configure the credentials in a '.env' file or to define the environment variables 'TRANSPARENT_CLIENT_(ID|SECRET)' with those credentials… et voilà: TE-API will automagically (may Arthur C. Clarke forgive us…) handle the retrieval and subsequent renewal of the corresponding token.

[alberto@MacBook-Air 189 16:00] ~ (21 files, 504K)
✔ (0 jobs) $ env | grep -E 'TRANSPARENT_CLIENT_(ID|SECRET)'
TRANSPARENT_CLIENT_ID=<...>
TRANSPARENT_CLIENT_SECRET=<...>

[alberto@MacBook-Air 455 16:00] ~ (21 files, 504K)
✔ (0 jobs) $ te-api
audit             autoprovisioning  bot-mitigation    companies         core              login             media             security          show-context      storage
authentication    billing           clear-company     completion        inventory         logs              notifications     set-company       statistics        users

[alberto@MacBook-Air 455 16:00] ~ (21 files, 504K)
✔ (0 jobs) $

From here, we can interact with the tool following a hierarchical and intuitive structure:
te-api [MODULE] [VERB] [RESOURCE] [OPTIONS];
for example:

[alberto@MacBook-Air 246 16:00] ~ (21 files, 508K)
✔ (0 jobs) $ te-api companies get current-user | jq '(.first_name + " " + .last_name)'
"Alberto Suárez"

[alberto@MacBook-Air 266 16:00] ~ (21 files, 508K)
✔ (0 jobs) $ te-api companies get sites --company-id <...> | jq -r '.[] | .url' | sort
mi-sitio.es
otro-sitio.es
www.mi-nuevo-site.es
www.mi-sitio.es
www.my-site.com
www.other-site.com
www.otro-sitio.es

[alberto@MacBook-Air 276 16:00] ~ (21 files, 508K)
✔ (0 jobs) $ te-api companies create invalidate --company-id <...> --json-body '{ "urls": ["https://www.mi-sitio.es/"] }'
{
  "urls_to_send": [
    "https://www.mi-sitio.es/"
  ],
  "locked_urls": []
}

[alberto@MacBook-Air 245 16:00] ~ (21 files, 508K)
✔ (0 jobs) $ te-api companies get invalidate --company-id <...>
{
  "total": 1,
  "data": [
    {
      "id": 752974895,
      "user": "asuarez@transparentedge.eu",
      "urls": [
        "https://www.mi-sitio.es/"
      ],
      "invalidation_type": 1,
      "refetch": false,
      "date": "2026-03-19T15:10:15.487469Z",
      "soft": false
    }
  ]
}

[alberto@MacBook-Air 215 16:00] ~ (21 files, 508K)
✔ (0 jobs) $

And so, thanks to TE-API, we eliminate at a stroke the tedious need to manually construct HTTP requests to consume our API's endpoints, leaving in its place a clean and simple interface. And it is there, in simplicity, where the ultimate sophistication resides. Pure magic.

Alberto Suárez López is a systems administrator at Transparent Edge.