v13.0.0 (2026-02-16)
Breaking Changes:
- deprecated(user): The Compute package metadata model
hashsumandsizefields have been deprecated.
Enhancements:
- feat(apisecurity-operations): Add new API Security Operations API.
- feat(domain-inspector-realtime, domain-inspector-historical): Add new metrics
compute_*. - feat(realtime, historical): Add new metrics
compute_resp_status_*. - feat(realtime, historical): Add new metric
ngwaf_bot_analysis_request_count. - feat(backend): Add support for
fetch_timeoutfield. - feat(historical): Add support for
datacenterquery.
v12.1.0 (2025-12-09)
Enhancements:
-
feat(py): Update to support urllib3 2.6.0 (fastly-py#112)
-
feat(realtime, historical): Add new metrics
imgopto_compute_requests,dns_billable_responses_count,dns_nonbillable_responses_count, andupgrade. -
feat(products[ngwaf]): Add new parameter
traffic_ramptoenable-product-ngwaf. -
feat(products[ddos_protection]): Add new parameter
modetoenable-product-ddos-protection. -
feat(kv_store): Add
kv-store-putoperation. -
feat(iam_roles): Add
DisplayNamefield to model. -
feat(domain_research): Add new Domain Research API.
-
feat(ddos_protection): Add
requests_allowedandrequests_detectedfields to DDoS Protection event API. -
feat(products): Add
domain_researchproduct to enablement API.
Documentation:
- doc(enabled-products): Add support for optional enablement parameters for some products.
v12.0.0 (2025-10-31)
Bug fixes:
- fix(dictionary): Correct example dictionary name to use valid characters
Enhancements:
- feat(iam_roles): Add new IAM Roles API.
- feat(api_discovery): Add new API Discovery API.
- feat(realtime, historical): Add new metric
api_discovery_requests_count. - feat(user): Add the ability to assign multiple roles to users.
- feat(healthcheck): Clarify the valid range for the
check_intervalparameter. - feat(ddos_protection): Add
traffic_percentagefield to DDoS Protection traffic statistics responses. - feat(ddos_protection): Update
ddos-protection-event-rule-listwithinclude=traffic_statsparameter for embedded traffic statistics. - feat(logging_https): Add
periodparameter to the logging HTTPS endpoint.
Documentation:
- doc(sudo): Spelling fixes.
- doc(enabled-products): Add support for product ID
api_discovery.
v11.0.0 (2025-08-28)
Breaking Changes:
- removed(ddos_protection): Remove enum configs
ddos_protection_actionand ``ddos_protection_traffic_attribute`. - changed(backend): Added default values to
tcp_keepalive_interval,tcp_keepalive_probes, andtcp_keepalive_timeproperties. - removed(tls_subscriptions): Remove
forceparameter from TLS subscriptions.
Enhancements:
- feat(ngwaf_reports): Add Get attacks report endpoint.
- feat(kv_store): Add
nameparameter to the List KV stores endpoint. - feat(historical): Add
servicesparameter to the Historical Stats API endpoint. - feat(ddos_protection): Add PATCH endpoint in the Fastly DDoS Protection Events API allowing customers to update the DDoS rules action to
log,block,default, oroff. - feat(observability_timeseries): Add Observability Timeseries API for data visualized in the Sustainability dashboard.
Documentation:
- doc(backend, pool): Describe difference in behavior of
between_bytes_timeoutbetween Deliver and Compute services. - doc(ddos_protection): Update GET API docs describing that they can be accessed by any user role as long as the service belongs to the customer.
v10.1.0 (2025-07-07)
Bug fixes:
- fix(backend): Marked
prefer_ipv6as not nullable, and documented that the default value differs for Delivery and Compute services. - fix(invitations): Marked
service_invitations.dataunder relationships as nullable, and corrected model composition.
Enhancements:
- feat(tls_certificates): Add
allow_untrusted_rootattribute for TLS certificate creation and update endpoints
Documentation:
- doc: Update redirect URLs
v10.0.0 (2025-06-11)
Breaking Changes:
- removed(properties): Remove logging placement value
waf_debug.
Bug fixes:
- fix(backend): Marked
prefer_ipv6as nullable.
Enhancements:
- feat(historical): The following Next-Gen WAF metrics have been updated to include both Edge WAF and
-
Core WAF counts:`ngwaf_requests_total_count`, `ngwaf_requests_blocked_count`,
Documentation:
- doc(domain-discovery): Correct documentation of valid values of
scopequery parameter. - doc(observability-aggregations-for-logs): Correct documentation of valid values of
log-aggregations-filterquery parameter. - doc(backend): Tweak language of
prefer_ipv6description. - doc(service): Add documentation for
filter[versions.active]query parameter when getting detailed information on a specified service.
v9.0.0 (2025-05-12)
Breaking Changes:
-
deprecated(user): The POST /user endpoint has been deprecated.
-
fix(acls_in_compute): Corrected the successful
PATCHresponse code from the/resources/acls/${acl_id}/entriesendpoint.
Enhancements:
- feat(products): Add endpoint to each service-level product to list services that enable that product.
- feat(observability-aggregations-for-logs): Add new Observability Aggregations API for Logs.
- feat(observability-timeseries-for-logs): Add new Observability Timeseries API for Logs.
- feat(pops): Add new Mexico regions.
- feat(historical): Add new Mexico regions.
- feat(ddos-protection): Add
ddos-protectionproduct. - feat(backend): Add the
prefer_ipv6option to prefer IPv6 during a backend DNS hostname lookup. - feat(products): Added new GET endpoint for all services with product enabled on a customer.
Documentation:
- doc(kv-store): Add clarification on valid KV Store names.
- doc(kv-store-item): Add clarification on valid KV Store keys.
- doc(dictionary): Usages of
edge dictionarystandardized todictionary. - doc(acls-in-compute): Add documentation on how to remove a single ACL entry using the existing
compute-acl-update-aclsoperation. - doc(acls-in-compute): Correct documentation on
actionfield ofcompute-acl-update-aclsendpoint.
v8.0.0 (2025-03-13)
Breaking Changes:
-
fix(automation_tokens): Response content types corrected.
-
fix(automation_tokens): Removed timestamp fields.
-
removed(billing): Billing v2 API has been removed.
-
fix(acls_in_compute): Corrected
meta.limitfield type from string to integer. -
fix(condition): Condition responses now always have a string value for the priority field.
-
fix(header): Header responses now always have a string value for the priority field.
-
fix(snippet): Snippet responses now always have string values for the priority and dynamic fields.
-
fix(kv_store_item):
kv-store-get-itemreturns an inline object instead of a File object.
Enhancements:
- fix(automation_tokens): Added tls_access, creator_id fields to responses.
- feat(billing_usage_metrics): Added filter by service identifier for service-usage-metrics endpoint.
- feat(historical): Added new metrics:
ngwaf_requests_total_count,ngwaf_requests_unknown_count,ngwaf_requests_allowed_count,ngwaf_requests_logged_count,ngwaf_requests_blocked_count,ngwaf_requests_timeout_count, andngwaf_requests_challenged_count. - feat(tls_bulk_certificates): Added
not_beforeandnot_afterfilter parameters to allow for filtering of bulk TLS certificates by expiry.
Documentation:
- doc(billing_usage_metrics): Correct documentation of pagination limits.
- doc(billing_usage_metrics): Correct documentation of api conditions for product_id and usage_type_name filters.
- doc(logging_azureblob): Mention Azure Block size limits.
v7.0.0 (2025-02-26)
Breaking Changes:
- fix(snippet): Renamed
snippet_idandsnippet_nameproperties toidandnamerespectively. - feat(kv_store, kv_store_item): KV store endpoints have new operation names, and the associated data models also have new names.
- feat(product): Product enablement and configuration endpoints have been renamed into per-product operations.
- fix(historical): Widened integer stats fields to 64 bits.
- fix(realtime, domain_inspector): Widened integer stats fields to 64 bits.
- fix(historical): Corrected field names of
ddos_protection_requests_detect_count,ddos_protection_requests_mitigate_count, andddos_protection_requests_allow_count. - fix(realtime): Corrected field names of
ddos_protection_requests_detect_count,ddos_protection_requests_mitigate_count, andddos_protection_requests_allow_count. - fix(billing_usage_metrics): added parameters
req_start_monthandreq_end_month. - deprecated(billing): Billing v2 API has been deprecated.
- removed(legacy_waf): Legacy WAF API has been removed.
Bug fixes:
- fix(snippet): Marked
contentas nullable to support dynamic snippets. - fix(billing_usage_metrics):
product_idandusage_type_nameparameters are no longer required.
Enhancements:
- feat(products): Added
object_storageandai_acceleratorproducts. - feat(historical): Added new metrics:
object_storage_class_a_operations_count,object_storage_class_b_operations_count,aia_requests,aia_status_1xx,aia_status_2xx,aia_status_3xx,aia_status_5xx,aia_response_usage_tokens,aia_origin_usage_tokens,aia_estimated_time_saved_ms,request_collapse_usable_count,request_collapse_unusable_count,status_530, andcompute_cache_operations_count. - feat(realtime): Added new metrics:
object_storage_class_a_operations_count,object_storage_class_b_operations_count,aia_requests,aia_status_1xx,aia_status_2xx,aia_status_3xx,aia_status_5xx,aia_response_usage_tokens,aia_origin_usage_tokens,aia_estimated_time_saved_ms,request_collapse_usable_count,request_collapse_unusable_count,status_530, andcompute_cache_operations_count. - feat(object_storage_access_keys): Added Object Storage Access Keys API.
- feat(domain_inspector_historical, domain_inspector_realtime): Added new metrics:
status_530andorigin_status_530. - feat(origin_inspector_historical, origin_inspector_realtime): Added new metrics:
status_530,waf_status_530,compute_status_530, andall_status_530. - feat(kv_store_item): Added support for
if-generation-match. - feat(acls_in_compute): Added ACLs in Compute API.
Documentation:
- doc(billing_usage_metrics): Documented that
start_monthandend_monthare required. - doc(historical): Correct default start time in description of Historical Stats API.
- doc(domain_inspector_historical): Removed duplicate description.
- doc(domain_inspector_realtime): Removed duplicate description.
- doc(origin_inspector_historical): Removed duplicate description.
- doc(origin_inspector_realtime): Removed duplicate description.
- doc(backend): Updated description of Backend API.
- doc(backend): Clarified default behavior of keepalive_time.
- doc(waf): Updated EOL notice of legacy-waf.
v6.0.0 (2024-12-05)
Breaking Changes:
- fix(udm-domains): Use v1 versioned HTTP endpoints for UDM domains
- fix(historical): Remove references to VCL on Compute metrics
- fix(realtime): Remove references to VCL on Compute metrics
- feat(billing-usage-metrics): Updated to v3 of the API
Bug fixes:
- fix(acls-in-compute): Corrected shape of
compute-acl-updatemodel.
Enhancements:
- feat(object-storage-access-keys): Added Object Storage Access Keys API
- feat(logging-grafanacloudlogs): Added Grafana Cloud Logs Loggin API
- feat(log-explorer): Added Log Explorer API
- feat(insights): Added Insights API
- feat(kv-store-item): Added
consistencyparameter toget-keysoperation. - feat(enabled-products): Added
modeproperty toset-configuration.
Documentation:
- doc(observability-custom-dashboards): Fix bad link in custom dashboard documentation
- doc(observability-custom-dashboards): Reformat some enums to fix docs rendering
- doc(acls-in-compute): Corrections to descriptions of
compute-acl-lookup,compute-acl-list-entries,compute-acl-update-entry, andcompute-acl-updatestructures - doc(enabled-products): Added support for product ID
log_explorer_insights. - doc(enabled-products): Added support for product ID
ddos_protection.
v5.10.0 (2024-10-23)
Bug fixes:
- bugfix(rust): Implement std::fmt::Display instead of std::string::ToString for enum models.
- bugfix(py): Add dependencies to pyproject.toml.
- fix(contact): Corrected endpoint called by
delete-contactoperation - fix(origin-inspector, domain-inspector): Use integer type for Timestamp.
- fix(billing): Make all fields on billing list item data nullable
- fix(billing): make rate-per-unit nullable
- fix(billing): Adjust type of regional data to help the generator
- fix(billing): Correct type of invoice_id field
- fix(logging): For several endpoints, correct use_tls to be string
- fix(backend): Correct tcp_keepalive_enable to be nullable
- bugfix(billing_address, invitations): Correct customer relationship schema to be single entry rather than array
- bugfix(request_settings): Mark request_settings fields as nullable: bypass_busy_wait, force_miss, geo_headers, max_stale_age, timer_support, and xff
- bugfix(resource): Correct
type_resourceaccepted values - bugfix(sudo): Mark API to require authentication token
- bugfix(alerts-definitions): For Origin derived metrics, correct
all_bandwidthtype tointeger
Enhancements:
- feat(generator): The API Client Generator now uses a new automatic changelog generation process.
- feat(acls-in-compute): Add ACLs in Compute API
- feat(enabled-products): Updated to use
v1versioned endpoints. - feat(enabled-products): Added
get-product-configuration,set-product-configurationoperations. - feat(realtime, historical): Added
request_denied_get_head_bodymetric. - feat(tls): Add definitions for values of sort parameter
- feat(staging): Add activate/deactivate endpoints for staging
- feat(customer-addresses): Add Customer Addresses API
- feat(observability): Adds new Observability Custom Dashboards API
- feat(billing-invoices): Adds month-to-date invoice information
- feat(billing-usage-metrics): Adds information on service-level usage.
- feat(tls): Adds an endpoint to get a TLS certificate blob (Limited Availability)
- feat(stats): Add
origin_offloadmetric - feat(content):
/content/edge_checkendpoint now returns informational values inhashwhen a timeout occurs or when an object is too large. - feat(logging-datalog): Added additional regions
- feat(historical, realtime): Add the following new metrics:
ddos_action_downgrade,ddos_action_downgraded_connections,vcl_on_compute_hit_requests,vcl_on_compute_miss_requests,vcl_on_compute_pass_requests,vcl_on_compute_error_requests,vcl_on_compute_synth_requests,vcl_on_compute_edge_hit_requests,vcl_on_compute_edge_miss_requests,all_hit_requests,all_miss_requests,all_pass_requests,all_error_requests,all_synth_requests,all_edge_hit_requests,all_edge_miss_requests,all_status_1xx,all_status_2xx,all_status_3xx,all_status_4xx, andall_status_5xx. - feat(backend): Add
tcp_keepalive_*properties to the Backend API, which allow configuring TCP keepalives for backend connections. - feat(image-optimizer-default-settings): Add Image Optimizer Default Settings APIs
- feat(tls-subscriptions): Add
certificate_authorityfilter parameter - feat(logging-s3): Add
file_max_bytesconfiguration field - feat(alerts-definitions): Add
integration_idparameter to the List Alert Definitions endpoint - feat(alerts-definitions): For Origin derived metrics, add
all_status_4xx_excl_404_rateandall_status_404_rateproperties - feat(alerts-definitions): For Domain derived metrics, add
status_4xx_excl_404_rateandstatus_404_rateproperties - feat(alerts-definitions): For Stats derived metrics, add
status_4xx_excl_404_rate,status_404_rate,all_status_5xx_rate,all_status_4xx_rate,all_status_gte_400_rate, andall_status_lt_500_rateproperties - feat(billing-invoices): For invoice line items, added
ProductLineproperty
Documentation:
- docs(generator): Update links in docs and comments with unified docs site URL structure
- docs(generator): Clean up README by using GitHub alert icons and collapsible sections
- doc(backend): Correct spelling in
connect_timeoutandfirst_byte_timeoutfield descriptions. - doc(enabled-products): Added support for product IDs
bot_managementandngwaf. - doc(realtime): Correct description of miss_histogram structure in real-time stats.
- doc(logging-kinesis): Update description of
formatfield. - doc(tls-subscriptions): Update descriptions of
certificate_authorityandtls_subscription_includefields. - doc(billing-invoices): "Billing Invoices API" relabeled to "Invoices API"
- doc(billing-invoices): Updated documentation of
billing_start_dateandbilling_end_datequery parameters of List of invoices endpoint - doc(alerts-definitions): Updated documentation of several fields
- doc(notification-service): Updated documentation examples for several fields