Skip to main content

Python wrapper around Akamai's Content Control Utility API

Project description

Python wrapper around Akamai ccuapi including a command line utility


Python 2.7, 3.3, 3.4 and 3.5 are currently supported. There are currently no plans to support anything older than Python 2.7


Credentials can be provided in 1 of 3 ways:

  1. AKAMAI_USERNAME and AKAMAI_PASSWORD environment variables.
  2. A .akamai config file in the user’s home directory. Example:
  3. Passing username and password kwargs to ccuapi.purge.PurgeRequest on initialization.

Email Notifications

One or more comma-separated email addresses may be set to receive notifications when a content purge is complete. These are provided in 1 of 3 ways:

  1. AKAMAI_NOTIFY_EMAIL environment variable.
  2. In the .akamai config file
  3. Passing email kwarg to ccuapi.purge.PurgeRequest on initialization.


from ccuapi.purge import PurgeRequest
purger = PurgeRequest()
purger.add('') # this can be a string, or list of strings
results = purger.purge() # returns the status of the request

Command Line Usage


Run ccu_purge -h for additional options.

Using a proxy server

ccuapi_purge will honor the standard proxy environment variables so if you are running behind a proxy export the proper environment variables:

$ export HTTP_PROXY=""
$ export HTTPS_PROXY=""

Change Log

1.2.1 (12/15/2015)

  • Added support for HTTPS socket timeouts when making Akamai API requests.

1.2.0 (01/09/2015)

  • Added support for altering the API endpoint. Thanks elmirjagudin
  • Added support for using a custom certificate bundle. Thanks elmirjagudin
  • Added support for disabling SSL verification. Thanks elmirjagudin

1.1.2 (05/23/2014)

  • Fix bug where purge method was returning the results of a status call rather than the actual results of the purge

1.1.1 (05/22/2014)

  • Fix entry point issue with CLI running

1.1.0 (05/16/2014)

  • Python 3 support
  • Catch exception in CLI when no username is supplied

1.0.0 (05/15/2014)

This versions marks a fairly significant overhaul to convert to Akamai’s REST based API. There some backward incompatible changes so be sure to review the list of changes below:

  • Drop Django related code. A separate Django module should be created which can potentially leverage this library, however having Django related code in this module didn’t fit well.
  • Unittests have been introduced which should make future updates safer
  • Pylint and PEP8 compliance
  • WSDL has been dropped. Since Akamai won’t be supporting use of the SOAP API going forward, there was no reason to keep this around
  • Project is now tested using Travis-CI


This was the last version which supported the SOAP based API

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for ccuapi, version 1.2.1
Filename, size File type Python version Upload date Hashes
Filename, size ccuapi-1.2.1.tar.gz (12.5 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page