fastly/fastly

PHP API client v14.0.0

Artifact
fastly-14.0.0.zip (3.4MB)

Generated on: Fri Jul 17 12:51:42 UTC 2026
G-code: bc34d07e, D-code: 5b9e76f7

PHP API client v13.1.0

Artifact
fastly-13.1.0.zip (3.2MB)

Generated on: Tue Mar 31 05:25:16 UTC 2026
G-code: bc34d07e, D-code: e6d75df4

PHP API client v13.0.0

Artifact
fastly-13.0.0.zip (3.1MB)

Generated on: Mon Feb 16 09:20:23 UTC 2026
G-code: 9cbe6734, D-code: f1f08971

PHP API client v12.1.0

Artifact
fastly-12.1.0.zip (3.1MB)

Generated on: Tue Dec 9 09:45:17 UTC 2025
G-code: bc5e590d, D-code: 0d6bf445

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_interval parameter.
• feat(ddos_protection): Add traffic_percentage field to DDoS Protection traffic statistics responses.
• feat(ddos_protection): Update ddos-protection-event-rule-list with include=traffic_stats parameter for embedded traffic statistics.
• feat(logging_https): Add period parameter to the logging HTTPS endpoint.

Documentation:

• doc(sudo): Spelling fixes.
• doc(enabled-products): Add support for product ID api_discovery.

Breaking Changes:

