What's New?

We are constantly improving the REST API by:

Adding new endpoints.
Adding new functionality to existing endpoints.
Deprecating legacy endpoints.

This section is designed to help you keep track of key recent changes to the REST API.

New 07/22/2022	The following WAF endpoints now support the ability to define or retrieve country subdivision (e.g., state or province) access controls: Add Access Rule (ACL) Get Access Rule (ACL) Update Access Rule (ACL)
New 07/12/2022	We have introduced a BETA version of the following endpoints to support customer origin group management: Customer Origin Groups Add Customer Origin Group (HTTP Large \| ADN) Delete Customer Origin Group (HTTP Large \| ADN) Get All Customer Origin Groups (HTTP Large \| ADN) Get Customer Origin Group (HTTP Large \| ADN) Get Customer Origin Group Status (HTTP Large \| ADN) Update Customer Origin Group (HTTP Large \| ADN) Origin Entries Add Origin Entry (HTTP Large \| ADN) Delete Origin Entry (HTTP Large \| ADN) Get All Origin Entries (HTTP Large \| ADN) Get Origin Entries by Customer Origin Group (HTTP Large \| ADN) Get Origin Entry (HTTP Large \| ADN) Update Origin Entry (HTTP Large \| ADN) Load Balancing Update Failover Order (HTTP Large \| ADN) Functions@Edge Get All Functions (HTTP Large \| ADN) Reference Get Available Protocols Get Available Hostname Resolution Methods Get Origin Shield POPs
New 05/04/2022	We have introduced the following endpoints to support Web Application Firewall Bot Rules: Add Bot Rule Set Delete Bot Rule Set Get All Bot Rule Sets Get Bot Rule Set Update Bot Rule Set
New 02/25/2022	A BETA version of the following endpoints have been introduced to support certificate provisioning: Add Certificate Cancel Certificate Request Change Organization Delete Certificate Generate Domain Control Validation Token Get All Certificate Requests Get Cancel Certificate Request Actions Get Certificate Licenses Get Certificate Order Statuses Get Certificate Request Get Certificate Request Status Get Certificate Request Statuses Get Certificate Request's Notification Configuration Get Certificate Validation Levels Get Country Codes Get Default Notification Configuration Get Default Organization Get Domain Control Validation Metadata Get Domain Control Validation Types Get Domain Statuses Get Organization by ID Get Organization by Name Get Validation Statuses Renew Certificate Resend Domain Control Validation Email Resubmit Certificate Request Update Certificate Request Update Certificate Request's Notification Configuration Update Default Notification Configuration Validate Domain Control
New 10/05/2021	The following endpoints have been introduced to support RTLD Rate Limiting configuration: Add RTLD Rate Limiting Profile Delete RTLD Rate Limiting Profile Get All RTLD Rate Limiting Profiles Get Log Fields (RTLD Rate Limiting) Get RTLD Rate Limiting Profile Update RTLD Rate Limiting Profile
Update 05/25/2021	RTLD endpoints have been updated to introduce support for setting up a profile to deliver log data to: Google Cloud Storage New Relic (RTLD CDN only) Learn more: RTLD CDN RTLD WAF
New 05/24/2021	You may now manage your OAuth 2.0 API clients through the VDMS Identity dashboard. Learn more.
Update 04/12/2020	Our DNS endpoints now support PTR records. Learn more.
Update 03/12/2020	The following RTLD WAF endpoints have been updated to introduce log data filtering by security application manager configurations, access rules, custom rules, and managed rules: Add RTLD WAF Profile Get All RTLD WAF Profiles Get RTLD WAF Profile Update RTLD WAF Profile
Update 03/12/2020	The following RTLD CDN endpoints have been updated to introduce log data filtering by user agent: Add RTLD Configuration Get All RTLD Configurations Get RTLD Configuration Update RTLD Configuration
New 12/15/2020	The following WAF endpoints have been introduced: Add Access Rule (ACL) Add Custom Rule Set Add Managed Rule (Profile) Add Rate Rule Delete Access Rule (ACL) Delete Custom Rule Set Delete Managed Rule (Profile) Delete Rate Rule Get Access Rule (ACL) Get All Access Rules (ACL) Get All Custom Rule Sets Get All Managed Rules (Profiles) Get All Rate Rules Get All Security Application Manager Configurations (Scopes) Get Custom Rule Set Get Managed Rule (Profile) Get Rate Rule Manage All Security Application Manager Configurations (Scopes) Update Access Rule (ACL) Update Custom Rule Set Update Managed Rule (Profile) Update Rate Rule
New 11/25/2020	The following endpoints, which automate the administration of RTLD WAF profiles, have been introduced: Add RTLD WAF Profile Delete RTLD WAF Profile Get All RTLD WAF Profiles Get Log Fields (RTLD WAF) Get RTLD WAF Profile Update RTLD WAF Profile
Update 11/25/2020	The following endpoints are now also hosted on our API gateway. You may request them via either api.edgecast.com or api.vdms.io. However, api.vdms.io requires an IDS client that is granted the ec.rtld scope. Get AWS Regions Get Access Types (Azure Blob Storage) Get HTTP POST Authentication Methods Get HTTP Status Codes Get Log Delivery Methods Get Log Downsampling Rates Get Log Fields (RTLD CDN)
Update 07/23/2020	The Generate Downloadable Report endpoint now supports the format request body parameter that determines whether report data will be generated as a CSV or JSON.
New 03/31/2020	The following Report Builder endpoints have been introduced: Generate Downloadable Report Generate Report Get All Dimensions Get All Downloadable Reports Get All Granularities Get All Metrics Get All Operators Get All Reports Get All Units Get Dimension Get Downloadable Report Get Granularity Get Metric Get Operator Get Report Get Unit
Update 03/31/2020	Real-Time Log Delivery now supports multiple profiles, log delivery to Datadog, custom log data, and formatting log data as a JSON array or lines when delivering to either web server(s), AWS S3, or an Azure Block Blob. The following endpoints have been updated to reflect these new capabilities: Add RTLD Configuration Get All RTLD Configurations Get Log Delivery Methods Get RTLD Configuration Update RTLD Configuration
New 10/11/2019	The following Rules Engine v4 endpoints have been introduced: Get Deploy Request Update Policy
New 09/27/2019	The following Rules Engine v4 endpoints have been introduced: Add Policy Cancel Deploy Request Delete Rule Get All Policies Get Deploy Requests Get Policy Get Rules by Customer Origin Get Rules by Edge CNAME Submit Deploy Request
New 07/23/2019	The following Real-Time Log Delivery endpoints have been introduced: Add RTLD Configuration Get All RTLD Configurations Get AWS Regions Get Access Types (Azure Blob Storage) Get HTTP POST Authentication Methods Get HTTP Status Codes Get Log Delivery Methods Get Log Downsampling Rates Get Log Fields Get RTLD Configuration Update RTLD Configuration
New 04/25/2019	The following endpoints, which return configuration propagation status, have been introduced: Get Customer Origin Status Get Deploy Request Status (Rules Engine version 4) Get Edge CNAME Status
11/20/2018	User privileges are now enforced on REST API requests. Please ensure that the user associated with your REST API token has been granted sufficient permissions to perform the equivalent action within the MCC.
Update 01/31/2018	Classes of status codes (i.e., 2xx, 3xx, 4xx, and 5xx) will no longer exclude status codes that are individually tracked (e.g., 403 and 404 for 4xx reporting). This change was applied to the following endpoints: Get Current Status Code Statistics Get Current Edge CNAME Statistics Get Current Edge CNAME Statistics II
New 01/29/2018	The Get Real-Time Statistics by Country and Edge CNAME endpoint reports the most recent statistics on a per edge CNAME basis by country.
New 01/24/2018	The Get Billing Usage Data endpoint returns billing usage data for a given month. This data may be filtered by region, country, or POP.
New 01/09/2018	The Get CDN IP Blocks endpoint retrieves a list of IPv4 and IPv6 blocks used by our CDN service.
New 10/24/2017	The following cache-related endpoints are now available: Bulk Load Content Bulk Purge Content Get Bulk Load Request Get Bulk Purge Request
Update 08/30/2017	The following Dynamic Cloud Packaging endpoints were updated to indicate that a default DVR duration of 1 minute will be assigned to an instance when one is not defined and to include support for Server-Side Archiving (SsaEnabled) and Encrypted Key Rotation (EncryptedKeyRotation): Add Instance Get All Instances Update Instance
New 8/30/2017	A BETA version of the following Route endpoint is now available: Update Secondary Zone Group
New 8/15/2017	A BETA version of the following Route endpoints are now available: Add Master Server Group Add Secondary Zone Group Delete Master Name Server Delete Master Server Group Delete Secondary Zone Delete Secondary Zone Group Get All TSIG Keys Get Master Name Servers Get Master Server Groups Get Secondary Zone Groups Update Master Name Server
Update 07/07/2017	The response for the Get Event Log Entries endpoint now includes the unique ID assigned to the event. This ID is reported through the Event ID parameter. This ID may be passed to the Get Event Log Entry endpoint to retrieve information about that event.
5/31/2017	The Flash Media StreamingThis service was discontinued on 5/31/2017. The Flash Media Streaming platform streamed live and on-demand content via a Flash media player over a RTMP-based protocol., HLSAllows the creation of a customized report data., and HDS services were discontinued on May 31, 2017. Information for endpoints that are specific to these services is solely provided as a reference for the migration of automation scripts to a different streaming technology (e.g., Dynamic Cloud Packaging). View the endpoints that have been discontinued. Flash Media Streaming Add Customer Origin - FMS- Discontinued Add SWF Verification URL - Discontinued Check All SWF Verification URLs - Discontinued Delete SWF Verification URL - Discontinued Get All Customer Origins - FMS- Discontinued Get All SWF Verification URLs - Discontinued Get Customer Origin - FMS- Discontinued Get SWF Verification Status - Discontinued Get SWF Verification URL - Discontinued Update Customer Origin - FMS- Discontinued Update SWF Verification Status - Discontinued Update SWF Verification URL - Discontinued HLS and HDS Add Event - Discontinued Add PHLS Directory - Discontinued Delete Event - Discontinued Delete PHLS Directory - Discontinued Get All Events - Discontinued Get All PHLS Directory - Discontinued Get Event - Discontinued Get PHLS Directory - Discontinued Update Event - Discontinued Update On-Demand HLS/HDS Status - Discontinued Update PHLS Directory - Discontinued Live Authentication (FMS and HLS/HDS) Add Stream Key - Discontinued Delete Stream Key - Discontinued Get All Stream Keys - Discontinued Get Global Key - Discontinued Get Stream Key - Discontinued Update Global Key - Discontinued Update Stream Key - Discontinued
New 04/27/2017	The following Dynamic Cloud Packaging endpoints are now available: Add Encrypted HLS Directory Add Instance Add Stream Key Delete Encrypted HLS Directory Delete Instance Delete Stream Key Get All Instances Get Encrypted HLS Directories Get Global Key Get Stream Keys Update Global Key Update Instance Update Stream Key
New 06/29/2016	The Get Current Edge CNAME Statistics II endpoint retrieves edge CNAME-specific statistics and indicates the date/time for which data was retrieved.
New 04/11/2016	The Get Load Request endpoint provides status information on a load request submitted via the Load Content endpoint.
Update 04/11/2016	A response body parameter was added to the Load Content endpoint. This parameter indicates the unique ID assigned to a request to load content.
Update 4/06/2016	All Defend endpoints have been modified to return the following status codes: 400 Bad Request: Indicates that an invalid date range was requested. 404 Not Found: Indicates that the requested object does not exist or is invalid for your customer account.
Update 4/06/2016	The response for the Update Configuration endpoint now conforms to JSON standards.
New 03/21/2016	The Get Route Summary Query endpoint retrieves statistics on DNS queries.
New 02/11/2016	The Get Current Edge CNAME Statistics endpoint retrieves edge CNAME-specific statistics.
Update 1/21/2016	The Referrer response parameter has been replaced by the Referer response parameter in the following endpoints: Get Available Event Log Fields Get Event Log Entries Get Event Log Entry