A Service represents the configuration for a website, app, API, or anything else to be served through Fastly. A Service can have many Versions, through which Backends, Domains, and more can be configured.

Data model

commentstringA freeform descriptive note.
customer_idstringAlphanumeric string identifying the customer.
namestringThe name of the service.
typestringThe type of this service.
active_versionobjectConfiguration for the active version of this service.
created_atstringDate and time in ISO 8601 format.
deleted_atstringDate and time in ISO 8601 format.
idstringAlphanumeric string identifying the service.
pausedbooleanWhether the service is paused. Services are paused due to a lack of traffic for an extended period of time. Services are resumed either when a draft version is activated or a locked version is cloned and reactivated.
publish_keystringUnused at this time.
updated_atstringDate and time in ISO 8601 format.
versionintegerCurrent version of the service.
versionsarrayA list of versions associated with the service.
backendsarrayList of backends associated to this service.
cache_settingsarrayList of cache settings associated to this service.
conditionsarrayList of conditions associated to this service.
directorsarrayList of directors associated to this service.
domainsarrayList of domains associated to this service.
gzipsarrayList of gzip rules associated to this service.
headersarrayList of headers associated to this service.
healthchecksarrayList of healthchecks associated to this service.
request_settingsarrayList of request settings for this service.
response_objectsarrayList of response objects for this service.
settingsobjectList of default settings for this service.
snippetsarrayList of VCL snippets for this service.
vclsarrayList of VCL files for this service.
wordpressarrayA list of Wordpress rules with this service.


List services


Create a service


Get service details


Search for a service by name


Get a service


Update a service


Delete a service


List the domains within a service