• removed(ddos_protection): Remove enum configs ddos_protection_action and ``ddos_protection_traffic_attribute`.
• changed(backend): Added default values to tcp_keepalive_interval, tcp_keepalive_probes, and tcp_keepalive_time properties.
• removed(tls_subscriptions): Remove force parameter from TLS subscriptions.

Enhancements:

• feat(ngwaf_reports): Add Get attacks report endpoint.
• feat(kv_store): Add name parameter to the List KV stores endpoint.
• feat(historical): Add services parameter 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, or off.
• 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_timeout between 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.

Bug fixes:

• fix(backend): Marked prefer_ipv6 as not nullable, and documented that the default value differs for Delivery and Compute services.
• fix(invitations): Marked service_invitations.data under relationships as nullable, and corrected model composition.

Enhancements:

• feat(tls_certificates): Add allow_untrusted_root attribute for TLS certificate creation and update endpoints

Documentation:

• doc: Update redirect URLs

Breaking Changes:

• removed(properties): Remove logging placement value waf_debug.

Bug fixes:

• fix(backend): Marked prefer_ipv6 as 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 scope query parameter.
• doc(observability-aggregations-for-logs): Correct documentation of valid values of log-aggregations-filter query parameter.
• doc(backend): Tweak language of prefer_ipv6 description.
• doc(service): Add documentation for filter[versions.active] query parameter when getting detailed information on a specified service.

Breaking Changes:

• deprecated(user): The POST /user endpoint has been deprecated.

• fix(acls_in_compute): Corrected the successful PATCH response code from the /resources/acls/${acl_id}/entries endpoint.

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-protection product.
• feat(backend): Add the prefer_ipv6 option 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 dictionary standardized to dictionary.
• doc(acls-in-compute): Add documentation on how to remove a single ACL entry using the existing compute-acl-update-acls operation.
• doc(acls-in-compute): Correct documentation on action field of compute-acl-update-acls endpoint.

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.limit field 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-item returns 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, and ngwaf_requests_challenged_count.
• feat(tls_bulk_certificates): Added not_before and not_after filter 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.

Breaking Changes:

• fix(snippet): Renamed snippet_id and snippet_name properties to id and name respectively.
• 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, and ddos_protection_requests_allow_count.
• fix(realtime): Corrected field names of ddos_protection_requests_detect_count, ddos_protection_requests_mitigate_count, and ddos_protection_requests_allow_count.
• fix(billing_usage_metrics): added parameters req_start_month and req_end_month.
• deprecated(billing): Billing v2 API has been deprecated.
• removed(legacy_waf): Legacy WAF API has been removed.

Bug fixes:

• bugfix(php): Define apiKeys on the Configuration class (Fix PHP deprecated syntax)
• fix(snippet): Marked content as nullable to support dynamic snippets.
• fix(billing_usage_metrics): product_id and usage_type_name parameters are no longer required.

Enhancements:

• feat(products): Added object_storage and ai_accelerator products.
• 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, and compute_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, and compute_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_530 and origin_status_530.
• feat(origin_inspector_historical, origin_inspector_realtime): Added new metrics: status_530, waf_status_530, compute_status_530, and all_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_month and end_month are 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.

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-update model.

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 consistency parameter to get-keys operation.
• feat(enabled-products): Added mode property to set-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, and compute-acl-update structures
• doc(enabled-products): Added support for product ID log_explorer_insights.
• doc(enabled-products): Added support for product ID ddos_protection.

Documentation:

• doc(backend): Correct spelling in connect_timeout and first_byte_timeout field descriptions.

Bug fixes:

• bugfix(rust): Implement std::fmt::Display instead of std::string::ToString for enum models.
• fix(contact): Corrected endpoint called by delete-contact operation
• fix(origin-inspector, domain-inspector): Use integer type for Timestamp.
• fix(billing): Make all fields on billing list item data nullable

Enhancements:

• feat(acls-in-compute): Add ACLs in Compute API
• feat(enabled-products): Updated to use v1 versioned endpoints.
• feat(enabled-products): Added get-product-configuration, set-product-configuration operations.
• feat(realtime, historical): Added request_denied_get_head_body metric.
• feat(tls): Add definitions for values of sort parameter
• feat(staging): Add activate/deactivate endpoints for staging
• feat(customer-addresses): Add Customer Addresses API

Documentation:

• doc(enabled-products): Added support for product IDs bot_management and ngwaf.

Bug fixes:

• fix(billing): make rate-per-unit nullable

Bug fixes:

• fix(billing): Adjust type of regional data to help the generator
• fix(billing): Correct type of invoice_id field

Enhancements:

• 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_offload metric

Bug fixes:

• fix(logging): For several endpoints, correct use_tls to be string

Enhancements:

• feat(content): /content/edge_check endpoint now returns informational values in hash when a timeout occurs or when an object is too large.
• feat(logging-datalog): Added additional regions

Bug fixes:

• bugfix(alerts-definitions): For Origin derived metrics, correct all_bandwidth type to integer

Enhancements:

• feat(logging-s3): Add file_max_bytes configuration field
• feat(alerts-definitions): Add integration_id parameter to the List Alert Definitions endpoint
• feat(alerts-definitions): For Origin derived metrics, add all_status_4xx_excl_404_rate and all_status_404_rate properties
• feat(alerts-definitions): For Domain derived metrics, add status_4xx_excl_404_rate and status_404_rate properties
• 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, and all_status_lt_500_rate properties
• feat(billing-invoices): For invoice line items, added ProductLine property

Documentation:

• doc(billing-invoices): "Billing Invoices API" relabeled to "Invoices API"
• doc(billing-invoices): Updated documentation of billing_start_date and billing_end_date query parameters of List of invoices endpoint
• doc(alerts-definitions): Updated documentation of several fields
• doc(notification-service): Updated documentation examples for several fields

Bug fixes:

• fix(backend): Correct tcp_keepalive_enable to be nullable
• bugfix(resource): Correct type_resource accepted values
• bugfix(sudo): Mark API to require authentication token

Enhancements:

• feat(image-optimizer-default-settings): Add Image Optimizer Default Settings APIs
• feat(tls-subscriptions): Add certificate_authority filter parameter

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(logging-kinesis): Update description of format field.
• doc(tls-subscriptions): Update descriptions of certificate_authority and tls_subscription_include fields.

Bug fixes:

• 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

Enhancements:

• feat(generator): The API Client Generator now uses a new automatic changelog generation process.
• 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, and all_status_5xx.
• feat(backend): Add tcp_keepalive_* properties to the Backend API, which allow configuring TCP keepalives for backend connections.

Documentation:

• doc(realtime): Correct description of miss_histogram structure in real-time stats.

Enhancements:

• feat(billing): add 'get invoice by invoice ID' endpoint.
• feat(billing): add 'list invoices' endpoint.
• feat(image_opto): add 'shield' and 'transform' methods and fields.
• feat(secret_store): add 'name' filter.
• feat(tls): add 'create CSR' endpoint.
• feat(tls_subscription): add 'active order' methods and fields.

Documentation:

• doc(backend) fix openssl link.
• doc(director,domain_inspector,pool,realtime) fix POPs link.
• doc(service) fix service version link.
• doc(tls) fix activation link.

Bug fixes:

• fix(response_object): strongly type response_object create_update requests
• fix(tls_configurations): fix tls_protocols field to be a string array type

Breaking:

• breaking(historical): restructure OpenAPI schema to avoid duplicated data rendering.

Bug fixes:

• fix: no longer display Markdown syntax in code comments.

Enhancements:

• feat(stats): expose new service_id and start_time fields.

Enhancements:

• feat(config_store): add name query param to list endpoint.

Documentation:

• docs: rename Compute@Edge to Compute.

Enhancements:

• feat(stats): add historical DDoS metrics.
• feat(stats): add bot challenges.

Bug fixes:

• fix(snippets): ensure POST response's dynamic field is numerical.

Enhancements:

• feat(events): support extra created_at filters.

Enhancements:

• feat(backend): support share_key field.
• feat(events): support extra created_at filters.
• feat(logging/newrelic): add OTLP endpoints.
• feat(tls/subscriptions): support self_managed_http_challenge field.

Documentation:

• doc(secretstore): correct description for GET endpoint.

Breaking:

The following restructures have helped resolve some issues with our OpenAPI schemas but as a side-effect this has resulted in a break to our API client interface as different types are now being generated.

• refactor: general restructure OpenAPI schemas.
• refactor(domain): remove explicit schema type for 'any'.

Bug fixes:

• fix: change response version type to string.
• fix(cache_settings): change response stale_ttl and ttl types to strings.
• fix(header): change response ignore_if_set and priority types to strings.
• fix(logging): change response period and gzip_level types to strings.
• fix(pool): change response use_tls, max_conn_default, first_byte_timeout, quorum and tls_check_cert types to strings.
• fix(request_settings): change response bypass_busy_wait, force_miss, force_ssl, geo_headers, max_stale_age and timer_support types to strings.
• fix(response_object): change response status type to string.

Bug fixes:

• fix(logging_gcs): set expected default value for 'path'.
• fix(origin_inspector_historical): use correct type for 'values'.
• fix(tls_subscriptions): fix argument order for deleting globalsign email challenge.

Bug fixes:

• fix(billing): rename response field 'lines' to 'line_items'.
• fix(billing): restructure response models like 'aria_invoice_id'.
• fix(billing): make 'sent_at', 'locked', 'require_new_password', 'two_factor_auth_enabled' nullable.

Bug fixes:

• fix: update return types for multiple model methods to avoid deprecation notices.

Substantial changes were made to the underlying OpenAPI specification that produces this API client. These changes have resulted in multiple new endpoints being supported as well as multiple breaking type changes and so we're publishing these changes as a new major release.

Enhancements:

• feat(apex_redirect): support all endpoints.
• feat(contact): support 'create' endpoint.
• feat(director): support 'update' endpoint.
• feat(domain_inspector): support all endpoints.
• feat(iam_roles): support 'add permissions' endpoint.
• feat(iam_roles): support 'create role' endpoint.
• feat(iam_roles): support 'delete permissions' endpoint.
• feat(iam_roles): support 'update role' endpoint.
• feat(iam_services): support 'add services' endpoint.
• feat(iam_services): support 'create service group' endpoint.
• feat(iam_services): support 'remove services' endpoint.
• feat(iam_services): support 'update service group' endpoint.
• feat(iam_users): support 'add members' endpoint.
• feat(iam_users): support 'add roles' endpoint.
• feat(iam_users): support 'add service groups' endpoint.
• feat(iam_users): support 'create user group' endpoint.
• feat(iam_users): support 'remove members' endpoint.
• feat(iam_users): support 'remove roles' endpoint.
• feat(iam_users): support 'remove service groups' endpoint.
• feat(iam_users): support 'update user group' endpoint.
• feat(legacy_waf): support all endpoints.
• feat(logging_kafka): support 'update' endpoint.
• feat(logging_kinesis): support 'update' endpoint.
• feat(origin_inspector): support all endpoints.
• feat(request_settings): support 'create' endpoint.
• feat(response_object): support 'create' endpoint.
• feat(response_object): support 'update' endpoint.
• feat(secret_store): support all endpoints.
• feat(service_authorizations): support 'delete' endpoint.
• feat(service_authorizations): support 'update' endpoint.
• feat(snippet): support 'update versioned snippet' endpoint.
• feat(sudo): support 'request sudo access' endpoint.
• feat(tokens): support 'revoke multiple tokens' endpoint.
• feat(tokens): support 'create token' endpoint.
• feat(waf_active_rules): support 'delete' endpoint.

Bug fixes:

• fix(content): update request/response types.
• fix(events): update metadata type.
• fix(realtime_entry): update recorded/aggregated type.
• fix(realtime_measurements): update miss_histogram type.

Bug fixes:

• fix(snippet): dynamic field switched from int to string.
• fix(vcl): implement correct response models.

Enhancements:

• feat(rate_limiter): implement POST/PUT endpoints.

Bug fixes:

• fix(automation_tokens): generate explicit error response type.
• fix(historical_stats): extract primitive into custom type.

Bug fixes:

• fix(historical_stats): generate missing models.

Bug fixes:

• fix(tls_activation): add tls_configuration and tls_domains.
• fix(tls_subscription): add tls_configuration and common name.

Enhancements:

• feat(realtime_measurements): add billable request processing time.
• feat(tokens): add support for the 'get token' endpoint.

Bug fixes:

• fix(config): add realtime hostname.
• fix(historical_stats): generate field results model.
• fix(kv_store): remove the 'force' property from the 'delete store' endpoint.
• feat(realtime_measurements): rename object store to kv store.

Bug fixes:

• fix(acl): change version from int to string.
• fix(acl): add missing methods for service_id and service_version properties.
• fix(backend): make ssl_check_cert nullable.
• fix(purge): skip URL escape for surrogate_key param.
• fix(snippets): change priority and version from int to string.
• fix(snippets): add missing methods for service_id and service_version properties.

Enhancements:

• feat(config_store): add Config Store endpoints.

Breaking changes:

• breaking(object_store): rename to kv_store

Enhancements:

• feat(dictionary_item): add 'bulk' PATCH endpoint.
• feat(package): add files_hash metadata property.
• feat(tls_certificates): add filter[in_use] parameter.

Bug fixes:

• fix(object-store-item): use correct type for key value
• fix(tls-csrs): remove internal endpoint

Bug fixes:

• fix(purge): avoid escaping URL parameter

Enhancements:

• feat(domain-ownership): list API endpoint
• feat(object-store): items API endpoints
• feat(object-store): add 'location' property to 'create_store'
• feat(object-store): add 'force' property to 'delete_store'
• feat(realtime): additional DDoS properties

Documentation:

• docs(acl-entries): document batch updating
• docs(resource): terminology + 'config_store' support.

Bug fixes:

• fix(purge): switch authentication type to 'token'

Enhancements:

• feat(events): implement 'filter_created_at' property
• feat(mutual-authentication): implement 'include' property
• feat(object-store): implement new Object Store API endpoints
• feat(settings): implement Service Settings 'update' endpoint

Documentation:

• docs(backend): keepalive_time
• docs(pop): region, shield, latitude, longitude
• docs(product-enablement): brotli_compression
• docs(resource): terminology
• docs(results): fanout properties
• docs(tls/subscriptions): new 'failed' state
• docs(user): 'login' modification note removed

Full Changelog

Full Changelog

Enhancements:

• New interface from code-generated API client #43
  • Blog post: Better Fastly API clients with OpenAPI Generator
  • Documentation
  • Unsupported API endpoints