{"info":{"_postman_id":"3ae89321-fd45-4694-880c-3081da4ef678","name":"Fastly API","description":"<html><head></head><body><p>Via the Fastly API you can perform any of the operations that are possible within the management console, including creating services, domains, and backends; and configuring rules or uploading your own application code, as well as perform account operations such as user administration and billing reports.</p>\n<p>The API is organized into collections of endpoints that allow manipulation of objects related to Fastly services and accounts.</p>\n<p>For the most accurate and up-to-date API reference content, visit <a href=\"https://developer.fastly.com/reference/api/\">developer.fastly.com/reference/api/</a>.</p>\n</body></html>","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"10146383","collectionId":"3ae89321-fd45-4694-880c-3081da4ef678","publishedId":"TzY1jHHZ","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"e82c2a"},"publishDate":"2021-06-02T04:05:12.000Z"},"item":[{"name":"Account","item":[{"name":"Billing address","item":[{"name":"Get a billing address","id":"b0b06652-af72-4a48-9598-377837a009ff","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":"https://api.fastly.com/customer/{{customer_id}}/billing_address","description":"<p>Get a customer's billing address.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["customer","{{customer_id}}","billing_address"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"31c59876-0a73-482d-b4fc-602fd558ce61","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":"https://api.fastly.com/customer/x4xCwxxJxGCx123Rx5xTx/billing_address","description":"Get a customer's billing address.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":{\"type\":\"billing_address\",\"id\":\"3DTWpamEUGISvrUiDWkesQ\",\"attributes\":{\"address_1\":\"80719 Dorothea Mountain\",\"address_2\":\"Apt. 652\",\"city\":\"New Rasheedville\",\"state\":\"DE\",\"country\":\"US\",\"postal_code\":\"53538-5902\"},\"relationships\":{\"customer\":{\"data\":{\"type\":\"customer\",\"id\":\"x4xCwxxJxGCx123Rx5xTx\"}}}}}"}],"_postman_id":"b0b06652-af72-4a48-9598-377837a009ff"},{"name":"Add a billing address to a customer","id":"a7817751-5a17-470b-b0bf-93b0d53838c9","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"skip_verification\":false,\"data\":{\"type\":\"billing_address\",\"attributes\":{\"address_1\":\"80719 Dorothea Mountain\",\"address_2\":\"Apt. 652\",\"city\":\"New Rasheedville\",\"state\":\"DE\",\"country\":\"US\",\"postal_code\":\"53538-5902\"}}}"},"url":"https://api.fastly.com/customer/{{customer_id}}/billing_address","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/account/billing-address/#add-billing-addr\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["customer","{{customer_id}}","billing_address"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"90656d8d-992e-4812-a48b-78c362ecc926","name":"201 Created","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"skip_verification\":false,\"data\":{\"type\":\"billing_address\",\"attributes\":{\"address_1\":\"80719 Dorothea Mountain\",\"address_2\":\"Apt. 652\",\"city\":\"New Rasheedville\",\"state\":\"DE\",\"country\":\"US\",\"postal_code\":\"53538-5902\"}}}"},"url":"https://api.fastly.com/customer/x4xCwxxJxGCx123Rx5xTx/billing_address","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/account/billing-address/#add-billing-addr)**\n\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"201 Created","code":201,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":{\"type\":\"billing_address\",\"id\":\"3DTWpamEUGISvrUiDWkesQ\",\"attributes\":{\"address_1\":\"80719 Dorothea Mountain\",\"address_2\":\"Apt. 652\",\"city\":\"New Rasheedville\",\"state\":\"DE\",\"country\":\"US\",\"postal_code\":\"53538-5902\"},\"relationships\":{\"customer\":{\"data\":{\"type\":\"customer\",\"id\":\"x4xCwxxJxGCx123Rx5xTx\"}}}}}"}],"_postman_id":"a7817751-5a17-470b-b0bf-93b0d53838c9"},{"name":"Delete a billing address","id":"40e9e314-6ff9-43c2-8609-7933667406e9","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/customer/{{customer_id}}/billing_address","description":"<p>Delete a customer's billing address.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["customer","{{customer_id}}","billing_address"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"6f592a59-6ba1-4032-9529-6010cdcd95bc","name":"204 No Content","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/customer/x4xCwxxJxGCx123Rx5xTx/billing_address","description":"Delete a customer's billing address.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"204 No Content","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"40e9e314-6ff9-43c2-8609-7933667406e9"},{"name":"Update a billing address","id":"5d81d391-7d2d-442c-9fc6-22a49fe54309","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"skip_verification\":false,\"data\":{\"type\":\"billing_address\",\"id\":\"3DTWpamEUGISvrUiDWkesQ\",\"attributes\":{\"state\":\"DE\"}}}"},"url":"https://api.fastly.com/customer/{{customer_id}}/billing_address","description":"<p>Update a customer's billing address. You may update only part of the customer's billing address.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["customer","{{customer_id}}","billing_address"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"0b20a118-350d-442d-8ad9-b1b9e2c3ab37","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"skip_verification\":false,\"data\":{\"type\":\"billing_address\",\"id\":\"3DTWpamEUGISvrUiDWkesQ\",\"attributes\":{\"state\":\"DE\"}}}"},"url":"https://api.fastly.com/customer/x4xCwxxJxGCx123Rx5xTx/billing_address","description":"Update a customer's billing address. You may update only part of the customer's billing address.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":{\"type\":\"billing_address\",\"id\":\"3DTWpamEUGISvrUiDWkesQ\",\"attributes\":{\"address_1\":\"80719 Dorothea Mountain\",\"address_2\":\"Apt. 652\",\"city\":\"New Rasheedville\",\"state\":\"DE\",\"country\":\"US\",\"postal_code\":\"53538-5902\"},\"relationships\":{\"customer\":{\"data\":{\"type\":\"customer\",\"id\":\"x4xCwxxJxGCx123Rx5xTx\"}}}}}"}],"_postman_id":"5d81d391-7d2d-442c-9fc6-22a49fe54309"}],"id":"af8a93fe-76e6-4302-91c0-b5541386e5b5","description":"<p>A billing address is used to calculate your bill correctly.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>address_1</td>\n<td>string</td>\n<td>The first address line.</td>\n</tr>\n<tr>\n<td>address_2</td>\n<td>string</td>\n<td>The second address line.</td>\n</tr>\n<tr>\n<td>city</td>\n<td>string</td>\n<td>The city name.</td>\n</tr>\n<tr>\n<td>country</td>\n<td>string</td>\n<td>ISO 3166-1 two-letter country code.</td>\n</tr>\n<tr>\n<td>customer_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the customer.</td>\n</tr>\n<tr>\n<td>locality</td>\n<td>string</td>\n<td>Other locality.</td>\n</tr>\n<tr>\n<td>postal_code</td>\n<td>string</td>\n<td>Postal code (ZIP code for US addresses).</td>\n</tr>\n<tr>\n<td>state</td>\n<td>string</td>\n<td>The state or province name.</td>\n</tr>\n<tr>\n<td>skip_verification</td>\n<td>boolean</td>\n<td>When set to true, the address will be saved without verification.</td>\n</tr>\n<tr>\n<td>type</td>\n<td>string</td>\n<td>Resource type.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the billing address.</td>\n</tr>\n<tr>\n<td>relationships.customer.id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the customer.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"af8a93fe-76e6-4302-91c0-b5541386e5b5"},{"name":"Usage Metrics API","item":[{"name":"Retrieve service-level usage metrics for services with non-zero usage units","id":"ba6f5dad-c22a-4e5d-ad72-6dd44b73053b","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/billing/v3/service-usage-metrics?cursor&end_month&limit&product_id&service&start_month&usage_type_name","description":"<p>Returns product usage, broken down by service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Billing</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["billing","v3","service-usage-metrics"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Cursor value from the next_cursor field of a previous response, used to retrieve the next page. To request the first page, this should be empty.</p>\n","type":"text/plain"},"key":"cursor"},{"description":{"content":"<p>The end month for metrics.</p>\n","type":"text/plain"},"key":"end_month"},{"description":{"content":"<p>Number of results per page. The maximum is 10000.</p>\n","type":"text/plain"},"key":"limit"},{"description":{"content":"<p>The product identifier for the metrics returned (e.g., cdn_usage). This should be used along with usage_type_name.</p>\n","type":"text/plain"},"key":"product_id"},{"description":{"content":"<p>The service identifier for the metrics being requested.</p>\n","type":"text/plain"},"key":"service"},{"description":{"content":"<p>The start month for metrics.</p>\n","type":"text/plain"},"key":"start_month"},{"description":{"content":"<p>The usage type name for the metrics returned (e.g., North America Requests). This should be used along with product_id.</p>\n","type":"text/plain"},"key":"usage_type_name"}],"variable":[]}},"response":[{"id":"5ba82ad8-24e6-4900-8004-b887ae3bfdc9","name":"200 A response containing usage elements.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/billing/v3/service-usage-metrics?end_month=2023-03&start_month=2023-01?cursor&end_month&limit&product_id&service&start_month&usage_type_name","protocol":"https","host":["api","fastly","com"],"path":["billing","v3","service-usage-metrics"],"query":[{"key":"cursor","description":"Cursor value from the next_cursor field of a previous response, used to retrieve the next page. To request the first page, this should be empty."},{"key":"end_month","description":"The end month for metrics."},{"key":"limit","description":"Number of results per page. The maximum is 10000."},{"key":"product_id","description":"The product identifier for the metrics returned (e.g., cdn_usage). This should be used along with usage_type_name."},{"key":"service","description":"The service identifier for the metrics being requested."},{"key":"start_month","description":"The start month for metrics."},{"key":"usage_type_name","description":"The usage type name for the metrics returned (e.g., North America Requests). This should be used along with product_id."}]},"description":"Returns product usage, broken down by service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Billing](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 A response containing usage elements.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":{\"customer_id\":\"2fNwVYePN8WqqDFvVf7XMN\",\"start_time\":\"2023-01-01T00:00:00.000Z\",\"end_time\":\"2023-03-31T00:15:00.000Z\",\"usage_type\":\"\",\"unit\":\"\",\"details\":[{\"customer_id\":\"2fNwVYePN8WqqDFvVf7XMN\",\"service_id\":\"bptj4wc6VheGhOPN0Okjt5\",\"service_name\":\"Example Production Challenge Service Audio\",\"usage_units\":0.011197259,\"usage_type\":\"North_America_Bandwidth\",\"unit\":\"gb\"},{\"customer_id\":\"2fNwVYePN8WqqDFvVf7XMN\",\"service_id\":\"vpFdIXI0NmgoBSbbFbxbY4\",\"service_name\":\"Example Production Client Challenge Health Check Service\",\"usage_units\":369.108883208,\"usage_type\":\"North_America_Bandwidth\",\"unit\":\"gb\"},{\"customer_id\":\"2fNwVYePN8WqqDFvVf7XMN\",\"service_id\":\"GF4YOGOTsnGkRb6ydDbib4\",\"service_name\":\"Example Production Client Challenge Service A\",\"usage_units\":39.885526458,\"usage_type\":\"Asia_Requests\",\"unit\":\"unit\"},{\"customer_id\":\"2fNwVYePN8WqqDFvVf7XMN\",\"service_id\":\"hSzFGIm8kMN0HdiW7Ppdn3\",\"service_name\":\"Example Production Client Challenge Service B\",\"usage_units\":84.736532146,\"usage_type\":\"North_America_Requests\",\"unit\":\"unit\"},{\"customer_id\":\"2fNwVYePN8WqqDFvVf7XMN\",\"service_id\":\"dxlSF5cAWt2VcwitclfKL6\",\"service_name\":\"se--1xinternetgmbh--66558d4f3319eaad8bd98cae\",\"usage_units\":66.736532146,\"usage_type\":\"Africa_Bandwidth\",\"unit\":\"gb\"}]},\"meta\":{\"next_cursor\":\"MTC==\",\"limit\":5,\"sort\":\"service_name\",\"total\":142}}"}],"_postman_id":"ba6f5dad-c22a-4e5d-ad72-6dd44b73053b"},{"name":"Get monthly usage metrics","id":"dcfdef6b-0be4-47f4-8cb1-6b77d8685b2e","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/billing/v3/usage-metrics?end_month&start_month","description":"<p>Returns monthly usage metrics for customer by product.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Billing</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["billing","v3","usage-metrics"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>The end month for metrics.</p>\n","type":"text/plain"},"key":"end_month"},{"description":{"content":"<p>The start month for metrics.</p>\n","type":"text/plain"},"key":"start_month"}],"variable":[]}},"response":[{"id":"dfd28885-01ba-4198-8307-7cc6e5efaccd","name":"200 A response containing usage metric elements.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/billing/v3/usage-metrics?end_month=2024-06&start_month=2024-05?end_month&start_month","protocol":"https","host":["api","fastly","com"],"path":["billing","v3","usage-metrics"],"query":[{"key":"end_month","description":"The end month for metrics."},{"key":"start_month","description":"The start month for metrics."}]},"description":"Returns monthly usage metrics for customer by product.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Billing](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 A response containing usage metric elements.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"month\":\"2024-07\",\"usage_type\":\"Other\",\"name\":\"Fastly TLS - Non-Profit CA / Bring Your Own Certificates\",\"region\":\"Global\",\"unit\":\"unit\",\"quantity\":2,\"raw_quantity\":2,\"product_id\":\"fastly_tls\",\"last_updated_at\":\"2024-08-01\"},{\"month\":\"2024-09\",\"usage_type\":\"Other\",\"name\":\"Fastly TLS - Non-Profit CA / Bring Your Own Certificates\",\"region\":\"Global\",\"unit\":\"unit\",\"quantity\":3,\"raw_quantity\":3,\"product_id\":\"fastly_tls\",\"last_updated_at\":\"2024-09-04\"}]}"}],"_postman_id":"dcfdef6b-0be4-47f4-8cb1-6b77d8685b2e"}],"id":"17f72e5f-3779-494d-96db-5e59c2868bb0","description":"<p>Get information on billing usage metrics.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Billing</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>customer_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the customer.</td>\n</tr>\n<tr>\n<td>end_time</td>\n<td>string</td>\n<td>Date and time (in ISO 8601 format) for termination point of a billing cycle, signifying the end of charges for a service or subscription.</td>\n</tr>\n<tr>\n<td>meta</td>\n<td>object</td>\n<td>Pagination metadata.</td>\n</tr>\n<tr>\n<td>start_time</td>\n<td>string</td>\n<td>Date and time (in ISO 8601 format) for initiation point of a billing cycle, signifying the start of charges for a service or subscription.</td>\n</tr>\n<tr>\n<td>unit</td>\n<td>string</td>\n<td>The unit for the usage as shown on an invoice. If there is no explicit unit, this field will be \"unit\" (e.g., a request with product_id of 'cdn_usage' and usage_type of 'North America Requests' has no unit, and will return \"unit\").</td>\n</tr>\n<tr>\n<td>usage_type</td>\n<td>string</td>\n<td>The usage type identifier for the usage. This is a single, billable metric for the product.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>Full name of the product usage type as it might appear on a customer's invoice.</td>\n</tr>\n<tr>\n<td>product_id</td>\n<td>string</td>\n<td>The product identifier associated with the usage type. This corresponds to a Fastly product offering.</td>\n</tr>\n<tr>\n<td>limit</td>\n<td>integer</td>\n<td>The number of invoices included in the response.</td>\n</tr>\n<tr>\n<td>next_cursor</td>\n<td>string</td>\n<td>The token used to request the next set of results.</td>\n</tr>\n<tr>\n<td>sort</td>\n<td>string</td>\n<td>The sort order of the invoices in the response.</td>\n</tr>\n<tr>\n<td>total</td>\n<td>integer</td>\n<td>Total number of records available on the backend.</td>\n</tr>\n<tr>\n<td>last_updated_at</td>\n<td>string</td>\n<td>The date when the usage metric was last updated.</td>\n</tr>\n<tr>\n<td>month</td>\n<td>string</td>\n<td>The year and month of the usage element.</td>\n</tr>\n<tr>\n<td>quantity</td>\n<td>number</td>\n<td>The quantity of the usage for the product.</td>\n</tr>\n<tr>\n<td>raw_quantity</td>\n<td>number</td>\n<td>The raw units measured for the product.</td>\n</tr>\n<tr>\n<td>region</td>\n<td>string</td>\n<td>The geographical area applicable for regionally based products.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"17f72e5f-3779-494d-96db-5e59c2868bb0"},{"name":"Customer Contact","item":[{"name":"List contacts","id":"30989379-05fe-4490-9741-168998b64309","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/customer/{{customer_id}}/contacts","description":"<p>List all contacts from a specified customer ID.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["customer","{{customer_id}}","contacts"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"17a71e60-404a-4deb-95fa-2d0c6bcfd7ec","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/customer/x4xCwxxJxGCx123Rx5xTx/contacts","description":"List all contacts from a specified customer ID.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"id\":\"hTE5dRlSBICGPJxJwCH4M\",\"name\":null,\"email\":null,\"type\":\"security\",\"phone_number\":\"5555555559\",\"user_id\":\"x9KzsrACXZv8tPwlEDsKb6\",\"customer_id\":\"x9KzsrACXZv8tPwlEDsKb6\",\"created_at\":\"2020-06-14T14:43:01.000Z\",\"updated_at\":\"2020-06-14T14:43:01.000Z\",\"deleted_at\":null}]"}],"_postman_id":"30989379-05fe-4490-9741-168998b64309"},{"name":"Add a new customer contact","id":"203f0681-74f2-4404-92cc-9e6601089c8a","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/customer/{{customer_id}}/contacts","description":"<p>Create a contact.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["customer","{{customer_id}}","contacts"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"b1170c70-aa14-46a9-b4ec-17fa3f484e91","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/customer/x4xCwxxJxGCx123Rx5xTx/contacts","description":"Create a contact.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"hTE5dRlSBICGPJxJwCH4M\",\"name\":null,\"email\":null,\"type\":\"primary\",\"phone_number\":\"5555555559\",\"user_id\":\"x9KzsrACXZv8tPwlEDsKb6\",\"customer_id\":\"x9KzsrACXZv8tPwlEDsKb6\",\"created_at\":\"2020-06-14T14:43:01.000Z\",\"updated_at\":\"2020-06-14T14:43:01.000Z\",\"deleted_at\":null,\"phone\":\"5555555555\"}"}],"_postman_id":"203f0681-74f2-4404-92cc-9e6601089c8a"},{"name":"Delete a contact","id":"ba511ba1-f10d-4691-a411-c8676741a1a0","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/customer/{{customer_id}}/contacts/{{contact_id}}","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/account/contact/#delete-contact\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["customer","{{customer_id}}","contacts","{{contact_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"fc1c5e77-a52f-405d-88fb-a71bfab331a0","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/customer/x4xCwxxJxGCx123Rx5xTx/contacts/x4xCwxxJxGCx123Rx5xTx","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/account/contact/#delete-contact)**\n\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"ba511ba1-f10d-4691-a411-c8676741a1a0"}],"id":"4a2d9ce9-5e65-4c8c-bf71-503e68526426","description":"<p>A Customer Contact is the base object that holds the different types of contact information Fastly uses to contact a customer.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>contact_type</td>\n<td>string</td>\n<td>The type of contact.</td>\n</tr>\n<tr>\n<td>customer_id</td>\n<td>string</td>\n<td>The alphanumeric string representing the customer for this customer contact.</td>\n</tr>\n<tr>\n<td>email</td>\n<td>string</td>\n<td>The email of this contact, when a user_id is not provided.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The name of this contact, when user_id is not provided.</td>\n</tr>\n<tr>\n<td>phone</td>\n<td>string</td>\n<td>The phone number for this contact. Required for primary, technical, and security contact types.</td>\n</tr>\n<tr>\n<td>user_id</td>\n<td>string</td>\n<td>The alphanumeric string representing the user for this customer contact.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>An alphanumeric string identifying the customer contact.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"4a2d9ce9-5e65-4c8c-bf71-503e68526426"},{"name":"Customer","item":[{"name":"List users","id":"7e7938c4-6ff0-4c1f-afd6-ddd8f78071e3","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/customer/{{customer_id}}/users","description":"<p>List all users from a specified customer id.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["customer","{{customer_id}}","users"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"0f6380bc-c03c-4963-997d-4deb2700d0e5","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/customer/x4xCwxxJxGCx123Rx5xTx/users","description":"List all users from a specified customer id.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"created_at\":\"2020-05-02T17:15:54.000Z\",\"customer_id\":\"x4xCwxxJxGCx123Rx5xTx\",\"deleted_at\":null,\"email_hash\":\"hTE5dRlSBICGPJxJwCH4M\",\"id\":\"x9KzsrACXZv8tPwlEDsKb6\",\"locked\":false,\"login\":\"krisowner@example.com\",\"name\":\"Kris Owner\",\"require_new_password\":false,\"role\":\"user\",\"roles\":[\"6bKsDElwPt8vZXCArszK9x\"],\"two_factor_auth_enabled\":true,\"two_factor_setup_required\":false,\"updated_at\":\"2020-05-21T18:45:00.000Z\"}]"}],"_postman_id":"7e7938c4-6ff0-4c1f-afd6-ddd8f78071e3"},{"name":"Get the logged in customer","id":"9d100615-c1b0-4fac-bc53-e4ddb8d6a0cf","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/current_customer","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/account/customer/#get-logged-in-customer\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["current_customer"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"d8ec4eb8-3f68-4389-ab91-5158f6bf1237","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/current_customer","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/account/customer/#get-logged-in-customer)**\n\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"billing_contact_id\":null,\"billing_network_type\":\"public\",\"billing_ref\":null,\"can_configure_wordpress\":false,\"can_reset_passwords\":true,\"can_upload_vcl\":false,\"force_2fa\":false,\"force_sso\":false,\"has_account_panel\":true,\"has_improved_events\":false,\"has_improved_ssl_config\":false,\"has_openstack_logging\":false,\"has_pci\":false,\"has_pci_passwords\":false,\"id\":\"hTE5dRlSBICGPJxJwCH4M\",\"ip_whitelist\":\"0.0.0.0/0\",\"legal_contact_id\":\"x9KzsrACXZv8tPwlEDsKb6\",\"name\":\"Test Account\",\"owner_id\":\"x9KzsrACXZv8tPwlEDsKb6\",\"phone_number\":\"5555555559\",\"postal_address\":null,\"pricing_plan\":\"developer\",\"pricing_plan_id\":\"6HW4welznAHVnMCJhY9QdX\",\"readonly\":false,\"requires_support_email\":false,\"security_contact_id\":\"x9KzsrACXZv8tPwlEDsKb6\",\"technical_contact_id\":\"x9KzsrACXZv8tPwlEDsKb6\",\"created_at\":\"2020-06-14T14:43:01.000Z\",\"updated_at\":\"2020-06-14T14:43:01.000Z\",\"deleted_at\":null}"}],"_postman_id":"9d100615-c1b0-4fac-bc53-e4ddb8d6a0cf"},{"name":"Get a customer","id":"9a7fd425-b06f-4c48-b334-a7d36a0a044d","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/customer/{{customer_id}}","description":"<p>Get a specific customer.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["customer","{{customer_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"1a61484b-2fb7-4f65-954f-0691f61c856f","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/customer/x4xCwxxJxGCx123Rx5xTx","description":"Get a specific customer.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"billing_contact_id\":null,\"billing_network_type\":\"public\",\"billing_ref\":null,\"can_configure_wordpress\":false,\"can_reset_passwords\":true,\"can_upload_vcl\":false,\"force_2fa\":false,\"force_sso\":false,\"has_account_panel\":true,\"has_improved_events\":false,\"has_improved_ssl_config\":false,\"has_openstack_logging\":false,\"has_pci\":false,\"has_pci_passwords\":false,\"id\":\"hTE5dRlSBICGPJxJwCH4M\",\"ip_whitelist\":\"0.0.0.0/0\",\"legal_contact_id\":\"x9KzsrACXZv8tPwlEDsKb6\",\"name\":\"Test Account\",\"owner_id\":\"x9KzsrACXZv8tPwlEDsKb6\",\"phone_number\":\"5555555559\",\"postal_address\":null,\"pricing_plan\":\"developer\",\"pricing_plan_id\":\"6HW4welznAHVnMCJhY9QdX\",\"readonly\":false,\"requires_support_email\":false,\"security_contact_id\":\"x9KzsrACXZv8tPwlEDsKb6\",\"technical_contact_id\":\"x9KzsrACXZv8tPwlEDsKb6\",\"created_at\":\"2020-06-14T14:43:01.000Z\",\"updated_at\":\"2020-06-14T14:43:01.000Z\",\"deleted_at\":null}"}],"_postman_id":"9a7fd425-b06f-4c48-b334-a7d36a0a044d"},{"name":"Update a customer","id":"5cccda45-2dff-4903-b98e-d56dd8c51276","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/customer/{{customer_id}}","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/account/customer/#update-customer\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["customer","{{customer_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"dd6bc652-d404-4395-aeca-e05cd7164473","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/customer/x4xCwxxJxGCx123Rx5xTx","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/account/customer/#update-customer)**\n\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"billing_contact_id\":null,\"billing_network_type\":\"public\",\"billing_ref\":null,\"can_configure_wordpress\":false,\"can_reset_passwords\":true,\"can_upload_vcl\":false,\"force_2fa\":false,\"force_sso\":false,\"has_account_panel\":true,\"has_improved_events\":false,\"has_improved_ssl_config\":false,\"has_openstack_logging\":false,\"has_pci\":false,\"has_pci_passwords\":false,\"id\":\"hTE5dRlSBICGPJxJwCH4M\",\"ip_whitelist\":\"0.0.0.0/0\",\"legal_contact_id\":\"x9KzsrACXZv8tPwlEDsKb6\",\"name\":\"Updated Test Account\",\"owner_id\":\"x9KzsrACXZv8tPwlEDsKb6\",\"phone_number\":\"5555555559\",\"postal_address\":null,\"pricing_plan\":\"developer\",\"pricing_plan_id\":\"6HW4welznAHVnMCJhY9QdX\",\"readonly\":false,\"requires_support_email\":false,\"security_contact_id\":\"x9KzsrACXZv8tPwlEDsKb6\",\"technical_contact_id\":\"x9KzsrACXZv8tPwlEDsKb6\",\"created_at\":\"2020-06-14T14:43:01.000Z\",\"updated_at\":\"2020-06-14T14:43:01.000Z\",\"deleted_at\":null}"}],"_postman_id":"5cccda45-2dff-4903-b98e-d56dd8c51276"},{"name":"Delete a customer","id":"d4039158-ed78-46bc-b483-0cd93d8fa0fc","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/customer/{{customer_id}}","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/account/customer/#delete-customer\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["customer","{{customer_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"f5835420-80f2-40dc-884c-be018c9e1180","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/customer/x4xCwxxJxGCx123Rx5xTx","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/account/customer/#delete-customer)**\n\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"d4039158-ed78-46bc-b483-0cd93d8fa0fc"}],"id":"f67d03b4-b4e3-4cd8-b2f7-41368148944d","description":"<p>A Customer is the base object that owns your Users and Services. Some information may be limited depending on access level.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>billing_contact_id</td>\n<td>string</td>\n<td>The alphanumeric string representing the primary billing contact.</td>\n</tr>\n<tr>\n<td>billing_network_type</td>\n<td>string</td>\n<td>Customer's current network revenue type.</td>\n</tr>\n<tr>\n<td>billing_ref</td>\n<td>string</td>\n<td>Used for adding purchased orders to customer's account.</td>\n</tr>\n<tr>\n<td>can_configure_wordpress</td>\n<td>boolean</td>\n<td>Whether this customer can view or edit wordpress.</td>\n</tr>\n<tr>\n<td>can_reset_passwords</td>\n<td>boolean</td>\n<td>Whether this customer can reset passwords.</td>\n</tr>\n<tr>\n<td>can_upload_vcl</td>\n<td>boolean</td>\n<td>Whether this customer can upload VCL.</td>\n</tr>\n<tr>\n<td>force_2fa</td>\n<td>boolean</td>\n<td>Specifies whether 2FA is forced or not forced on the customer account. Logs out non-2FA users once 2FA is force enabled.</td>\n</tr>\n<tr>\n<td>force_sso</td>\n<td>boolean</td>\n<td>Specifies whether SSO is forced or not forced on the customer account.</td>\n</tr>\n<tr>\n<td>has_account_panel</td>\n<td>boolean</td>\n<td>Specifies whether the account has access or does not have access to the account panel.</td>\n</tr>\n<tr>\n<td>has_improved_events</td>\n<td>boolean</td>\n<td>Specifies whether the account has access or does not have access to the improved events.</td>\n</tr>\n<tr>\n<td>has_improved_ssl_config</td>\n<td>boolean</td>\n<td>Whether this customer can view or edit the SSL config.</td>\n</tr>\n<tr>\n<td>has_openstack_logging</td>\n<td>boolean</td>\n<td>Specifies whether the account has enabled or not enabled openstack logging.</td>\n</tr>\n<tr>\n<td>has_pci</td>\n<td>boolean</td>\n<td>Specifies whether the account can edit PCI for a service.</td>\n</tr>\n<tr>\n<td>has_pci_passwords</td>\n<td>boolean</td>\n<td>Specifies whether PCI passwords are required for the account.</td>\n</tr>\n<tr>\n<td>ip_whitelist</td>\n<td>string</td>\n<td>The range of IP addresses authorized to access the customer account.</td>\n</tr>\n<tr>\n<td>legal_contact_id</td>\n<td>string</td>\n<td>The alphanumeric string identifying the account's legal contact.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The name of the customer, generally the company name.</td>\n</tr>\n<tr>\n<td>owner_id</td>\n<td>string</td>\n<td>The alphanumeric string identifying the account owner.</td>\n</tr>\n<tr>\n<td>phone_number</td>\n<td>string</td>\n<td>The phone number associated with the account.</td>\n</tr>\n<tr>\n<td>postal_address</td>\n<td>string</td>\n<td>The postal address associated with the account.</td>\n</tr>\n<tr>\n<td>pricing_plan</td>\n<td>string</td>\n<td>The pricing plan this customer is under.</td>\n</tr>\n<tr>\n<td>pricing_plan_id</td>\n<td>string</td>\n<td>The alphanumeric string identifying the pricing plan.</td>\n</tr>\n<tr>\n<td>security_contact_id</td>\n<td>string</td>\n<td>The alphanumeric string identifying the account's security contact.</td>\n</tr>\n<tr>\n<td>technical_contact_id</td>\n<td>string</td>\n<td>The alphanumeric string identifying the account's technical contact.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the customer.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"f67d03b4-b4e3-4cd8-b2f7-41368148944d"},{"name":"Event logs","item":[{"name":"List events","id":"30dbde96-bd0b-4b5d-8c84-ae5e3d82d8c5","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":"https://api.fastly.com/events?filter[created_at][gt]&filter[created_at][gte]&filter[created_at][lt]&filter[created_at][lte]&filter[created_at]&filter[customer_id]&filter[event_type]&filter[service_id]&filter[token_id]&filter[user_id]&page[number]&page[size]&sort","description":"<p>List all events for a particular customer. Events can be filtered by user, customer and event type. Events can be sorted by date.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["events"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Return events after a date and time in ISO 8601 format.</p>\n","type":"text/plain"},"key":"filter[created_at][gt]"},{"description":{"content":"<p>Return events on and after a date and time in ISO 8601 format.</p>\n","type":"text/plain"},"key":"filter[created_at][gte]"},{"description":{"content":"<p>Return events before a date and time in ISO 8601 format.</p>\n","type":"text/plain"},"key":"filter[created_at][lt]"},{"description":{"content":"<p>Return events on and before a date and time in ISO 8601 format.</p>\n","type":"text/plain"},"key":"filter[created_at][lte]"},{"description":{"content":"<p>Limit the returned events to a specific time frame. Accepts sub-parameters: lt, lte, gt, gte (e.g., filter[created_at][gt]=2022-01-12).</p>\n","type":"text/plain"},"key":"filter[created_at]"},{"description":{"content":"<p>Limit the results returned to a specific customer.</p>\n","type":"text/plain"},"key":"filter[customer_id]"},{"description":{"content":"<p>Limit the returned events to a specific event_type.</p>\n","type":"text/plain"},"key":"filter[event_type]"},{"description":{"content":"<p>Limit the results returned to a specific service.</p>\n","type":"text/plain"},"key":"filter[service_id]"},{"description":{"content":"<p>Limit the returned events to a specific token.</p>\n","type":"text/plain"},"key":"filter[token_id]"},{"description":{"content":"<p>Limit the results returned to a specific user.</p>\n","type":"text/plain"},"key":"filter[user_id]"},{"description":{"content":"<p>Current page.</p>\n","type":"text/plain"},"key":"page[number]"},{"description":{"content":"<p>Number of records per page.</p>\n","type":"text/plain"},"key":"page[size]"},{"description":{"content":"<p>The order in which to list the results by creation date.</p>\n","type":"text/plain"},"key":"sort"}],"variable":[]}},"response":[{"id":"6f03e54b-f628-487c-a607-5985a1ab51d4","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":{"raw":"https://api.fastly.com/events?filter%5Bcustomer_id%5D=x4xCwxxJxGCx123Rx5xTx&page%5Bnumber%5D=1&page%5Bsize%5D=20&sort=created_at?filter[created_at][gt]&filter[created_at][gte]&filter[created_at][lt]&filter[created_at][lte]&filter[created_at]&filter[customer_id]&filter[event_type]&filter[service_id]&filter[token_id]&filter[user_id]&page[number]&page[size]&sort","protocol":"https","host":["api","fastly","com"],"path":["events"],"query":[{"key":"filter[created_at][gt]","description":"Return events after a date and time in ISO 8601 format."},{"key":"filter[created_at][gte]","description":"Return events on and after a date and time in ISO 8601 format."},{"key":"filter[created_at][lt]","description":"Return events before a date and time in ISO 8601 format."},{"key":"filter[created_at][lte]","description":"Return events on and before a date and time in ISO 8601 format."},{"key":"filter[created_at]","description":"Limit the returned events to a specific time frame. Accepts sub-parameters: lt, lte, gt, gte (e.g., filter[created_at][gt]=2022-01-12)."},{"key":"filter[customer_id]","description":"Limit the results returned to a specific customer."},{"key":"filter[event_type]","description":"Limit the returned events to a specific event_type."},{"key":"filter[service_id]","description":"Limit the results returned to a specific service."},{"key":"filter[token_id]","description":"Limit the returned events to a specific token."},{"key":"filter[user_id]","description":"Limit the results returned to a specific user."},{"key":"page[number]","description":"Current page."},{"key":"page[size]","description":"Number of records per page."},{"key":"sort","description":"The order in which to list the results by creation date."}]},"description":"List all events for a particular customer. Events can be filtered by user, customer and event type. Events can be sorted by date.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"attributes\":{\"admin\":false,\"created_at\":\"2016-06-06T20:05:10.000Z\",\"customer_id\":\"x4xCwxxJxGCx123Rx5xTx\",\"description\":\"Version 2 was activated\",\"event_type\":\"version.activate\",\"ip\":\"127.0.0.0\",\"metadata\":{\"version_number\":2},\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"user_id\":\"4Pp0BW3UkBEJhG3N0kovLP\",\"token_id\":\"5Yo3XXnrQpjc20u0ybrf2g\"},\"id\":\"5IH1QmNSV1Qi7jXc4oIZlZ\",\"type\":\"event\"}],\"links\":{\"last\":\"http://api.fastly.com/events?filter[customer_id]=x4xCwxxJxGCx123Rx5xTx&page[number]=1&page[size]=1\"}}"}],"_postman_id":"30dbde96-bd0b-4b5d-8c84-ae5e3d82d8c5"},{"name":"Get an event","id":"d617069f-bef7-4a43-9501-09d92a776cb6","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":"https://api.fastly.com/events/{{event_id}}","description":"<p>Get a specific event.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["events","{{event_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"1a81198e-29e7-4f4d-b8dd-18d42d017aeb","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":"https://api.fastly.com/events/1PTzLK8g1NRKMGu5kUb8SC","description":"Get a specific event.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":{\"attributes\":{\"admin\":false,\"created_at\":\"2020-06-01T21:29:38.000Z\",\"customer_id\":\"x4xCwxxJxGCx123Rx5xTx\",\"description\":\"Version 2 was activated\",\"event_type\":\"version.activate\",\"ip\":\"127.0.0.0\",\"metadata\":{\"version_number\":2},\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"user_id\":\"6MwX4ZZM7Ji4Q3O07dI8Ln\",\"token_id\":\"5Yo3XXnrQpjc20u0ybrf2g\"},\"id\":\"1PTzLK8g1NRKMGu5kUb8SC\",\"type\":\"event\"}}"}],"_postman_id":"d617069f-bef7-4a43-9501-09d92a776cb6"}],"id":"e826c2ef-51f8-40eb-baae-ec579d947ff1","description":"<p>Event logs are used to audit actions performed by customers.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>admin</td>\n<td>boolean</td>\n<td>Indicates if event was performed by Fastly.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>customer_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the customer.</td>\n</tr>\n<tr>\n<td>description</td>\n<td>string</td>\n<td>Description of the event.</td>\n</tr>\n<tr>\n<td>event_type</td>\n<td>string</td>\n<td>Type of event. Can be used with filter[event_type].</td>\n</tr>\n<tr>\n<td></td>\n<td>api_key.create</td>\n<td>An API key was created.</td>\n</tr>\n<tr>\n<td></td>\n<td>acl.create</td>\n<td>An access control list was created.</td>\n</tr>\n<tr>\n<td></td>\n<td>acl.delete</td>\n<td>An access control list was deleted.</td>\n</tr>\n<tr>\n<td></td>\n<td>acl.update</td>\n<td>An access control list was updated.</td>\n</tr>\n<tr>\n<td></td>\n<td>address.create</td>\n<td>A customer billing address was created.</td>\n</tr>\n<tr>\n<td></td>\n<td>address.delete</td>\n<td>A customer billing address was deleted.</td>\n</tr>\n<tr>\n<td></td>\n<td>address.update</td>\n<td>A customer billing address was updated.</td>\n</tr>\n<tr>\n<td></td>\n<td>alerts.definition.create</td>\n<td>A customer alert definition was created.</td>\n</tr>\n<tr>\n<td></td>\n<td>alerts.definition.delete</td>\n<td>A customer alert definition was deleted.</td>\n</tr>\n<tr>\n<td></td>\n<td>alerts.definition.test</td>\n<td>A customer alert definition was tested.</td>\n</tr>\n<tr>\n<td></td>\n<td>alerts.definition.update</td>\n<td>A customer alert definition was updated.</td>\n</tr>\n<tr>\n<td></td>\n<td>backend.create</td>\n<td>A backend was added to a service.</td>\n</tr>\n<tr>\n<td></td>\n<td>backend.delete</td>\n<td>A backend was removed from a service.</td>\n</tr>\n<tr>\n<td></td>\n<td>backend.update</td>\n<td>A backend was updated.</td>\n</tr>\n<tr>\n<td></td>\n<td>billing.contact_update</td>\n<td>A billing contact was updated.</td>\n</tr>\n<tr>\n<td></td>\n<td>cache_settings.create</td>\n<td>A cache settings configuration object was created.</td>\n</tr>\n<tr>\n<td></td>\n<td>cache_settings.delete</td>\n<td>A cache settings configuration object was deleted.</td>\n</tr>\n<tr>\n<td></td>\n<td>cache_settings.update</td>\n<td>A cache settings configuration object was updated.</td>\n</tr>\n<tr>\n<td></td>\n<td>customer.create</td>\n<td>A customer was created.</td>\n</tr>\n<tr>\n<td></td>\n<td>customer.pricing</td>\n<td>A customer pricing plan was changed.</td>\n</tr>\n<tr>\n<td></td>\n<td>customer.update</td>\n<td>A customer was updated.</td>\n</tr>\n<tr>\n<td></td>\n<td>customer_feature.create</td>\n<td>A feature flag was applied to the customer account.</td>\n</tr>\n<tr>\n<td></td>\n<td>customer_feature.delete</td>\n<td>A feature flag was removed from the customer account.</td>\n</tr>\n<tr>\n<td></td>\n<td>director.create</td>\n<td>A load-balancing director was created.</td>\n</tr>\n<tr>\n<td></td>\n<td>director.delete</td>\n<td>A load-balancing director was deleted.</td>\n</tr>\n<tr>\n<td></td>\n<td>director.update</td>\n<td>A load-balancing director was updated.</td>\n</tr>\n<tr>\n<td></td>\n<td>director_backend.create</td>\n<td>A backend was assigned to a load-balancing director.</td>\n</tr>\n<tr>\n<td></td>\n<td>director_backend.delete</td>\n<td>A backend was removed from a load-balancing director.</td>\n</tr>\n<tr>\n<td></td>\n<td>domain.create</td>\n<td>A domain was assigned to a service.</td>\n</tr>\n<tr>\n<td></td>\n<td>domain.delete</td>\n<td>A domain was removed from a service.</td>\n</tr>\n<tr>\n<td></td>\n<td>domain.update</td>\n<td>A domain was updated.</td>\n</tr>\n<tr>\n<td></td>\n<td>gzip.create</td>\n<td>A gzip policy was created.</td>\n</tr>\n<tr>\n<td></td>\n<td>gzip.delete</td>\n<td>A gzip policy was deleted.</td>\n</tr>\n<tr>\n<td></td>\n<td>gzip.update</td>\n<td>A gzip policy was updated.</td>\n</tr>\n<tr>\n<td></td>\n<td>header.create</td>\n<td>A header configuration object was created.</td>\n</tr>\n<tr>\n<td></td>\n<td>header.delete</td>\n<td>A header configuration object was deleted.</td>\n</tr>\n<tr>\n<td></td>\n<td>header.update</td>\n<td>A header configuration object was updated.</td>\n</tr>\n<tr>\n<td></td>\n<td>healthcheck.create</td>\n<td>A healthcheck was created.</td>\n</tr>\n<tr>\n<td></td>\n<td>healthcheck.delete</td>\n<td>A healthcheck was deleted.</td>\n</tr>\n<tr>\n<td></td>\n<td>healthcheck.update</td>\n<td>A healthcheck was updated.</td>\n</tr>\n<tr>\n<td></td>\n<td>invitation.accept</td>\n<td>An account invitation was accepted.</td>\n</tr>\n<tr>\n<td></td>\n<td>invitation.sent</td>\n<td>An account invitation was sent.</td>\n</tr>\n<tr>\n<td></td>\n<td>invoice.failed_payment</td>\n<td>An invoice payment failed.</td>\n</tr>\n<tr>\n<td></td>\n<td>invoice.payment</td>\n<td>An invoice was paid.</td>\n</tr>\n<tr>\n<td></td>\n<td>io_settings.create</td>\n<td>Image optimization was activated.</td>\n</tr>\n<tr>\n<td></td>\n<td>io_settings.delete</td>\n<td>Image optimization was deactivated.</td>\n</tr>\n<tr>\n<td></td>\n<td>io_settings.update</td>\n<td>Image optimization was updated.</td>\n</tr>\n<tr>\n<td></td>\n<td>logging.create</td>\n<td>A log endpoint was created.</td>\n</tr>\n<tr>\n<td></td>\n<td>logging.delete</td>\n<td>A log endpoint was deleted.</td>\n</tr>\n<tr>\n<td></td>\n<td>logging.update</td>\n<td>A log endpoint was updated.</td>\n</tr>\n<tr>\n<td></td>\n<td>pool.create</td>\n<td>A dynamic server pool was created.</td>\n</tr>\n<tr>\n<td></td>\n<td>pool.delete</td>\n<td>A dynamic server pool was deleted.</td>\n</tr>\n<tr>\n<td></td>\n<td>pool.update</td>\n<td>A dynamic server pool was updated.</td>\n</tr>\n<tr>\n<td></td>\n<td>request_settings.create</td>\n<td>A request settings configuration object was created.</td>\n</tr>\n<tr>\n<td></td>\n<td>request_settings.delete</td>\n<td>A request settings configuration object was deleted.</td>\n</tr>\n<tr>\n<td></td>\n<td>request_settings.update</td>\n<td>A request settings configuration object was updated.</td>\n</tr>\n<tr>\n<td></td>\n<td>response_object.create</td>\n<td>A response object was created.</td>\n</tr>\n<tr>\n<td></td>\n<td>response_object.delete</td>\n<td>A response object was deleted.</td>\n</tr>\n<tr>\n<td></td>\n<td>response_object.update</td>\n<td>A response object was updated.</td>\n</tr>\n<tr>\n<td></td>\n<td>rule_status.update</td>\n<td>A WAF rule status was updated.</td>\n</tr>\n<tr>\n<td></td>\n<td>rule_status.upsert</td>\n<td>A WAF rule status was upserted.</td>\n</tr>\n<tr>\n<td></td>\n<td>security.workspace.create</td>\n<td>A security workspace was created.</td>\n</tr>\n<tr>\n<td></td>\n<td>security.workspace.update</td>\n<td>A security workspace was updated.</td>\n</tr>\n<tr>\n<td></td>\n<td>security.workspace.delete</td>\n<td>A security workspace was deleted.</td>\n</tr>\n<tr>\n<td></td>\n<td>security.redaction.create</td>\n<td>A security redaction was created.</td>\n</tr>\n<tr>\n<td></td>\n<td>security.redaction.update</td>\n<td>A security redaction was updated.</td>\n</tr>\n<tr>\n<td></td>\n<td>security.redaction.delete</td>\n<td>A security redaction was deleted.</td>\n</tr>\n<tr>\n<td></td>\n<td>security.rule.create</td>\n<td>A security rule was created.</td>\n</tr>\n<tr>\n<td></td>\n<td>security.rule.update</td>\n<td>A security rule was updated.</td>\n</tr>\n<tr>\n<td></td>\n<td>security.rule.delete</td>\n<td>A security rule was deleted.</td>\n</tr>\n<tr>\n<td></td>\n<td>security.virtual_patch.create</td>\n<td>A security virtual patch was created.</td>\n</tr>\n<tr>\n<td></td>\n<td>security.virtual_patch.update</td>\n<td>A security virtual patch was updated.</td>\n</tr>\n<tr>\n<td></td>\n<td>security.virtual_patch.delete</td>\n<td>A security virtual patch was deleted.</td>\n</tr>\n<tr>\n<td></td>\n<td>security.event.update</td>\n<td>A security event was updated.</td>\n</tr>\n<tr>\n<td></td>\n<td>server.create</td>\n<td>A server was created as part of a dynamic server pool.</td>\n</tr>\n<tr>\n<td></td>\n<td>server.delete</td>\n<td>A server was deleted as part of a dynamic server pool.</td>\n</tr>\n<tr>\n<td></td>\n<td>server.update</td>\n<td>A server was updated as part of a dynamic server pool.</td>\n</tr>\n<tr>\n<td></td>\n<td>service.create</td>\n<td>A service was created.</td>\n</tr>\n<tr>\n<td></td>\n<td>service.delete</td>\n<td>A service was deleted.</td>\n</tr>\n<tr>\n<td></td>\n<td>service.move</td>\n<td>A service was moved to another customer.</td>\n</tr>\n<tr>\n<td></td>\n<td>service.move_destination</td>\n<td>A service was moved from another customer.</td>\n</tr>\n<tr>\n<td></td>\n<td>service.move_source</td>\n<td>A service was moved to another customer.</td>\n</tr>\n<tr>\n<td></td>\n<td>service.purge_all</td>\n<td>The cache was purged for a service.</td>\n</tr>\n<tr>\n<td></td>\n<td>service.update</td>\n<td>A service was updated.</td>\n</tr>\n<tr>\n<td></td>\n<td>service_authorization.create</td>\n<td>A service authorization was created.</td>\n</tr>\n<tr>\n<td></td>\n<td>service_authorization.delete</td>\n<td>A service authorization was deleted.</td>\n</tr>\n<tr>\n<td></td>\n<td>service_authorization.update</td>\n<td>A service authorization was updated.</td>\n</tr>\n<tr>\n<td></td>\n<td>tls.bulk_certificate.create</td>\n<td>A bulk TLS certificate was created.</td>\n</tr>\n<tr>\n<td></td>\n<td>tls.bulk_certificate.delete</td>\n<td>A bulk TLS certificate was deleted.</td>\n</tr>\n<tr>\n<td></td>\n<td>tls.bulk_certificate.update</td>\n<td>A bulk TLS certificate was updated.</td>\n</tr>\n<tr>\n<td></td>\n<td>tls.certificate.create</td>\n<td>A TLS certificate was created.</td>\n</tr>\n<tr>\n<td></td>\n<td>tls.certificate.expiration_email</td>\n<td>Certificate expiration email was sent.</td>\n</tr>\n<tr>\n<td></td>\n<td>tls.certificate.update</td>\n<td>A TLS certificate was updated.</td>\n</tr>\n<tr>\n<td></td>\n<td>tls.certificate.delete</td>\n<td>A TLS certificate was deleted.</td>\n</tr>\n<tr>\n<td></td>\n<td>tls.configuration.update</td>\n<td>TLS configuration was updated.</td>\n</tr>\n<tr>\n<td></td>\n<td>tls.private_key.create</td>\n<td>A private key was created.</td>\n</tr>\n<tr>\n<td></td>\n<td>tls.private_key.delete</td>\n<td>A private key was deleted.</td>\n</tr>\n<tr>\n<td></td>\n<td>tls.activation.enable</td>\n<td>TLS activation was enabled.</td>\n</tr>\n<tr>\n<td></td>\n<td>tls.activation.update</td>\n<td>TLS activation was updated.</td>\n</tr>\n<tr>\n<td></td>\n<td>tls.activation.disable</td>\n<td>TLS activation was disabled.</td>\n</tr>\n<tr>\n<td></td>\n<td>tls.globalsign.domain.create</td>\n<td>A GlobalSign SAN entry was added.</td>\n</tr>\n<tr>\n<td></td>\n<td>tls.globalsign.domain.verify</td>\n<td>GlobalSign SAN entry verification was requested.</td>\n</tr>\n<tr>\n<td></td>\n<td>tls.globalsign.domain.delete</td>\n<td>A GlobalSign SAN entry was deleted.</td>\n</tr>\n<tr>\n<td></td>\n<td>tls.subscription.create</td>\n<td>A TLS subscription was created.</td>\n</tr>\n<tr>\n<td></td>\n<td>tls.subscription.delete</td>\n<td>A TLS subscription was deleted.</td>\n</tr>\n<tr>\n<td></td>\n<td>tls.subscription.dns_check_email</td>\n<td>A TLS subscription renewal DNS check email was sent.</td>\n</tr>\n<tr>\n<td></td>\n<td>token.create</td>\n<td>An API token was created or a user logged into the web interface.</td>\n</tr>\n<tr>\n<td></td>\n<td>token.destroy</td>\n<td>An API token was revoked.</td>\n</tr>\n<tr>\n<td></td>\n<td>two_factor_auth.disable</td>\n<td>Two-factor authentication was disabled.</td>\n</tr>\n<tr>\n<td></td>\n<td>two_factor_auth.enable</td>\n<td>Two-factor authentication was enabled.</td>\n</tr>\n<tr>\n<td></td>\n<td>user.create</td>\n<td>A user account was created.</td>\n</tr>\n<tr>\n<td></td>\n<td>user.destroy</td>\n<td>A user account was deleted.</td>\n</tr>\n<tr>\n<td></td>\n<td>user.lock</td>\n<td>A user account was locked.</td>\n</tr>\n<tr>\n<td></td>\n<td>user.login</td>\n<td>Deprecated. See token.create.</td>\n</tr>\n<tr>\n<td></td>\n<td>user.login_failure</td>\n<td>A user account login attempt failed.</td>\n</tr>\n<tr>\n<td></td>\n<td>user.logout</td>\n<td>Deprecated. See token.destroy.</td>\n</tr>\n<tr>\n<td></td>\n<td>user.password_update</td>\n<td>An account password was updated.</td>\n</tr>\n<tr>\n<td></td>\n<td>user.unlock</td>\n<td>A user account was unlocked.</td>\n</tr>\n<tr>\n<td></td>\n<td>user.update</td>\n<td>A user account was updated.</td>\n</tr>\n<tr>\n<td></td>\n<td>vcl.create</td>\n<td>A custom VCL file was created.</td>\n</tr>\n<tr>\n<td></td>\n<td>vcl.delete</td>\n<td>A custom VCL file was deleted.</td>\n</tr>\n<tr>\n<td></td>\n<td>vcl.update</td>\n<td>A custom VCL file was updated.</td>\n</tr>\n<tr>\n<td></td>\n<td>version.activate</td>\n<td>A service version was activated.</td>\n</tr>\n<tr>\n<td></td>\n<td>version.clone</td>\n<td>A service version was cloned.</td>\n</tr>\n<tr>\n<td></td>\n<td>version.copy</td>\n<td>A service version was copied to another service.</td>\n</tr>\n<tr>\n<td></td>\n<td>version.copy_destination</td>\n<td>The service version was copied from another service.</td>\n</tr>\n<tr>\n<td></td>\n<td>version.copy_source</td>\n<td>The service version was copied to another service.</td>\n</tr>\n<tr>\n<td></td>\n<td>version.create</td>\n<td>A service version was created.</td>\n</tr>\n<tr>\n<td></td>\n<td>version.deactivate</td>\n<td>A service version was deactivated.</td>\n</tr>\n<tr>\n<td></td>\n<td>version.lock</td>\n<td>A service version was locked.</td>\n</tr>\n<tr>\n<td></td>\n<td>version.update</td>\n<td>A service version was updated.</td>\n</tr>\n<tr>\n<td></td>\n<td>waf.configuration_set_update</td>\n<td>A WAF configuration set was updated.</td>\n</tr>\n<tr>\n<td></td>\n<td>waf.create</td>\n<td>A WAF object was created.</td>\n</tr>\n<tr>\n<td></td>\n<td>waf.delete</td>\n<td>A WAF object was deleted.</td>\n</tr>\n<tr>\n<td></td>\n<td>waf.update</td>\n<td>A WAF object was updated.</td>\n</tr>\n<tr>\n<td></td>\n<td>waf.enable</td>\n<td>A WAF object was enabled.</td>\n</tr>\n<tr>\n<td></td>\n<td>waf.disable</td>\n<td>A WAF object was disabled.</td>\n</tr>\n<tr>\n<td></td>\n<td>waf.owasp.create</td>\n<td>A WAF OWASP setting was created.</td>\n</tr>\n<tr>\n<td></td>\n<td>waf.owasp.update</td>\n<td>A WAF OWASP setting was updated.</td>\n</tr>\n<tr>\n<td></td>\n<td>waf.ruleset.deploy</td>\n<td>A WAF ruleset was deployed.</td>\n</tr>\n<tr>\n<td></td>\n<td>waf.ruleset.deploy_failure</td>\n<td>A WAF ruleset's deployment failed.</td>\n</tr>\n<tr>\n<td></td>\n<td>wordpress.create</td>\n<td>A WordPress rule was created.</td>\n</tr>\n<tr>\n<td></td>\n<td>wordpress.delete</td>\n<td>A WordPress rule was deleted.</td>\n</tr>\n<tr>\n<td></td>\n<td>wordpress.update</td>\n<td>A WordPress rule was updated.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>Alphanumeric string identifying an event.</td>\n</tr>\n<tr>\n<td>ip</td>\n<td>string</td>\n<td>IP addresses that the event was requested from.</td>\n</tr>\n<tr>\n<td>metadata</td>\n<td>object</td>\n<td>Hash of key value pairs of additional information.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>token_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying a token.</td>\n</tr>\n<tr>\n<td>type</td>\n<td>string</td>\n<td>Resource type.</td>\n</tr>\n<tr>\n<td></td>\n<td>event</td>\n<td>The event type.</td>\n</tr>\n<tr>\n<td>user_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the user.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"e826c2ef-51f8-40eb-baae-ec579d947ff1"},{"name":"Invitations","item":[{"name":"List invitations","id":"5f84b7d0-a5f5-49ee-8a32-c496ec913269","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":"https://api.fastly.com/invitations?page[number]&page[size]","description":"<p>List all invitations.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["invitations"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Current page.</p>\n","type":"text/plain"},"key":"page[number]"},{"description":{"content":"<p>Number of records per page.</p>\n","type":"text/plain"},"key":"page[size]"}],"variable":[]}},"response":[{"id":"461e9e29-26a1-44bf-829f-f36707109bc0","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":{"raw":"https://api.fastly.com/invitations?page%5Bnumber%5D=1&page%5Bsize%5D=20?page[number]&page[size]","protocol":"https","host":["api","fastly","com"],"path":["invitations"],"query":[{"key":"page[number]","description":"Current page."},{"key":"page[size]","description":"Number of records per page."}]},"description":"List all invitations.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"id\":\"3krg2uUGZzb2W9Euo4moOY\",\"type\":\"invitation\",\"attributes\":{\"created_at\":\"2020-03-15T20:10:09.000Z\",\"deleted_at\":null,\"email\":\"john@example.com\",\"role\":\"superuser\",\"roles\":[\"wT9a8QkPm7f0Z3xRu2NcVy\"],\"status_code\":1,\"updated_at\":\"2020-03-15T20:10:09.000Z\"},\"relationships\":{\"customer\":{\"data\":{\"type\":\"customer\",\"id\":\"SU1Z0isxPaozGVKXdv0eY\"}}}}],\"links\":{\"last\":\"http://api.fastly.com/invitations?page[number]=1&page[size]=100\"},\"meta\":{\"current_page\":1,\"per_page\":100,\"record_count\":1,\"total_pages\":1}}"}],"_postman_id":"5f84b7d0-a5f5-49ee-8a32-c496ec913269"},{"name":"Create an invitation","id":"ceed9d3b-7c4b-45c5-8076-f2af287b210c","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"data\":{\"type\":\"invitation\",\"attributes\":{\"email\":\"thelma@example.com\",\"limit_services\":true,\"roles\":[\"Q4rXe9vN1szK8a2fUjYtWp\"]},\"relationships\":{\"customer\":{\"data\":{\"id\":\"44tb1D3asjhhuh2SH8e8YD\",\"type\":\"customer\"}},\"service_invitations\":{\"data\":[{\"type\":\"service_invitation\",\"attributes\":{\"permission\":\"purge_all\"},\"relationships\":{\"service\":{\"data\":{\"type\":\"service\",\"id\":\"6yrrdleXQ9QDtum9rMB0nr\"}}}}]}}}}"},"url":"https://api.fastly.com/invitations","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/account/invitations/#create-invitation\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Superuser</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["invitations"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"d2515202-b16d-475e-b01e-9364dda1a403","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"data\":{\"type\":\"invitation\",\"attributes\":{\"email\":\"thelma@example.com\",\"limit_services\":true,\"roles\":[\"Q4rXe9vN1szK8a2fUjYtWp\"]},\"relationships\":{\"customer\":{\"data\":{\"id\":\"44tb1D3asjhhuh2SH8e8YD\",\"type\":\"customer\"}},\"service_invitations\":{\"data\":[{\"type\":\"service_invitation\",\"attributes\":{\"permission\":\"purge_all\"},\"relationships\":{\"service\":{\"data\":{\"type\":\"service\",\"id\":\"6yrrdleXQ9QDtum9rMB0nr\"}}}}]}}}}"},"url":"https://api.fastly.com/invitations","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/account/invitations/#create-invitation)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Superuser](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":{\"id\":\"7kP8T3JrqSD2ZdijWGxOB1\",\"type\":\"invitation\",\"attributes\":{\"created_at\":\"2020-05-09T18:45:17.000Z\",\"email\":\"thelma@example.com\",\"deleted_at\":null,\"role\":\"engineer\",\"roles\":[\"Q4rXe9vN1szK8a2fUjYtWp\"],\"status_code\":1,\"updated_at\":\"2020-05-09T18:45:17.000Z\",\"limit_services\":true},\"relationships\":{\"customer\":{\"data\":{\"id\":\"3krg2uUGZzb2W9Euo4moOY\",\"type\":\"customer\"}},\"service_invitations\":{\"data\":[{\"id\":\"QNcWQmR5UIpVVO6f1Y3Rl\",\"type\":\"service_invitation\"}]}}},\"included\":[{\"id\":\"QNcWQmR5UIpVVO6f1Y3Rl\",\"type\":\"service_invitation\",\"attributes\":{\"permission\":\"purge_all\",\"created_at\":\"2020-05-09T18:45:18.000Z\",\"deleted_at\":null,\"updated_at\":\"2020-05-09T18:45:18.000Z\"}},{\"id\":\"3krg2uUGZzb2W9Euo4moOY\",\"type\":\"customer\",\"attributes\":{\"created_at\":\"2020-05-09T18:45:17.000Z\",\"deleted_at\":null,\"name\":\"Test\",\"phone_number\":\"875.788.2000 x29959\",\"postal_address\":null,\"updated_at\":\"2020-05-09T18:45:17.000Z\"}}]}"}],"_postman_id":"ceed9d3b-7c4b-45c5-8076-f2af287b210c"},{"name":"Delete an invitation","id":"a75b565e-1a15-4fae-9a84-ab840800c8ed","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/invitations/{{invitation_id}}","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/account/invitations/#delete-invitation\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Superuser</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["invitations","{{invitation_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"ae397db2-f235-45fd-98d1-5fb78e6e8312","name":"204 No Content","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/invitations/3krg2uUGZzb2W9Euo4moOY","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/account/invitations/#delete-invitation)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Superuser](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 No Content","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"a75b565e-1a15-4fae-9a84-ab840800c8ed"}],"id":"85a81eb4-fe62-4339-a5cf-281545779c3a","description":"<p>Invitations allow superusers and engineers to invite users to set up accounts as collaborators under a main customer account. Superusers can invite collaborators and assign them any role or permission level on a per-service basis. Engineers with no per-service limitations can only invite new collaborators but cannot modify their permissions.</p>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>email</td>\n<td>string</td>\n<td>The email address of the invitee.</td>\n</tr>\n<tr>\n<td>limit_services</td>\n<td>boolean</td>\n<td>Indicates the user has limited access to the customer's services.</td>\n</tr>\n<tr>\n<td>role</td>\n<td>string</td>\n<td>The permissions role assigned to the user. Can be user, tls_viewer, tls_admin, billing, engineer, or superuser.</td>\n</tr>\n<tr>\n<td>status_code</td>\n<td>integer</td>\n<td>Indicates whether or not the invitation is active.</td>\n</tr>\n<tr>\n<td></td>\n<td>0</td>\n<td>Inactive.</td>\n</tr>\n<tr>\n<td></td>\n<td>1</td>\n<td>Active.</td>\n</tr>\n<tr>\n<td>type</td>\n<td>string</td>\n<td>Resource type.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>Alphanumeric string identifying an invitation.</td>\n</tr>\n<tr>\n<td>relationships.customer.id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the customer.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n</tbody>\n</table>\n</div>","_postman_id":"85a81eb4-fe62-4339-a5cf-281545779c3a"},{"name":"Invoices API","item":[{"name":"List of invoices","id":"53a8c9c9-2259-431a-8492-a0bd1dbe1e08","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/billing/v3/invoices?billing_end_date&billing_start_date&cursor&limit","description":"<p>Returns the list of invoices, sorted by billing start date (newest to oldest).</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Billing</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["billing","v3","invoices"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Filter invoices by billing end date.</p>\n","type":"text/plain"},"key":"billing_end_date"},{"description":{"content":"<p>Filter invoices by billing start date.</p>\n","type":"text/plain"},"key":"billing_start_date"},{"description":{"content":"<p>Cursor value from the next_cursor field of a previous response, used to retrieve the next page. To request the first page, this should be empty.</p>\n","type":"text/plain"},"key":"cursor"},{"description":{"content":"<p>Number of results per page. The maximum is 200.</p>\n","type":"text/plain"},"key":"limit"}],"variable":[]}},"response":[{"id":"5e1b6143-d41d-412f-86e4-3171a4a861a8","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/billing/v3/invoices?billing_end_date=2023-01-31&billing_start_date=2023-01-01?billing_end_date&billing_start_date&cursor&limit","protocol":"https","host":["api","fastly","com"],"path":["billing","v3","invoices"],"query":[{"key":"billing_end_date","description":"Filter invoices by billing end date."},{"key":"billing_start_date","description":"Filter invoices by billing start date."},{"key":"cursor","description":"Cursor value from the next_cursor field of a previous response, used to retrieve the next page. To request the first page, this should be empty."},{"key":"limit","description":"Number of results per page. The maximum is 200."}]},"description":"Returns the list of invoices, sorted by billing start date (newest to oldest).\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Billing](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"customer_id\":\"2sLme2UJR3SksnvKdEXHri\",\"invoice_id\":\"39973421\",\"invoice_posted_on\":\"2020-07-01T08:44:24Z\",\"billing_start_date\":\"2020-06-01T00:00:00Z\",\"billing_end_date\":\"2020-06-30T00:00:00Z\",\"statement_number\":\"295826163\",\"currency_code\":\"USD\",\"monthly_transaction_amount\":0,\"payment_status\":\"paid\",\"transaction_line_items\":[{\"description\":\"Monthly Minimum Fee\",\"amount\":50,\"credit_coupon_code\":\"\",\"rate\":50,\"units\":1,\"product_name\":\"Committed Amount\",\"product_group\":\"Full Site Delivery\",\"product_line\":\"Network Services\",\"region\":\"Global\",\"usage_type\":\"Committed Amount\"},{\"description\":\"Developer Account\",\"amount\":-50,\"credit_coupon_code\":\"developer\",\"rate\":-50,\"units\":1,\"product_name\":\"Committed Amount\",\"product_group\":\"Full Site Delivery\",\"product_line\":\"Network Services\",\"region\":\"Global\",\"usage_type\":\"Committed Amount\"}]},{\"customer_id\":\"2sLme2UJR3SksnvKdEXHri\",\"invoice_id\":\"39472869\",\"invoice_posted_on\":\"2020-06-01T10:43:06Z\",\"billing_start_date\":\"2020-05-01T00:00:00Z\",\"billing_end_date\":\"2020-05-31T00:00:00Z\",\"statement_number\":\"291985823\",\"currency_code\":\"USD\",\"monthly_transaction_amount\":0,\"payment_status\":\"paid\",\"transaction_line_items\":[{\"description\":\"Monthly Minimum Fee\",\"amount\":50,\"credit_coupon_code\":\"\",\"rate\":50,\"units\":1,\"product_name\":\"Committed Amount\",\"product_group\":\"Full Site Delivery\",\"product_line\":\"Network Services\",\"region\":\"Global\",\"usage_type\":\"Committed Amount\"},{\"description\":\"Developer Account\",\"amount\":-50,\"credit_coupon_code\":\"developer\",\"rate\":-50,\"units\":1,\"product_name\":\"Committed Amount\",\"product_group\":\"Full Site Delivery\",\"product_line\":\"Network Services\",\"region\":\"Global\",\"usage_type\":\"Committed Amount\"}]}],\"meta\":{\"next_cursor\":\"\",\"limit\":2,\"total\":2,\"sort\":\"-billing_start_date\"}}"}],"_postman_id":"53a8c9c9-2259-431a-8492-a0bd1dbe1e08"},{"name":"Get invoice by ID","id":"d073b3cb-2c92-467b-a203-5a2a6b284377","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/billing/v3/invoices/{{invoice_id}}","description":"<p>Returns invoice associated with the invoice id.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Billing</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["billing","v3","invoices","{{invoice_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"578d2bfc-82b9-4ee2-9aa3-a149eaa0972d","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/billing/v3/invoices/4183280","description":"Returns invoice associated with the invoice id.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Billing](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"customer_id\":\"2sLme2UJR3SksnvKdEXHri\",\"invoice_id\":\"39973421\",\"invoice_posted_on\":\"2020-07-01T08:44:24Z\",\"billing_start_date\":\"2020-06-01T00:00:00Z\",\"billing_end_date\":\"2020-06-30T00:00:00Z\",\"statement_number\":\"295826163\",\"currency_code\":\"USD\",\"monthly_transaction_amount\":0,\"payment_status\":\"paid\",\"transaction_line_items\":[{\"description\":\"Monthly Minimum Fee\",\"amount\":50,\"credit_coupon_code\":\"\",\"rate\":50,\"units\":1,\"product_name\":\"Committed Amount\",\"product_group\":\"Full Site Delivery\",\"product_line\":\"Network Services\",\"region\":\"Global\",\"usage_type\":\"Committed Amount\"},{\"description\":\"Developer Account\",\"amount\":-50,\"credit_coupon_code\":\"developer\",\"rate\":-50,\"units\":1,\"product_name\":\"Committed Amount\",\"product_group\":\"Full Site Delivery\",\"product_line\":\"Network Services\",\"region\":\"Global\",\"usage_type\":\"Committed Amount\"}]}"}],"_postman_id":"d073b3cb-2c92-467b-a203-5a2a6b284377"},{"name":"Get month-to-date invoice","id":"fbabb960-7fb2-4e59-bcb1-108df7705b00","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/billing/v3/invoices/month-to-date","description":"<p>Returns month-to-date invoice for the current month.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Billing</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["billing","v3","invoices","month-to-date"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"356ee496-cf75-45a8-aa1d-14dc54be945c","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/billing/v3/invoices/month-to-date","description":"Returns month-to-date invoice for the current month.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Billing](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"invoice_id\":\"XO1DhSTCeOr8HKCAC7cycg\",\"customer_id\":\"2sLme2UJR3SksnvKdEXHri\",\"billing_start_date\":\"2020-07-01T00:00:00Z\",\"billing_end_date\":\"2020-07-26T17:30:05Z\",\"monthly_transaction_amount\":\"0.00\",\"transaction_line_items\":[{\"description\":\"Developer Account\",\"amount\":-50,\"rate\":0,\"units\":1,\"product_name\":\"Committed Amount\",\"product_group\":\"Full Site Delivery\",\"product_line\":\"Network Services\",\"region\":\"Global\",\"usage_type\":\"Committed Amount\"},{\"description\":\"Monthly Minimum Fee\",\"amount\":50,\"rate\":0,\"units\":1,\"product_name\":\"Committed Amount\",\"product_group\":\"Full Site Delivery\",\"product_line\":\"Network Services\",\"region\":\"Global\",\"usage_type\":\"Committed Amount\"}]}"}],"_postman_id":"fbabb960-7fb2-4e59-bcb1-108df7705b00"}],"id":"970ee890-2fb8-4601-8d36-291fb5d0fde0","description":"<p>Get information on current and past invoices.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Billing</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>billing_end_date</td>\n<td>string</td>\n<td>Date and time (in ISO 8601 format) for termination point of a billing cycle, signifying the end of charges for a service or subscription.</td>\n</tr>\n<tr>\n<td>billing_start_date</td>\n<td>string</td>\n<td>Date and time (in ISO 8601 format) for initiation point of a billing cycle, signifying the start of charges for a service or subscription.</td>\n</tr>\n<tr>\n<td>currency_code</td>\n<td>string</td>\n<td>Three-letter code representing a specific currency used for financial transactions.</td>\n</tr>\n<tr>\n<td>customer_id</td>\n<td>string</td>\n<td>Customer ID associated with the invoice.</td>\n</tr>\n<tr>\n<td>invoice_id</td>\n<td>string</td>\n<td>Numeric string identifying the invoice.</td>\n</tr>\n<tr>\n<td>invoice_posted_on</td>\n<td>string</td>\n<td>Date and time invoice was posted on, in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>monthly_transaction_amount</td>\n<td>number</td>\n<td>Total billable amount for invoiced services charged within a single month.</td>\n</tr>\n<tr>\n<td>statement_number</td>\n<td>string</td>\n<td>Alphanumeric string identifying the statement number.</td>\n</tr>\n<tr>\n<td>amount</td>\n<td>number</td>\n<td>Billed amount for line item.</td>\n</tr>\n<tr>\n<td>credit_coupon_code</td>\n<td>string</td>\n<td>Discount coupon associated with the invoice for any account or service credits.</td>\n</tr>\n<tr>\n<td>description</td>\n<td>string</td>\n<td>Invoice line item transaction name.</td>\n</tr>\n<tr>\n<td>product_group</td>\n<td>string</td>\n<td>The broader classification of the product (e.g., Compute or Full-Site Delivery).</td>\n</tr>\n<tr>\n<td>product_line</td>\n<td>string</td>\n<td>The broader classification of the product (e.g., Network Services or Security).</td>\n</tr>\n<tr>\n<td>product_name</td>\n<td>string</td>\n<td>The name of the product.</td>\n</tr>\n<tr>\n<td>rate</td>\n<td>number</td>\n<td>Price per unit.</td>\n</tr>\n<tr>\n<td>region</td>\n<td>string</td>\n<td>The geographical area applicable for regionally based products.</td>\n</tr>\n<tr>\n<td>units</td>\n<td>number</td>\n<td>Total number of units of usage.</td>\n</tr>\n<tr>\n<td>usage_type</td>\n<td>string</td>\n<td>The unit of measure (e.g., requests or bandwidth).</td>\n</tr>\n<tr>\n<td>meta</td>\n<td>object</td>\n<td>Pagination metadata.</td>\n</tr>\n<tr>\n<td>limit</td>\n<td>integer</td>\n<td>The number of invoices included in the response.</td>\n</tr>\n<tr>\n<td>next_cursor</td>\n<td>string</td>\n<td>The token used to request the next set of results.</td>\n</tr>\n<tr>\n<td>sort</td>\n<td>string</td>\n<td>The sort order of the invoices in the response.</td>\n</tr>\n<tr>\n<td>total</td>\n<td>integer</td>\n<td>Total number of records available on the backend.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"970ee890-2fb8-4601-8d36-291fb5d0fde0"},{"name":"IAM Roles","item":[{"name":"List IAM roles","id":"cbad3154-2c41-45a3-a7d8-e9bd3d54b660","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/iam/v1/roles?cursor&limit","description":"<p>Retrieve a paginated list of IAM roles available in the account.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["iam","v1","roles"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Cursor value from the next_cursor field of a previous response, used to retrieve the next page. To request the first page, this should be empty.</p>\n","type":"text/plain"},"key":"cursor"},{"description":{"content":"<p>Number of results per page. The maximum is 1000.</p>\n","type":"text/plain"},"key":"limit"}],"variable":[]}},"response":[{"id":"667829b1-b3de-4cef-bc13-f2c038d3a30b","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/iam/v1/roles?cursor&limit","protocol":"https","host":["api","fastly","com"],"path":["iam","v1","roles"],"query":[{"key":"cursor","description":"Cursor value from the next_cursor field of a previous response, used to retrieve the next page. To request the first page, this should be empty."},{"key":"limit","description":"Number of results per page. The maximum is 1000."}]},"description":"Retrieve a paginated list of IAM roles available in the account.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"limit\":100,\"data\":[{\"name\":\"superuser\",\"display_name\":\"Superuser\",\"id\":\"wT9a8QkPm7f0Z3xRu2NcVy\",\"description\":\"Can view and manage all services, workspaces, stats, account settings, billing, payments, and TLS management.\"},{\"name\":\"engineer\",\"display_name\":\"Engineer\",\"id\":\"Q4rXe9vN1szK8a2fUjYtWp\",\"description\":\"Can view, manage, purge, and delete services. Can view or edit workspaces. Some abilities may be restricted per service or workspace.\"},{\"name\":\"billing\",\"display_name\":\"Billing\",\"id\":\"L7pRk3hXm9bWq5dCj2FzGt\",\"description\":\"Can view basic information about services, workspaces, stats, invoices, and billing history. Can manage payments and account types.\"},{\"name\":\"user\",\"display_name\":\"User\",\"id\":\"Z1nKy6jEo4Mv9qLt8PbXcR\",\"description\":\"Can view basic information about services, workspaces, and stats. Some abilities may be restricted per service or workspace.\"},{\"name\":\"tls_admin\",\"display_name\":\"TLS Admin\",\"id\":\"H2fBv7cJm8xQp5rDn9TsLy\",\"description\":\"Can view and manage TLS settings and configuration details.\"},{\"name\":\"tls_viewer\",\"display_name\":\"TLS Viewer\",\"id\":\"U5sMc9eRq1nVy8tKa3FgHp\",\"description\":\"Can view TLS settings and configuration details.\"}]}"}],"_postman_id":"cbad3154-2c41-45a3-a7d8-e9bd3d54b660"},{"name":"Get IAM role by ID","id":"c5f129fc-dd9a-4bf1-8590-02d02b781bcc","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/iam/v1/roles/{{role_id}}?include","description":"<p>Retrieve a single IAM role by its unique identifier.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["iam","v1","roles","{{role_id}}"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Include related data (i.e., permissions).</p>\n","type":"text/plain"},"key":"include"}],"variable":[]}},"response":[{"id":"e752c50b-07ac-4167-8958-0e582b660c9d","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/iam/v1/roles/Q4rXe9vN1szK8a2fUjYtWp?include","protocol":"https","host":["api","fastly","com"],"path":["iam","v1","roles","Q4rXe9vN1szK8a2fUjYtWp"],"query":[{"key":"include","description":"Include related data (i.e., permissions)."}]},"description":"Retrieve a single IAM role by its unique identifier.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"name\":\"engineer\",\"display_name\":\"Engineer\",\"id\":\"Q4rXe9vN1szK8a2fUjYtWp\",\"description\":\"Can view, manage, purge, and delete services. Can view or edit workspaces. Some abilities may be restricted per service or workspace.\"}"}],"_postman_id":"c5f129fc-dd9a-4bf1-8590-02d02b781bcc"}],"id":"f6dfe6f5-9950-4976-b066-edd5e39824b3","description":"<p>An identity and access management (IAM) role is a collection of permissions that define access to account resources.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>limit</td>\n<td>integer</td>\n<td>Maximum number of results returned.</td>\n</tr>\n<tr>\n<td>next_cursor</td>\n<td>string</td>\n<td>Cursor for the next page.</td>\n</tr>\n<tr>\n<td>permissions</td>\n<td>array</td>\n<td>The set of permissions granted to this role.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"f6dfe6f5-9950-4976-b066-edd5e39824b3"},{"name":"Service authorizations","item":[{"name":"Show service authorization","id":"32357cc2-bb4b-4334-b2f5-74da1be15bff","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":"https://api.fastly.com/service-authorizations/{{service_authorization_id}}","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/account/service-authorization/#show-service-authorization\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["service-authorizations","{{service_authorization_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"eb70c8a3-333e-49b8-883d-c75744e044ee","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":"https://api.fastly.com/service-authorizations/3krg2uUGZzb2W9Euo4moOY","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/account/service-authorization/#show-service-authorization)**\n\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":{\"id\":\"3krg2uUGZzb2W9Euo4moOY\",\"type\":\"service_authorization\",\"attributes\":{\"created_at\":\"2020-03-15T20:10:09.000Z\",\"updated_at\":\"2020-03-15T20:10:09.000Z\",\"deleted_at\":null,\"permission\":\"read_only\"},\"relationships\":{\"service\":{\"data\":{\"type\":\"service\",\"id\":\"x4xCwxxJxGCx123Rx5xTx\"}},\"user\":{\"data\":{\"type\":\"user\",\"id\":\"6c7kAlo4vACNchGOdQxP37\"}}}}}"}],"_postman_id":"32357cc2-bb4b-4334-b2f5-74da1be15bff"},{"name":"Delete service authorization","id":"9be52cb8-c4d8-4afb-a882-5d649736f10d","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/service-authorizations/{{service_authorization_id}}","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/account/service-authorization/#delete-service-authorization\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["service-authorizations","{{service_authorization_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"a46c89c1-9417-47d7-8ba6-43fdfecffd3a","name":"204 No Content","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/service-authorizations/3krg2uUGZzb2W9Euo4moOY","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/account/service-authorization/#delete-service-authorization)**\n\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"204 No Content","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"9be52cb8-c4d8-4afb-a882-5d649736f10d"},{"name":"Update service authorization","id":"d7344918-2eb8-428c-afa9-613a245b90ca","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"data\":{\"id\":\"3krg2uUGZzb2W9Euo4moOY\",\"type\":\"service_authorization\",\"attributes\":{\"permission\":\"read_only\"}}}"},"url":"https://api.fastly.com/service-authorizations/{{service_authorization_id}}","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/account/service-authorization/#update-service-authorization\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["service-authorizations","{{service_authorization_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"e798abe5-20b8-45a7-b6bc-3ad53cacd6f7","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"data\":{\"id\":\"3krg2uUGZzb2W9Euo4moOY\",\"type\":\"service_authorization\",\"attributes\":{\"permission\":\"read_only\"}}}"},"url":"https://api.fastly.com/service-authorizations/3krg2uUGZzb2W9Euo4moOY","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/account/service-authorization/#update-service-authorization)**\n\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":{\"id\":\"3krg2uUGZzb2W9Euo4moOY\",\"type\":\"service_authorization\",\"attributes\":{\"created_at\":\"2020-03-15T20:07:34.000Z\",\"updated_at\":\"2020-03-15T20:07:34.000Z\",\"deleted_at\":null,\"permission\":\"read_only\"}}}"}],"_postman_id":"d7344918-2eb8-428c-afa9-613a245b90ca"},{"name":"List service authorizations","id":"8b376571-38ac-497d-bd60-84d80d3bc515","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":"https://api.fastly.com/service-authorizations?page[number]&page[size]","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/account/service-authorization/#list-service-authorization\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["service-authorizations"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Current page.</p>\n","type":"text/plain"},"key":"page[number]"},{"description":{"content":"<p>Number of records per page.</p>\n","type":"text/plain"},"key":"page[size]"}],"variable":[]}},"response":[{"id":"f8de2daf-05ca-4390-9db2-0497fdb8f97f","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":{"raw":"https://api.fastly.com/service-authorizations?page%5Bnumber%5D=1&page%5Bsize%5D=20?page[number]&page[size]","protocol":"https","host":["api","fastly","com"],"path":["service-authorizations"],"query":[{"key":"page[number]","description":"Current page."},{"key":"page[size]","description":"Number of records per page."}]},"description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/account/service-authorization/#list-service-authorization)**\n\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"id\":\"3krg2uUGZzb2W9Euo4moOY\",\"type\":\"service_authorization\",\"attributes\":{\"created_at\":\"2020-03-15T20:10:09.000Z\",\"updated_at\":\"2020-03-15T20:10:09.000Z\",\"deleted_at\":null,\"permission\":\"read_only\"},\"relationships\":{\"service\":{\"data\":{\"type\":\"service\",\"id\":\"x4xCwxxJxGCx123Rx5xTx\"}},\"user\":{\"data\":{\"type\":\"user\",\"id\":\"6c7kAlo4vACNchGOdQxP37\"}}}}],\"links\":{\"last\":\"http://api.fastly.com/service-authorizations?page[number]=1&page[size]=100\"},\"meta\":{\"current_page\":1,\"per_page\":100,\"record_count\":1,\"total_pages\":1}}"}],"_postman_id":"8b376571-38ac-497d-bd60-84d80d3bc515"},{"name":"Create service authorization","id":"4b98a004-7079-49ff-a54a-fdb104212dd1","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"data\":{\"type\":\"service_authorization\",\"attributes\":{\"permission\":\"read_only\"},\"relationships\":{\"user\":{\"data\":{\"type\":\"user\",\"id\":\"6c7kAlo4vACNchGOdQxP37\"}},\"service\":{\"data\":{\"type\":\"service\",\"id\":\"SU1Z0isxPaozGVKXdv0eY\"}}}}}"},"url":"https://api.fastly.com/service-authorizations","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/account/service-authorization/#create-service-authorization\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["service-authorizations"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"f46cd68b-3c8f-428c-81b4-447bd6152226","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"data\":{\"type\":\"service_authorization\",\"attributes\":{\"permission\":\"read_only\"},\"relationships\":{\"user\":{\"data\":{\"type\":\"user\",\"id\":\"6c7kAlo4vACNchGOdQxP37\"}},\"service\":{\"data\":{\"type\":\"service\",\"id\":\"SU1Z0isxPaozGVKXdv0eY\"}}}}}"},"url":"https://api.fastly.com/service-authorizations","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/account/service-authorization/#create-service-authorization)**\n\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":{\"type\":\"service_authorization\",\"attributes\":{\"created_at\":\"2020-03-15T20:07:34.000Z\",\"updated_at\":\"2020-03-15T20:07:34.000Z\",\"deleted_at\":null,\"permission\":\"read_only\"},\"relationships\":{\"user\":{\"data\":{\"type\":\"user\",\"id\":\"6c7kAlo4vACNchGOdQxP37\"}},\"service\":{\"data\":{\"type\":\"service\",\"id\":\"SU1Z0isxPaozGVKXdv0eY\"}}}}}"}],"_postman_id":"4b98a004-7079-49ff-a54a-fdb104212dd1"},{"name":"Delete service authorizations","id":"7bb249f5-c61b-4d0d-8753-5f58c3ea4609","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json; ext=bulk"},{"key":"Accept","value":"application/vnd.api+json; ext=bulk"}],"body":{"mode":"raw","raw":"{\"data\":[{\"id\":\"3krg2uUGZzb2W9Euo4moOY\",\"type\":\"service_authorization\"},{\"id\":\"71ZA6hv2FO6tGEQIE203Xj\",\"type\":\"service_authorization\"}]}"},"url":"https://api.fastly.com/service-authorizations","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/account/service-authorization/#delete-service-authorization2\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["service-authorizations"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"671b0ac1-cdb5-4a3c-998d-e34aa81a1827","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json; ext=bulk"},{"key":"Accept","value":"application/vnd.api+json; ext=bulk"}],"body":{"mode":"raw","raw":"{\"data\":[{\"id\":\"3krg2uUGZzb2W9Euo4moOY\",\"type\":\"service_authorization\"},{\"id\":\"71ZA6hv2FO6tGEQIE203Xj\",\"type\":\"service_authorization\"}]}"},"url":"https://api.fastly.com/service-authorizations","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/account/service-authorization/#delete-service-authorization2)**\n\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"id\":\"3krg2uUGZzb2W9Euo4moOY\",\"type\":\"service_authorization\",\"attributes\":{\"created_at\":\"2020-03-15T20:07:34.000Z\",\"updated_at\":\"2020-03-15T20:07:34.000Z\",\"deleted_at\":\"2020-03-16T20:07:34.000Z\"},\"relationships\":{\"user\":{\"data\":{\"type\":\"user\",\"id\":\"6c7kAlo4vACNchGOdQxP37\"}},\"service\":{\"data\":{\"type\":\"service\",\"id\":\"SU1Z0isxPaozGVKXdv0eY\"}}}},{\"id\":\"71ZA6hv2FO6tGEQIE203Xj\",\"type\":\"service_authorization\",\"attributes\":{\"created_at\":\"2020-03-15T20:07:34.000Z\",\"updated_at\":\"2020-03-15T20:07:34.000Z\",\"deleted_at\":\"2020-03-16T20:07:34.000Z\"},\"relationships\":{\"user\":{\"data\":{\"type\":\"user\",\"id\":\"6c7kAlo4vACNchGOdQxP37\"}},\"service\":{\"data\":{\"type\":\"service\",\"id\":\"hTE5dRlSBICGPJxJwCH4M\"}}}}]}"}],"_postman_id":"7bb249f5-c61b-4d0d-8753-5f58c3ea4609"},{"name":"Update service authorizations","id":"f2d0050d-1fc6-4fd9-9901-6a287776075b","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json; ext=bulk"},{"key":"Accept","value":"application/vnd.api+json; ext=bulk"}],"body":{"mode":"raw","raw":"{\"data\":[{\"id\":\"3krg2uUGZzb2W9Euo4moOY\",\"type\":\"service_authorization\",\"attributes\":{\"permission\":\"read_only\"}},{\"id\":\"71ZA6hv2FO6tGEQIE203Xj\",\"type\":\"service_authorization\",\"attributes\":{\"permission\":\"purge_all\"}}]}"},"url":"https://api.fastly.com/service-authorizations","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/account/service-authorization/#update-service-authorization2\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["service-authorizations"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"cf0a597b-6196-4a13-8131-d90845a77d35","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json; ext=bulk"},{"key":"Accept","value":"application/vnd.api+json; ext=bulk"}],"body":{"mode":"raw","raw":"{\"data\":[{\"id\":\"3krg2uUGZzb2W9Euo4moOY\",\"type\":\"service_authorization\",\"attributes\":{\"permission\":\"read_only\"}},{\"id\":\"71ZA6hv2FO6tGEQIE203Xj\",\"type\":\"service_authorization\",\"attributes\":{\"permission\":\"purge_all\"}}]}"},"url":"https://api.fastly.com/service-authorizations","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/account/service-authorization/#update-service-authorization2)**\n\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"id\":\"3krg2uUGZzb2W9Euo4moOY\",\"type\":\"service_authorization\",\"attributes\":{\"created_at\":\"2020-03-15T20:07:34.000Z\",\"updated_at\":\"2020-03-15T20:07:34.000Z\",\"deleted_at\":null,\"permission\":\"read_only\"},\"relationships\":{\"user\":{\"data\":{\"type\":\"user\",\"id\":\"6c7kAlo4vACNchGOdQxP37\"}},\"service\":{\"data\":{\"type\":\"service\",\"id\":\"SU1Z0isxPaozGVKXdv0eY\"}}}},{\"id\":\"71ZA6hv2FO6tGEQIE203Xj\",\"type\":\"service_authorization\",\"attributes\":{\"created_at\":\"2020-03-15T20:07:34.000Z\",\"updated_at\":\"2020-03-15T20:07:34.000Z\",\"deleted_at\":null,\"permission\":\"purge_all\"},\"relationships\":{\"user\":{\"data\":{\"type\":\"user\",\"id\":\"6c7kAlo4vACNchGOdQxP37\"}},\"service\":{\"data\":{\"type\":\"service\",\"id\":\"hTE5dRlSBICGPJxJwCH4M\"}}}}]}"}],"_postman_id":"f2d0050d-1fc6-4fd9-9901-6a287776075b"}],"id":"7328f47c-9fc0-4396-857a-162d2163b641","description":"<p>A service authorization allows limited users to access only specified services.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>permission</td>\n<td>string</td>\n<td>The permission the user has in relation to the service.</td>\n</tr>\n<tr>\n<td>relationships.service.id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>relationships.user.id</td>\n<td>string</td>\n<td>The ID of the user being given access to the service.</td>\n</tr>\n<tr>\n<td>type</td>\n<td>string</td>\n<td>Resource type.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>Alphanumeric string identifying a service authorization.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"7328f47c-9fc0-4396-857a-162d2163b641"},{"name":"Star","item":[{"name":"Get a star","id":"54a27624-90de-419d-a433-2539d81864ff","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":"https://api.fastly.com/stars/{{star_id}}","description":"<p>Show star.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["stars","{{star_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"57623979-c81d-4319-9580-5dbc7c004a1b","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":"https://api.fastly.com/stars/3krg2uUGZzb2W9Euo4moOY","description":"Show star.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":{\"id\":\"3krg2uUGZzb2W9Euo4moOY\",\"type\":\"star\",\"attributes\":{\"created_at\":\"2020-03-15T20:10:09.000Z\",\"updated_at\":\"2020-03-15T20:10:09.000Z\",\"deleted_at\":null},\"relationships\":{\"service\":{\"data\":{\"type\":\"service\",\"id\":\"SU1Z0isxPaozGVKXdv0eY\"}},\"user\":{\"data\":{\"type\":\"user\",\"id\":\"x9KzsrACXZv8tPwlEDsKb6\"}}}}}"}],"_postman_id":"54a27624-90de-419d-a433-2539d81864ff"},{"name":"Delete a star","id":"9399d9b1-c9f3-4774-b0fd-ed96dee65374","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/stars/{{star_id}}","description":"<p>Delete star.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["stars","{{star_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"c05691ac-4945-4e55-a22b-29984770bc20","name":"204 No Content","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/stars/3krg2uUGZzb2W9Euo4moOY","description":"Delete star.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"204 No Content","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"9399d9b1-c9f3-4774-b0fd-ed96dee65374"},{"name":"List stars","id":"7f603827-7984-455e-98f9-afab00de332a","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":"https://api.fastly.com/stars","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/account/star/#list-service-stars\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["stars"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"fd397f74-c761-4597-8e83-fefefb610a8f","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":"https://api.fastly.com/stars","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/account/star/#list-service-stars)**\n\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"type\":\"star\",\"relationships\":{\"user\":{\"data\":{\"type\":\"user\",\"id\":\"6c7kAlo4vACNchGOdQxP37\"}},\"service\":{\"data\":[{\"type\":\"service\",\"id\":\"SU1Z0isxPaozGVKXdv0eY\"}]}}}],\"meta\":{\"current_page\":1,\"per_page\":100,\"record_count\":1,\"total_pages\":1},\"links\":{\"last\":\"http://api.fastly.com/stars?page[number]=1&page[size]=100\"}}"}],"_postman_id":"7f603827-7984-455e-98f9-afab00de332a"},{"name":"Create a star","id":"204a1de7-7f9c-4cb9-964c-9e2b6bd3820f","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"data\":{\"type\":\"star\",\"relationships\":{\"user\":{\"data\":{\"type\":\"user\",\"id\":\"6c7kAlo4vACNchGOdQxP37\"}},\"service\":{\"data\":{\"type\":\"service\",\"id\":\"SU1Z0isxPaozGVKXdv0eY\"}}}}}"},"url":"https://api.fastly.com/stars","description":"<p>Create star.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["stars"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"62c30aae-74cc-420b-aea8-a37a7e5a3f22","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"data\":{\"type\":\"star\",\"relationships\":{\"user\":{\"data\":{\"type\":\"user\",\"id\":\"6c7kAlo4vACNchGOdQxP37\"}},\"service\":{\"data\":{\"type\":\"service\",\"id\":\"SU1Z0isxPaozGVKXdv0eY\"}}}}}"},"url":"https://api.fastly.com/stars","description":"Create star.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":{\"id\":\"3krg2uUGZzb2W9Euo4moOY\",\"type\":\"star\",\"attributes\":{\"created_at\":\"2020-03-15T20:10:09.000Z\",\"updated_at\":\"2020-03-15T20:10:09.000Z\",\"deleted_at\":null},\"relationships\":{\"service\":{\"data\":{\"type\":\"service\",\"id\":\"SU1Z0isxPaozGVKXdv0eY\"}},\"user\":{\"data\":{\"type\":\"user\",\"id\":\"x9KzsrACXZv8tPwlEDsKb6\"}}}}}"}],"_postman_id":"204a1de7-7f9c-4cb9-964c-9e2b6bd3820f"}],"id":"dcb3dbf6-226e-4e31-be63-7d32f9a73f6f","description":"<p>A star allows users to mark services of interest.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>relationships.service.id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>relationships.user.id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the user.</td>\n</tr>\n<tr>\n<td>type</td>\n<td>string</td>\n<td>Resource type.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>Alphanumeric string identifying a star.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"dcb3dbf6-226e-4e31-be63-7d32f9a73f6f"},{"name":"User","item":[{"name":"Get the current user","id":"97ef452a-1f56-42e9-a088-7ed8073474c3","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/current_user","description":"<p>Get the logged in user.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["current_user"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"c35ed380-8984-4e74-a6d4-7f35f68521ab","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/current_user","description":"Get the logged in user.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"created_at\":\"2020-05-02T17:15:54.000Z\",\"customer_id\":\"x4xCwxxJxGCx123Rx5xTx\",\"deleted_at\":null,\"email_hash\":\"hTE5dRlSBICGPJxJwCH4M\",\"id\":\"x9KzsrACXZv8tPwlEDsKb6\",\"locked\":false,\"login\":\"krisowner@example.com\",\"name\":\"Kris Owner\",\"require_new_password\":false,\"role\":\"user\",\"roles\":[\"Z1nKy6jEo4Mv9qLt8PbXcR\"],\"two_factor_auth_enabled\":true,\"two_factor_setup_required\":false,\"updated_at\":\"2020-05-21T18:45:00.000Z\"}"}],"_postman_id":"97ef452a-1f56-42e9-a088-7ed8073474c3"},{"name":"Get a user","id":"b063968e-304a-482b-9a3c-7dfb985821ba","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/user/{{user_id}}","description":"<p>Get a specific user.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["user","{{user_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"36f99a5b-fb95-47b8-977c-347b33578df9","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/user/x9KzsrACXZv8tPwlEDsKb6","description":"Get a specific user.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"created_at\":\"2020-05-02T17:15:54.000Z\",\"customer_id\":\"x4xCwxxJxGCx123Rx5xTx\",\"deleted_at\":null,\"email_hash\":\"hTE5dRlSBICGPJxJwCH4M\",\"id\":\"x9KzsrACXZv8tPwlEDsKb6\",\"locked\":false,\"login\":\"krisowner@example.com\",\"name\":\"Kris Owner\",\"require_new_password\":false,\"role\":\"user\",\"roles\":[\"Z1nKy6jEo4Mv9qLt8PbXcR\"],\"two_factor_auth_enabled\":true,\"two_factor_setup_required\":false,\"updated_at\":\"2020-05-21T18:45:00.000Z\"}"}],"_postman_id":"b063968e-304a-482b-9a3c-7dfb985821ba"},{"name":"Update a user","id":"65a173ff-de8f-4419-b813-59c07cffb44c","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/user/{{user_id}}","description":"<p>Update a user. Only users with the role of superuser can make changes to other users on the account. Non-superusers may use this endpoint to make changes to their own account. Two-factor attributes are not editable via this endpoint.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["user","{{user_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"b3532c07-a2f7-4c4c-a191-8643bb010c4c","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/user/x9KzsrACXZv8tPwlEDsKb6","description":"Update a user. Only users with the role of superuser can make changes to other users on the account. Non-superusers may use this endpoint to make changes to their own account. Two-factor attributes are not editable via this endpoint.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"created_at\":\"2020-05-02T17:15:54.000Z\",\"customer_id\":\"x4xCwxxJxGCx123Rx5xTx\",\"deleted_at\":null,\"email_hash\":\"hTE5dRlSBICGPJxJwCH4M\",\"id\":\"x9KzsrACXZv8tPwlEDsKb6\",\"locked\":false,\"login\":\"krisowner@example.com\",\"name\":\"Updated Name\",\"require_new_password\":false,\"role\":\"user\",\"roles\":[\"Z1nKy6jEo4Mv9qLt8PbXcR\"],\"two_factor_auth_enabled\":true,\"two_factor_setup_required\":false,\"updated_at\":\"2020-05-21T18:45:00.000Z\"}"}],"_postman_id":"65a173ff-de8f-4419-b813-59c07cffb44c"},{"name":"Delete a user","id":"84b6bd18-1a3d-4e0d-a6c8-5e81e10a365a","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/user/{{user_id}}","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/account/user/#delete-user\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Superuser</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["user","{{user_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"43422e5d-a041-4d10-a925-dc56a45a70ea","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/user/x9KzsrACXZv8tPwlEDsKb6","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/account/user/#delete-user)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Superuser](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"84b6bd18-1a3d-4e0d-a6c8-5e81e10a365a"},{"name":"Create a user","id":"4bc7bcda-99f5-4877-86e8-d28912dc344c","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/user","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/account/user/#create-user\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Superuser</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["user"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"d70310d5-c11f-467c-b126-21a3c0ea0fe3","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/user","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/account/user/#create-user)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Superuser](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"created_at\":\"2020-05-02T17:15:54.000Z\",\"customer_id\":\"x4xCwxxJxGCx123Rx5xTx\",\"deleted_at\":null,\"email_hash\":\"hTE5dRlSBICGPJxJwCH4M\",\"id\":\"x9KzsrACXZv8tPwlEDsKb6\",\"locked\":false,\"login\":\"krisowner@example.com\",\"name\":\"Kris Owner\",\"require_new_password\":false,\"role\":\"user\",\"roles\":[\"Z1nKy6jEo4Mv9qLt8PbXcR\"],\"two_factor_auth_enabled\":true,\"two_factor_setup_required\":false,\"updated_at\":\"2020-05-21T18:45:00.000Z\"}"}],"_postman_id":"4bc7bcda-99f5-4877-86e8-d28912dc344c"},{"name":"Update the user's password","id":"ec0e2d4b-ad23-47b2-af4a-bc7a3cf9f500","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/current_user/password","description":"<p>Update the user's password to a new one.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Username and password.</p>\n</blockquote>\n","urlObject":{"path":["current_user","password"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"30a3bbae-5fa9-4767-8f42-2e88f50409ac","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/current_user/password","description":"Update the user's password to a new one.\n> **Authorization**: Username and password.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"created_at\":\"2020-05-02T17:15:54.000Z\",\"customer_id\":\"x4xCwxxJxGCx123Rx5xTx\",\"deleted_at\":null,\"email_hash\":\"hTE5dRlSBICGPJxJwCH4M\",\"id\":\"x9KzsrACXZv8tPwlEDsKb6\",\"locked\":false,\"login\":\"krisowner@example.com\",\"name\":\"Kris Owner\",\"require_new_password\":false,\"role\":\"user\",\"roles\":[\"Z1nKy6jEo4Mv9qLt8PbXcR\"],\"two_factor_auth_enabled\":true,\"two_factor_setup_required\":false,\"updated_at\":\"2020-05-21T18:45:00.000Z\"}"}],"_postman_id":"ec0e2d4b-ad23-47b2-af4a-bc7a3cf9f500"},{"name":"Request a password reset","id":"8841abb0-582d-43dc-90b6-483bbc947b10","request":{"method":"POST","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/user/{{user_login}}/password/request_reset","description":"<p>Requests a password reset for the specified user.</p>\n","urlObject":{"path":["user","{{user_login}}","password","request_reset"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"df1e6f89-e686-40a2-97fa-b4ec0ba19695","name":"200 OK","originalRequest":{"method":"POST","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/user/krisowner@example.com/password/request_reset","description":"Requests a password reset for the specified user."},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"8841abb0-582d-43dc-90b6-483bbc947b10"}],"id":"9ec1001f-6e1b-4c3f-abbc-3c6587734c0f","description":"<p>A user of the Fastly API and web interface. A user is always associated with a customer. Some information may be limited depending on access level.</p>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>new_password</td>\n<td>string</td>\n<td>The user's new password.</td>\n</tr>\n<tr>\n<td>old_password</td>\n<td>string</td>\n<td>The user's current password.</td>\n</tr>\n<tr>\n<td>limit_services</td>\n<td>boolean</td>\n<td>Indicates that the user has limited access to the customer's services.</td>\n</tr>\n<tr>\n<td>locked</td>\n<td>boolean</td>\n<td>Indicates whether the is account is locked for editing or not.</td>\n</tr>\n<tr>\n<td>login</td>\n<td>string</td>\n<td>The login associated with the user (typically, an email address).</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The real life name of the user.</td>\n</tr>\n<tr>\n<td>require_new_password</td>\n<td>boolean</td>\n<td>Indicates if a new password is required at next login.</td>\n</tr>\n<tr>\n<td>role</td>\n<td>string</td>\n<td>The permissions role assigned to the user. Can be user, tls_viewer, tls_admin, billing, engineer, or superuser.</td>\n</tr>\n<tr>\n<td>roles</td>\n<td>array</td>\n<td>A list of role IDs assigned to the user.</td>\n</tr>\n<tr>\n<td>two_factor_auth_enabled</td>\n<td>boolean</td>\n<td>Indicates if 2FA is enabled on the user.</td>\n</tr>\n<tr>\n<td>two_factor_setup_required</td>\n<td>boolean</td>\n<td>Indicates if 2FA is required by the user's customer account.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>customer_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the customer.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>email_hash</td>\n<td>string</td>\n<td>The alphanumeric string identifying a email login.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the user.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n</tbody>\n</table>\n</div>","_postman_id":"9ec1001f-6e1b-4c3f-abbc-3c6587734c0f"}],"id":"b9f2e895-c278-42ab-874c-26f200c0081d","_postman_id":"b9f2e895-c278-42ab-874c-26f200c0081d","description":""},{"name":"Access control lists","item":[{"name":"ACL Entry","item":[{"name":"List ACL entries","id":"c5073b3d-21e2-4d73-bd8c-f7655a5b27d3","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/acl/{{acl_id}}/entries?direction&page&per_page&sort","description":"<p>List ACL entries for a specified ACL.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","acl","{{acl_id}}","entries"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Direction in which to sort results.</p>\n","type":"text/plain"},"key":"direction"},{"description":{"content":"<p>Current page.</p>\n","type":"text/plain"},"key":"page"},{"description":{"content":"<p>Number of records per page.</p>\n","type":"text/plain"},"key":"per_page"},{"description":{"content":"<p>Field on which to sort.</p>\n","type":"text/plain"},"key":"sort"}],"variable":[]}},"response":[{"id":"3adc072b-ed79-4124-908d-fec2997fec7d","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/acl/6tUXdegLTf5BCig0zGFrU3/entries?direction=ascend&page=1&per_page=20&sort=created?direction&page&per_page&sort","protocol":"https","host":["api","fastly","com"],"path":["service","SU1Z0isxPaozGVKXdv0eY","acl","6tUXdegLTf5BCig0zGFrU3","entries"],"query":[{"key":"direction","description":"Direction in which to sort results."},{"key":"page","description":"Current page."},{"key":"per_page","description":"Number of records per page."},{"key":"sort","description":"Field on which to sort."}]},"description":"List ACL entries for a specified ACL.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"id\":\"6yxNzlOpW1V7JfSwvLGtOc\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"acl_id\":\"2cFflPOskFLhmnZJEfUake\",\"ip\":\"192.168.0.1\",\"negated\":0,\"subnet\":16,\"comment\":\"\",\"created_at\":\"2020-04-21T18:14:32.000Z\",\"updated_at\":\"2020-04-21T18:14:32.000Z\",\"deleted_at\":null}]"}],"_postman_id":"c5073b3d-21e2-4d73-bd8c-f7655a5b27d3"},{"name":"Update multiple ACL entries","id":"47b8e8b7-42ee-46c8-9afc-514dece90a2b","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"entries\":[{\"op\":\"create\",\"ip\":\"192.168.0.1\",\"subnet\":8},{\"op\":\"update\",\"id\":\"6yxNzlOpW1V7JfSwvLGtOc\",\"ip\":\"192.168.0.2\",\"subnet\":16},{\"op\":\"delete\",\"id\":\"6yxNzlOpW1V7JfSwvLGtOc\"}]}"},"url":"https://api.fastly.com/service/{{service_id}}/acl/{{acl_id}}/entries","description":"<p>Update multiple ACL entries on the same ACL. For faster updates to your service, group your changes into large batches. The maximum batch size is 1000 entries. Contact support to discuss raising this limit.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","acl","{{acl_id}}","entries"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"13d086a7-9649-4bb8-9452-c996b2341d49","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"entries\":[{\"op\":\"create\",\"ip\":\"192.168.0.1\",\"subnet\":8},{\"op\":\"update\",\"id\":\"6yxNzlOpW1V7JfSwvLGtOc\",\"ip\":\"192.168.0.2\",\"subnet\":16},{\"op\":\"delete\",\"id\":\"6yxNzlOpW1V7JfSwvLGtOc\"}]}"},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/acl/6tUXdegLTf5BCig0zGFrU3/entries","description":"Update multiple ACL entries on the same ACL. For faster updates to your service, group your changes into large batches. The maximum batch size is 1000 entries. Contact support to discuss raising this limit.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"47b8e8b7-42ee-46c8-9afc-514dece90a2b"},{"name":"Describe an ACL entry","id":"75ef3188-a40c-424b-bd22-7f7235a3e2d6","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/acl/{{acl_id}}/entry/{{acl_entry_id}}","description":"<p>Retrieve a single ACL entry.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","acl","{{acl_id}}","entry","{{acl_entry_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"2a73a4ff-fd13-40be-aaf6-293ce5cfdad1","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/acl/6tUXdegLTf5BCig0zGFrU3/entry/6yxNzlOpW1V7JfSwvLGtOc","description":"Retrieve a single ACL entry.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"6yxNzlOpW1V7JfSwvLGtOc\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"acl_id\":\"2cFflPOskFLhmnZJEfUake\",\"ip\":\"192.168.0.1\",\"negated\":0,\"subnet\":16,\"comment\":\"\",\"created_at\":\"2020-04-21T18:14:32.000Z\",\"updated_at\":\"2020-04-21T18:14:32.000Z\",\"deleted_at\":null}"}],"_postman_id":"75ef3188-a40c-424b-bd22-7f7235a3e2d6"},{"name":"Delete an ACL entry","id":"d9c480bc-2d00-45c9-9798-54e305c88424","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/acl/{{acl_id}}/entry/{{acl_entry_id}}","description":"<p>Delete an ACL entry from a specified ACL.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","acl","{{acl_id}}","entry","{{acl_entry_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"fd84d39d-8b5f-44f0-b268-f511858da7d5","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/acl/6tUXdegLTf5BCig0zGFrU3/entry/6yxNzlOpW1V7JfSwvLGtOc","description":"Delete an ACL entry from a specified ACL.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"d9c480bc-2d00-45c9-9798-54e305c88424"},{"name":"Update an ACL entry","id":"7b8da9a7-2618-49e1-8309-19f6e08a2c64","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"subnet\":8}"},"url":"https://api.fastly.com/service/{{service_id}}/acl/{{acl_id}}/entry/{{acl_entry_id}}","description":"<p>Update an ACL entry for a specified ACL.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","acl","{{acl_id}}","entry","{{acl_entry_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"8e3ca46e-5504-4d22-94c5-c5eca588df7e","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"subnet\":8}"},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/acl/6tUXdegLTf5BCig0zGFrU3/entry/6yxNzlOpW1V7JfSwvLGtOc","description":"Update an ACL entry for a specified ACL.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"6yxNzlOpW1V7JfSwvLGtOc\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"acl_id\":\"2cFflPOskFLhmnZJEfUake\",\"ip\":\"192.168.0.1\",\"negated\":0,\"subnet\":8,\"comment\":\"\",\"created_at\":\"2020-04-21T18:14:32.000Z\",\"updated_at\":\"2020-04-21T18:14:32.000Z\",\"deleted_at\":null}"}],"_postman_id":"7b8da9a7-2618-49e1-8309-19f6e08a2c64"},{"name":"Create an ACL entry","id":"1b4c9795-ae20-4995-ad08-8d4b34cdd7d5","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"subnet\":16,\"ip\":\"192.168.0.1\"}"},"url":"https://api.fastly.com/service/{{service_id}}/acl/{{acl_id}}/entry","description":"<p>Add an ACL entry to an ACL.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","acl","{{acl_id}}","entry"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"7ef3a75c-be7e-40cf-a433-062815c08b14","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"subnet\":16,\"ip\":\"192.168.0.1\"}"},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/acl/6tUXdegLTf5BCig0zGFrU3/entry","description":"Add an ACL entry to an ACL.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"6yxNzlOpW1V7JfSwvLGtOc\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"acl_id\":\"2cFflPOskFLhmnZJEfUake\",\"ip\":\"192.168.0.1\",\"negated\":0,\"subnet\":16,\"comment\":\"\",\"created_at\":\"2020-04-21T18:14:32.000Z\",\"updated_at\":\"2020-04-21T18:14:32.000Z\",\"deleted_at\":null}"}],"_postman_id":"1b4c9795-ae20-4995-ad08-8d4b34cdd7d5"}],"id":"1d006dc8-99a4-4dcb-8628-876d0f5220ad","description":"<p>An ACL entry holds an individual IP address or subnet range and is a member of an ACL. ACL entries are versionless, which means they can be created, modified, or deleted without activating a new version of your service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>comment</td>\n<td>string</td>\n<td>A freeform descriptive note.</td>\n</tr>\n<tr>\n<td>ip</td>\n<td>string</td>\n<td>An IP address.</td>\n</tr>\n<tr>\n<td>negated</td>\n<td>integer</td>\n<td>Whether to negate the match. Useful primarily when creating individual exceptions to larger subnets.</td>\n</tr>\n<tr>\n<td></td>\n<td>0</td>\n<td>disable negation.</td>\n</tr>\n<tr>\n<td></td>\n<td>1</td>\n<td>enable negation.</td>\n</tr>\n<tr>\n<td>subnet</td>\n<td>integer</td>\n<td>Number of bits for the subnet mask applied to the IP address. For IPv4 addresses, a value of 32 represents the smallest subnet mask (1 address), 24 represents a class C subnet mask (256 addresses), 16 represents a class B subnet mask (65k addresses), and 8 is class A subnet mask (16m addresses). If not provided, no mask is applied.</td>\n</tr>\n<tr>\n<td>acl_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying a ACL.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>Alphanumeric string identifying an ACL Entry.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"1d006dc8-99a4-4dcb-8628-876d0f5220ad"},{"name":"ACL","item":[{"name":"List ACLs","id":"9a48f874-9d03-473d-a096-14c3495de74f","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/acl","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/acls/acl/#list-acls\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","acl"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"f0bfdc24-8d66-4c3d-97d7-75bffe5df657","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/acl","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/acls/acl/#list-acls)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"version\":\"1\",\"name\":\"test-acl\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"id\":\"2cFflPOskFLhmnZJEKU7y6\",\"created_at\":\"2020-04-21T18:14:32.000Z\",\"deleted_at\":null,\"updated_at\":\"2020-04-21T18:14:32.000Z\"}]"}],"_postman_id":"9a48f874-9d03-473d-a096-14c3495de74f"},{"name":"Create a new ACL","id":"a95c6321-14bb-446f-b2d2-cb188dc6c4f5","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/acl","description":"<p>Create a new ACL attached to the specified service version. A new, empty ACL must be attached to a draft version of a service. The version associated with the ACL must be activated to be used.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","acl"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"b015bb78-18cd-41f5-8e67-2578898d6694","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/acl","description":"Create a new ACL attached to the specified service version. A new, empty ACL must be attached to a draft version of a service. The version associated with the ACL must be activated to be used.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"version\":\"1\",\"name\":\"test-acl\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"id\":\"2cFflPOskFLhmnZJEKU7y6\",\"created_at\":\"2020-04-21T18:14:32.000Z\",\"deleted_at\":null,\"updated_at\":\"2020-04-21T18:14:32.000Z\"}"}],"_postman_id":"a95c6321-14bb-446f-b2d2-cb188dc6c4f5"},{"name":"Describe an ACL","id":"028ff869-59b6-403b-8c3e-edf1b1e825d4","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/acl/{{acl_name}}","description":"<p>Retrieve a single ACL by name for the version and service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","acl","{{acl_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"ab5aaf29-05ce-4f74-bd16-ce654a4c43a9","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/acl/test-acl","description":"Retrieve a single ACL by name for the version and service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"version\":\"1\",\"name\":\"test-acl\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"id\":\"2cFflPOskFLhmnZJEKU7y6\",\"created_at\":\"2020-04-21T18:14:32.000Z\",\"deleted_at\":null,\"updated_at\":\"2020-04-21T18:14:32.000Z\"}"}],"_postman_id":"028ff869-59b6-403b-8c3e-edf1b1e825d4"},{"name":"Update an ACL","id":"0e6690bf-a4b9-434a-b781-199b99315485","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/acl/{{acl_name}}","description":"<p>Update an ACL for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","acl","{{acl_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"e19c3255-5ee3-49cc-bced-9a559b99aba1","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/acl/test-acl","description":"Update an ACL for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"version\":\"1\",\"name\":\"updated-test-acl\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"id\":\"2cFflPOskFLhmnZJEKU7y6\",\"created_at\":\"2020-04-21T18:14:32.000Z\",\"deleted_at\":null,\"updated_at\":\"2020-04-21T18:14:32.000Z\"}"}],"_postman_id":"0e6690bf-a4b9-434a-b781-199b99315485"},{"name":"Delete an ACL","id":"a707e3c9-0dd0-4f80-aae5-db907e90c69d","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/acl/{{acl_name}}","description":"<p>Delete an ACL from the specified service version. To remove an ACL from use, the ACL must be deleted from a draft version and the version without the ACL must be activated.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","acl","{{acl_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"6af19cc7-98d6-47e8-aa43-5ff1b8ea3d25","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/acl/test-acl","description":"Delete an ACL from the specified service version. To remove an ACL from use, the ACL must be deleted from a draft version and the version without the ACL must be activated.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"a707e3c9-0dd0-4f80-aae5-db907e90c69d"}],"id":"a4c33e32-2f0c-430d-8370-427aa64afbf7","description":"<p>An access control list or \"ACL\" specifies individual IP addresses or subnet ranges and can be accessed and used from Fastly VCL.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>Name for the ACL. Must start with an alphanumeric character and contain only alphanumeric characters, underscores, and whitespace.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>Alphanumeric string identifying a ACL.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>string</td>\n<td>String representing the number identifying a version of the service.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"a4c33e32-2f0c-430d-8370-427aa64afbf7"},{"name":"ACLs in Compute","item":[{"name":"List ACLs","id":"8e20055f-0866-4ee2-be66-4a3589224649","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/resources/acls","description":"<p>List all ACLs.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","acls"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"f7f80f84-1a26-4c99-ac18-7de35ac42d05","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/resources/acls","description":"List all ACLs.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"name\":\"my-test-acl\",\"id\":\"ipyym7sp3s4w49po05p1ir\"},{\"name\":\"my-other-acl\",\"id\":\"piyy7mpss34w49po501pri\"}],\"meta\":{\"total\":2}}"}],"_postman_id":"8e20055f-0866-4ee2-be66-4a3589224649"},{"name":"Create a new ACL","id":"c3d11bdd-9f71-4276-8586-cb398bab54f5","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"my-test-acl\"}"},"url":"https://api.fastly.com/resources/acls","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/acls/acls/#compute-acl-create-acls\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","acls"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"a01d3d0a-3915-40bd-beb5-341ae23af759","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"my-test-acl\"}"},"url":"https://api.fastly.com/resources/acls","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/acls/acls/#compute-acl-create-acls)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"name\":\"my-test-acl\",\"id\":\"ipyym7sp3s4w49po05p1ir\"}"}],"_postman_id":"c3d11bdd-9f71-4276-8586-cb398bab54f5"},{"name":"Describe an ACL","id":"212768d0-259d-465c-9d00-e757ce42e258","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/resources/acls/{{acl_id}}","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/acls/acls/#compute-acl-list-acls-s-acl_id\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","acls","{{acl_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"19935387-ad4b-4275-baa8-3a33d2e7a224","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/resources/acls/{{acl_id}}","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/acls/acls/#compute-acl-list-acls-s-acl_id)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"name\":\"my-test-acl\",\"id\":\"ipyym7sp3s4w49po05p1ir\"}"}],"_postman_id":"212768d0-259d-465c-9d00-e757ce42e258"},{"name":"Delete an ACL","id":"1a098692-bdcf-49c3-828b-3c652a069146","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/resources/acls/{{acl_id}}","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/acls/acls/#compute-acl-delete-s-acl_id\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","acls","{{acl_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"67eb7977-9a72-497c-9e7c-b72ca4abd679","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/resources/acls/{{acl_id}}","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/acls/acls/#compute-acl-delete-s-acl_id)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"1a098692-bdcf-49c3-828b-3c652a069146"},{"name":"Lookup an ACL","id":"1759aaad-1cce-40a8-a272-130a633c073e","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/resources/acls/{{acl_id}}/entry/{{acl_ip}}","description":"<p>Find a matching ACL entry for an IP address.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","acls","{{acl_id}}","entry","{{acl_ip}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"9d853228-a1dd-4055-8696-efe08b75efd2","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/resources/acls/{{acl_id}}/entry/{{acl_ip}}","description":"Find a matching ACL entry for an IP address.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"prefix\":\"192.0.2.0/24\",\"action\":\"block\"}"}],"_postman_id":"1759aaad-1cce-40a8-a272-130a633c073e"},{"name":"List an ACL","id":"f54ce553-08c8-47f3-afc9-6d4df767b70a","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/resources/acls/{{acl_id}}/entries?cursor&limit","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/acls/acls/#compute-acl-list-acl-entries\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","acls","{{acl_id}}","entries"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Use to paginate through results.</p>\n","type":"text/plain"},"key":"cursor"},{"description":{"content":"<p>The maximum number of items included in the response.</p>\n","type":"text/plain"},"key":"limit"}],"variable":[]}},"response":[{"id":"a8f4a9b3-bd29-42f2-b601-cfbe96d345c0","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/resources/acls/{{acl_id}}/entries?cursor&limit","protocol":"https","host":["api","fastly","com"],"path":["resources","acls","{{acl_id}}","entries"],"query":[{"key":"cursor","description":"Use to paginate through results."},{"key":"limit","description":"The maximum number of items included in the response."}]},"description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/acls/acls/#compute-acl-list-acl-entries)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"entries\":[{\"prefix\":\"1.2.3.0/24\",\"action\":\"BLOCK\"},{\"prefix\":\"192.168.0.0/16\",\"action\":\"BLOCK\"},{\"prefix\":\"23.23.23.23/32\",\"action\":\"ALLOW\"},{\"prefix\":\"1.2.3.4/32\",\"action\":\"ALLOW\"}],\"meta\":{\"limit\":100,\"next_cursor\":\"next-cursor-id\"}}"}],"_postman_id":"f54ce553-08c8-47f3-afc9-6d4df767b70a"},{"name":"Update an ACL","id":"f0590bd4-edc3-41f3-a8a7-6fc5acefc5b9","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\"entries\":[{\"op\":\"create\",\"prefix\":\"1.2.3.0/24\",\"action\":\"BLOCK\"},{\"op\":\"update\",\"prefix\":\"192.168.0.0/16\",\"action\":\"BLOCK\"},{\"op\":\"create\",\"prefix\":\"23.23.23.23/32\",\"action\":\"ALLOW\"},{\"op\":\"update\",\"prefix\":\"1.2.3.4/32\",\"action\":\"ALLOW\"},{\"op\":\"delete\",\"prefix\":\"42.42.42.42/32\"}]}"},"url":"https://api.fastly.com/resources/acls/{{acl_id}}/entries","description":"<p>Update an ACL entry with a new operation or action, this allows you to modify an existing entry or delete it.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","acls","{{acl_id}}","entries"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"f137ceda-d2f7-4451-99b4-9d506a2c1b5b","name":"202 ACCEPTED","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\"entries\":[{\"op\":\"create\",\"prefix\":\"1.2.3.0/24\",\"action\":\"BLOCK\"},{\"op\":\"update\",\"prefix\":\"192.168.0.0/16\",\"action\":\"BLOCK\"},{\"op\":\"create\",\"prefix\":\"23.23.23.23/32\",\"action\":\"ALLOW\"},{\"op\":\"update\",\"prefix\":\"1.2.3.4/32\",\"action\":\"ALLOW\"},{\"op\":\"delete\",\"prefix\":\"42.42.42.42/32\"}]}"},"url":"https://api.fastly.com/resources/acls/{{acl_id}}/entries","description":"Update an ACL entry with a new operation or action, this allows you to modify an existing entry or delete it.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"202 ACCEPTED","code":202,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"f0590bd4-edc3-41f3-a8a7-6fc5acefc5b9"}],"id":"44c496a2-e345-4c2c-8f92-3f8513aff32e","description":"<p>An access control list (ACL) specifies individual IP addresses or subnet ranges and can be accessed and used from the Fastly Compute platform.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>Human readable name of store.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>An example identifier (UUID).</td>\n</tr>\n<tr>\n<td>action</td>\n<td>string</td>\n<td>One of \"ALLOW\" or \"BLOCK\".</td>\n</tr>\n<tr>\n<td>prefix</td>\n<td>string</td>\n<td>An IP prefix defined in Classless Inter-Domain Routing (CIDR) format, i.e. a valid IP address (v4 or v6) followed by a forward slash (/) and a prefix length (0-32 or 0-128, depending on address family).</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-1\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>An example identifier (UUID).</td>\n</tr>\n<tr>\n<td>meta</td>\n<td>object</td>\n<td>Meta for the total of ACLs.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>Human readable name of store.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-2\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n</tbody>\n</table>\n</div><h2 id=\"data-model-3\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>action</td>\n<td>string</td>\n<td>One of \"ALLOW\" or \"BLOCK\".</td>\n</tr>\n<tr>\n<td>prefix</td>\n<td>string</td>\n<td>A valid IPv4 or IPv6 address and prefix in CIDR notation.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-4\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n</tbody>\n</table>\n</div><h2 id=\"data-model-5\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>action</td>\n<td>string</td>\n<td>The action taken on the IP address, one of \"BLOCK\" or \"ALLOW\". If using the \"delete\" operation, no action should be specified.</td>\n</tr>\n<tr>\n<td>op</td>\n<td>string</td>\n<td>One of \"create\", \"update\", or \"delete\" indicating the operation to perform on the update.</td>\n</tr>\n<tr>\n<td>prefix</td>\n<td>string</td>\n<td>An IP prefix defined in Classless Inter-Domain Routing (CIDR) format, i.e. a valid IP address (v4 or v6) followed by a forward slash (/) and a prefix length (0-32 or 0-128, depending on address family).</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"44c496a2-e345-4c2c-8f92-3f8513aff32e"}],"id":"5b380715-4f77-4611-99b0-141ec4999edc","_postman_id":"5b380715-4f77-4611-99b0-141ec4999edc","description":""},{"name":"API Security","item":[{"name":"Operations","item":[{"name":"List discovered operations","id":"b7552468-dcec-4859-8026-7e18a41e38fe","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/api-security/v1/services/{{service_id}}/discovered-operations?domain&limit&method&page&path","description":"<p>List all discovered operations associated with a specific service. Optionally filter operations by status.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["api-security","v1","services","{{service_id}}","discovered-operations"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Filter operations by fully-qualified domain name (exact match).</p>\n","type":"text/plain"},"key":"domain"},{"description":{"content":"<p>The maximum number of operations to return per page.</p>\n","type":"text/plain"},"key":"limit"},{"description":{"content":"<p>Filter operations by HTTP method.</p>\n","type":"text/plain"},"key":"method"},{"description":{"content":"<p>The page number to return.</p>\n","type":"text/plain"},"key":"page"},{"description":{"content":"<p>Filter operations by path (exact match).</p>\n","type":"text/plain"},"key":"path"}],"variable":[]}},"response":[{"id":"dbaf3896-6971-43f9-bd84-d045f9255408","name":"200 A list of discovered operations for the service was successfully retrieved.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/api-security/v1/services/3NeCFuZNP1v0iyJ2vmYQI6/discovered-operations?domain=%5B%22example.com%22%2C%22api.example.com%22%5D&limit=100&method=%5B%22GET%22%2C%22POST%22%5D&page=1&path=%2Fapi%2Fv1%2Fusers?domain&limit&method&page&path","protocol":"https","host":["api","fastly","com"],"path":["api-security","v1","services","3NeCFuZNP1v0iyJ2vmYQI6","discovered-operations"],"query":[{"key":"domain","description":"Filter operations by fully-qualified domain name (exact match)."},{"key":"limit","description":"The maximum number of operations to return per page."},{"key":"method","description":"Filter operations by HTTP method."},{"key":"page","description":"The page number to return."},{"key":"path","description":"Filter operations by path (exact match)."}]},"description":"List all discovered operations associated with a specific service. Optionally filter operations by status.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 A list of discovered operations for the service was successfully retrieved.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"meta\":{\"limit\":100,\"total\":2},\"data\":[{\"id\":\"op_abc123def456\",\"method\":\"GET\",\"domain\":\"api.example.com\",\"path\":\"/users\",\"updated_at\":\"2024-06-20T19:40:49.000Z\",\"last_seen_at\":\"2024-06-20T19:40:49.000Z\",\"rps\":125.5},{\"id\":\"op_def456ghi789\",\"method\":\"POST\",\"domain\":\"api.example.com\",\"path\":\"/users\",\"updated_at\":\"2024-06-20T19:40:49.000Z\",\"last_seen_at\":\"2024-06-20T19:40:49.000Z\",\"rps\":42.3}]}"}],"_postman_id":"b7552468-dcec-4859-8026-7e18a41e38fe"},{"name":"List operations","id":"69932530-7db1-4905-8d52-7a9a45231581","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/api-security/v1/services/{{service_id}}/operations?domain&limit&method&page&path&status&tag_id","description":"<p>List all operations associated with a specific service. Optionally filter operations by tag ID.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["api-security","v1","services","{{service_id}}","operations"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Filter operations by fully-qualified domain name (exact match).</p>\n","type":"text/plain"},"key":"domain"},{"description":{"content":"<p>The maximum number of operations to return per page.</p>\n","type":"text/plain"},"key":"limit"},{"description":{"content":"<p>Filter operations by HTTP method.</p>\n","type":"text/plain"},"key":"method"},{"description":{"content":"<p>The page number to return.</p>\n","type":"text/plain"},"key":"page"},{"description":{"content":"<p>Filter operations by path (exact match).</p>\n","type":"text/plain"},"key":"path"},{"description":{"content":"<p>Filter operations by status. Defaults to SAVED if omitted.</p>\n","type":"text/plain"},"key":"status"},{"description":{"content":"<p>Filter operations by operation tag ID. Only operations associated with this operation tag will be returned.</p>\n","type":"text/plain"},"key":"tag_id"}],"variable":[]}},"response":[{"id":"adc1e4e6-b45b-4859-81e1-fbdcc77eceb7","name":"200 A list of operations for the service was successfully retrieved.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/api-security/v1/services/3NeCFuZNP1v0iyJ2vmYQI6/operations?domain=%5B%22example.com%22%2C%22api.example.com%22%5D&limit=100&method=%5B%22GET%22%2C%22POST%22%5D&page=1&path=%2Fapi%2Fv1%2Fusers&status=SAVED&tag_id=tag_abc123def456?domain&limit&method&page&path&status&tag_id","protocol":"https","host":["api","fastly","com"],"path":["api-security","v1","services","3NeCFuZNP1v0iyJ2vmYQI6","operations"],"query":[{"key":"domain","description":"Filter operations by fully-qualified domain name (exact match)."},{"key":"limit","description":"The maximum number of operations to return per page."},{"key":"method","description":"Filter operations by HTTP method."},{"key":"page","description":"The page number to return."},{"key":"path","description":"Filter operations by path (exact match)."},{"key":"status","description":"Filter operations by status. Defaults to SAVED if omitted."},{"key":"tag_id","description":"Filter operations by operation tag ID. Only operations associated with this operation tag will be returned."}]},"description":"List all operations associated with a specific service. Optionally filter operations by tag ID.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 A list of operations for the service was successfully retrieved.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"meta\":{\"limit\":100,\"total\":2},\"data\":[{\"id\":\"op_abc123def456\",\"method\":\"GET\",\"domain\":\"api.example.com\",\"path\":\"/users\",\"description\":\"Retrieve all users\",\"tag_ids\":[\"tag_abc123def456\"],\"status\":\"SAVED\",\"created_at\":\"2024-06-20T19:40:49.000Z\",\"updated_at\":\"2024-06-20T19:40:49.000Z\",\"last_seen_at\":\"2024-06-20T19:40:49.000Z\",\"rps\":125.5},{\"id\":\"op_def456ghi789\",\"method\":\"POST\",\"domain\":\"api.example.com\",\"path\":\"/users\",\"description\":\"Create a new user\",\"tag_ids\":[],\"status\":\"SAVED\",\"created_at\":\"2024-06-20T19:40:49.000Z\",\"updated_at\":\"2024-06-20T19:40:49.000Z\",\"last_seen_at\":\"2024-06-20T19:40:49.000Z\",\"rps\":42.3}]}"}],"_postman_id":"69932530-7db1-4905-8d52-7a9a45231581"},{"name":"Create operation","id":"9b8c6759-41b1-4864-b73b-f980bacc3478","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"method\":\"GET\",\"domain\":\"www.example.com\",\"path\":\"/api/v1/users/{var1}\",\"description\":\"Retrieve user information\",\"tag_ids\":[\"tag_abc123def456\"]}"},"url":"https://api.fastly.com/api-security/v1/services/{{service_id}}/operations","description":"<p>Create a new operation associated with a specific service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["api-security","v1","services","{{service_id}}","operations"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"4f0ffb83-34dd-4055-8054-cfd17e7ffa75","name":"201 The operation was successfully created.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"method\":\"GET\",\"domain\":\"www.example.com\",\"path\":\"/api/v1/users/{var1}\",\"description\":\"Retrieve user information\",\"tag_ids\":[\"tag_abc123def456\"]}"},"url":"https://api.fastly.com/api-security/v1/services/3NeCFuZNP1v0iyJ2vmYQI6/operations","description":"Create a new operation associated with a specific service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"201 The operation was successfully created.","code":201,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"op_abc123def456\",\"method\":\"GET\",\"domain\":\"www.example.com\",\"path\":\"/api/v1/users/{var1}\",\"description\":\"Retrieve user information\",\"tag_ids\":[\"tag_abc123def456\"],\"status\":\"SAVED\",\"created_at\":\"2024-06-20T19:40:49.000Z\",\"updated_at\":\"2024-06-20T19:40:49.000Z\",\"last_seen_at\":\"2024-06-20T19:40:49.000Z\",\"rps\":0}"}],"_postman_id":"9b8c6759-41b1-4864-b73b-f980bacc3478"},{"name":"Bulk create operations","id":"7da15f72-cbb5-4904-a005-1e594a2361a4","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"operations\":[{\"method\":\"GET\",\"domain\":\"api.example.com\",\"path\":\"/users\",\"description\":\"Retrieve all users\",\"tag_ids\":[\"tag_abc123def456\"]},{\"method\":\"POST\",\"domain\":\"api.example.com\",\"path\":\"/users\",\"description\":\"Create a new user\"}]}"},"url":"https://api.fastly.com/api-security/v1/services/{{service_id}}/operations-bulk","description":"<p>Create multiple operations associated with a specific service in a single request.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["api-security","v1","services","{{service_id}}","operations-bulk"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"5ebabece-eaca-40f3-84af-904ab7771f2b","name":"207 Multi-status response indicating the result of each operation creation.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"operations\":[{\"method\":\"GET\",\"domain\":\"api.example.com\",\"path\":\"/users\",\"description\":\"Retrieve all users\",\"tag_ids\":[\"tag_abc123def456\"]},{\"method\":\"POST\",\"domain\":\"api.example.com\",\"path\":\"/users\",\"description\":\"Create a new user\"}]}"},"url":"https://api.fastly.com/api-security/v1/services/3NeCFuZNP1v0iyJ2vmYQI6/operations-bulk","description":"Create multiple operations associated with a specific service in a single request.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"207 Multi-status response indicating the result of each operation creation.","code":207,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"id\":\"op_abc123def456\",\"status_code\":201,\"operation\":{\"id\":\"op_abc123def456\",\"method\":\"GET\",\"domain\":\"api.example.com\",\"path\":\"/users\",\"description\":\"Retrieve all users\",\"tag_ids\":[\"tag_abc123def456\"],\"status\":\"SAVED\",\"created_at\":\"2024-06-20T19:40:49.000Z\",\"updated_at\":\"2024-06-20T19:40:49.000Z\",\"last_seen_at\":\"2024-06-20T19:40:49.000Z\",\"rps\":0}},{\"id\":\"op_def456ghi789\",\"status_code\":201,\"operation\":{\"id\":\"op_def456ghi789\",\"method\":\"POST\",\"domain\":\"api.example.com\",\"path\":\"/users\",\"description\":\"Create a new user\",\"tag_ids\":[],\"status\":\"SAVED\",\"created_at\":\"2024-06-20T19:40:49.000Z\",\"updated_at\":\"2024-06-20T19:40:49.000Z\",\"last_seen_at\":\"2024-06-20T19:40:49.000Z\",\"rps\":0}}]}"}],"_postman_id":"7da15f72-cbb5-4904-a005-1e594a2361a4"},{"name":"Bulk delete operations","id":"f224f4c7-7f6e-4452-8344-67214b6de31b","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"operation_ids\":[\"op_abc123def456\",\"op_def456ghi789\"]}"},"url":"https://api.fastly.com/api-security/v1/services/{{service_id}}/operations-bulk","description":"<p>Delete multiple operations in a single request.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["api-security","v1","services","{{service_id}}","operations-bulk"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"7dc6a155-7bde-4d9d-a7cd-3a16ff7dc2ff","name":"207 Multi-status response indicating the result of each operation deletion.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"operation_ids\":[\"op_abc123def456\",\"op_def456ghi789\"]}"},"url":"https://api.fastly.com/api-security/v1/services/3NeCFuZNP1v0iyJ2vmYQI6/operations-bulk","description":"Delete multiple operations in a single request.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"207 Multi-status response indicating the result of each operation deletion.","code":207,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"id\":\"op_abc123def456\",\"status_code\":200},{\"id\":\"op_def456ghi789\",\"status_code\":404,\"reason\":\"Operation not found\"}]}"}],"_postman_id":"f224f4c7-7f6e-4452-8344-67214b6de31b"},{"name":"Bulk add tags to operations","id":"97ccb024-7e3b-4697-b5f9-1172481d6ff6","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"operation_ids\":[\"op_abc123def456\",\"op_def456ghi789\"],\"tag_ids\":[\"tag_abc123def456\",\"tag_def456ghi789\"]}"},"url":"https://api.fastly.com/api-security/v1/services/{{service_id}}/operations-bulk-tags","description":"<p>Add tags to multiple operations in a single request.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["api-security","v1","services","{{service_id}}","operations-bulk-tags"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"8a012dd5-12bb-4077-86c4-53825adf8035","name":"207 Multi-status response indicating the result of each tag addition.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"operation_ids\":[\"op_abc123def456\",\"op_def456ghi789\"],\"tag_ids\":[\"tag_abc123def456\",\"tag_def456ghi789\"]}"},"url":"https://api.fastly.com/api-security/v1/services/3NeCFuZNP1v0iyJ2vmYQI6/operations-bulk-tags","description":"Add tags to multiple operations in a single request.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"207 Multi-status response indicating the result of each tag addition.","code":207,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"id\":\"op_abc123def456\",\"status_code\":200},{\"id\":\"op_def456ghi789\",\"status_code\":200}]}"}],"_postman_id":"97ccb024-7e3b-4697-b5f9-1172481d6ff6"},{"name":"Retrieve operation","id":"1c5bcae6-f87b-4a13-ac1d-cd061d3f0805","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/api-security/v1/services/{{service_id}}/operations/{{operation_id}}","description":"<p>Get a specific operation associated with a service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["api-security","v1","services","{{service_id}}","operations","{{operation_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"5d1ec2b8-4180-4b9f-86ac-9386398e2288","name":"200 The operation was successfully retrieved.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/api-security/v1/services/3NeCFuZNP1v0iyJ2vmYQI6/operations/op_abc123def456","description":"Get a specific operation associated with a service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 The operation was successfully retrieved.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"op_abc123def456\",\"method\":\"GET\",\"domain\":\"www.example.com\",\"path\":\"/api/v1/users/{var1}\",\"description\":\"Retrieve user information\",\"tag_ids\":[\"tag_abc123def456\"],\"status\":\"SAVED\",\"created_at\":\"2024-06-20T19:40:49.000Z\",\"updated_at\":\"2024-06-20T19:40:49.000Z\",\"last_seen_at\":\"2024-06-20T19:40:49.000Z\",\"rps\":125.5}"}],"_postman_id":"1c5bcae6-f87b-4a13-ac1d-cd061d3f0805"},{"name":"Delete operation","id":"fc4d50e2-20f6-4794-bb7f-158e82f128ea","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/api-security/v1/services/{{service_id}}/operations/{{operation_id}}","description":"<p>Delete an existing operation associated with a specific service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["api-security","v1","services","{{service_id}}","operations","{{operation_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"0d682245-d71f-4774-8250-9f7021d33531","name":"204 The operation was successfully deleted.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/api-security/v1/services/3NeCFuZNP1v0iyJ2vmYQI6/operations/op_abc123def456","description":"Delete an existing operation associated with a specific service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 The operation was successfully deleted.","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"fc4d50e2-20f6-4794-bb7f-158e82f128ea"},{"name":"Update operation","id":"12c3d316-1eed-41e0-8d03-64e55aa061e6","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"description\":\"Updated description for the operation\",\"tag_ids\":[\"tag_abc123def456\",\"tag_def456ghi789\"]}"},"url":"https://api.fastly.com/api-security/v1/services/{{service_id}}/operations/{{operation_id}}","description":"<p>Partially update an existing operation associated with a specific service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["api-security","v1","services","{{service_id}}","operations","{{operation_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"f58901e9-e034-42db-85cd-5bbe1ff96ad0","name":"200 The operation was successfully updated.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"description\":\"Updated description for the operation\",\"tag_ids\":[\"tag_abc123def456\",\"tag_def456ghi789\"]}"},"url":"https://api.fastly.com/api-security/v1/services/3NeCFuZNP1v0iyJ2vmYQI6/operations/op_abc123def456","description":"Partially update an existing operation associated with a specific service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 The operation was successfully updated.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"op_abc123def456\",\"method\":\"GET\",\"domain\":\"www.example.com\",\"path\":\"/api/v1/users/{var1}\",\"description\":\"Updated description for the operation\",\"tag_ids\":[\"tag_abc123def456\",\"tag_def456ghi789\"],\"status\":\"SAVED\",\"created_at\":\"2024-06-20T19:40:49.000Z\",\"updated_at\":\"2024-06-21T10:30:00.000Z\",\"last_seen_at\":\"2024-06-20T19:40:49.000Z\",\"rps\":125.5}"}],"_postman_id":"12c3d316-1eed-41e0-8d03-64e55aa061e6"},{"name":"List operation tags","id":"ebf77740-9224-462b-9f9a-56a0d299470e","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/api-security/v1/services/{{service_id}}/tags?limit&page","description":"<p>List all operation tags associated with a specific service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["api-security","v1","services","{{service_id}}","tags"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>The maximum number of operations to return per page.</p>\n","type":"text/plain"},"key":"limit"},{"description":{"content":"<p>The page number to return.</p>\n","type":"text/plain"},"key":"page"}],"variable":[]}},"response":[{"id":"01cd85a4-824b-4c14-a234-9c1f4047f5ca","name":"200 A list of operation tags was successfully retrieved.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/api-security/v1/services/3NeCFuZNP1v0iyJ2vmYQI6/tags?limit=100&page=1?limit&page","protocol":"https","host":["api","fastly","com"],"path":["api-security","v1","services","3NeCFuZNP1v0iyJ2vmYQI6","tags"],"query":[{"key":"limit","description":"The maximum number of operations to return per page."},{"key":"page","description":"The page number to return."}]},"description":"List all operation tags associated with a specific service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 A list of operation tags was successfully retrieved.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"meta\":{\"limit\":100,\"total\":2},\"data\":[{\"id\":\"tag_abc123def456\",\"name\":\"production\",\"description\":\"Tag for production environment resources\",\"count\":5,\"created_at\":\"2024-01-15T10:30:00Z\",\"updated_at\":\"2024-01-16T14:45:00Z\"},{\"id\":\"tag_def456ghi789\",\"name\":\"staging\",\"description\":\"Tag for staging environment resources\",\"count\":3,\"created_at\":\"2024-01-15T10:30:00Z\",\"updated_at\":\"2024-01-16T14:45:00Z\"}]}"}],"_postman_id":"ebf77740-9224-462b-9f9a-56a0d299470e"},{"name":"Create operation tag","id":"d6aab816-4c5c-4852-90d0-735693531c67","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"production\",\"description\":\"Tag for production environment resources\"}"},"url":"https://api.fastly.com/api-security/v1/services/{{service_id}}/tags","description":"<p>Create a new operation tag associated with a specific service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["api-security","v1","services","{{service_id}}","tags"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"181293f5-0564-4684-8536-434ef7b6cc3d","name":"201 The operation tag was successfully created.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"production\",\"description\":\"Tag for production environment resources\"}"},"url":"https://api.fastly.com/api-security/v1/services/3NeCFuZNP1v0iyJ2vmYQI6/tags","description":"Create a new operation tag associated with a specific service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"201 The operation tag was successfully created.","code":201,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"tag_abc123def456\",\"name\":\"production\",\"description\":\"Tag for production environment resources\",\"created_at\":\"2024-01-15T10:30:00Z\",\"updated_at\":\"2024-01-15T10:30:00Z\"}"}],"_postman_id":"d6aab816-4c5c-4852-90d0-735693531c67"},{"name":"Retrieve operation tag","id":"dd5955d2-aa63-44f9-a20c-829e7408d22f","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/api-security/v1/services/{{service_id}}/tags/{{tag_id}}","description":"<p>Get a specific operation tag by its unique identifier.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["api-security","v1","services","{{service_id}}","tags","{{tag_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"c4d53ef9-edce-453f-bfde-fd11116d9b3f","name":"200 The operation tag was successfully retrieved.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/api-security/v1/services/3NeCFuZNP1v0iyJ2vmYQI6/tags/tag_abc123def456","description":"Get a specific operation tag by its unique identifier.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 The operation tag was successfully retrieved.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"tag_abc123def456\",\"name\":\"production\",\"description\":\"Tag for production environment resources\",\"count\":5,\"created_at\":\"2024-01-15T10:30:00Z\",\"updated_at\":\"2024-01-16T14:45:00Z\"}"}],"_postman_id":"dd5955d2-aa63-44f9-a20c-829e7408d22f"},{"name":"Delete operation tag","id":"a10418c8-46c0-437b-a444-17182e6dcc27","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/api-security/v1/services/{{service_id}}/tags/{{tag_id}}","description":"<p>Delete an existing operation tag.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["api-security","v1","services","{{service_id}}","tags","{{tag_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"69bedafc-5b36-4874-8af0-2474d23273b1","name":"204 The operation tag was successfully deleted.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/api-security/v1/services/3NeCFuZNP1v0iyJ2vmYQI6/tags/tag_abc123def456","description":"Delete an existing operation tag.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 The operation tag was successfully deleted.","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"a10418c8-46c0-437b-a444-17182e6dcc27"},{"name":"Update operation tag","id":"510e8513-376e-41cc-84cf-85b68e530435","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"production-updated\",\"description\":\"Updated description for production tag\"}"},"url":"https://api.fastly.com/api-security/v1/services/{{service_id}}/tags/{{tag_id}}","description":"<p>Partially update an existing operation tag.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["api-security","v1","services","{{service_id}}","tags","{{tag_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"b3d658bd-09b5-410f-a479-8c89c8fed620","name":"200 The operation tag was successfully updated.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"production-updated\",\"description\":\"Updated description for production tag\"}"},"url":"https://api.fastly.com/api-security/v1/services/3NeCFuZNP1v0iyJ2vmYQI6/tags/tag_abc123def456","description":"Partially update an existing operation tag.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 The operation tag was successfully updated.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"tag_abc123def456\",\"name\":\"production-updated\",\"description\":\"Updated description for production tag\",\"created_at\":\"2024-01-15T10:30:00Z\",\"updated_at\":\"2024-01-17T09:00:00Z\"}"}],"_postman_id":"510e8513-376e-41cc-84cf-85b68e530435"}],"id":"6fd8b6b1-b423-4d5c-b8e8-752192c3478b","description":"<p>Operations provide functionality to manage API operations discovered for a service, including listing, creating, updating, and deleting operations, as well as managing tags for organizing operations.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>domain</td>\n<td>string</td>\n<td>The domain for the operation.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>The unique identifier of the discovered operation.</td>\n</tr>\n<tr>\n<td>last_seen_at</td>\n<td>string</td>\n<td>The timestamp when the operation was last seen in traffic.</td>\n</tr>\n<tr>\n<td>method</td>\n<td>string</td>\n<td>The HTTP method for the operation.</td>\n</tr>\n<tr>\n<td>path</td>\n<td>string</td>\n<td>The path for the operation, which may include path parameters.</td>\n</tr>\n<tr>\n<td>rps</td>\n<td>number</td>\n<td>Requests per second observed for this operation.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>The timestamp when the operation was last updated.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>The timestamp when the operation was created.</td>\n</tr>\n<tr>\n<td>description</td>\n<td>string</td>\n<td>A description of what the operation does.</td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>The status of the operation.</td>\n</tr>\n<tr>\n<td>tag_ids</td>\n<td>array</td>\n<td>An array of operation tag IDs associated with this operation.</td>\n</tr>\n<tr>\n<td>count</td>\n<td>integer</td>\n<td>The number of operations associated with this operation tag.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The name of the operation tag.</td>\n</tr>\n<tr>\n<td>reason</td>\n<td>string</td>\n<td>Error reason if the operation failed.</td>\n</tr>\n<tr>\n<td>status_code</td>\n<td>integer</td>\n<td>HTTP status code for this operation.</td>\n</tr>\n<tr>\n<td>operation_ids</td>\n<td>array</td>\n<td>List of operation IDs to add tags to.</td>\n</tr>\n<tr>\n<td>operations</td>\n<td>array</td>\n<td>List of operations to create.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"6fd8b6b1-b423-4d5c-b8e8-752192c3478b"}],"id":"ffa38f92-41fc-4c30-bf02-fded21bd63d2","_postman_id":"ffa38f92-41fc-4c30-bf02-fded21bd63d2","description":""},{"name":"Authentication tokens","item":[{"name":"Automation Tokens","item":[{"name":"List Customer Automation Tokens","id":"48be163f-de3f-47e2-b6ca-bd54052da41a","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/automation-tokens?page&per_page","description":"<p>Lists all automation tokens for a customer.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["automation-tokens"],"host":["https://api.fastly.com"],"query":[{"key":"page"},{"key":"per_page"}],"variable":[]}},"response":[{"id":"bd549a60-4f9f-4d79-b0df-b693b586b540","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/automation-tokens?page&per_page","protocol":"https","host":["api","fastly","com"],"path":["automation-tokens"],"query":[{"key":"page"},{"key":"per_page"}]},"description":"Lists all automation tokens for a customer.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"id\":\"FASTLY_AUTOMATION_TOKEN_ID\",\"customer_id\":\"FASTLY_CUSTOMER_ID\",\"creator_id\":\"FASTLY_USER_ID\",\"name\":\"automation-token\",\"role\":\"engineer\",\"ip\":\"127.17.202.173\",\"user_agent\":\"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_3) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/56.0.2924.87 Safari/537.36\",\"scope\":\"global\",\"services\":[],\"tls_access\":false,\"last_used_at\":\"2022-06-07T20:43:14Z\",\"created_at\":\"2022-06-07T20:43:14Z\",\"expires_at\":\"2022-07-07T23:00:00Z\"}]"}],"_postman_id":"48be163f-de3f-47e2-b6ca-bd54052da41a"},{"name":"Create Automation Token","id":"7c73d9d0-2b4a-4636-ba30-5ab68cd9eee6","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"my_automation_token\",\"expires_at\":null,\"role\":\"engineer\",\"services\":[],\"tls_access\":false}"},"url":"https://api.fastly.com/automation-tokens","description":"<p>Creates a new automation token.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["automation-tokens"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"881074f4-5313-432c-b99c-29fae9f39340","name":"201 Created","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"my_automation_token\",\"expires_at\":null,\"role\":\"engineer\",\"services\":[],\"tls_access\":false}"},"url":"https://api.fastly.com/automation-tokens","description":"Creates a new automation token.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"201 Created","code":201,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"FASTLY_AUTOMATION_TOKEN_ID\",\"customer_id\":\"FASTLY_CUSTOMER_ID\",\"creator_id\":\"FASTLY_USER_ID\",\"name\":\"automation-token01\",\"access_token\":\"0FMUwOLYpTSaCX2BWhdSJhAtm9ubU3MC\",\"role\":\"engineer\",\"ip\":\"127.17.202.173\",\"user_agent\":\"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_3) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/56.0.2924.87 Safari/537.36\",\"scope\":\"global\",\"services\":[],\"tls_access\":false,\"last_used_at\":\"2022-06-07T20:43:14Z\",\"created_at\":\"2022-06-07T20:43:14Z\",\"expires_at\":\"2022-06-07T23:00:00Z\"}"}],"_postman_id":"7c73d9d0-2b4a-4636-ba30-5ab68cd9eee6"},{"name":"Retrieve an Automation Token by ID","id":"24aa9218-fcce-4ca5-a750-23d9007979d2","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/automation-tokens/{{id}}","description":"<p>Retrieves an automation token by ID.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["automation-tokens","{{id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"464f3eb4-82a8-4bca-a2b3-8984eb755768","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/automation-tokens/{{id}}","description":"Retrieves an automation token by ID.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"FASTLY_AUTOMATION_TOKEN_ID\",\"customer_id\":\"FASTLY_CUSTOMER_ID\",\"creator_id\":\"FASTLY_USER_ID\",\"name\":\"automation-token\",\"role\":\"engineer\",\"ip\":\"127.17.202.173\",\"user_agent\":\"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_3) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/56.0.2924.87 Safari/537.36\",\"scope\":\"global\",\"services\":[],\"tls_access\":false,\"last_used_at\":\"2022-06-07T20:43:14Z\",\"created_at\":\"2022-06-07T20:43:14Z\",\"expires_at\":\"2022-07-07T23:00:00Z\"}"}],"_postman_id":"24aa9218-fcce-4ca5-a750-23d9007979d2"},{"name":"Revoke an Automation Token by ID","id":"b04bade0-4ed7-4b7f-bcee-c0d970cadeeb","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/automation-tokens/{{id}}","description":"<p>Revoke an automation token by ID.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["automation-tokens","{{id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"5639311a-8880-40d0-9023-16089e15c0c1","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/automation-tokens/{{id}}","description":"Revoke an automation token by ID.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{}"}],"_postman_id":"b04bade0-4ed7-4b7f-bcee-c0d970cadeeb"},{"name":"List Automation Token Services","id":"044c1ae5-6bc8-40e5-8ab9-cc1600ea2b8f","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/automation-tokens/{{id}}/services?page&per_page","description":"<p>List of services associated with the automation token.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["automation-tokens","{{id}}","services"],"host":["https://api.fastly.com"],"query":[{"key":"page"},{"key":"per_page"}],"variable":[]}},"response":[{"id":"628e8745-d479-422e-b201-3a892d1615bd","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/automation-tokens/{{id}}/services?page&per_page","protocol":"https","host":["api","fastly","com"],"path":["automation-tokens","{{id}}","services"],"query":[{"key":"page"},{"key":"per_page"}]},"description":"List of services associated with the automation token.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[\"SU1Z0isxPaozGVKXdv0eX\",\"SU1Z0isxPaozGVKXdv0eY\",\"SU1Z0isxPaozGVKXdv0eZ\"],\"meta\":{\"current_page\":1,\"per_page\":100,\"record_count\":3,\"total_pages\":1}}"}],"_postman_id":"044c1ae5-6bc8-40e5-8ab9-cc1600ea2b8f"}],"id":"bc1be811-04e7-4161-885b-b70dda76d1ea","description":"<p>Automation tokens differ from other token types because they are not tied to a specific person and therefore are not subject to the lifecycle of such accounts. Automation tokens are sometimes also called \"service accounts\". They are designed for API automation use-cases such as continuous integration, deployment pipelines, or automation scripts. For more information about authentication tokens, review the Authentication token documentation.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>expires_at</td>\n<td>string</td>\n<td>A UTC timestamp of when the token expires.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The name of the token.</td>\n</tr>\n<tr>\n<td>role</td>\n<td>string</td>\n<td>The role on the token.</td>\n</tr>\n<tr>\n<td>scope</td>\n<td>string</td>\n<td>A space-delimited list of authorization scope.</td>\n</tr>\n<tr>\n<td></td>\n<td>global</td>\n<td>This is the default scope covering all supported capabilities.</td>\n</tr>\n<tr>\n<td></td>\n<td>purge_select</td>\n<td>Allows purging with surrogate key and URL. Disallows purging with purge-all.</td>\n</tr>\n<tr>\n<td></td>\n<td>purge_all</td>\n<td>Allows purging an entire service via purge_all.</td>\n</tr>\n<tr>\n<td></td>\n<td>global:read</td>\n<td>Allows read-only access to account information, configuration, and stats.</td>\n</tr>\n<tr>\n<td>services</td>\n<td>array</td>\n<td>(Optional) The service IDs of the services the token will have access to. Separate service IDs with a space. If no services are specified, the token will have access to all services on the account.</td>\n</tr>\n<tr>\n<td>tls_access</td>\n<td>boolean</td>\n<td>Indicates whether TLS access is enabled for the token.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>A UTC timestamp of when the token was created.</td>\n</tr>\n<tr>\n<td>customer_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the customer.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>Alphanumeric string identifying a token.</td>\n</tr>\n<tr>\n<td>last_used_at</td>\n<td>string</td>\n<td>A UTC timestamp of when the token was last used.</td>\n</tr>\n<tr>\n<td>user_agent</td>\n<td>string</td>\n<td>The User-Agent header of the client that last used the token.</td>\n</tr>\n<tr>\n<td>user_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the user.</td>\n</tr>\n<tr>\n<td>ip</td>\n<td>string</td>\n<td>The IP address of the client that last used the token.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"bc1be811-04e7-4161-885b-b70dda76d1ea"},{"name":"User tokens","item":[{"name":"List tokens for the authenticated user","id":"5849ef25-a1ee-40e8-acba-9f6072206b83","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/tokens","description":"<p>List all tokens belonging to the authenticated user.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["tokens"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"236115b7-58d8-43c6-9d38-7203e058a4c8","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/tokens","description":"List all tokens belonging to the authenticated user.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"id\":\"5Yo3XXnrQpjc20u0ybrf2g\",\"user_id\":\"4y5K5trZocEAQYkesWlk7M\",\"services\":[],\"name\":\"test-token\",\"scope\":\"global\",\"created_at\":\"2020-06-22T03:19:48.000Z\",\"last_used_at\":\"2020-06-22T03:19:48.000Z\",\"expires_at\":\"2020-07-28T19:24:50.000Z\",\"ip\":\"127.17.202.173\",\"user_agent\":\"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_3) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/56.0.2924.87 Safari/537.36\"}]"}],"_postman_id":"5849ef25-a1ee-40e8-acba-9f6072206b83"},{"name":"Create a token","id":"5733ac49-0e1c-4148-bdac-8b6ff01a3633","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/tokens","description":"<p>Create an API token. If two-factor authentication is enabled for your account, review the instructions for including a one-time password in the request.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Username and password, Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["tokens"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"ee77ed17-c55c-4803-bae7-746eaa43bc10","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/tokens","description":"Create an API token. If two-factor authentication is enabled for your account, review the instructions for including a one-time password in the request.\n> **Authorization**: Username and password, Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"5Yo3XXnrQpjc20u0ybrf2g\",\"user_id\":\"4y5K5trZocEAQYkesWlk7M\",\"services\":[\"5VqE6MOOy1QFJbgmCK41pY\",\"6VqE6MOOy1QFJbgmCK41pZ\"],\"name\":\"test-token\",\"scope\":\"global\",\"created_at\":\"2020-06-22T03:19:48.000Z\",\"last_used_at\":\"2020-06-22T03:19:48.000Z\",\"expires_at\":\"2020-07-28T19:24:50.000Z\",\"ip\":\"127.17.202.173\",\"user_agent\":\"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_3) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/56.0.2924.87 Safari/537.36\",\"access_token\":\"YOUR_FASTLY_TOKEN\"}"}],"_postman_id":"5733ac49-0e1c-4148-bdac-8b6ff01a3633"},{"name":"Revoke multiple tokens","id":"2ea095c1-d148-4c2d-aae8-8db8c5d1e58f","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json; ext=bulk"}],"body":{"mode":"raw","raw":"{\"data\":[{\"id\":\"3krg2uUGZzb2W9Euo4moOY\",\"type\":\"token\"},{\"id\":\"71ZA6hv2FO6tGEQIE203Xj\",\"type\":\"token\"}]}"},"url":"https://api.fastly.com/tokens","description":"<p>Revoke Tokens in bulk format. Users may only revoke their own tokens. Superusers may revoke tokens of others.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["tokens"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"43bf5d6d-8180-4690-acb3-94fba6aef146","name":"204 No Content","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json; ext=bulk"}],"body":{"mode":"raw","raw":"{\"data\":[{\"id\":\"3krg2uUGZzb2W9Euo4moOY\",\"type\":\"token\"},{\"id\":\"71ZA6hv2FO6tGEQIE203Xj\",\"type\":\"token\"}]}"},"url":"https://api.fastly.com/tokens","description":"Revoke Tokens in bulk format. Users may only revoke their own tokens. Superusers may revoke tokens of others.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"204 No Content","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"2ea095c1-d148-4c2d-aae8-8db8c5d1e58f"},{"name":"List tokens for a customer","id":"0fe3f018-0a9f-4493-93da-909cc087ad24","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/customer/{{customer_id}}/tokens","description":"<p>List all tokens belonging to a specific customer.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["customer","{{customer_id}}","tokens"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"2760a6bd-ce34-4763-a9a6-74d3b911e317","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/customer/x4xCwxxJxGCx123Rx5xTx/tokens","description":"List all tokens belonging to a specific customer.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"id\":\"5Yo3XXnrQpjc20u0ybrf2g\",\"user_id\":\"4y5K5trZocEAQYkesWlk7M\",\"services\":[],\"name\":\"test-token\",\"scope\":\"global\",\"created_at\":\"2020-06-22T03:19:48.000Z\",\"last_used_at\":\"2020-06-22T03:19:48.000Z\",\"expires_at\":\"2020-07-28T19:24:50.000Z\",\"ip\":\"127.17.202.173\",\"user_agent\":\"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_3) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/56.0.2924.87 Safari/537.36\"}]"}],"_postman_id":"0fe3f018-0a9f-4493-93da-909cc087ad24"},{"name":"Get the current token","id":"704f9dca-0862-4500-b75e-2f7951f6816f","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/tokens/self","description":"<p>Get a single token based on the access_token used in the request.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["tokens","self"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"cc14ba58-5f51-4c20-b867-7f425a95e591","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/tokens/self","description":"Get a single token based on the access_token used in the request.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"5Yo3XXnrQpjc20u0ybrf2g\",\"user_id\":\"4y5K5trZocEAQYkesWlk7M\",\"services\":[],\"name\":\"test-token\",\"scope\":\"global\",\"created_at\":\"2020-06-22T03:19:48.000Z\",\"last_used_at\":\"2020-06-22T03:19:48.000Z\",\"expires_at\":\"2020-07-28T19:24:50.000Z\",\"ip\":\"127.17.202.173\",\"user_agent\":\"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_3) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/56.0.2924.87 Safari/537.36\"}"}],"_postman_id":"704f9dca-0862-4500-b75e-2f7951f6816f"},{"name":"Revoke the current token","id":"c01833bb-193c-41f5-84bc-fc96228c1056","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/tokens/self","description":"<p>Revoke a token that is used to authenticate the request.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["tokens","self"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"229c380b-e959-45e9-a3dc-174c7fae0027","name":"204 No Content","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/tokens/self","description":"Revoke a token that is used to authenticate the request.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"204 No Content","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"c01833bb-193c-41f5-84bc-fc96228c1056"},{"name":"Get a token","id":"76ec2c7a-b276-4f02-8531-c1dff9407360","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/tokens/{{token_id}}","description":"<p>Get a single token by its id.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["tokens","{{token_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"52a68061-2741-4632-bc6e-1c9da60be507","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/tokens/5Yo3XXnrQpjc20u0ybrf2g","description":"Get a single token by its id.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"5Yo3XXnrQpjc20u0ybrf2g\",\"user_id\":\"4y5K5trZocEAQYkesWlk7M\",\"services\":[],\"name\":\"test-token\",\"scope\":\"global\",\"created_at\":\"2020-06-22T03:19:48.000Z\",\"last_used_at\":\"2020-06-22T03:19:48.000Z\",\"expires_at\":\"2020-07-28T19:24:50.000Z\",\"ip\":\"127.17.202.173\",\"user_agent\":\"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_3) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/56.0.2924.87 Safari/537.36\"}"}],"_postman_id":"76ec2c7a-b276-4f02-8531-c1dff9407360"},{"name":"Revoke a token","id":"a23432eb-d243-4032-b03d-4ec808113da3","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/tokens/{{token_id}}","description":"<p>Revoke a specific token by its id.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["tokens","{{token_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"e42ffb9d-b15c-4401-ba4a-f72371d7d860","name":"204 No Content","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/tokens/5Yo3XXnrQpjc20u0ybrf2g","description":"Revoke a specific token by its id.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"204 No Content","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"a23432eb-d243-4032-b03d-4ec808113da3"}],"id":"713a437b-f358-451e-834a-1baa0f8d5a77","description":"<p>An API Token is used to identify who is making the API call. Users can create multiple tokens to suit their needs.</p>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>Name of the token.</td>\n</tr>\n<tr>\n<td>scope</td>\n<td>string</td>\n<td>Space-delimited list of authorization scope.</td>\n</tr>\n<tr>\n<td></td>\n<td>global</td>\n<td>This is the default scope covering all supported capabilities.</td>\n</tr>\n<tr>\n<td></td>\n<td>purge_select</td>\n<td>Allows purging with surrogate key and URL. Disallows purging with purge-all.</td>\n</tr>\n<tr>\n<td></td>\n<td>purge_all</td>\n<td>Allows purging an entire service via purge_all.</td>\n</tr>\n<tr>\n<td></td>\n<td>global:read</td>\n<td>Allows read-only access to account information, configuration, and stats.</td>\n</tr>\n<tr>\n<td>services</td>\n<td>array</td>\n<td>List of alphanumeric strings identifying services (optional). If no services are specified, the token will have access to all services on the account.</td>\n</tr>\n<tr>\n<td>access_token</td>\n<td>string</td>\n<td>The alphanumeric string for accessing the API (only available on token creation).</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Time-stamp (UTC) of when the token was created.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>expires_at</td>\n<td>string</td>\n<td>Time-stamp (UTC) of when the token will expire (optional).</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>Alphanumeric string identifying a token.</td>\n</tr>\n<tr>\n<td>ip</td>\n<td>string</td>\n<td>IP Address of the client that last used the token.</td>\n</tr>\n<tr>\n<td>last_used_at</td>\n<td>string</td>\n<td>Time-stamp (UTC) of when the token was last used.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>user_agent</td>\n<td>string</td>\n<td>User-Agent header of the client that last used the token.</td>\n</tr>\n<tr>\n<td>user_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the user.</td>\n</tr>\n</tbody>\n</table>\n</div>","_postman_id":"713a437b-f358-451e-834a-1baa0f8d5a77"}],"id":"d7e647d5-37f2-4f52-a758-fc0aa66c7117","_postman_id":"d7e647d5-37f2-4f52-a758-fc0aa66c7117","description":""},{"name":"Dictionaries","item":[{"name":"Dictionary info","item":[{"name":"Get dictionary metadata","id":"ea5e1238-f316-475a-9576-41786ff27323","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/dictionary/{{dictionary_id}}/info","description":"<p>Retrieve metadata for a single dictionary by ID for a version and service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","dictionary","{{dictionary_id}}","info"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"8b3abaf4-d92d-4a9b-9510-e1ab6a0a716a","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/dictionary/3vjTN8v1O7nOAY7aNDGOL/info","description":"Retrieve metadata for a single dictionary by ID for a version and service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"item_count\":1,\"last_updated\":\"2020-06-04 19:23:11\",\"digest\":\"43ee763040973ca602549c94c5357a41c280afbb54e48d436af88f4e40d73081\"}"}],"_postman_id":"ea5e1238-f316-475a-9576-41786ff27323"}],"id":"10a1f3fb-3d49-4426-9fd6-83d11ac06f4d","description":"<p>Dictionary Info is a set of metadata describing properties of a dictionary which change as items are added and removed.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>digest</td>\n<td>string</td>\n<td>A hash of all the dictionary content.</td>\n</tr>\n<tr>\n<td>item_count</td>\n<td>integer</td>\n<td>The number of items currently in the dictionary.</td>\n</tr>\n<tr>\n<td>last_updated</td>\n<td>string</td>\n<td>Timestamp (UTC) when the dictionary was last updated or an item was added or removed.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"10a1f3fb-3d49-4426-9fd6-83d11ac06f4d"},{"name":"Dictionary item","item":[{"name":"List items in a dictionary","id":"9d8796b9-cf3f-425b-8889-a004d142ce5e","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/dictionary/{{dictionary_id}}/items?direction&page&per_page&sort","description":"<p>List of DictionaryItems given service and dictionary ID.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","dictionary","{{dictionary_id}}","items"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Direction in which to sort results.</p>\n","type":"text/plain"},"key":"direction"},{"description":{"content":"<p>Current page.</p>\n","type":"text/plain"},"key":"page"},{"description":{"content":"<p>Number of records per page.</p>\n","type":"text/plain"},"key":"per_page"},{"description":{"content":"<p>Field on which to sort.</p>\n","type":"text/plain"},"key":"sort"}],"variable":[]}},"response":[{"id":"c3b8bb78-eafe-4d04-81fa-39f1b8550248","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/dictionary/3vjTN8v1O7nOAY7aNDGOL/items?direction=ascend&page=1&per_page=20&sort=created?direction&page&per_page&sort","protocol":"https","host":["api","fastly","com"],"path":["service","SU1Z0isxPaozGVKXdv0eY","dictionary","3vjTN8v1O7nOAY7aNDGOL","items"],"query":[{"key":"direction","description":"Direction in which to sort results."},{"key":"page","description":"Current page."},{"key":"per_page","description":"Number of records per page."},{"key":"sort","description":"Field on which to sort."}]},"description":"List of DictionaryItems given service and dictionary ID.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"dictionary_id\":\"3vjTN8v1O7nOAY7aNDGOL\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"item_key\":\"test-key\",\"item_value\":\"test-value\",\"created_at\":\"2020-04-21T18:14:32.000Z\",\"deleted_at\":null,\"updated_at\":\"2020-04-21T18:14:32.000Z\"}]"}],"_postman_id":"9d8796b9-cf3f-425b-8889-a004d142ce5e"},{"name":"Update multiple entries in a dictionary","id":"403f32d3-deb9-4d4d-865d-820bc403fcc4","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"items\":[{\"op\":\"create\",\"item_key\":\"test-key\",\"item_value\":\"new-value\"},{\"op\":\"update\",\"item_key\":\"test-key-2\",\"item_value\":\"new-value-2\"},{\"op\":\"upsert\",\"item_key\":\"test-key-3\",\"item_value\":\"new-value-3\"},{\"op\":\"delete\",\"item_key\":\"test-key-4\"}]}"},"url":"https://api.fastly.com/service/{{service_id}}/dictionary/{{dictionary_id}}/items","description":"<p>Update multiple items in the same dictionary. For faster updates to your service, group your changes into large batches. The maximum batch size is 1000 items. Contact support to discuss raising this limit.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","dictionary","{{dictionary_id}}","items"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"4bf448c6-9e0a-430b-a981-987a33a15a7a","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"items\":[{\"op\":\"create\",\"item_key\":\"test-key\",\"item_value\":\"new-value\"},{\"op\":\"update\",\"item_key\":\"test-key-2\",\"item_value\":\"new-value-2\"},{\"op\":\"upsert\",\"item_key\":\"test-key-3\",\"item_value\":\"new-value-3\"},{\"op\":\"delete\",\"item_key\":\"test-key-4\"}]}"},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/dictionary/3vjTN8v1O7nOAY7aNDGOL/items","description":"Update multiple items in the same dictionary. For faster updates to your service, group your changes into large batches. The maximum batch size is 1000 items. Contact support to discuss raising this limit.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"403f32d3-deb9-4d4d-865d-820bc403fcc4"},{"name":"Get an item from a dictionary","id":"a46ad0fb-e611-4168-9c79-e12b140b6094","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/dictionary/{{dictionary_id}}/item/{{dictionary_item_key}}","description":"<p>Retrieve a single DictionaryItem given service, dictionary ID and item key.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","dictionary","{{dictionary_id}}","item","{{dictionary_item_key}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"a9d40c48-8ab4-4f75-bdad-af6e5bf683b6","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/dictionary/3vjTN8v1O7nOAY7aNDGOL/item/test-key","description":"Retrieve a single DictionaryItem given service, dictionary ID and item key.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"dictionary_id\":\"3vjTN8v1O7nOAY7aNDGOL\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"item_key\":\"test-key\",\"item_value\":\"test-value\",\"created_at\":\"2020-04-21T18:14:32.000Z\",\"deleted_at\":null,\"updated_at\":\"2020-04-21T18:14:32.000Z\"}"}],"_postman_id":"a46ad0fb-e611-4168-9c79-e12b140b6094"},{"name":"Insert or update an entry in a dictionary","id":"62aaaac7-ccb8-4fe1-8c4b-f919d15b0d51","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/dictionary/{{dictionary_id}}/item/{{dictionary_item_key}}","description":"<p>Upsert DictionaryItem given service, dictionary ID, item key, and item value.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","dictionary","{{dictionary_id}}","item","{{dictionary_item_key}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"62bc01ce-8d67-463d-8d61-e1b3e4d6d87e","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/dictionary/3vjTN8v1O7nOAY7aNDGOL/item/test-key","description":"Upsert DictionaryItem given service, dictionary ID, item key, and item value.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"dictionary_id\":\"3vjTN8v1O7nOAY7aNDGOL\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"item_key\":\"test-key\",\"item_value\":\"test-value\",\"created_at\":\"2020-04-21T18:14:32.000Z\",\"deleted_at\":null,\"updated_at\":\"2020-04-21T18:14:32.000Z\"}"}],"_postman_id":"62aaaac7-ccb8-4fe1-8c4b-f919d15b0d51"},{"name":"Delete an item from a dictionary","id":"2c639b14-83c1-4bd7-b2d5-d7759d103854","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/dictionary/{{dictionary_id}}/item/{{dictionary_item_key}}","description":"<p>Delete DictionaryItem given service, dictionary ID, and item key.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","dictionary","{{dictionary_id}}","item","{{dictionary_item_key}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"f3aa3a12-aa25-4d89-a1ea-671a569e7bfe","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/dictionary/3vjTN8v1O7nOAY7aNDGOL/item/test-key","description":"Delete DictionaryItem given service, dictionary ID, and item key.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"2c639b14-83c1-4bd7-b2d5-d7759d103854"},{"name":"Update an entry in a dictionary","id":"64fa5083-ec1f-48f9-81d2-aa9ad0f706c9","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/dictionary/{{dictionary_id}}/item/{{dictionary_item_key}}","description":"<p>Update DictionaryItem given service, dictionary ID, item key, and item value.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","dictionary","{{dictionary_id}}","item","{{dictionary_item_key}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"d7ff76af-8e35-4ba1-b8c7-97e21e565423","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/dictionary/3vjTN8v1O7nOAY7aNDGOL/item/test-key","description":"Update DictionaryItem given service, dictionary ID, item key, and item value.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"dictionary_id\":\"3vjTN8v1O7nOAY7aNDGOL\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"item_key\":\"test-key\",\"item_value\":\"test-value\",\"created_at\":\"2020-04-21T18:14:32.000Z\",\"deleted_at\":null,\"updated_at\":\"2020-04-21T18:14:32.000Z\"}"}],"_postman_id":"64fa5083-ec1f-48f9-81d2-aa9ad0f706c9"},{"name":"Create an entry in a dictionary","id":"e893d274-5f52-4306-bcea-1af5c269b043","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/dictionary/{{dictionary_id}}/item","description":"<p>Create DictionaryItem given service, dictionary ID, item key, and item value.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","dictionary","{{dictionary_id}}","item"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"c90c8b7e-8967-40d3-8e29-9741d0d008c1","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/dictionary/3vjTN8v1O7nOAY7aNDGOL/item","description":"Create DictionaryItem given service, dictionary ID, item key, and item value.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"dictionary_id\":\"3vjTN8v1O7nOAY7aNDGOL\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"item_key\":\"test-key\",\"item_value\":\"test-value\",\"created_at\":\"2020-04-21T18:14:32.000Z\",\"deleted_at\":null,\"updated_at\":\"2020-04-21T18:14:32.000Z\"}"}],"_postman_id":"e893d274-5f52-4306-bcea-1af5c269b043"}],"id":"d5268daf-ab02-40d4-aea3-e96399d1b0b4","description":"<p>A Dictionary Item is a single key-value pair that makes up an entry in a Dictionary. Dictionary Items can be added, removed and modified without activating a new version of the associated service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>item_key</td>\n<td>string</td>\n<td>Item key, maximum 256 characters.</td>\n</tr>\n<tr>\n<td>item_value</td>\n<td>string</td>\n<td>Item value, maximum 8000 characters.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>dictionary_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying a Dictionary.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"d5268daf-ab02-40d4-aea3-e96399d1b0b4"},{"name":"Dictionary","item":[{"name":"List dictionaries","id":"cbbc8a03-73cd-4b9a-936d-e64813d18ed4","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/dictionary","description":"<p>List all dictionaries for the version of the service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","dictionary"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"3d57c93a-686b-459d-bf46-c93af5204b6d","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/dictionary","description":"List all dictionaries for the version of the service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"created_at\":\"2020-04-29T22:16:23.000Z\",\"deleted_at\":null,\"id\":\"3vjTN8v1O7nOAY7aNDGOL\",\"name\":\"test_dictionary\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"updated_at\":\"2020-04-29T22:16:23.000Z\",\"version\":1,\"write_only\":false}]"}],"_postman_id":"cbbc8a03-73cd-4b9a-936d-e64813d18ed4"},{"name":"Create a dictionary","id":"3e71d308-d0c5-48e5-b1b1-1f4670104f6d","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/dictionary","description":"<p>Create named dictionary for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","dictionary"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"b84d41f1-0620-4e50-9100-fff4480e89f9","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/dictionary","description":"Create named dictionary for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"created_at\":\"2020-04-29T22:16:23.000Z\",\"deleted_at\":null,\"id\":\"3vjTN8v1O7nOAY7aNDGOL\",\"name\":\"test_dictionary\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"updated_at\":\"2020-04-29T22:16:23.000Z\",\"version\":1,\"write_only\":false}"}],"_postman_id":"3e71d308-d0c5-48e5-b1b1-1f4670104f6d"},{"name":"Get a dictionary","id":"85865056-07e3-4fa7-b3c4-f38d14c50404","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/dictionary/{{dictionary_name}}","description":"<p>Retrieve a single dictionary by name for the version and service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","dictionary","{{dictionary_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"85a7cdaf-cf0b-4500-8cb5-784801889831","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/dictionary/test_dictionary","description":"Retrieve a single dictionary by name for the version and service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"created_at\":\"2020-04-29T22:16:23.000Z\",\"deleted_at\":null,\"id\":\"3vjTN8v1O7nOAY7aNDGOL\",\"name\":\"test_dictionary\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"updated_at\":\"2020-04-29T22:16:23.000Z\",\"version\":1,\"write_only\":false}"}],"_postman_id":"85865056-07e3-4fa7-b3c4-f38d14c50404"},{"name":"Update a dictionary","id":"07b755de-5a72-4e7f-99d2-a87203fdbcfd","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/dictionary/{{dictionary_name}}","description":"<p>Update named dictionary for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","dictionary","{{dictionary_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"76713ef1-cae0-44be-a999-81acf13bda59","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/dictionary/test_dictionary","description":"Update named dictionary for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"created_at\":\"2020-04-29T22:16:23.000Z\",\"deleted_at\":null,\"id\":\"3vjTN8v1O7nOAY7aNDGOL\",\"name\":\"test_dictionary\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"updated_at\":\"2020-04-29T22:16:23.000Z\",\"version\":1,\"write_only\":false}"}],"_postman_id":"07b755de-5a72-4e7f-99d2-a87203fdbcfd"},{"name":"Delete a dictionary","id":"9b033c40-1dcb-438d-8b89-c7829417a882","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/dictionary/{{dictionary_name}}","description":"<p>Delete named dictionary for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","dictionary","{{dictionary_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"f42755a5-5484-4480-80e5-ac7062ba166f","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/dictionary/test_dictionary","description":"Delete named dictionary for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"9b033c40-1dcb-438d-8b89-c7829417a882"}],"id":"de28a70e-a965-4632-9e3a-1e30bcf67565","description":"<p>A Dictionary is a VCL data table that stores key-value pairs accessible to VCL during request processing. New, empty dictionaries can be attached to a draft version of a service, which must be activated for the dictionary to be included in VCL. Once installed, a dictionary's items may be updated via API calls without having to activate a new version of the associated service configuration. To remove a dictionary, delete it on a draft version of a service (one that is not locked and not active). Once removed, activate the draft service version without the dictionary.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>Name for the Dictionary (must start with an alphabetic character and can contain only alphanumeric characters, underscores, and whitespace).</td>\n</tr>\n<tr>\n<td>write_only</td>\n<td>boolean</td>\n<td>Determines if items in the dictionary are readable or not.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>Alphanumeric string identifying a Dictionary.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>integer</td>\n<td>Integer identifying a service version.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"de28a70e-a965-4632-9e3a-1e30bcf67565"}],"id":"6a51b4ad-e49a-479d-84c4-615ecb7502ed","_postman_id":"6a51b4ad-e49a-479d-84c4-615ecb7502ed","description":""},{"name":"Domain Management","item":[{"name":"Domain Research","item":[{"name":"Suggest domains","id":"db25abb0-5381-4a0e-85b1-82d11b9b0273","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/domain-management/v1/tools/suggest?defaults&keywords&location&query&vendor","description":"<p>The Suggest method performs a real-time query of the search term(s) against the known zone database,\nmaking recommendations, stemming, and applying Unicode folding, IDN normalization, registrar supported-zone\nrestrictions, and other refinements. Note: Suggest method responses do not include domain availability status.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["domain-management","v1","tools","suggest"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Comma-separated list of default zones to include in the search results response.</p>\n","type":"text/plain"},"key":"defaults"},{"description":{"content":"<p>Comma-separated list of keywords for seeding the results. For example, a new gTLD like kitchen,\nor a related keyword like vegan. Helpful for search result relevance (e.g. from a targeted ad click,\na user profile, etc.).</p>\n","type":"text/plain"},"key":"keywords"},{"description":{"content":"<p>Override IP location detection for country-code zones, with a two-character country code.\nE.g. to include Geo-relevant zones in the search results.</p>\n","type":"text/plain"},"key":"location"},{"description":{"content":"<p>Term(s) to search against.</p>\n","type":"text/plain"},"key":"query"},{"description":{"content":"<p>The domain name of a specific registrar or vendor, for filtering results by the zones supported by the vendor.</p>\n","type":"text/plain"},"key":"vendor"}],"variable":[]}},"response":[{"id":"3726b32a-e641-491b-b10a-ad6053a27353","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/domain-management/v1/tools/suggest?defaults=club&keywords=food%2Ckitchen&location=de&query=foo%2520bar&vendor=dnsimple.com?defaults&keywords&location&query&vendor","protocol":"https","host":["api","fastly","com"],"path":["domain-management","v1","tools","suggest"],"query":[{"key":"defaults","description":"Comma-separated list of default zones to include in the search results response."},{"key":"keywords","description":"Comma-separated list of keywords for seeding the results. For example, a new gTLD like kitchen,\nor a related keyword like vegan. Helpful for search result relevance (e.g. from a targeted ad click,\na user profile, etc.)."},{"key":"location","description":"Override IP location detection for country-code zones, with a two-character country code.\nE.g. to include Geo-relevant zones in the search results."},{"key":"query","description":"Term(s) to search against."},{"key":"vendor","description":"The domain name of a specific registrar or vendor, for filtering results by the zones supported by the vendor."}]},"description":"The Suggest method performs a real-time query of the search term(s) against the known zone database,\nmaking recommendations, stemming, and applying Unicode folding, IDN normalization, registrar supported-zone\nrestrictions, and other refinements. Note: Suggest method responses do not include domain availability status.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"results\":[{\"domain\":\"foo.club\",\"subdomain\":\"foo.\",\"zone\":\"club\"},{\"domain\":\"foo.bar\",\"subdomain\":\"foo.\",\"zone\":\"bar\"},{\"domain\":\"foobar.eat\",\"subdomain\":\"foobar.\",\"zone\":\"eat\"},{\"domain\":\"foobar.cafe\",\"subdomain\":\"foobar.\",\"zone\":\"cafe\"},{\"domain\":\"foobar.menu\",\"subdomain\":\"foobar.\",\"zone\":\"menu\"},{\"domain\":\"foo.beer\",\"subdomain\":\"foo.\",\"zone\":\"bee\"},{\"domain\":\"foobar.cooking\",\"subdomain\":\"foobar.\",\"zone\":\"cooking\"},{\"domain\":\"foobar.kitchen\",\"subdomain\":\"foobar.\",\"zone\":\"kitchen\"},{\"domain\":\"foobar.organic\",\"subdomain\":\"foobar.\",\"zone\":\"organic\"},{\"domain\":\"foobar.restaurant\",\"subdomain\":\"foobar.\",\"zone\":\"restaurant\"},{\"domain\":\"foo.pub\",\"subdomain\":\"foo.\",\"zone\":\"pub\"},{\"domain\":\"foo.eat\",\"subdomain\":\"foo.\",\"zone\":\"eat\"},{\"domain\":\"foo.cafe\",\"subdomain\":\"foo.\",\"zone\":\"cafe\"},{\"domain\":\"foo.organic\",\"subdomain\":\"foo.\",\"zone\":\"organic\"},{\"domain\":\"foo.restaurant\",\"subdomain\":\"foo.\",\"zone\":\"restaurant\"},{\"domain\":\"foo.menu\",\"subdomain\":\"foo.\",\"zone\":\"menu\"},{\"domain\":\"foo.cooking\",\"subdomain\":\"foo.\",\"zone\":\"cooking\"},{\"domain\":\"foo.kitchen\",\"subdomain\":\"foo.\",\"zone\":\"kitchen\"},{\"domain\":\"foobar.club\",\"subdomain\":\"foobar.\",\"zone\":\"club\"},{\"domain\":\"foob.ar\",\"subdomain\":\"foob.\",\"zone\":\"ar\"},{\"domain\":\"foobar.com\",\"subdomain\":\"foobar.\",\"zone\":\"com\"},{\"domain\":\"bar.foo\",\"subdomain\":\"bar.\",\"zone\":\"foo\"},{\"domain\":\"foobar.net\",\"subdomain\":\"foobar.\",\"zone\":\"net\"},{\"domain\":\"foobar.org\",\"subdomain\":\"foobar.\",\"zone\":\"org\"},{\"domain\":\"foobar.co\",\"subdomain\":\"foobar.\",\"zone\":\"co\"},{\"domain\":\"foobar.io\",\"subdomain\":\"foobar.\",\"zone\":\"io\"},{\"domain\":\"foobar.us\",\"subdomain\":\"foobar.\",\"zone\":\"us\"},{\"domain\":\"foobar.co.us\",\"subdomain\":\"foobar.\",\"zone\":\"co.us\"},{\"domain\":\"foobar.food\",\"subdomain\":\"foobar.\",\"zone\":\"food\"},{\"domain\":\"foo.food\",\"subdomain\":\"foo.\",\"zone\":\"food\"},{\"domain\":\"foo.ba\",\"subdomain\":\"foo.\",\"zone\":\"ba\",\"path\":\"/r\"},{\"domain\":\"foo\",\"zone\":\"foo\",\"path\":\"/bar\"},{\"domain\":\"fo\",\"zone\":\"fo\",\"path\":\"/obar\"}]}"}],"_postman_id":"db25abb0-5381-4a0e-85b1-82d11b9b0273"},{"name":"Domain status","id":"39dd7200-b281-4d96-8ec6-d6512379896d","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/domain-management/v1/tools/status?domain&scope","description":"<p>The Status method checks the availability status of a single domain name.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["domain-management","v1","tools","status"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Domain name you are checking.</p>\n","type":"text/plain"},"key":"domain"},{"description":{"content":"<p>Include scope=estimate to perform an Estimated status check. Otherwise, a Precise status check is performed by default.</p>\n","type":"text/plain"},"key":"scope"}],"variable":[]}},"response":[{"id":"d511ca37-f997-487c-b8c8-604ba826e1c3","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/domain-management/v1/tools/status?domain=acmecoffee.shop&scope=estimate?domain&scope","protocol":"https","host":["api","fastly","com"],"path":["domain-management","v1","tools","status"],"query":[{"key":"domain","description":"Domain name you are checking."},{"key":"scope","description":"Include scope=estimate to perform an Estimated status check. Otherwise, a Precise status check is performed by default."}]},"description":"The Status method checks the availability status of a single domain name.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"domain\":\"acmecoffee.shop\",\"zone\":\"shop\",\"status\":\"undelegated inactive\",\"tags\":\"generic\"}"}],"_postman_id":"39dd7200-b281-4d96-8ec6-d6512379896d"}],"id":"952ff5f9-b495-4d46-9125-375d24b03266","description":"<p>The Domain Research API lets you programmatically retrieve algorithmic domain search results, and check domains for detailed availability.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>currency</td>\n<td>string</td>\n<td>The currency for the aftermarket offer.</td>\n</tr>\n<tr>\n<td>price</td>\n<td>string</td>\n<td>The price for the domain from the aftermarket vendor.</td>\n</tr>\n<tr>\n<td>vendor</td>\n<td>string</td>\n<td>The aftermarket vendor.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-1\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>domain</td>\n<td>string</td>\n<td>The domain provided in the status request.</td>\n</tr>\n<tr>\n<td>scope</td>\n<td>string</td>\n<td>The scope provided in the status request.</td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>A space-delimited string of the varying statuses associated with the domain provided.</td>\n</tr>\n<tr>\n<td>tags</td>\n<td>string</td>\n<td>A space-delimited string of the varying tags associated with the domain provided.</td>\n</tr>\n<tr>\n<td>zone</td>\n<td>string</td>\n<td>The zone of the domain provided of the status request.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-2\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>domain</td>\n<td>string</td>\n<td>The suggested domain, consisting of a subdomain and zone.</td>\n</tr>\n<tr>\n<td>path</td>\n<td>string</td>\n<td>If present, the path is to be appended to the domain to complete the suggestion.</td>\n</tr>\n<tr>\n<td>subdomain</td>\n<td>string</td>\n<td>The subdomain of the suggested domain.</td>\n</tr>\n<tr>\n<td>zone</td>\n<td>string</td>\n<td>The zone of the suggested domain.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"952ff5f9-b495-4d46-9125-375d24b03266"},{"name":"Domains","item":[{"name":"List domains","id":"7da22afa-15fd-4747-89c1-a518b923a305","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/domain-management/v1/domains?activated&cursor&fqdn_match&fqdn&limit&service_id&sort&verified","description":"<p>List all domains.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["domain-management","v1","domains"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>(Optional) Filters results by activated domains.</p>\n","type":"text/plain"},"key":"activated"},{"description":{"content":"<p>Cursor value from the next_cursor field of a previous response, used to retrieve the next page. To request the first page, this should be empty.</p>\n","type":"text/plain"},"key":"cursor"},{"description":{"content":"<p>(Optional) Filter fully-qualified domain name (FQDN) specifically by match type. If used, requires filtering by FQDN.</p>\n","type":"text/plain"},"key":"fqdn_match"},{"description":{"content":"<p>(Optional) Filters results by the fully-qualified domain name. The type of match will be determined by the fqdn_match parameter.</p>\n","type":"text/plain"},"key":"fqdn"},{"description":{"content":"<p>Limit how many results are returned.</p>\n","type":"text/plain"},"key":"limit"},{"description":{"content":"<p>Filter results based on a service_id.</p>\n","type":"text/plain"},"key":"service_id"},{"description":{"content":"<p>The order in which to list the results.</p>\n","type":"text/plain"},"key":"sort"},{"description":{"content":"<p>(Optional) Filters results by verified domains.</p>\n","type":"text/plain"},"key":"verified"}],"variable":[]}},"response":[{"id":"8d3ae94f-a635-41b2-9818-7313d1fa4938","name":"200 A list of domains.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/domain-management/v1/domains?activated&cursor&fqdn_match&fqdn&limit&service_id&sort&verified","protocol":"https","host":["api","fastly","com"],"path":["domain-management","v1","domains"],"query":[{"key":"activated","description":"(Optional) Filters results by activated domains."},{"key":"cursor","description":"Cursor value from the next_cursor field of a previous response, used to retrieve the next page. To request the first page, this should be empty."},{"key":"fqdn_match","description":"(Optional) Filter fully-qualified domain name (FQDN) specifically by match type. If used, requires filtering by FQDN."},{"key":"fqdn","description":"(Optional) Filters results by the fully-qualified domain name. The type of match will be determined by the fqdn_match parameter."},{"key":"limit","description":"Limit how many results are returned."},{"key":"service_id","description":"Filter results based on a service_id."},{"key":"sort","description":"The order in which to list the results."},{"key":"verified","description":"(Optional) Filters results by verified domains."}]},"description":"List all domains.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 A list of domains.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"id\":\"DOMAIN_ID\",\"fqdn\":\"DOMAIN_NAME\",\"service_id\":\"SERVICE_ID\",\"description\":\"DESCRIPTION\",\"activated\":true,\"verified\":true,\"created_at\":\"2024-05-31T12:12:12.000Z\",\"updated_at\":\"2024-05-31T12:12:12.000Z\"}],\"meta\":{\"next_cursor\":\"CURSOR_VALUE\",\"limit\":20,\"sort\":\"fqdn\",\"total\":10}}"}],"_postman_id":"7da22afa-15fd-4747-89c1-a518b923a305"},{"name":"Create a domain","id":"0f9a60fb-a043-41f6-8bbd-f3847408cb7a","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"fqdn\":\"DOMAIN_NAME\",\"service_id\":\"SERVICE_ID\",\"description\":\"DESCRIPTION\"}"},"url":"https://api.fastly.com/domain-management/v1/domains","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/domain-management/domains/#create-dm-domain\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["domain-management","v1","domains"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"91881080-8cea-4bfd-bfa3-b768cf503dd4","name":"201 A domain.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"fqdn\":\"DOMAIN_NAME\",\"service_id\":\"SERVICE_ID\",\"description\":\"DESCRIPTION\"}"},"url":"https://api.fastly.com/domain-management/v1/domains","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/domain-management/domains/#create-dm-domain)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"201 A domain.","code":201,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"DOMAIN_ID\",\"fqdn\":\"DOMAIN_NAME\",\"service_id\":\"SERVICE_ID\",\"description\":\"DESCRIPTION\",\"activated\":true,\"verified\":true,\"created_at\":\"2024-05-31T12:12:12.000Z\",\"updated_at\":\"2024-05-31T12:12:12.000Z\"}"}],"_postman_id":"0f9a60fb-a043-41f6-8bbd-f3847408cb7a"},{"name":"Get a domain","id":"62a2e234-343a-4729-b6ba-815bb16f6d92","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/domain-management/v1/domains/{{domain_id}}","description":"<p>Show a domain.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["domain-management","v1","domains","{{domain_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"2248114c-4f47-4492-bb04-5d61789ec526","name":"200 A domain.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/domain-management/v1/domains/{{domain_id}}","description":"Show a domain.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 A domain.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"DOMAIN_ID\",\"fqdn\":\"DOMAIN_NAME\",\"service_id\":\"SERVICE_ID\",\"description\":\"DESCRIPTION\",\"activated\":true,\"verified\":true,\"created_at\":\"2024-05-31T12:12:12.000Z\",\"updated_at\":\"2024-05-31T12:12:12.000Z\"}"}],"_postman_id":"62a2e234-343a-4729-b6ba-815bb16f6d92"},{"name":"Delete a domain","id":"73626348-76ed-4d83-ae3d-c9bc61b7b584","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/domain-management/v1/domains/{{domain_id}}","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/domain-management/domains/#delete-dm-domain\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["domain-management","v1","domains","{{domain_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"f4a3c93b-f0ea-4651-8272-aaec9fa2f1ce","name":"204 No content","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/domain-management/v1/domains/{{domain_id}}","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/domain-management/domains/#delete-dm-domain)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 No content","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"73626348-76ed-4d83-ae3d-c9bc61b7b584"},{"name":"Update a domain","id":"6297ce59-421f-48d3-8448-bde00848533e","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"service_id\":\"SERVICE_ID\",\"description\":\"DESCRIPTION\"}"},"url":"https://api.fastly.com/domain-management/v1/domains/{{domain_id}}","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/domain-management/domains/#update-dm-domain\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["domain-management","v1","domains","{{domain_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"e94c8103-e7dd-4acd-b7f8-25934a9741e0","name":"200 A domain.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"service_id\":\"SERVICE_ID\",\"description\":\"DESCRIPTION\"}"},"url":"https://api.fastly.com/domain-management/v1/domains/{{domain_id}}","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/domain-management/domains/#update-dm-domain)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 A domain.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"DOMAIN_ID\",\"fqdn\":\"DOMAIN_NAME\",\"service_id\":\"SERVICE_ID\",\"description\":\"DESCRIPTION\",\"activated\":true,\"verified\":true,\"created_at\":\"2024-05-31T12:12:12.000Z\",\"updated_at\":\"2024-05-31T12:12:12.000Z\"}"}],"_postman_id":"6297ce59-421f-48d3-8448-bde00848533e"}],"id":"96e9c687-0675-4e13-899f-004bf3a9fa72","description":"<p>The Domains API allows you to manage your domains on Fastly and the services that they interact with.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>description</td>\n<td>string</td>\n<td>A freeform descriptive note.</td>\n</tr>\n<tr>\n<td>fqdn</td>\n<td>string</td>\n<td>The fully-qualified domain name for your domain. Can be created, but not updated.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>The service_id associated with your domain or null if there is no association.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-1\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>description</td>\n<td>string</td>\n<td>A freeform descriptive note.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>The service_id associated with your domain or null if there is no association.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-2\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>activated</td>\n<td>boolean</td>\n<td>Denotes if the domain has at least one TLS activation or not.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>description</td>\n<td>string</td>\n<td>A freeform descriptive note.</td>\n</tr>\n<tr>\n<td>fqdn</td>\n<td>string</td>\n<td>The fully-qualified domain name for your domain. Can be created, but not updated.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>Domain Identifier (UUID).</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>The service_id associated with your domain or null if there is no association.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>verified</td>\n<td>boolean</td>\n<td>Denotes that the customer has proven ownership over the domain by obtaining a Fastly-managed</td>\n</tr>\n<tr>\n<td>TLS certificate for it or by providing a their own TLS certificate from a publicly-trusted CA</td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td>that includes the domain or matching wildcard.</td>\n<td></td>\n<td></td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"96e9c687-0675-4e13-899f-004bf3a9fa72"}],"id":"fbe25f84-2ac6-422f-8c06-5011ecb11827","_postman_id":"fbe25f84-2ac6-422f-8c06-5011ecb11827","description":""},{"name":"Subscriber Provided Prefix (SPP)","item":[{"name":"DNS Configuration","item":[{"name":"List DNS configurations","id":"274affbf-20c3-467c-bc8f-20332ca37dc6","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":"https://api.fastly.com/dns/configurations","description":"<p>List all DNS configurations.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["dns","configurations"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"aecfff1e-b8f2-4831-b4ee-322a34e32e72","name":"200 List of DNS configurations.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":"https://api.fastly.com/dns/configurations","description":"List all DNS configurations.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 List of DNS configurations.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"id\":\"DNS_CONFIGURATION_ID\",\"type\":\"dns_configuration\",\"attributes\":{\"dualstack\":true,\"name\":\"example_customer.customer.fastly.net\",\"region\":\"global\"},\"relationships\":{\"tls_configuration\":{\"data\":{\"id\":\"TLS_CONFIGURATION_ID\",\"type\":\"tls_configuration\"}}}}]}"}],"_postman_id":"274affbf-20c3-467c-bc8f-20332ca37dc6"},{"name":"Create a DNS configuration","id":"2354985c-2844-42a1-a855-de76f0eb59df","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"data\":{\"type\":\"dns_configuration\",\"attributes\":{\"dualstack\":true,\"name\":\"example_customer.customer.fastly.net\"},\"relationships\":{\"tls_configuration\":{\"data\":{\"id\":\"TLS_CONFIGURATION_ID\",\"type\":\"tls_configuration\"}}}}}"},"url":"https://api.fastly.com/dns/configurations","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/ip-configuration/spp/dns-configuration/#create-spp-dns-config\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["dns","configurations"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"773ddf19-464d-491a-bf4c-bb85bd10549e","name":"201 A DNS configuration.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"data\":{\"type\":\"dns_configuration\",\"attributes\":{\"dualstack\":true,\"name\":\"example_customer.customer.fastly.net\"},\"relationships\":{\"tls_configuration\":{\"data\":{\"id\":\"TLS_CONFIGURATION_ID\",\"type\":\"tls_configuration\"}}}}}"},"url":"https://api.fastly.com/dns/configurations","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/ip-configuration/spp/dns-configuration/#create-spp-dns-config)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"201 A DNS configuration.","code":201,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":{\"id\":\"DNS_CONFIGURATION_ID\",\"type\":\"dns_configuration\",\"attributes\":{\"dualstack\":true,\"name\":\"example_customer.customer.fastly.net\",\"region\":\"global\"},\"relationships\":{\"tls_configuration\":{\"data\":{\"id\":\"TLS_CONFIGURATION_ID\",\"type\":\"tls_configuration\"}}}}}"}],"_postman_id":"2354985c-2844-42a1-a855-de76f0eb59df"},{"name":"Get a DNS configuration","id":"f18385ef-7378-48f4-8fc2-5bd5a1293f79","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":"https://api.fastly.com/dns/configurations/{{dns_configuration_id}}","description":"<p>Show a specific DNS configuration.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["dns","configurations","{{dns_configuration_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"c0c7d665-7d26-4d4d-a69f-30a4ef6eff9c","name":"200 A DNS configuration.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":"https://api.fastly.com/dns/configurations/{{dns_configuration_id}}","description":"Show a specific DNS configuration.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 A DNS configuration.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":{\"id\":\"DNS_CONFIGURATION_ID\",\"type\":\"dns_configuration\",\"attributes\":{\"dualstack\":true,\"name\":\"example_customer.customer.fastly.net\",\"region\":\"global\"},\"relationships\":{\"tls_configuration\":{\"data\":{\"id\":\"TLS_CONFIGURATION_ID\",\"type\":\"tls_configuration\"}}}}}"}],"_postman_id":"f18385ef-7378-48f4-8fc2-5bd5a1293f79"},{"name":"Delete a DNS configuration","id":"5fd888c4-72e6-4726-ac04-473db5f21472","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/dns/configurations/{{dns_configuration_id}}","description":"<p>Remove a DNS configuration.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["dns","configurations","{{dns_configuration_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"d7974f06-1123-4ce5-9b75-2428137030b7","name":"204 No Content","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/dns/configurations/{{dns_configuration_id}}","description":"Remove a DNS configuration.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 No Content","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"5fd888c4-72e6-4726-ac04-473db5f21472"},{"name":"Update a DNS configuration","id":"6bd9d7a3-8b02-414c-956d-dea55d9c8786","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"data\":{\"id\":\"DNS_CONFIGURATION_ID\",\"type\":\"dns_configuration\",\"attributes\":{\"dualstack\":true}}}"},"url":"https://api.fastly.com/dns/configurations/{{dns_configuration_id}}","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/ip-configuration/spp/dns-configuration/#update-spp-dns-config\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["dns","configurations","{{dns_configuration_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"ffa934bd-7926-4b40-ad07-2312b3c54efa","name":"200 A DNS configuration.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"data\":{\"id\":\"DNS_CONFIGURATION_ID\",\"type\":\"dns_configuration\",\"attributes\":{\"dualstack\":true}}}"},"url":"https://api.fastly.com/dns/configurations/{{dns_configuration_id}}","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/ip-configuration/spp/dns-configuration/#update-spp-dns-config)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 A DNS configuration.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":{\"id\":\"DNS_CONFIGURATION_ID\",\"type\":\"dns_configuration\",\"attributes\":{\"dualstack\":true,\"name\":\"example_customer.customer.fastly.net\",\"region\":\"global\"},\"relationships\":{\"tls_configuration\":{\"data\":{\"id\":\"TLS_CONFIGURATION_ID\",\"type\":\"tls_configuration\"}}}}}"}],"_postman_id":"6bd9d7a3-8b02-414c-956d-dea55d9c8786"}],"id":"5535351b-ea54-4c94-93dc-945861f95df2","description":"<p>Customers with access to multiple sets of IP pools are able to manage DNS records associated with the IP pools.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The CNAME record for your DNS Configuration. It must be a valid FQDN that starts with a custom label and ends with.customer.fastly.com (e.g., example.customer.fastly.net). Supported characters for the custom label include a-z, 0-9, hyphens, and underscores.</td>\n</tr>\n<tr>\n<td>dualstack</td>\n<td>boolean</td>\n<td>True shows this DNS configuration is using both IPv4 (default) and IPv6 (optional). False shows it is using IPv4 only. When not provided, we will default to false.</td>\n</tr>\n<tr>\n<td>region</td>\n<td>string</td>\n<td>The region string will be “global” for all configurations involving the customer’s SPP vipspace.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-1\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>dualstack</td>\n<td>boolean</td>\n<td>True shows this DNS configuration is using both IPv4 (default) and IPv6 (optional). False shows it is using IPv4 only. When not provided, we will default to false.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The CNAME record for your DNS Configuration. It must be a valid FQDN that starts with a custom label and ends with.customer.fastly.com (e.g., example.customer.fastly.net). Supported characters for the custom label include a-z, 0-9, hyphens, and underscores.</td>\n</tr>\n<tr>\n<td>relationships.tls_configuration.id</td>\n<td>string</td>\n<td>Alphanumeric string identifying a TLS configuration.</td>\n</tr>\n<tr>\n<td>type</td>\n<td>string</td>\n<td>Resource type.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-2\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>dualstack</td>\n<td>boolean</td>\n<td>True shows this DNS configuration is using both IPv4 (default) and IPv6 (optional). False shows it is using IPv4 only. When not provided, we will default to false.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>Alphanumeric string identifying a DNS configuration.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The CNAME record for your DNS Configuration. It must be a valid FQDN that starts with a custom label and ends with.customer.fastly.com (e.g., example.customer.fastly.net). Supported characters for the custom label include a-z, 0-9, hyphens, and underscores.</td>\n</tr>\n<tr>\n<td>region</td>\n<td>string</td>\n<td>The region string will be “global” for all configurations involving the customer’s SPP vipspace.</td>\n</tr>\n<tr>\n<td>relationships.tls_configuration.id</td>\n<td>string</td>\n<td>Alphanumeric string identifying a TLS configuration.</td>\n</tr>\n<tr>\n<td>type</td>\n<td>string</td>\n<td>Resource type.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-3\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>dualstack</td>\n<td>boolean</td>\n<td>True shows this DNS configuration is using both IPv4 (default) and IPv6 (optional). False shows it is using IPv4 only. When not provided, we will default to false.</td>\n</tr>\n<tr>\n<td>type</td>\n<td>string</td>\n<td>Resource type.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"5535351b-ea54-4c94-93dc-945861f95df2"},{"name":"TLS Configuration","item":[{"name":"List TLS configurations","id":"a3f0b95c-be36-4afe-b580-6c5a8ed980df","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":"https://api.fastly.com/tls/configurations?filter[bulk]&include&page[number]&page[size]","description":"<p>List all TLS configurations.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["tls","configurations"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Optionally filters by the bulk attribute.</p>\n","type":"text/plain"},"key":"filter[bulk]"},{"description":{"content":"<p>Include related objects. Optional, comma-separated values. Permitted values: dns_records.</p>\n","type":"text/plain"},"key":"include"},{"description":{"content":"<p>Current page.</p>\n","type":"text/plain"},"key":"page[number]"},{"description":{"content":"<p>Number of records per page.</p>\n","type":"text/plain"},"key":"page[size]"}],"variable":[]}},"response":[{"id":"b419926c-8b40-4ab1-9565-0bf15f42c788","name":"200 List of TLS configurations.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":{"raw":"https://api.fastly.com/tls/configurations?include=dns_records&page%5Bnumber%5D=1&page%5Bsize%5D=20?filter[bulk]&include&page[number]&page[size]","protocol":"https","host":["api","fastly","com"],"path":["tls","configurations"],"query":[{"key":"filter[bulk]","description":"Optionally filters by the bulk attribute."},{"key":"include","description":"Include related objects. Optional, comma-separated values. Permitted values: dns_records."},{"key":"page[number]","description":"Current page."},{"key":"page[size]","description":"Number of records per page."}]},"description":"List all TLS configurations.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 List of TLS configurations.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"id\":\"t7CguUGZzb2W9Euo5FoKa\",\"type\":\"tls_configuration\",\"attributes\":{\"bulk\":false,\"created_at\":\"2020-02-01T12:12:12.000Z\",\"default\":true,\"http_protocols\":[\"http/1.1\",\"http/2\"],\"name\":\"TLS Configuration A\",\"tls_1_2_cipher_suite_profile\":[\"ECDHE-RSA-AES256-GCM-SHA384\",\"...\"],\"tls_1_3_cipher_suite_profile\":[\"TLS_AES_256_GCM_SHA384\",\"...\"],\"tls_protocols\":[\"1.1\",\"1.2\"],\"updated_at\":\"2020-02-01T12:12:12.000Z\",\"vipspace\":\"customer_assigned_vipspace\"},\"relationships\":{\"dns_records\":{\"data\":[{\"id\":\"23.154.64.3\",\"type\":\"dns_record\"},{\"id\":\"spp-test.customer.fastly.net\",\"type\":\"dns_record\"},{\"id\":\"2620:11a:c004::3\",\"type\":\"dns_record\"}]},\"service\":{\"data\":{\"id\":\"VKXdv0eYSU1Z0isxPaozG\",\"type\":\"service\"}},\"default_certificate\":{\"data\":{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"type\":\"tls_certificate\"}},\"default_ecdsa_certificate\":{\"data\":{\"id\":\"5YwbK89STDIW0UYejRRUmG\",\"type\":\"tls_certificate\"}}}}],\"included\":[{\"id\":\"23.154.64.3\",\"type\":\"dns_record\",\"attributes\":{\"record_type\":\"A\",\"region\":\"global\"}},{\"id\":\"spp-test.customer.fastly.net\",\"type\":\"dns_record\",\"attributes\":{\"record_type\":\"CNAME\",\"region\":\"global\"}},{\"id\":\"2620:11a:c004::3\",\"type\":\"dns_record\",\"attributes\":{\"record_type\":\"AAAA\",\"region\":\"global\"}}],\"links\":{\"self\":\"https://api.fastly.com/tls/configurations?include=dns_records&page%5Bnumber%5D=1&page%5Bsize%5D=100\",\"first\":\"https://api.fastly.com/tls/configurations?include=dns_records&page%5Bnumber%5D=1&page%5Bsize%5D=100\",\"prev\":null,\"next\":null,\"last\":\"https://api.fastly.com/tls/configurations?include=dns_records&page%5Bnumber%5D=1&page%5Bsize%5D=100\"},\"meta\":{\"per_page\":100,\"current_page\":1,\"record_count\":1,\"total_pages\":1}}"}],"_postman_id":"a3f0b95c-be36-4afe-b580-6c5a8ed980df"},{"name":"Create a TLS configuration","id":"622452b4-74bc-48d9-96c0-fb6424efa5a8","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"data\":{\"type\":\"tls_configuration\",\"attributes\":{\"http_protocols\":[\"http/1.1\",\"http/2\"],\"name\":\"New TLS Configuration\",\"tls_protocols\":[\"1.2\",\"1.3\"],\"tls_1_2_cipher_suite_profile\":[\"ECDHE-RSA-AES256-GCM-SHA384\",\"...\"],\"vipspace\":\"customer_assigned_vipspace\"},\"relationships\":{\"dns_records\":{\"data\":[{\"id\":\"IPV4_ADDRESS\",\"type\":\"dns_record\"}]},\"default_certificate\":{\"data\":{\"id\":\"DEFAULT_CERTIFICATE_ID\",\"type\":\"tls_certificate\"}},\"default_ecdsa_certificate\":{\"data\":{\"id\":\"DEFAULT_ECDSA_CERTIFICATE_ID\",\"type\":\"tls_certificate\"}},\"service\":{\"data\":{\"id\":\"SERVICE_ID\",\"type\":\"service\"}}}}}"},"url":"https://api.fastly.com/tls/configurations","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/ip-configuration/spp/tls-configuration/#create-spp-tls-config\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["tls","configurations"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"0394d419-3bf3-4e74-9064-9023dfd325d3","name":"201 A TLS configuration.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"data\":{\"type\":\"tls_configuration\",\"attributes\":{\"http_protocols\":[\"http/1.1\",\"http/2\"],\"name\":\"New TLS Configuration\",\"tls_protocols\":[\"1.2\",\"1.3\"],\"tls_1_2_cipher_suite_profile\":[\"ECDHE-RSA-AES256-GCM-SHA384\",\"...\"],\"vipspace\":\"customer_assigned_vipspace\"},\"relationships\":{\"dns_records\":{\"data\":[{\"id\":\"IPV4_ADDRESS\",\"type\":\"dns_record\"}]},\"default_certificate\":{\"data\":{\"id\":\"DEFAULT_CERTIFICATE_ID\",\"type\":\"tls_certificate\"}},\"default_ecdsa_certificate\":{\"data\":{\"id\":\"DEFAULT_ECDSA_CERTIFICATE_ID\",\"type\":\"tls_certificate\"}},\"service\":{\"data\":{\"id\":\"SERVICE_ID\",\"type\":\"service\"}}}}}"},"url":"https://api.fastly.com/tls/configurations","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/ip-configuration/spp/tls-configuration/#create-spp-tls-config)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"201 A TLS configuration.","code":201,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":{\"id\":\"t7CguUGZzb2W9Euo5FoKa\",\"type\":\"tls_configuration\",\"attributes\":{\"bulk\":false,\"created_at\":\"2020-02-01T12:12:12.000Z\",\"default\":true,\"http_protocols\":[\"http/1.1\",\"http/2\"],\"name\":\"TLS Configuration A\",\"tls_protocols\":[\"1.1\",\"1.2\"],\"updated_at\":\"2020-02-01T12:12:12.000Z\",\"vipspace\":\"customer_assigned_vipspace\"},\"relationships\":{\"default_certificate\":{\"data\":{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"type\":\"tls_certificate\"}},\"default_ecdsa_certificate\":{\"data\":{\"id\":\"5YwbK89STDIW0UYejRRUmG\",\"type\":\"tls_certificate\"}},\"service\":{\"data\":{\"id\":\"SERVICE_ID\",\"type\":\"service\"}}}}}"}],"_postman_id":"622452b4-74bc-48d9-96c0-fb6424efa5a8"},{"name":"Get a TLS configuration","id":"dea87ef0-1443-48cd-b27d-453885064211","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":"https://api.fastly.com/tls/configurations/{{tls_configuration_id}}?include","description":"<p>Show a specific TLS configuration.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["tls","configurations","{{tls_configuration_id}}"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Include related objects. Optional, comma-separated values. Permitted values: dns_records.</p>\n","type":"text/plain"},"key":"include"}],"variable":[]}},"response":[{"id":"be951d3b-4177-4de2-bd0b-aed9150cdf93","name":"200 A TLS configuration.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":{"raw":"https://api.fastly.com/tls/configurations/{{tls_configuration_id}}?include=dns_records?include","protocol":"https","host":["api","fastly","com"],"path":["tls","configurations","{{tls_configuration_id}}"],"query":[{"key":"include","description":"Include related objects. Optional, comma-separated values. Permitted values: dns_records."}]},"description":"Show a specific TLS configuration.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 A TLS configuration.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":{\"id\":\"t7CguUGZzb2W9Euo5FoKa\",\"type\":\"tls_configuration\",\"attributes\":{\"bulk\":false,\"created_at\":\"2020-02-01T12:12:12.000Z\",\"default\":true,\"http_protocols\":[\"http/1.1\",\"http/2\"],\"name\":\"TLS Configuration A\",\"tls_1_2_cipher_suite_profile\":[\"ECDHE-RSA-AES256-GCM-SHA384\",\"...\"],\"tls_1_3_cipher_suite_profile\":[\"TLS_AES_256_GCM_SHA384\",\"...\"],\"tls_protocols\":[\"1.1\",\"1.2\"],\"updated_at\":\"2020-02-01T12:12:12.000Z\",\"vipspace\":\"customer_assigned_vipspace\"},\"relationships\":{\"dns_records\":{\"data\":[{\"id\":\"23.154.64.3\",\"type\":\"dns_record\"},{\"id\":\"spp-test.customer.fastly.net\",\"type\":\"dns_record\"},{\"id\":\"2620:11a:c004::3\",\"type\":\"dns_record\"}]},\"service\":{\"data\":{\"id\":\"VKXdv0eYSU1Z0isxPaozG\",\"type\":\"service\"}},\"default_certificate\":{\"data\":{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"type\":\"tls_certificate\"}},\"default_ecdsa_certificate\":{\"data\":{\"id\":\"5YwbK89STDIW0UYejRRUmG\",\"type\":\"tls_certificate\"}}}},\"included\":[{\"id\":\"23.154.64.3\",\"type\":\"dns_record\",\"attributes\":{\"record_type\":\"A\",\"region\":\"global\"}},{\"id\":\"spp-test.customer.fastly.net\",\"type\":\"dns_record\",\"attributes\":{\"record_type\":\"CNAME\",\"region\":\"global\"}},{\"id\":\"2620:11a:c004::3\",\"type\":\"dns_record\",\"attributes\":{\"record_type\":\"AAAA\",\"region\":\"global\"}}]}"}],"_postman_id":"dea87ef0-1443-48cd-b27d-453885064211"},{"name":"Delete a TLS configuration","id":"b1b5fbf6-617a-4391-8c1f-d0e8b72fa6fc","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/tls/configurations/{{tls_configuration_id}}","description":"<p>Remove a TLS configuration.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["tls","configurations","{{tls_configuration_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"a4ddb326-f04d-4b93-91a2-69a621a10398","name":"204 No Content","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/tls/configurations/{{tls_configuration_id}}","description":"Remove a TLS configuration.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 No Content","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"b1b5fbf6-617a-4391-8c1f-d0e8b72fa6fc"},{"name":"Update a TLS configuration","id":"57e06aae-5c1d-425e-8f25-d5aad76d4bda","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"data\":{\"id\":\"t7CguUGZzb2W9Euo5FoKa\",\"type\":\"tls_configuration\",\"attributes\":{\"http_protocols\":[\"http/1.1\",\"http/2\"],\"name\":\"New TLS Configuration\",\"tls_protocols\":[\"1.2\",\"1.3\"],\"tls_1_2_cipher_suite_profile\":[\"ECDHE-RSA-AES256-GCM-SHA384\",\"...\"]},\"relationships\":{\"default_certificate\":{\"data\":{\"id\":\"DEFAULT_CERTIFICATE_ID\",\"type\":\"tls_certificate\"}},\"default_ecdsa_certificate\":{\"data\":{\"id\":\"DEFAULT_ECDSA_CERTIFICATE_ID\",\"type\":\"tls_certificate\"}},\"service\":{\"data\":{\"id\":\"SERVICE_ID\",\"type\":\"service\"}}}}}"},"url":"https://api.fastly.com/tls/configurations/{{tls_configuration_id}}","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/ip-configuration/spp/tls-configuration/#update-spp-tls-config\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["tls","configurations","{{tls_configuration_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"097f5fb2-557b-4620-bdcd-b140c56e605a","name":"200 A TLS configuration.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"data\":{\"id\":\"t7CguUGZzb2W9Euo5FoKa\",\"type\":\"tls_configuration\",\"attributes\":{\"http_protocols\":[\"http/1.1\",\"http/2\"],\"name\":\"New TLS Configuration\",\"tls_protocols\":[\"1.2\",\"1.3\"],\"tls_1_2_cipher_suite_profile\":[\"ECDHE-RSA-AES256-GCM-SHA384\",\"...\"]},\"relationships\":{\"default_certificate\":{\"data\":{\"id\":\"DEFAULT_CERTIFICATE_ID\",\"type\":\"tls_certificate\"}},\"default_ecdsa_certificate\":{\"data\":{\"id\":\"DEFAULT_ECDSA_CERTIFICATE_ID\",\"type\":\"tls_certificate\"}},\"service\":{\"data\":{\"id\":\"SERVICE_ID\",\"type\":\"service\"}}}}}"},"url":"https://api.fastly.com/tls/configurations/{{tls_configuration_id}}","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/ip-configuration/spp/tls-configuration/#update-spp-tls-config)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 A TLS configuration.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":{\"id\":\"t7CguUGZzb2W9Euo5FoKa\",\"type\":\"tls_configuration\",\"attributes\":{\"bulk\":false,\"created_at\":\"2020-02-01T12:12:12.000Z\",\"default\":true,\"http_protocols\":[\"http/1.1\",\"http/2\"],\"name\":\"TLS Configuration A\",\"tls_protocols\":[\"1.1\",\"1.2\"],\"updated_at\":\"2020-02-01T12:12:12.000Z\",\"vipspace\":\"customer_assigned_vipspace\"},\"relationships\":{\"default_certificate\":{\"data\":{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"type\":\"tls_certificate\"}},\"default_ecdsa_certificate\":{\"data\":{\"id\":\"5YwbK89STDIW0UYejRRUmG\",\"type\":\"tls_certificate\"}},\"service\":{\"data\":{\"id\":\"SERVICE_ID\",\"type\":\"service\"}}}}}"}],"_postman_id":"57e06aae-5c1d-425e-8f25-d5aad76d4bda"}],"id":"13d2ba98-5023-4d87-8d93-273cd1a06ca3","description":"<p>Customers with access to multiple sets of IP pools can apply different configuration options to their TLS-enabled domains.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>http_protocols</td>\n<td>array</td>\n<td>HTTP protocols available on your configuration. At least one protocol is required:</td>\n</tr>\n</tbody>\n</table>\n</div><p>http/1.1 is always supported and is required in the array.\nhttp/2 is optionally supported in the array.\nhttp/3 is optionally supported in the array. |\n| name | string | A custom name for your TLS configuration. Optional, we will assign a value to this if none is provided. |\n| tls_1_2_cipher_suite_profile | array | An ordered collection of OpenSSL-formatted cipher suite names used for TLS-1.0, TLS-1.1 and TLS-1.2 protocol versions.\nNote: Setting this field is an advanced feature that requires enablement by Fastly Support. |\n| tls_protocols | array | TLS protocols available on your configuration. The following TLS protocols are supported:</p>\n<p>[“1.0”, “1.1”, “1.2”] \n[“1.0”, “1.1”, “1.2”, “1.3”] \n[“1.0”, “1.1”, “1.2”, “1.3+0RTT”] \n[“1.2”]\n[“1.2”, “1.3”]\n[“1.2”, “1.3+0RTT”]. |\n| vipspace | string | A Fastly assigned name representing a set of network prefixes that are available for operations like acquiring TLS configurations.\nThis field is Required, and must be customer_assigned_vipspace. |</p>\n<h2 id=\"data-model-1\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>http_protocols</td>\n<td>array</td>\n<td>HTTP protocols available on your configuration. At least one protocol is required:</td>\n</tr>\n</tbody>\n</table>\n</div><p>http/1.1 is always supported and is required in the array.\nhttp/2 is optionally supported in the array.\nhttp/3 is optionally supported in the array. |\n| name | string | A custom name for your TLS configuration. Optional, we will assign a value to this if none is provided. |\n| relationships.default_certificate.id | string | Alphanumeric string identifying the default TLS certificate. |\n| relationships.default_ecdsa_certificate.id | string | Alphanumeric string identifying the default ECDSA TLS certificate. |\n| relationships.dns_records.id | string | The IPv4 address that will be used for your TLS configuration. Note: Setting this field is an advanced feature that requires enablement by Fastly Support. |\n| relationships.service.id | string | Alphanumeric string identifying the service. |\n| tls_1_2_cipher_suite_profile | array | An ordered collection of OpenSSL-formatted cipher suite names used for TLS-1.0, TLS-1.1 and TLS-1.2 protocol versions.\nNote: Setting this field is an advanced feature that requires enablement by Fastly Support. |\n| tls_protocols | array | TLS protocols available on your configuration. The following TLS protocols are supported:</p>\n<p>[“1.0”, “1.1”, “1.2”] \n[“1.0”, “1.1”, “1.2”, “1.3”] \n[“1.0”, “1.1”, “1.2”, “1.3+0RTT”] \n[“1.2”]\n[“1.2”, “1.3”]\n[“1.2”, “1.3+0RTT”]. |\n| type | string | Resource type. |\n| vipspace | string | A Fastly assigned name representing a set of network prefixes that are available for operations like acquiring TLS configurations.\nThis field is Required, and must be customer_assigned_vipspace. |</p>\n<h2 id=\"data-model-2\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>bulk</td>\n<td>boolean</td>\n<td>Signifies whether the configuration is used for Platform TLS or not. We will always assume for this product</td>\n</tr>\n<tr>\n<td>that the value for this is “false”, signifying you have full access to the main set of APIs for custom</td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td>TLS certificates and</td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td>TLS subscriptions, as well as the</td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td>TLS management UI.</td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>default</td>\n<td>boolean</td>\n<td>Signifies whether or not Fastly will use this configuration as a default when creating a new</td>\n</tr>\n<tr>\n<td>TLS activation.</td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td>http_protocols</td>\n<td>array</td>\n<td>HTTP protocols available on your configuration. At least one protocol is required:</td>\n</tr>\n</tbody>\n</table>\n</div><p>http/1.1 is always supported and is required in the array.\nhttp/2 is optionally supported in the array.\nhttp/3 is optionally supported in the array. |\n| id | string | Alphanumeric string identifying a TLS configuration. |\n| name | string | A custom name for your TLS configuration. Optional, we will assign a value to this if none is provided. |\n| relationships.default_certificate.id | string | Alphanumeric string identifying the default TLS certificate. |\n| relationships.default_ecdsa_certificate.id | string | Alphanumeric string identifying the default ECDSA TLS certificate. |\n| relationships.dns_records.id | string | The IP address or hostname of the DNS record. |\n| relationships.service.id | string | Alphanumeric string identifying the service. |\n| tls_1_2_cipher_suite_profile | array | An ordered collection of OpenSSL-formatted cipher suite names used for TLS-1.0, TLS-1.1 and TLS-1.2 protocol versions.\nNote: Setting this field is an advanced feature that requires enablement by Fastly Support. |\n| tls_1_3_cipher_suite_profile | array | An ordered collection of OpenSSL-formatted cipher suite names used for TLS-1.3. \nIf TLS-1.3 is selected, you will get the default list. |\n| tls_protocols | array | TLS protocols available on your configuration. The following TLS protocols are supported:</p>\n<p>[“1.0”, “1.1”, “1.2”] \n[“1.0”, “1.1”, “1.2”, “1.3”] \n[“1.0”, “1.1”, “1.2”, “1.3+0RTT”] \n[“1.2”]\n[“1.2”, “1.3”]\n[“1.2”, “1.3+0RTT”]. |\n| type | string | Resource type. |\n| updated_at | string | Date and time in ISO 8601 format. |\n| vipspace | string | A Fastly assigned name representing a set of network prefixes that are available for operations like acquiring TLS configurations.\nThis field is Required, and must be customer_assigned_vipspace. |</p>\n<h2 id=\"data-model-3\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>http_protocols</td>\n<td>array</td>\n<td>HTTP protocols available on your configuration. At least one protocol is required:</td>\n</tr>\n</tbody>\n</table>\n</div><p>http/1.1 is always supported and is required in the array.\nhttp/2 is optionally supported in the array.\nhttp/3 is optionally supported in the array. |\n| name | string | A custom name for your TLS configuration. Optional, we will assign a value to this if none is provided. |\n| relationships.default_certificate.id | string | Alphanumeric string identifying the default TLS certificate. |\n| relationships.default_ecdsa_certificate.id | string | Alphanumeric string identifying the default ECDSA TLS certificate. |\n| relationships.service.id | string | Alphanumeric string identifying the service. |\n| tls_1_2_cipher_suite_profile | array | An ordered collection of OpenSSL-formatted cipher suite names used for TLS-1.0, TLS-1.1 and TLS-1.2 protocol versions.\nNote: Setting this field is an advanced feature that requires enablement by Fastly Support. |\n| tls_protocols | array | TLS protocols available on your configuration. The following TLS protocols are supported:</p>\n<p>[“1.0”, “1.1”, “1.2”] \n[“1.0”, “1.1”, “1.2”, “1.3”] \n[“1.0”, “1.1”, “1.2”, “1.3+0RTT”] \n[“1.2”]\n[“1.2”, “1.3”]\n[“1.2”, “1.3+0RTT”]. |\n| type | string | Resource type. |</p>\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"13d2ba98-5023-4d87-8d93-273cd1a06ca3"}],"id":"be8d451e-0e09-4948-a98c-f391eda2da09","_postman_id":"be8d451e-0e09-4948-a98c-f391eda2da09","description":""},{"name":"Real-time logging","item":[{"name":"Microsoft Azure Blob Storage","item":[{"name":"List Azure Blob Storage log endpoints","id":"77dbd209-20aa-40b3-b3f1-e5422fdf6dfc","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/azureblob","description":"<p>List all of the Azure Blob Storage logging endpoints for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","azureblob"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"b7e086bc-233f-402a-8d50-59ef8791b73e","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/azureblob","description":"List all of the Azure Blob Storage logging endpoints for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"placement\":null,\"format_version\":\"2\",\"sas_token\":\"sv=2020-09-05&sr=b&sig=Z%2FRHIX5Xcg0Mq2rqI3OlWTjEg2tYkboXr1P9ZUXDtkk%3D&se=2020-09-30T02%3A23%3A26Z&sp=rw\",\"compression_codec\":\"zstd\",\"gzip_level\":\"0\",\"response_condition\":\"\",\"public_key\":null,\"updated_at\":\"2020-09-12T20:49:16.000Z\",\"message_type\":\"classic\",\"period\":\"3600\",\"name\":\"test-log-endpoint\",\"timestamp_format\":\"%Y-%m-%dT%H:%M:%S.000\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"container\":\"test-container\",\"path\":null,\"deleted_at\":null,\"account_name\":\"test-account\",\"created_at\":\"2020-09-12T20:49:16.000Z\",\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"file_max_bytes\":100000000}]"}],"_postman_id":"77dbd209-20aa-40b3-b3f1-e5422fdf6dfc"},{"name":"Create an Azure Blob Storage log endpoint","id":"f3af8343-7e01-40ef-867a-d2bbb69e85de","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/azureblob","description":"<p>Create an Azure Blob Storage logging endpoint for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","azureblob"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"e03e6f31-773f-4d25-affb-2064a403028f","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/azureblob","description":"Create an Azure Blob Storage logging endpoint for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"placement\":null,\"format_version\":\"2\",\"sas_token\":\"sv=2020-09-05&sr=b&sig=Z%2FRHIX5Xcg0Mq2rqI3OlWTjEg2tYkboXr1P9ZUXDtkk%3D&se=2020-09-30T02%3A23%3A26Z&sp=rw\",\"compression_codec\":\"zstd\",\"gzip_level\":\"0\",\"response_condition\":\"\",\"public_key\":null,\"updated_at\":\"2020-09-12T20:49:16.000Z\",\"message_type\":\"classic\",\"period\":\"3600\",\"name\":\"test-log-endpoint\",\"timestamp_format\":\"%Y-%m-%dT%H:%M:%S.000\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"container\":\"test-container\",\"path\":null,\"deleted_at\":null,\"account_name\":\"test-account\",\"created_at\":\"2020-09-12T20:49:16.000Z\",\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"file_max_bytes\":100000000}"}],"_postman_id":"f3af8343-7e01-40ef-867a-d2bbb69e85de"},{"name":"Get an Azure Blob Storage log endpoint","id":"2d4d02e2-f734-4862-a76d-7ad789a5f087","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/azureblob/{{logging_azureblob_name}}","description":"<p>Get the Azure Blob Storage logging endpoint for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","azureblob","{{logging_azureblob_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"bbff18f8-7c60-4ad6-9a5f-bed936c28295","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/azureblob/test-log-endpoint","description":"Get the Azure Blob Storage logging endpoint for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"placement\":null,\"format_version\":\"2\",\"sas_token\":\"sv=2020-09-05&sr=b&sig=Z%2FRHIX5Xcg0Mq2rqI3OlWTjEg2tYkboXr1P9ZUXDtkk%3D&se=2020-09-30T02%3A23%3A26Z&sp=rw\",\"compression_codec\":\"zstd\",\"gzip_level\":\"0\",\"response_condition\":\"\",\"public_key\":null,\"updated_at\":\"2020-09-12T20:49:16.000Z\",\"message_type\":\"classic\",\"period\":\"3600\",\"name\":\"test-log-endpoint\",\"timestamp_format\":\"%Y-%m-%dT%H:%M:%S.000\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"container\":\"test-container\",\"path\":null,\"deleted_at\":null,\"account_name\":\"test-account\",\"created_at\":\"2020-09-12T20:49:16.000Z\",\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"file_max_bytes\":100000000}"}],"_postman_id":"2d4d02e2-f734-4862-a76d-7ad789a5f087"},{"name":"Update an Azure Blob Storage log endpoint","id":"7674aab5-f58f-4808-92ed-193e0be17a16","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/azureblob/{{logging_azureblob_name}}","description":"<p>Update the Azure Blob Storage logging endpoint for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","azureblob","{{logging_azureblob_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"271af76e-b35c-4d58-8363-8fbd46609efc","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/azureblob/test-log-endpoint","description":"Update the Azure Blob Storage logging endpoint for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"placement\":null,\"format_version\":\"2\",\"sas_token\":\"sv=2020-09-05&sr=b&sig=Z%2FRHIX5Xcg0Mq2rqI3OlWTjEg2tYkboXr1P9ZUXDtkk%3D&se=2020-09-30T02%3A23%3A26Z&sp=rw\",\"compression_codec\":\"zstd\",\"gzip_level\":\"0\",\"response_condition\":\"\",\"public_key\":null,\"updated_at\":\"2020-09-12T20:49:16.000Z\",\"message_type\":\"classic\",\"period\":\"3600\",\"name\":\"updated-test-log-endpoint\",\"timestamp_format\":\"%Y-%m-%dT%H:%M:%S.000\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"container\":\"test-container\",\"path\":null,\"deleted_at\":null,\"account_name\":\"test-account\",\"created_at\":\"2020-09-12T20:49:16.000Z\",\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"file_max_bytes\":100000000}"}],"_postman_id":"7674aab5-f58f-4808-92ed-193e0be17a16"},{"name":"Delete the Azure Blob Storage log endpoint","id":"50f92a33-61fb-42a9-86f8-0101a8b44d20","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/azureblob/{{logging_azureblob_name}}","description":"<p>Delete the Azure Blob Storage logging endpoint for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","azureblob","{{logging_azureblob_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"41fc54c3-333a-48af-b67b-0a78541b43ea","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/azureblob/test-log-endpoint","description":"Delete the Azure Blob Storage logging endpoint for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"50f92a33-61fb-42a9-86f8-0101a8b44d20"}],"id":"77fe8184-a7e8-47b6-ba3a-daaca2e3177a","description":"<p>Fastly will upload log messages to the Azure Blob Storage container in the format specified in the Azure Blob object.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>account_name</td>\n<td>string</td>\n<td>The unique Azure Blob Storage namespace in which your data objects are stored. Required.</td>\n</tr>\n<tr>\n<td>container</td>\n<td>string</td>\n<td>The name of the Azure Blob Storage container in which to store logs. Required.</td>\n</tr>\n<tr>\n<td>file_max_bytes</td>\n<td>integer</td>\n<td>The maximum number of bytes for each uploaded file. A value of 0 can be used to indicate there is no limit on the size of uploaded files, otherwise the minimum value is 1048576 bytes (1 MiB). Note that Microsoft Azure Storage has block size limits.</td>\n</tr>\n<tr>\n<td>path</td>\n<td>string</td>\n<td>The path to upload logs to.</td>\n</tr>\n<tr>\n<td>public_key</td>\n<td>string</td>\n<td>A PGP public key that Fastly will use to encrypt your log files before writing them to disk.</td>\n</tr>\n<tr>\n<td>sas_token</td>\n<td>string</td>\n<td>The Azure shared access signature providing write access to the blob service objects. Be sure to update your token before it expires or the logging functionality will not work. Required.</td>\n</tr>\n<tr>\n<td>compression_codec</td>\n<td>string</td>\n<td>The codec used for compressing your logs. Valid values are zstd, snappy, and gzip. Specifying both compression_codec and gzip_level in the same API request will result in an error.</td>\n</tr>\n<tr>\n<td>format</td>\n<td>string</td>\n<td>A Fastly log format string.</td>\n</tr>\n<tr>\n<td>format_version</td>\n<td>integer</td>\n<td>The version of the custom logging format used for the configured endpoint. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1.</td>\n</tr>\n<tr>\n<td></td>\n<td>1</td>\n<td>Version 1 log format.</td>\n</tr>\n<tr>\n<td></td>\n<td>2</td>\n<td>Version 2 log format.</td>\n</tr>\n<tr>\n<td>gzip_level</td>\n<td>integer</td>\n<td>The level of gzip encoding when sending logs (default 0, no compression). Specifying both compression_codec and gzip_level in the same API request will result in an error.</td>\n</tr>\n<tr>\n<td>log_processing_region</td>\n<td>string</td>\n<td>The geographic region where the logs will be processed before streaming. Valid values are us, eu, and none for global.</td>\n</tr>\n<tr>\n<td>message_type</td>\n<td>string</td>\n<td>How the message should be formatted.</td>\n</tr>\n<tr>\n<td></td>\n<td>classic</td>\n<td>RFC 3164 syslog prefix.</td>\n</tr>\n<tr>\n<td></td>\n<td>loggly</td>\n<td>RFC 5424 structured syslog.</td>\n</tr>\n<tr>\n<td></td>\n<td>logplex</td>\n<td>Heroku-style length prefixed syslog.</td>\n</tr>\n<tr>\n<td></td>\n<td>blank</td>\n<td>No prefix. Useful for writing JSON and CSV.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The name for the real-time logging configuration.</td>\n</tr>\n<tr>\n<td>period</td>\n<td>integer</td>\n<td>How frequently log files are finalized so they can be available for reading (in seconds).</td>\n</tr>\n<tr>\n<td>placement</td>\n<td>string</td>\n<td>Where in the generated VCL the logging call should be placed. If not set, endpoints with format_version of 2 are placed in vcl_log and those with format_version of 1 are placed in vcl_deliver.</td>\n</tr>\n<tr>\n<td></td>\n<td>none</td>\n<td>Do not render a log statement into VCL. Use this option if you intend to write a log statement manually.</td>\n</tr>\n<tr>\n<td>response_condition</td>\n<td>string</td>\n<td>The name of an existing condition in the configured endpoint, or leave blank to always execute.</td>\n</tr>\n<tr>\n<td>timestamp_format</td>\n<td>string</td>\n<td>A timestamp format.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>string</td>\n<td>String identifying a service version.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"77fe8184-a7e8-47b6-ba3a-daaca2e3177a"},{"name":"BigQuery","item":[{"name":"List BigQuery log endpoints","id":"d07e64e9-77d6-4089-805f-9c388ce8205d","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/bigquery","description":"<p>List all of the BigQuery logging objects for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","bigquery"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"f3ebef30-6d30-43a7-bce1-6b5e8dc3b218","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/bigquery","description":"List all of the BigQuery logging objects for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"placement\":null,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"name\":\"test-log-endpoint\",\"format\":\"{ \\\"timestamp\\\":\\\"%{begin:%Y-%m-%dT%H:%M:%S}t\\\",\\n  \\\"time_elapsed\\\":%{time.elapsed.usec}V,\\n  \\\"is_tls\\\":%{if(req.is_ssl, \\\"true\\\", \\\"false\\\")}V,\\n  \\\"client_ip\\\":\\\"%{req.http.Fastly-Client-IP}V\\\",\\n  \\\"geo_city\\\":\\\"%{client.geo.city}V\\\",\\n  \\\"geo_country_code\\\":\\\"%{client.geo.country_code}V\\\",\\n  \\\"request\\\":\\\"%{req.request}V\\\",\\n  \\\"host\\\":\\\"%{req.http.Fastly-Orig-Host}V\\\",\\n  \\\"url\\\":\\\"%{json.escape(req.url)}V\\\",\\n  \\\"request_referer\\\":\\\"%{json.escape(req.http.Referer)}V\\\",\\n  \\\"request_user_agent\\\":\\\"%{json.escape(req.http.User-Agent)}V\\\",\\n  \\\"request_accept_language\\\":\\\"%{json.escape(req.http.Accept-Language)}V\\\",\\n  \\\"request_accept_charset\\\":\\\"%{json.escape(req.http.Accept-Charset)}V\\\",\\n  \\\"cache_status\\\":\\\"%{regsub(fastly_info.state, \\\"^(HIT-(SYNTH)|(HITPASS|HIT|MISS|PASS|ERROR|PIPE)).*\\\", \\\"\\\\\\\\2\\\\\\\\3\\\") }V\\\"\\n}\",\"format_version\":\"2\",\"user\":\"test-user@test-project-id.iam.gserviceaccount.com\",\"project_id\":\"test-project-id\",\"dataset\":\"test-dataset\",\"table\":\"test-table\",\"template_suffix\":null,\"secret_key\":\"-----BEGIN PRIVATE KEY-----\\n...\\n-----END PRIVATE KEY-----\\n\",\"created_at\":\"2020-05-17T20:23:15.000Z\",\"updated_at\":\"2020-05-17T20:23:15.000Z\",\"deleted_at\":null,\"response_condition\":\"\"}]"}],"_postman_id":"d07e64e9-77d6-4089-805f-9c388ce8205d"},{"name":"Create a BigQuery log endpoint","id":"fe36e31b-f6a2-4adb-85f2-1be9c9ce7cb5","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/bigquery","description":"<p>Create a BigQuery logging object for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","bigquery"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"b0bd0132-0cce-4883-bdee-b431b22a9f7b","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/bigquery","description":"Create a BigQuery logging object for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"placement\":null,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"name\":\"test-log-endpoint\",\"format\":\"{ \\\"timestamp\\\":\\\"%{begin:%Y-%m-%dT%H:%M:%S}t\\\",\\n  \\\"time_elapsed\\\":%{time.elapsed.usec}V,\\n  \\\"is_tls\\\":%{if(req.is_ssl, \\\"true\\\", \\\"false\\\")}V,\\n  \\\"client_ip\\\":\\\"%{req.http.Fastly-Client-IP}V\\\",\\n  \\\"geo_city\\\":\\\"%{client.geo.city}V\\\",\\n  \\\"geo_country_code\\\":\\\"%{client.geo.country_code}V\\\",\\n  \\\"request\\\":\\\"%{req.request}V\\\",\\n  \\\"host\\\":\\\"%{req.http.Fastly-Orig-Host}V\\\",\\n  \\\"url\\\":\\\"%{json.escape(req.url)}V\\\",\\n  \\\"request_referer\\\":\\\"%{json.escape(req.http.Referer)}V\\\",\\n  \\\"request_user_agent\\\":\\\"%{json.escape(req.http.User-Agent)}V\\\",\\n  \\\"request_accept_language\\\":\\\"%{json.escape(req.http.Accept-Language)}V\\\",\\n  \\\"request_accept_charset\\\":\\\"%{json.escape(req.http.Accept-Charset)}V\\\",\\n  \\\"cache_status\\\":\\\"%{regsub(fastly_info.state, \\\"^(HIT-(SYNTH)|(HITPASS|HIT|MISS|PASS|ERROR|PIPE)).*\\\", \\\"\\\\\\\\2\\\\\\\\3\\\") }V\\\"\\n}\",\"format_version\":\"2\",\"user\":\"test-user@test-project-id.iam.gserviceaccount.com\",\"project_id\":\"test-project-id\",\"dataset\":\"test-dataset\",\"table\":\"test-table\",\"template_suffix\":null,\"secret_key\":\"-----BEGIN PRIVATE KEY-----\\n...\\n-----END PRIVATE KEY-----\\n\",\"created_at\":\"2020-05-17T20:23:15.000Z\",\"updated_at\":\"2020-05-17T20:23:15.000Z\",\"deleted_at\":null,\"response_condition\":\"\"}"}],"_postman_id":"fe36e31b-f6a2-4adb-85f2-1be9c9ce7cb5"},{"name":"Get a BigQuery log endpoint","id":"1a962d99-df78-4ce7-824c-db05d026a1dd","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/bigquery/{{logging_bigquery_name}}","description":"<p>Get the details for a BigQuery logging object for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","bigquery","{{logging_bigquery_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"f752f156-5120-4e4b-84dc-d0885ca87ab9","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/bigquery/test-log-endpoint","description":"Get the details for a BigQuery logging object for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"placement\":null,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"name\":\"test-log-endpoint\",\"format\":\"{ \\\"timestamp\\\":\\\"%{begin:%Y-%m-%dT%H:%M:%S}t\\\",\\n  \\\"time_elapsed\\\":%{time.elapsed.usec}V,\\n  \\\"is_tls\\\":%{if(req.is_ssl, \\\"true\\\", \\\"false\\\")}V,\\n  \\\"client_ip\\\":\\\"%{req.http.Fastly-Client-IP}V\\\",\\n  \\\"geo_city\\\":\\\"%{client.geo.city}V\\\",\\n  \\\"geo_country_code\\\":\\\"%{client.geo.country_code}V\\\",\\n  \\\"request\\\":\\\"%{req.request}V\\\",\\n  \\\"host\\\":\\\"%{req.http.Fastly-Orig-Host}V\\\",\\n  \\\"url\\\":\\\"%{json.escape(req.url)}V\\\",\\n  \\\"request_referer\\\":\\\"%{json.escape(req.http.Referer)}V\\\",\\n  \\\"request_user_agent\\\":\\\"%{json.escape(req.http.User-Agent)}V\\\",\\n  \\\"request_accept_language\\\":\\\"%{json.escape(req.http.Accept-Language)}V\\\",\\n  \\\"request_accept_charset\\\":\\\"%{json.escape(req.http.Accept-Charset)}V\\\",\\n  \\\"cache_status\\\":\\\"%{regsub(fastly_info.state, \\\"^(HIT-(SYNTH)|(HITPASS|HIT|MISS|PASS|ERROR|PIPE)).*\\\", \\\"\\\\\\\\2\\\\\\\\3\\\") }V\\\"\\n}\",\"format_version\":\"2\",\"user\":\"test-user@test-project-id.iam.gserviceaccount.com\",\"project_id\":\"test-project-id\",\"dataset\":\"test-dataset\",\"table\":\"test-table\",\"template_suffix\":null,\"secret_key\":\"-----BEGIN PRIVATE KEY-----\\n...\\n-----END PRIVATE KEY-----\\n\",\"created_at\":\"2020-05-17T20:23:15.000Z\",\"updated_at\":\"2020-05-17T20:23:15.000Z\",\"deleted_at\":null,\"response_condition\":\"\"}"}],"_postman_id":"1a962d99-df78-4ce7-824c-db05d026a1dd"},{"name":"Update a BigQuery log endpoint","id":"50d37f64-c0eb-472d-b7b6-e4048c8f0f44","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/bigquery/{{logging_bigquery_name}}","description":"<p>Update a BigQuery logging object for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","bigquery","{{logging_bigquery_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"4b564854-e406-464e-bfea-a6c903b2598e","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/bigquery/test-log-endpoint","description":"Update a BigQuery logging object for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"placement\":null,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"name\":\"updated-test-log-endpoint\",\"format\":\"{ \\\"timestamp\\\":\\\"%{begin:%Y-%m-%dT%H:%M:%S}t\\\",\\n  \\\"time_elapsed\\\":%{time.elapsed.usec}V,\\n  \\\"is_tls\\\":%{if(req.is_ssl, \\\"true\\\", \\\"false\\\")}V,\\n  \\\"client_ip\\\":\\\"%{req.http.Fastly-Client-IP}V\\\",\\n  \\\"geo_city\\\":\\\"%{client.geo.city}V\\\",\\n  \\\"geo_country_code\\\":\\\"%{client.geo.country_code}V\\\",\\n  \\\"request\\\":\\\"%{req.request}V\\\",\\n  \\\"host\\\":\\\"%{req.http.Fastly-Orig-Host}V\\\",\\n  \\\"url\\\":\\\"%{json.escape(req.url)}V\\\",\\n  \\\"request_referer\\\":\\\"%{json.escape(req.http.Referer)}V\\\",\\n  \\\"request_user_agent\\\":\\\"%{json.escape(req.http.User-Agent)}V\\\",\\n  \\\"request_accept_language\\\":\\\"%{json.escape(req.http.Accept-Language)}V\\\",\\n  \\\"request_accept_charset\\\":\\\"%{json.escape(req.http.Accept-Charset)}V\\\",\\n  \\\"cache_status\\\":\\\"%{regsub(fastly_info.state, \\\"^(HIT-(SYNTH)|(HITPASS|HIT|MISS|PASS|ERROR|PIPE)).*\\\", \\\"\\\\\\\\2\\\\\\\\3\\\") }V\\\"\\n}\",\"format_version\":\"2\",\"user\":\"test-user@test-project-id.iam.gserviceaccount.com\",\"project_id\":\"test-project-id\",\"dataset\":\"test-dataset\",\"table\":\"test-table\",\"template_suffix\":null,\"secret_key\":\"-----BEGIN PRIVATE KEY-----\\n...\\n-----END PRIVATE KEY-----\\n\",\"created_at\":\"2020-05-17T20:23:15.000Z\",\"updated_at\":\"2020-05-17T20:23:15.000Z\",\"deleted_at\":null,\"response_condition\":\"\"}"}],"_postman_id":"50d37f64-c0eb-472d-b7b6-e4048c8f0f44"},{"name":"Delete a BigQuery log endpoint","id":"40ea8001-9d97-4e18-9183-1d37003a1361","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/bigquery/{{logging_bigquery_name}}","description":"<p>Delete a BigQuery logging object for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","bigquery","{{logging_bigquery_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"ddec0615-7e31-405f-8c6a-2afd9083e64c","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/bigquery/test-log-endpoint","description":"Delete a BigQuery logging object for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"40ea8001-9d97-4e18-9183-1d37003a1361"}],"id":"f553456f-4c03-4f62-b07a-5d09d02119c6","description":"<p>Fastly will upload log messages to the Google BigQuery dataset and table in the format specified in the BigQuery logging object.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>dataset</td>\n<td>string</td>\n<td>Your BigQuery dataset.</td>\n</tr>\n<tr>\n<td>format</td>\n<td>string</td>\n<td>A Fastly log format string. Must produce JSON that matches the schema of your BigQuery table.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The name of the BigQuery logging object. Used as a primary key for API access.</td>\n</tr>\n<tr>\n<td>project_id</td>\n<td>string</td>\n<td>Your Google Cloud Platform project ID. Required.</td>\n</tr>\n<tr>\n<td>table</td>\n<td>string</td>\n<td>Your BigQuery table.</td>\n</tr>\n<tr>\n<td>template_suffix</td>\n<td>string</td>\n<td>BigQuery table name suffix template. Optional.</td>\n</tr>\n<tr>\n<td>account_name</td>\n<td>string</td>\n<td>The name of the Google Cloud Platform service account associated with the target log collection service. Not required if user and secret_key are provided.</td>\n</tr>\n<tr>\n<td>format_version</td>\n<td>integer</td>\n<td>The version of the custom logging format used for the configured endpoint. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1.</td>\n</tr>\n<tr>\n<td></td>\n<td>1</td>\n<td>Version 1 log format.</td>\n</tr>\n<tr>\n<td></td>\n<td>2</td>\n<td>Version 2 log format.</td>\n</tr>\n<tr>\n<td>log_processing_region</td>\n<td>string</td>\n<td>The geographic region where the logs will be processed before streaming. Valid values are us, eu, and none for global.</td>\n</tr>\n<tr>\n<td>placement</td>\n<td>string</td>\n<td>Where in the generated VCL the logging call should be placed. If not set, endpoints with format_version of 2 are placed in vcl_log and those with format_version of 1 are placed in vcl_deliver.</td>\n</tr>\n<tr>\n<td></td>\n<td>none</td>\n<td>Do not render a log statement into VCL. Use this option if you intend to write a log statement manually.</td>\n</tr>\n<tr>\n<td>response_condition</td>\n<td>string</td>\n<td>The name of an existing condition in the configured endpoint, or leave blank to always execute.</td>\n</tr>\n<tr>\n<td>secret_key</td>\n<td>string</td>\n<td>Your Google Cloud Platform account secret key. The private_key field in your service account authentication JSON. Not required if account_name is specified.</td>\n</tr>\n<tr>\n<td>user</td>\n<td>string</td>\n<td>Your Google Cloud Platform service account email address. The client_email field in your service account authentication JSON. Not required if account_name is specified.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>string</td>\n<td>String identifying a service version.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"f553456f-4c03-4f62-b07a-5d09d02119c6"},{"name":"Cloud Files","item":[{"name":"List Cloud Files log endpoints","id":"bc8a336e-232d-4086-a8a7-4d090b026271","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/cloudfiles","description":"<p>List all of the Cloud Files log endpoints for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","cloudfiles"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"431e2e46-53c2-4849-807c-5623003feda6","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/cloudfiles","description":"List all of the Cloud Files log endpoints for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"compression_codec\":\"zstd\",\"gzip_level\":\"0\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"bucket_name\":\"test-bucket\",\"user\":\"test-user\",\"created_at\":\"2020-05-21T22:49:44.000Z\",\"public_key\":null,\"response_condition\":\"\",\"name\":\"test-log-endpoint\",\"period\":\"3600\",\"region\":null,\"deleted_at\":null,\"message_type\":\"classic\",\"access_key\":\"AKIAIOSFODNN7EXAMPLE\",\"updated_at\":\"2020-05-21T22:49:44.000Z\",\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"version\":\"1\",\"path\":null,\"timestamp_format\":\"%Y-%m-%dT%H:%M:%S.000\",\"placement\":null,\"format_version\":\"2\"}]"}],"_postman_id":"bc8a336e-232d-4086-a8a7-4d090b026271"},{"name":"Create a Cloud Files log endpoint","id":"6217d4aa-d54c-4957-9e1b-593135e4b437","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/cloudfiles","description":"<p>Create a Cloud Files log endpoint for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","cloudfiles"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"58c713bb-a3c1-4355-abe4-316c7fc59718","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/cloudfiles","description":"Create a Cloud Files log endpoint for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"compression_codec\":\"zstd\",\"gzip_level\":\"0\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"bucket_name\":\"test-bucket\",\"user\":\"test-user\",\"created_at\":\"2020-05-21T22:49:44.000Z\",\"public_key\":null,\"response_condition\":\"\",\"name\":\"test-log-endpoint\",\"period\":\"3600\",\"region\":null,\"deleted_at\":null,\"message_type\":\"classic\",\"access_key\":\"AKIAIOSFODNN7EXAMPLE\",\"updated_at\":\"2020-05-21T22:49:44.000Z\",\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"version\":\"1\",\"path\":null,\"timestamp_format\":\"%Y-%m-%dT%H:%M:%S.000\",\"placement\":null,\"format_version\":\"2\"}"}],"_postman_id":"6217d4aa-d54c-4957-9e1b-593135e4b437"},{"name":"Get a Cloud Files log endpoint","id":"63c98596-3db1-48e7-a057-11deacef92c5","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/cloudfiles/{{logging_cloudfiles_name}}","description":"<p>Get the Cloud Files log endpoint for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","cloudfiles","{{logging_cloudfiles_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"3f39bb37-362a-4eea-bbe1-b310b384c014","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/cloudfiles/test-log-endpoint","description":"Get the Cloud Files log endpoint for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"compression_codec\":\"zstd\",\"gzip_level\":\"0\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"bucket_name\":\"test-bucket\",\"user\":\"test-user\",\"created_at\":\"2020-05-21T22:49:44.000Z\",\"public_key\":null,\"response_condition\":\"\",\"name\":\"test-log-endpoint\",\"period\":\"3600\",\"region\":null,\"deleted_at\":null,\"message_type\":\"classic\",\"access_key\":\"AKIAIOSFODNN7EXAMPLE\",\"updated_at\":\"2020-05-21T22:49:44.000Z\",\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"version\":\"1\",\"path\":null,\"timestamp_format\":\"%Y-%m-%dT%H:%M:%S.000\",\"placement\":null,\"format_version\":\"2\"}"}],"_postman_id":"63c98596-3db1-48e7-a057-11deacef92c5"},{"name":"Update the Cloud Files log endpoint","id":"9e222080-d85e-4d81-9e3d-930ae22b12e4","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/cloudfiles/{{logging_cloudfiles_name}}","description":"<p>Update the Cloud Files log endpoint for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","cloudfiles","{{logging_cloudfiles_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"d0d47d2c-4321-4a07-8aa0-09b434e7d3f4","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/cloudfiles/test-log-endpoint","description":"Update the Cloud Files log endpoint for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"compression_codec\":\"zstd\",\"gzip_level\":\"0\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"bucket_name\":\"test-bucket\",\"user\":\"test-user\",\"created_at\":\"2020-05-21T22:49:44.000Z\",\"public_key\":null,\"response_condition\":\"\",\"name\":\"updated-test-log-endpoint\",\"period\":\"3600\",\"region\":null,\"deleted_at\":null,\"message_type\":\"classic\",\"access_key\":\"AKIAIOSFODNN7EXAMPLE\",\"updated_at\":\"2020-05-21T22:49:44.000Z\",\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"version\":\"1\",\"path\":null,\"timestamp_format\":\"%Y-%m-%dT%H:%M:%S.000\",\"placement\":null,\"format_version\":\"2\"}"}],"_postman_id":"9e222080-d85e-4d81-9e3d-930ae22b12e4"},{"name":"Delete the Cloud Files log endpoint","id":"74a4bc4a-2dcb-40b9-bfcc-55ca0e4cbac0","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/cloudfiles/{{logging_cloudfiles_name}}","description":"<p>Delete the Cloud Files log endpoint for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","cloudfiles","{{logging_cloudfiles_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"a470c7b9-c3c9-4458-a25c-5d1555362fc1","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/cloudfiles/test-log-endpoint","description":"Delete the Cloud Files log endpoint for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"74a4bc4a-2dcb-40b9-bfcc-55ca0e4cbac0"}],"id":"048a1396-424a-4540-9c5b-b5443e918088","description":"<p>Fastly will upload log messages to your Rackspace Cloud Files account.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>access_key</td>\n<td>string</td>\n<td>Your Cloud Files account access key.</td>\n</tr>\n<tr>\n<td>bucket_name</td>\n<td>string</td>\n<td>The name of your Cloud Files container.</td>\n</tr>\n<tr>\n<td>path</td>\n<td>string</td>\n<td>The path to upload logs to.</td>\n</tr>\n<tr>\n<td>public_key</td>\n<td>string</td>\n<td>A PGP public key that Fastly will use to encrypt your log files before writing them to disk.</td>\n</tr>\n<tr>\n<td>region</td>\n<td>string</td>\n<td>The region to stream logs to.</td>\n</tr>\n<tr>\n<td></td>\n<td>DFW</td>\n<td>Dallas.</td>\n</tr>\n<tr>\n<td></td>\n<td>ORD</td>\n<td>Chicago.</td>\n</tr>\n<tr>\n<td></td>\n<td>IAD</td>\n<td>Northern Virginia.</td>\n</tr>\n<tr>\n<td></td>\n<td>LON</td>\n<td>London.</td>\n</tr>\n<tr>\n<td></td>\n<td>SYD</td>\n<td>Sydney.</td>\n</tr>\n<tr>\n<td></td>\n<td>HKG</td>\n<td>Hong Kong.</td>\n</tr>\n<tr>\n<td></td>\n<td>null</td>\n<td></td>\n</tr>\n<tr>\n<td>user</td>\n<td>string</td>\n<td>The username for your Cloud Files account.</td>\n</tr>\n<tr>\n<td>compression_codec</td>\n<td>string</td>\n<td>The codec used for compressing your logs. Valid values are zstd, snappy, and gzip. Specifying both compression_codec and gzip_level in the same API request will result in an error.</td>\n</tr>\n<tr>\n<td>format</td>\n<td>string</td>\n<td>A Fastly log format string.</td>\n</tr>\n<tr>\n<td>format_version</td>\n<td>integer</td>\n<td>The version of the custom logging format used for the configured endpoint. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1.</td>\n</tr>\n<tr>\n<td></td>\n<td>1</td>\n<td>Version 1 log format.</td>\n</tr>\n<tr>\n<td></td>\n<td>2</td>\n<td>Version 2 log format.</td>\n</tr>\n<tr>\n<td>gzip_level</td>\n<td>integer</td>\n<td>The level of gzip encoding when sending logs (default 0, no compression). Specifying both compression_codec and gzip_level in the same API request will result in an error.</td>\n</tr>\n<tr>\n<td>log_processing_region</td>\n<td>string</td>\n<td>The geographic region where the logs will be processed before streaming. Valid values are us, eu, and none for global.</td>\n</tr>\n<tr>\n<td>message_type</td>\n<td>string</td>\n<td>How the message should be formatted.</td>\n</tr>\n<tr>\n<td></td>\n<td>classic</td>\n<td>RFC 3164 syslog prefix.</td>\n</tr>\n<tr>\n<td></td>\n<td>loggly</td>\n<td>RFC 5424 structured syslog.</td>\n</tr>\n<tr>\n<td></td>\n<td>logplex</td>\n<td>Heroku-style length prefixed syslog.</td>\n</tr>\n<tr>\n<td></td>\n<td>blank</td>\n<td>No prefix. Useful for writing JSON and CSV.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The name for the real-time logging configuration.</td>\n</tr>\n<tr>\n<td>period</td>\n<td>integer</td>\n<td>How frequently log files are finalized so they can be available for reading (in seconds).</td>\n</tr>\n<tr>\n<td>placement</td>\n<td>string</td>\n<td>Where in the generated VCL the logging call should be placed. If not set, endpoints with format_version of 2 are placed in vcl_log and those with format_version of 1 are placed in vcl_deliver.</td>\n</tr>\n<tr>\n<td></td>\n<td>none</td>\n<td>Do not render a log statement into VCL. Use this option if you intend to write a log statement manually.</td>\n</tr>\n<tr>\n<td>response_condition</td>\n<td>string</td>\n<td>The name of an existing condition in the configured endpoint, or leave blank to always execute.</td>\n</tr>\n<tr>\n<td>timestamp_format</td>\n<td>string</td>\n<td>A timestamp format.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>string</td>\n<td>String identifying a service version.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"048a1396-424a-4540-9c5b-b5443e918088"},{"name":"Datadog","item":[{"name":"List Datadog log endpoints","id":"9798f627-c04a-4680-9a12-d2da2e31e77b","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/datadog","description":"<p>List all of the Datadog logging objects for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","datadog"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"75d14f76-5fc5-4de1-814a-c15a461059e0","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/datadog","description":"List all of the Datadog logging objects for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"name\":\"test-log-endpoint\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"region\":\"US\",\"format\":\"{\\\"ddsource\\\":\\\"fastly\\\",\\\"service\\\":\\\"%{req.service_id}V\\\",\\\"date\\\":\\\"%{begin:%Y-%m-%dT%H:%M:%S%Z}t\\\",\\\"time_start\\\":\\\"%{begin:%Y-%m-%dT%H:%M:%S%Z}t\\\",\\\"time_end\\\":\\\"%{end:%Y-%m-%dT%H:%M:%S%Z}t\\\",\\\"http\\\":{\\\"request_time_ms\\\":\\\"%D\\\",\\\"method\\\":\\\"%m\\\",\\\"url\\\":\\\"%{json.escape(req.url)}V\\\",\\\"useragent\\\":\\\"%{User-Agent}i\\\",\\\"referer\\\":\\\"%{Referer}i\\\",\\\"protocol\\\":\\\"%H\\\",\\\"request_x_forwarded_for\\\":\\\"%{X-Forwarded-For}i\\\",\\\"status_code\\\":\\\"%s\\\"},\\\"network\\\":{\\\"client\\\":{\\\"ip\\\":\\\"%h\\\",\\\"name\\\":\\\"%{client.as.name}V\\\",\\\"number\\\":\\\"%{client.as.number}V\\\",\\\"connection_speed\\\":\\\"%{client.geo.conn_speed}V\\\"},\\\"destination\\\":{\\\"ip\\\":\\\"%A\\\"},\\\"geoip\\\":{\\\"geo_city\\\":\\\"%{client.geo.city.utf8}V\\\",\\\"geo_country_code\\\":\\\"%{client.geo.country_code}V\\\",\\\"geo_continent_code\\\":\\\"%{client.geo.continent_code}V\\\",\\\"geo_region\\\":\\\"%{client.geo.region}V\\\"},\\\"bytes_written\\\":\\\"%B\\\",\\\"bytes_read\\\":\\\"%{req.body_bytes_read}V\\\"},\\\"host\\\":\\\"%{Fastly-Orig-Host}i\\\",\\\"origin_host\\\":\\\"%v\\\",\\\"is_ipv6\\\":\\\"%{if(req.is_ipv6, \\\\\\\"true\\\\\\\", \\\\\\\"false\\\\\\\")}V\\\",\\\"is_tls\\\":\\\"%{if(req.is_ssl, \\\\\\\"true\\\\\\\", \\\\\\\"false\\\\\\\")}V\\\",\\\"tls_client_protocol\\\":\\\"%{json.escape(tls.client.protocol)}V\\\",\\\"tls_client_servername\\\":\\\"%{json.escape(tls.client.servername)}V\\\",\\\"tls_client_cipher\\\":\\\"%{json.escape(tls.client.cipher)}V\\\",\\\"tls_client_cipher_sha\\\":\\\"%{json.escape(tls.client.ciphers_sha)}V\\\",\\\"tls_client_tlsexts_sha\\\":\\\"%{json.escape(tls.client.tlsexts_sha)}V\\\",\\\"is_h2\\\":\\\"%{if(fastly_info.is_h2, \\\\\\\"true\\\\\\\", \\\\\\\"false\\\\\\\")}V\\\",\\\"is_h2_push\\\":\\\"%{if(fastly_info.h2.is_push, \\\\\\\"true\\\\\\\", \\\\\\\"false\\\\\\\")}V\\\",\\\"h2_stream_id\\\":\\\"%{fastly_info.h2.stream_id}V\\\",\\\"request_accept_content\\\":\\\"%{Accept}i\\\",\\\"request_accept_language\\\":\\\"%{Accept-Language}i\\\",\\\"request_accept_encoding\\\":\\\"%{Accept-Encoding}i\\\",\\\"request_accept_charset\\\":\\\"%{Accept-Charset}i\\\",\\\"request_connection\\\":\\\"%{Connection}i\\\",\\\"request_dnt\\\":\\\"%{DNT}i\\\",\\\"request_forwarded\\\":\\\"%{Forwarded}i\\\",\\\"request_via\\\":\\\"%{Via}i\\\",\\\"request_cache_control\\\":\\\"%{Cache-Control}i\\\",\\\"request_x_requested_with\\\":\\\"%{X-Requested-With}i\\\",\\\"request_x_att_device_id\\\":\\\"%{X-ATT-Device-Id}i\\\",\\\"content_type\\\":\\\"%{Content-Type}o\\\",\\\"is_cacheable\\\":\\\"%{if(fastly_info.state~\\\\\\\"^(HIT|MISS)$\\\\\\\", \\\\\\\"true\\\\\\\", \\\\\\\"false\\\\\\\")}V\\\",\\\"response_age\\\":\\\"%{Age}o\\\",\\\"response_cache_control\\\":\\\"%{Cache-Control}o\\\",\\\"response_expires\\\":\\\"%{Expires}o\\\",\\\"response_last_modified\\\":\\\"%{Last-Modified}o\\\",\\\"response_tsv\\\":\\\"%{TSV}o\\\",\\\"server_datacenter\\\":\\\"%{server.datacenter}V\\\",\\\"req_header_size\\\":\\\"%{req.header_bytes_read}V\\\",\\\"resp_header_size\\\":\\\"%{resp.header_bytes_written}V\\\",\\\"socket_cwnd\\\":\\\"%{client.socket.cwnd}V\\\",\\\"socket_nexthop\\\":\\\"%{client.socket.nexthop}V\\\",\\\"socket_tcpi_rcv_mss\\\":\\\"%{client.socket.tcpi_rcv_mss}V\\\",\\\"socket_tcpi_snd_mss\\\":\\\"%{client.socket.tcpi_snd_mss}V\\\",\\\"socket_tcpi_rtt\\\":\\\"%{client.socket.tcpi_rtt}V\\\",\\\"socket_tcpi_rttvar\\\":\\\"%{client.socket.tcpi_rttvar}V\\\",\\\"socket_tcpi_rcv_rtt\\\":\\\"%{client.socket.tcpi_rcv_rtt}V\\\",\\\"socket_tcpi_rcv_space\\\":\\\"%{client.socket.tcpi_rcv_space}V\\\",\\\"socket_tcpi_last_data_sent\\\":\\\"%{client.socket.tcpi_last_data_sent}V\\\",\\\"socket_tcpi_total_retrans\\\":\\\"%{client.socket.tcpi_total_retrans}V\\\",\\\"socket_tcpi_delta_retrans\\\":\\\"%{client.socket.tcpi_delta_retrans}V\\\",\\\"socket_ploss\\\":\\\"%{client.socket.ploss}V\\\"}\",\"format_version\":\"2\",\"created_at\":\"2020-04-22T16:50:01.000Z\",\"updated_at\":\"2020-04-22T16:50:01.000Z\",\"deleted_at\":null,\"response_condition\":\"\",\"placement\":null,\"token\":\"DD-API-KEY\"}]"}],"_postman_id":"9798f627-c04a-4680-9a12-d2da2e31e77b"},{"name":"Create a Datadog log endpoint","id":"f9174726-f3ee-43aa-b0f8-1aa5fb47e1b6","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/datadog","description":"<p>Create a Datadog logging object for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","datadog"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"da06bde7-0740-40b9-93b5-948f19992122","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/datadog","description":"Create a Datadog logging object for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"name\":\"test-log-endpoint\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"region\":\"US\",\"format\":\"{\\\"ddsource\\\":\\\"fastly\\\",\\\"service\\\":\\\"%{req.service_id}V\\\",\\\"date\\\":\\\"%{begin:%Y-%m-%dT%H:%M:%S%Z}t\\\",\\\"time_start\\\":\\\"%{begin:%Y-%m-%dT%H:%M:%S%Z}t\\\",\\\"time_end\\\":\\\"%{end:%Y-%m-%dT%H:%M:%S%Z}t\\\",\\\"http\\\":{\\\"request_time_ms\\\":\\\"%D\\\",\\\"method\\\":\\\"%m\\\",\\\"url\\\":\\\"%{json.escape(req.url)}V\\\",\\\"useragent\\\":\\\"%{User-Agent}i\\\",\\\"referer\\\":\\\"%{Referer}i\\\",\\\"protocol\\\":\\\"%H\\\",\\\"request_x_forwarded_for\\\":\\\"%{X-Forwarded-For}i\\\",\\\"status_code\\\":\\\"%s\\\"},\\\"network\\\":{\\\"client\\\":{\\\"ip\\\":\\\"%h\\\",\\\"name\\\":\\\"%{client.as.name}V\\\",\\\"number\\\":\\\"%{client.as.number}V\\\",\\\"connection_speed\\\":\\\"%{client.geo.conn_speed}V\\\"},\\\"destination\\\":{\\\"ip\\\":\\\"%A\\\"},\\\"geoip\\\":{\\\"geo_city\\\":\\\"%{client.geo.city.utf8}V\\\",\\\"geo_country_code\\\":\\\"%{client.geo.country_code}V\\\",\\\"geo_continent_code\\\":\\\"%{client.geo.continent_code}V\\\",\\\"geo_region\\\":\\\"%{client.geo.region}V\\\"},\\\"bytes_written\\\":\\\"%B\\\",\\\"bytes_read\\\":\\\"%{req.body_bytes_read}V\\\"},\\\"host\\\":\\\"%{Fastly-Orig-Host}i\\\",\\\"origin_host\\\":\\\"%v\\\",\\\"is_ipv6\\\":\\\"%{if(req.is_ipv6, \\\\\\\"true\\\\\\\", \\\\\\\"false\\\\\\\")}V\\\",\\\"is_tls\\\":\\\"%{if(req.is_ssl, \\\\\\\"true\\\\\\\", \\\\\\\"false\\\\\\\")}V\\\",\\\"tls_client_protocol\\\":\\\"%{json.escape(tls.client.protocol)}V\\\",\\\"tls_client_servername\\\":\\\"%{json.escape(tls.client.servername)}V\\\",\\\"tls_client_cipher\\\":\\\"%{json.escape(tls.client.cipher)}V\\\",\\\"tls_client_cipher_sha\\\":\\\"%{json.escape(tls.client.ciphers_sha)}V\\\",\\\"tls_client_tlsexts_sha\\\":\\\"%{json.escape(tls.client.tlsexts_sha)}V\\\",\\\"is_h2\\\":\\\"%{if(fastly_info.is_h2, \\\\\\\"true\\\\\\\", \\\\\\\"false\\\\\\\")}V\\\",\\\"is_h2_push\\\":\\\"%{if(fastly_info.h2.is_push, \\\\\\\"true\\\\\\\", \\\\\\\"false\\\\\\\")}V\\\",\\\"h2_stream_id\\\":\\\"%{fastly_info.h2.stream_id}V\\\",\\\"request_accept_content\\\":\\\"%{Accept}i\\\",\\\"request_accept_language\\\":\\\"%{Accept-Language}i\\\",\\\"request_accept_encoding\\\":\\\"%{Accept-Encoding}i\\\",\\\"request_accept_charset\\\":\\\"%{Accept-Charset}i\\\",\\\"request_connection\\\":\\\"%{Connection}i\\\",\\\"request_dnt\\\":\\\"%{DNT}i\\\",\\\"request_forwarded\\\":\\\"%{Forwarded}i\\\",\\\"request_via\\\":\\\"%{Via}i\\\",\\\"request_cache_control\\\":\\\"%{Cache-Control}i\\\",\\\"request_x_requested_with\\\":\\\"%{X-Requested-With}i\\\",\\\"request_x_att_device_id\\\":\\\"%{X-ATT-Device-Id}i\\\",\\\"content_type\\\":\\\"%{Content-Type}o\\\",\\\"is_cacheable\\\":\\\"%{if(fastly_info.state~\\\\\\\"^(HIT|MISS)$\\\\\\\", \\\\\\\"true\\\\\\\", \\\\\\\"false\\\\\\\")}V\\\",\\\"response_age\\\":\\\"%{Age}o\\\",\\\"response_cache_control\\\":\\\"%{Cache-Control}o\\\",\\\"response_expires\\\":\\\"%{Expires}o\\\",\\\"response_last_modified\\\":\\\"%{Last-Modified}o\\\",\\\"response_tsv\\\":\\\"%{TSV}o\\\",\\\"server_datacenter\\\":\\\"%{server.datacenter}V\\\",\\\"req_header_size\\\":\\\"%{req.header_bytes_read}V\\\",\\\"resp_header_size\\\":\\\"%{resp.header_bytes_written}V\\\",\\\"socket_cwnd\\\":\\\"%{client.socket.cwnd}V\\\",\\\"socket_nexthop\\\":\\\"%{client.socket.nexthop}V\\\",\\\"socket_tcpi_rcv_mss\\\":\\\"%{client.socket.tcpi_rcv_mss}V\\\",\\\"socket_tcpi_snd_mss\\\":\\\"%{client.socket.tcpi_snd_mss}V\\\",\\\"socket_tcpi_rtt\\\":\\\"%{client.socket.tcpi_rtt}V\\\",\\\"socket_tcpi_rttvar\\\":\\\"%{client.socket.tcpi_rttvar}V\\\",\\\"socket_tcpi_rcv_rtt\\\":\\\"%{client.socket.tcpi_rcv_rtt}V\\\",\\\"socket_tcpi_rcv_space\\\":\\\"%{client.socket.tcpi_rcv_space}V\\\",\\\"socket_tcpi_last_data_sent\\\":\\\"%{client.socket.tcpi_last_data_sent}V\\\",\\\"socket_tcpi_total_retrans\\\":\\\"%{client.socket.tcpi_total_retrans}V\\\",\\\"socket_tcpi_delta_retrans\\\":\\\"%{client.socket.tcpi_delta_retrans}V\\\",\\\"socket_ploss\\\":\\\"%{client.socket.ploss}V\\\"}\",\"format_version\":\"2\",\"created_at\":\"2020-04-22T16:50:01.000Z\",\"updated_at\":\"2020-04-22T16:50:01.000Z\",\"deleted_at\":null,\"response_condition\":\"\",\"placement\":null,\"token\":\"DD-API-KEY\"}"}],"_postman_id":"f9174726-f3ee-43aa-b0f8-1aa5fb47e1b6"},{"name":"Get a Datadog log endpoint","id":"3e886629-9d3e-4ca3-b6e5-030de9256590","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/datadog/{{logging_datadog_name}}","description":"<p>Get the details for a Datadog logging object for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","datadog","{{logging_datadog_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"50555b52-1a9e-49eb-912b-0af6c9a4204d","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/datadog/test-log-endpoint","description":"Get the details for a Datadog logging object for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"name\":\"test-log-endpoint\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"region\":\"US\",\"format\":\"{\\\"ddsource\\\":\\\"fastly\\\",\\\"service\\\":\\\"%{req.service_id}V\\\",\\\"date\\\":\\\"%{begin:%Y-%m-%dT%H:%M:%S%Z}t\\\",\\\"time_start\\\":\\\"%{begin:%Y-%m-%dT%H:%M:%S%Z}t\\\",\\\"time_end\\\":\\\"%{end:%Y-%m-%dT%H:%M:%S%Z}t\\\",\\\"http\\\":{\\\"request_time_ms\\\":\\\"%D\\\",\\\"method\\\":\\\"%m\\\",\\\"url\\\":\\\"%{json.escape(req.url)}V\\\",\\\"useragent\\\":\\\"%{User-Agent}i\\\",\\\"referer\\\":\\\"%{Referer}i\\\",\\\"protocol\\\":\\\"%H\\\",\\\"request_x_forwarded_for\\\":\\\"%{X-Forwarded-For}i\\\",\\\"status_code\\\":\\\"%s\\\"},\\\"network\\\":{\\\"client\\\":{\\\"ip\\\":\\\"%h\\\",\\\"name\\\":\\\"%{client.as.name}V\\\",\\\"number\\\":\\\"%{client.as.number}V\\\",\\\"connection_speed\\\":\\\"%{client.geo.conn_speed}V\\\"},\\\"destination\\\":{\\\"ip\\\":\\\"%A\\\"},\\\"geoip\\\":{\\\"geo_city\\\":\\\"%{client.geo.city.utf8}V\\\",\\\"geo_country_code\\\":\\\"%{client.geo.country_code}V\\\",\\\"geo_continent_code\\\":\\\"%{client.geo.continent_code}V\\\",\\\"geo_region\\\":\\\"%{client.geo.region}V\\\"},\\\"bytes_written\\\":\\\"%B\\\",\\\"bytes_read\\\":\\\"%{req.body_bytes_read}V\\\"},\\\"host\\\":\\\"%{Fastly-Orig-Host}i\\\",\\\"origin_host\\\":\\\"%v\\\",\\\"is_ipv6\\\":\\\"%{if(req.is_ipv6, \\\\\\\"true\\\\\\\", \\\\\\\"false\\\\\\\")}V\\\",\\\"is_tls\\\":\\\"%{if(req.is_ssl, \\\\\\\"true\\\\\\\", \\\\\\\"false\\\\\\\")}V\\\",\\\"tls_client_protocol\\\":\\\"%{json.escape(tls.client.protocol)}V\\\",\\\"tls_client_servername\\\":\\\"%{json.escape(tls.client.servername)}V\\\",\\\"tls_client_cipher\\\":\\\"%{json.escape(tls.client.cipher)}V\\\",\\\"tls_client_cipher_sha\\\":\\\"%{json.escape(tls.client.ciphers_sha)}V\\\",\\\"tls_client_tlsexts_sha\\\":\\\"%{json.escape(tls.client.tlsexts_sha)}V\\\",\\\"is_h2\\\":\\\"%{if(fastly_info.is_h2, \\\\\\\"true\\\\\\\", \\\\\\\"false\\\\\\\")}V\\\",\\\"is_h2_push\\\":\\\"%{if(fastly_info.h2.is_push, \\\\\\\"true\\\\\\\", \\\\\\\"false\\\\\\\")}V\\\",\\\"h2_stream_id\\\":\\\"%{fastly_info.h2.stream_id}V\\\",\\\"request_accept_content\\\":\\\"%{Accept}i\\\",\\\"request_accept_language\\\":\\\"%{Accept-Language}i\\\",\\\"request_accept_encoding\\\":\\\"%{Accept-Encoding}i\\\",\\\"request_accept_charset\\\":\\\"%{Accept-Charset}i\\\",\\\"request_connection\\\":\\\"%{Connection}i\\\",\\\"request_dnt\\\":\\\"%{DNT}i\\\",\\\"request_forwarded\\\":\\\"%{Forwarded}i\\\",\\\"request_via\\\":\\\"%{Via}i\\\",\\\"request_cache_control\\\":\\\"%{Cache-Control}i\\\",\\\"request_x_requested_with\\\":\\\"%{X-Requested-With}i\\\",\\\"request_x_att_device_id\\\":\\\"%{X-ATT-Device-Id}i\\\",\\\"content_type\\\":\\\"%{Content-Type}o\\\",\\\"is_cacheable\\\":\\\"%{if(fastly_info.state~\\\\\\\"^(HIT|MISS)$\\\\\\\", \\\\\\\"true\\\\\\\", \\\\\\\"false\\\\\\\")}V\\\",\\\"response_age\\\":\\\"%{Age}o\\\",\\\"response_cache_control\\\":\\\"%{Cache-Control}o\\\",\\\"response_expires\\\":\\\"%{Expires}o\\\",\\\"response_last_modified\\\":\\\"%{Last-Modified}o\\\",\\\"response_tsv\\\":\\\"%{TSV}o\\\",\\\"server_datacenter\\\":\\\"%{server.datacenter}V\\\",\\\"req_header_size\\\":\\\"%{req.header_bytes_read}V\\\",\\\"resp_header_size\\\":\\\"%{resp.header_bytes_written}V\\\",\\\"socket_cwnd\\\":\\\"%{client.socket.cwnd}V\\\",\\\"socket_nexthop\\\":\\\"%{client.socket.nexthop}V\\\",\\\"socket_tcpi_rcv_mss\\\":\\\"%{client.socket.tcpi_rcv_mss}V\\\",\\\"socket_tcpi_snd_mss\\\":\\\"%{client.socket.tcpi_snd_mss}V\\\",\\\"socket_tcpi_rtt\\\":\\\"%{client.socket.tcpi_rtt}V\\\",\\\"socket_tcpi_rttvar\\\":\\\"%{client.socket.tcpi_rttvar}V\\\",\\\"socket_tcpi_rcv_rtt\\\":\\\"%{client.socket.tcpi_rcv_rtt}V\\\",\\\"socket_tcpi_rcv_space\\\":\\\"%{client.socket.tcpi_rcv_space}V\\\",\\\"socket_tcpi_last_data_sent\\\":\\\"%{client.socket.tcpi_last_data_sent}V\\\",\\\"socket_tcpi_total_retrans\\\":\\\"%{client.socket.tcpi_total_retrans}V\\\",\\\"socket_tcpi_delta_retrans\\\":\\\"%{client.socket.tcpi_delta_retrans}V\\\",\\\"socket_ploss\\\":\\\"%{client.socket.ploss}V\\\"}\",\"format_version\":\"2\",\"created_at\":\"2020-04-22T16:50:01.000Z\",\"updated_at\":\"2020-04-22T16:50:01.000Z\",\"deleted_at\":null,\"response_condition\":\"\",\"placement\":null,\"token\":\"DD-API-KEY\"}"}],"_postman_id":"3e886629-9d3e-4ca3-b6e5-030de9256590"},{"name":"Update a Datadog log endpoint","id":"0ef6e2f4-eaba-45dc-8031-c28d9d103019","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/datadog/{{logging_datadog_name}}","description":"<p>Update the Datadog logging object for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","datadog","{{logging_datadog_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"4fe81eb8-66a7-4499-bb12-deef70e40f70","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/datadog/test-log-endpoint","description":"Update the Datadog logging object for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"name\":\"updated-test-log-endpoint\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"region\":\"US\",\"format\":\"{\\\"ddsource\\\":\\\"fastly\\\",\\\"service\\\":\\\"%{req.service_id}V\\\",\\\"date\\\":\\\"%{begin:%Y-%m-%dT%H:%M:%S%Z}t\\\",\\\"time_start\\\":\\\"%{begin:%Y-%m-%dT%H:%M:%S%Z}t\\\",\\\"time_end\\\":\\\"%{end:%Y-%m-%dT%H:%M:%S%Z}t\\\",\\\"http\\\":{\\\"request_time_ms\\\":\\\"%D\\\",\\\"method\\\":\\\"%m\\\",\\\"url\\\":\\\"%{json.escape(req.url)}V\\\",\\\"useragent\\\":\\\"%{User-Agent}i\\\",\\\"referer\\\":\\\"%{Referer}i\\\",\\\"protocol\\\":\\\"%H\\\",\\\"request_x_forwarded_for\\\":\\\"%{X-Forwarded-For}i\\\",\\\"status_code\\\":\\\"%s\\\"},\\\"network\\\":{\\\"client\\\":{\\\"ip\\\":\\\"%h\\\",\\\"name\\\":\\\"%{client.as.name}V\\\",\\\"number\\\":\\\"%{client.as.number}V\\\",\\\"connection_speed\\\":\\\"%{client.geo.conn_speed}V\\\"},\\\"destination\\\":{\\\"ip\\\":\\\"%A\\\"},\\\"geoip\\\":{\\\"geo_city\\\":\\\"%{client.geo.city.utf8}V\\\",\\\"geo_country_code\\\":\\\"%{client.geo.country_code}V\\\",\\\"geo_continent_code\\\":\\\"%{client.geo.continent_code}V\\\",\\\"geo_region\\\":\\\"%{client.geo.region}V\\\"},\\\"bytes_written\\\":\\\"%B\\\",\\\"bytes_read\\\":\\\"%{req.body_bytes_read}V\\\"},\\\"host\\\":\\\"%{Fastly-Orig-Host}i\\\",\\\"origin_host\\\":\\\"%v\\\",\\\"is_ipv6\\\":\\\"%{if(req.is_ipv6, \\\\\\\"true\\\\\\\", \\\\\\\"false\\\\\\\")}V\\\",\\\"is_tls\\\":\\\"%{if(req.is_ssl, \\\\\\\"true\\\\\\\", \\\\\\\"false\\\\\\\")}V\\\",\\\"tls_client_protocol\\\":\\\"%{json.escape(tls.client.protocol)}V\\\",\\\"tls_client_servername\\\":\\\"%{json.escape(tls.client.servername)}V\\\",\\\"tls_client_cipher\\\":\\\"%{json.escape(tls.client.cipher)}V\\\",\\\"tls_client_cipher_sha\\\":\\\"%{json.escape(tls.client.ciphers_sha)}V\\\",\\\"tls_client_tlsexts_sha\\\":\\\"%{json.escape(tls.client.tlsexts_sha)}V\\\",\\\"is_h2\\\":\\\"%{if(fastly_info.is_h2, \\\\\\\"true\\\\\\\", \\\\\\\"false\\\\\\\")}V\\\",\\\"is_h2_push\\\":\\\"%{if(fastly_info.h2.is_push, \\\\\\\"true\\\\\\\", \\\\\\\"false\\\\\\\")}V\\\",\\\"h2_stream_id\\\":\\\"%{fastly_info.h2.stream_id}V\\\",\\\"request_accept_content\\\":\\\"%{Accept}i\\\",\\\"request_accept_language\\\":\\\"%{Accept-Language}i\\\",\\\"request_accept_encoding\\\":\\\"%{Accept-Encoding}i\\\",\\\"request_accept_charset\\\":\\\"%{Accept-Charset}i\\\",\\\"request_connection\\\":\\\"%{Connection}i\\\",\\\"request_dnt\\\":\\\"%{DNT}i\\\",\\\"request_forwarded\\\":\\\"%{Forwarded}i\\\",\\\"request_via\\\":\\\"%{Via}i\\\",\\\"request_cache_control\\\":\\\"%{Cache-Control}i\\\",\\\"request_x_requested_with\\\":\\\"%{X-Requested-With}i\\\",\\\"request_x_att_device_id\\\":\\\"%{X-ATT-Device-Id}i\\\",\\\"content_type\\\":\\\"%{Content-Type}o\\\",\\\"is_cacheable\\\":\\\"%{if(fastly_info.state~\\\\\\\"^(HIT|MISS)$\\\\\\\", \\\\\\\"true\\\\\\\", \\\\\\\"false\\\\\\\")}V\\\",\\\"response_age\\\":\\\"%{Age}o\\\",\\\"response_cache_control\\\":\\\"%{Cache-Control}o\\\",\\\"response_expires\\\":\\\"%{Expires}o\\\",\\\"response_last_modified\\\":\\\"%{Last-Modified}o\\\",\\\"response_tsv\\\":\\\"%{TSV}o\\\",\\\"server_datacenter\\\":\\\"%{server.datacenter}V\\\",\\\"req_header_size\\\":\\\"%{req.header_bytes_read}V\\\",\\\"resp_header_size\\\":\\\"%{resp.header_bytes_written}V\\\",\\\"socket_cwnd\\\":\\\"%{client.socket.cwnd}V\\\",\\\"socket_nexthop\\\":\\\"%{client.socket.nexthop}V\\\",\\\"socket_tcpi_rcv_mss\\\":\\\"%{client.socket.tcpi_rcv_mss}V\\\",\\\"socket_tcpi_snd_mss\\\":\\\"%{client.socket.tcpi_snd_mss}V\\\",\\\"socket_tcpi_rtt\\\":\\\"%{client.socket.tcpi_rtt}V\\\",\\\"socket_tcpi_rttvar\\\":\\\"%{client.socket.tcpi_rttvar}V\\\",\\\"socket_tcpi_rcv_rtt\\\":\\\"%{client.socket.tcpi_rcv_rtt}V\\\",\\\"socket_tcpi_rcv_space\\\":\\\"%{client.socket.tcpi_rcv_space}V\\\",\\\"socket_tcpi_last_data_sent\\\":\\\"%{client.socket.tcpi_last_data_sent}V\\\",\\\"socket_tcpi_total_retrans\\\":\\\"%{client.socket.tcpi_total_retrans}V\\\",\\\"socket_tcpi_delta_retrans\\\":\\\"%{client.socket.tcpi_delta_retrans}V\\\",\\\"socket_ploss\\\":\\\"%{client.socket.ploss}V\\\"}\",\"format_version\":\"2\",\"created_at\":\"2020-04-22T16:50:01.000Z\",\"updated_at\":\"2020-04-22T16:50:01.000Z\",\"deleted_at\":null,\"response_condition\":\"\",\"placement\":null,\"token\":\"DD-API-KEY\"}"}],"_postman_id":"0ef6e2f4-eaba-45dc-8031-c28d9d103019"},{"name":"Delete a Datadog log endpoint","id":"eb5771bf-8dfd-49f7-9cef-29c4a6121ef4","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/datadog/{{logging_datadog_name}}","description":"<p>Delete the Datadog logging object for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","datadog","{{logging_datadog_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"6520c451-52ac-4e2f-b88f-7fc5c96c0281","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/datadog/test-log-endpoint","description":"Delete the Datadog logging object for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"eb5771bf-8dfd-49f7-9cef-29c4a6121ef4"}],"id":"b2554bf7-8886-43ad-aee0-c45cdd5c5afa","description":"<p>Fastly will upload log messages to Datadog in the format specified in the Datadog configuration object.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>format</td>\n<td>string</td>\n<td>A Fastly log format string. Must produce valid JSON that Datadog can ingest.</td>\n</tr>\n<tr>\n<td>region</td>\n<td>string</td>\n<td>The region that log data will be sent to.</td>\n</tr>\n<tr>\n<td>token</td>\n<td>string</td>\n<td>The API key from your Datadog account. Required.</td>\n</tr>\n<tr>\n<td>format_version</td>\n<td>integer</td>\n<td>The version of the custom logging format used for the configured endpoint. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1.</td>\n</tr>\n<tr>\n<td></td>\n<td>1</td>\n<td>Version 1 log format.</td>\n</tr>\n<tr>\n<td></td>\n<td>2</td>\n<td>Version 2 log format.</td>\n</tr>\n<tr>\n<td>log_processing_region</td>\n<td>string</td>\n<td>The geographic region where the logs will be processed before streaming. Valid values are us, eu, and none for global.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The name for the real-time logging configuration.</td>\n</tr>\n<tr>\n<td>placement</td>\n<td>string</td>\n<td>Where in the generated VCL the logging call should be placed. If not set, endpoints with format_version of 2 are placed in vcl_log and those with format_version of 1 are placed in vcl_deliver.</td>\n</tr>\n<tr>\n<td></td>\n<td>none</td>\n<td>Do not render a log statement into VCL. Use this option if you intend to write a log statement manually.</td>\n</tr>\n<tr>\n<td>response_condition</td>\n<td>string</td>\n<td>The name of an existing condition in the configured endpoint, or leave blank to always execute.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>string</td>\n<td>String identifying a service version.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"b2554bf7-8886-43ad-aee0-c45cdd5c5afa"},{"name":"DigitalOcean Spaces","item":[{"name":"List DigitalOcean Spaces log endpoints","id":"c553f09a-7005-4b20-bf0b-6710df2040e5","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/digitalocean","description":"<p>List all of the DigitalOcean Spaces for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","digitalocean"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"323d59a5-f726-45a6-8220-f0ec14cca5fa","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/digitalocean","description":"List all of the DigitalOcean Spaces for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"access_key\":\"AKIAIOSFODNN7EXAMPLE\",\"bucket_name\":\"test-bucket\",\"created_at\":\"2020-05-23T19:48:33.000Z\",\"deleted_at\":null,\"domain\":\"nyc3.digitaloceanspaces.com\",\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"compression_codec\":\"zstd\",\"gzip_level\":\"0\",\"message_type\":\"classic\",\"name\":\"test-log-endpoint\",\"path\":null,\"period\":\"3600\",\"placement\":null,\"response_condition\":\"\",\"secret_key\":\"wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"timestamp_format\":\"%Y-%m-%dT%H:%M:%S.000\",\"updated_at\":\"2020-05-23T19:48:33.000Z\",\"version\":\"1\"}]"}],"_postman_id":"c553f09a-7005-4b20-bf0b-6710df2040e5"},{"name":"Create a DigitalOcean Spaces log endpoint","id":"f9341edb-78e7-4ce9-b195-7cd098b07dae","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/digitalocean","description":"<p>Create a DigitalOcean Space for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","digitalocean"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"d83679bf-e00e-47ea-979a-51d4efac6f19","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/digitalocean","description":"Create a DigitalOcean Space for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"access_key\":\"AKIAIOSFODNN7EXAMPLE\",\"bucket_name\":\"test-bucket\",\"created_at\":\"2020-05-23T19:48:33.000Z\",\"deleted_at\":null,\"domain\":\"nyc3.digitaloceanspaces.com\",\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"compression_codec\":\"zstd\",\"gzip_level\":\"0\",\"message_type\":\"classic\",\"name\":\"test-log-endpoint\",\"path\":null,\"period\":\"3600\",\"placement\":null,\"response_condition\":\"\",\"secret_key\":\"wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"timestamp_format\":\"%Y-%m-%dT%H:%M:%S.000\",\"updated_at\":\"2020-05-23T19:48:33.000Z\",\"version\":\"1\"}"}],"_postman_id":"f9341edb-78e7-4ce9-b195-7cd098b07dae"},{"name":"Get a DigitalOcean Spaces log endpoint","id":"e4234215-d23e-46d5-94f3-4ad8fa7a3481","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/digitalocean/{{logging_digitalocean_name}}","description":"<p>Get the DigitalOcean Space for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","digitalocean","{{logging_digitalocean_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"1759be0c-a0b2-4000-8d7a-45db0eda2f48","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/digitalocean/test-log-endpoint","description":"Get the DigitalOcean Space for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"access_key\":\"AKIAIOSFODNN7EXAMPLE\",\"bucket_name\":\"test-bucket\",\"created_at\":\"2020-05-23T19:48:33.000Z\",\"deleted_at\":null,\"domain\":\"nyc3.digitaloceanspaces.com\",\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"compression_codec\":\"zstd\",\"gzip_level\":\"0\",\"message_type\":\"classic\",\"name\":\"test-log-endpoint\",\"path\":null,\"period\":\"3600\",\"placement\":null,\"response_condition\":\"\",\"secret_key\":\"wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"timestamp_format\":\"%Y-%m-%dT%H:%M:%S.000\",\"updated_at\":\"2020-05-23T19:48:33.000Z\",\"version\":\"1\"}"}],"_postman_id":"e4234215-d23e-46d5-94f3-4ad8fa7a3481"},{"name":"Update a DigitalOcean Spaces log endpoint","id":"fa493ad6-a387-43fc-9061-3e1e6e32340a","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/digitalocean/{{logging_digitalocean_name}}","description":"<p>Update the DigitalOcean Space for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","digitalocean","{{logging_digitalocean_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"6fd9efbb-95c1-45bd-9e4a-d77e4f2f6355","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/digitalocean/test-log-endpoint","description":"Update the DigitalOcean Space for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"access_key\":\"AKIAIOSFODNN7EXAMPLE\",\"bucket_name\":\"test-bucket\",\"created_at\":\"2020-05-23T19:48:33.000Z\",\"deleted_at\":null,\"domain\":\"nyc3.digitaloceanspaces.com\",\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"compression_codec\":\"zstd\",\"gzip_level\":\"0\",\"message_type\":\"classic\",\"name\":\"updated-test-log-endpoint\",\"path\":null,\"period\":\"3600\",\"placement\":null,\"response_condition\":\"\",\"secret_key\":\"wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"timestamp_format\":\"%Y-%m-%dT%H:%M:%S.000\",\"updated_at\":\"2020-05-23T19:48:33.000Z\",\"version\":\"1\"}"}],"_postman_id":"fa493ad6-a387-43fc-9061-3e1e6e32340a"},{"name":"Delete a DigitalOcean Spaces log endpoint","id":"f14976ea-97d0-4785-aa55-7e34546fa873","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/digitalocean/{{logging_digitalocean_name}}","description":"<p>Delete the DigitalOcean Space for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","digitalocean","{{logging_digitalocean_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"9db95d07-9290-4ef1-8fb4-bee6a8a1dac7","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/digitalocean/test-log-endpoint","description":"Delete the DigitalOcean Space for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"f14976ea-97d0-4785-aa55-7e34546fa873"}],"id":"24a29ccc-5bb5-4e92-885f-50a039acda13","description":"<p>Fastly will upload log messages to the DigitalOcean Space in the format specified in the DigitalOcean Spaces object.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>access_key</td>\n<td>string</td>\n<td>Your DigitalOcean Spaces account access key.</td>\n</tr>\n<tr>\n<td>bucket_name</td>\n<td>string</td>\n<td>The name of the DigitalOcean Space.</td>\n</tr>\n<tr>\n<td>domain</td>\n<td>string</td>\n<td>The domain of the DigitalOcean Spaces endpoint.</td>\n</tr>\n<tr>\n<td>path</td>\n<td>string</td>\n<td>The path to upload logs to.</td>\n</tr>\n<tr>\n<td>public_key</td>\n<td>string</td>\n<td>A PGP public key that Fastly will use to encrypt your log files before writing them to disk.</td>\n</tr>\n<tr>\n<td>secret_key</td>\n<td>string</td>\n<td>Your DigitalOcean Spaces account secret key.</td>\n</tr>\n<tr>\n<td>compression_codec</td>\n<td>string</td>\n<td>The codec used for compressing your logs. Valid values are zstd, snappy, and gzip. Specifying both compression_codec and gzip_level in the same API request will result in an error.</td>\n</tr>\n<tr>\n<td>format</td>\n<td>string</td>\n<td>A Fastly log format string.</td>\n</tr>\n<tr>\n<td>format_version</td>\n<td>integer</td>\n<td>The version of the custom logging format used for the configured endpoint. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1.</td>\n</tr>\n<tr>\n<td></td>\n<td>1</td>\n<td>Version 1 log format.</td>\n</tr>\n<tr>\n<td></td>\n<td>2</td>\n<td>Version 2 log format.</td>\n</tr>\n<tr>\n<td>gzip_level</td>\n<td>integer</td>\n<td>The level of gzip encoding when sending logs (default 0, no compression). Specifying both compression_codec and gzip_level in the same API request will result in an error.</td>\n</tr>\n<tr>\n<td>log_processing_region</td>\n<td>string</td>\n<td>The geographic region where the logs will be processed before streaming. Valid values are us, eu, and none for global.</td>\n</tr>\n<tr>\n<td>message_type</td>\n<td>string</td>\n<td>How the message should be formatted.</td>\n</tr>\n<tr>\n<td></td>\n<td>classic</td>\n<td>RFC 3164 syslog prefix.</td>\n</tr>\n<tr>\n<td></td>\n<td>loggly</td>\n<td>RFC 5424 structured syslog.</td>\n</tr>\n<tr>\n<td></td>\n<td>logplex</td>\n<td>Heroku-style length prefixed syslog.</td>\n</tr>\n<tr>\n<td></td>\n<td>blank</td>\n<td>No prefix. Useful for writing JSON and CSV.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The name for the real-time logging configuration.</td>\n</tr>\n<tr>\n<td>period</td>\n<td>integer</td>\n<td>How frequently log files are finalized so they can be available for reading (in seconds).</td>\n</tr>\n<tr>\n<td>placement</td>\n<td>string</td>\n<td>Where in the generated VCL the logging call should be placed. If not set, endpoints with format_version of 2 are placed in vcl_log and those with format_version of 1 are placed in vcl_deliver.</td>\n</tr>\n<tr>\n<td></td>\n<td>none</td>\n<td>Do not render a log statement into VCL. Use this option if you intend to write a log statement manually.</td>\n</tr>\n<tr>\n<td>response_condition</td>\n<td>string</td>\n<td>The name of an existing condition in the configured endpoint, or leave blank to always execute.</td>\n</tr>\n<tr>\n<td>timestamp_format</td>\n<td>string</td>\n<td>A timestamp format.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>string</td>\n<td>String identifying a service version.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"24a29ccc-5bb5-4e92-885f-50a039acda13"},{"name":"Elasticsearch","item":[{"name":"List Elasticsearch log endpoints","id":"4dca3a9c-0de8-4ef2-a4cd-c3cfffa95d6d","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/elasticsearch","description":"<p>List all of the Elasticsearch logging endpoints for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","elasticsearch"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"c00303ce-e116-4428-a47c-56726592e671","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/elasticsearch","description":"List all of the Elasticsearch logging endpoints for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"format_version\":\"2\",\"tls_hostname\":null,\"response_condition\":\"\",\"index\":\"test-index\",\"request_max_entries\":0,\"deleted_at\":null,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"password\":null,\"version\":\"1\",\"name\":\"test-log-endpoint\",\"user\":null,\"updated_at\":\"2020-07-02T23:13:17.000Z\",\"tls_client_key\":null,\"created_at\":\"2020-07-02T23:13:17.000Z\",\"request_max_bytes\":0,\"format\":\"{ \\\"timestamp\\\":\\\"%{begin:%Y-%m-%dT%H:%M:%S}t\\\",\\n  \\\"time_elapsed\\\":%{time.elapsed.usec}V,\\n  \\\"is_tls\\\":%{if(req.is_ssl, \\\"true\\\", \\\"false\\\")}V,\\n  \\\"client_ip\\\":\\\"%{req.http.Fastly-Client-IP}V\\\",\\n  \\\"geo_city\\\":\\\"%{client.geo.city}V\\\",\\n  \\\"geo_country_code\\\":\\\"%{client.geo.country_code}V\\\",\\n  \\\"request\\\":\\\"%{req.request}V\\\",\\n  \\\"host\\\":\\\"%{req.http.Fastly-Orig-Host}V\\\",\\n  \\\"url\\\":\\\"%{json.escape(req.url)}V\\\",\\n  \\\"request_referer\\\":\\\"%{json.escape(req.http.Referer)}V\\\",\\n  \\\"request_user_agent\\\":\\\"%{json.escape(req.http.User-Agent)}V\\\",\\n  \\\"request_accept_language\\\":\\\"%{json.escape(req.http.Accept-Language)}V\\\",\\n  \\\"request_accept_charset\\\":\\\"%{json.escape(req.http.Accept-Charset)}V\\\",\\n  \\\"cache_status\\\":\\\"%{regsub(fastly_info.state, \\\"^(HIT-(SYNTH)|(HITPASS|HIT|MISS|PASS|ERROR|PIPE)).*\\\", \\\"\\\\\\\\2\\\\\\\\3\\\") }V\\\"\\n}\",\"url\":\"https://www.example.com\",\"pipeline\":null,\"tls_client_cert\":null,\"tls_ca_cert\":null,\"placement\":null}]"}],"_postman_id":"4dca3a9c-0de8-4ef2-a4cd-c3cfffa95d6d"},{"name":"Create an Elasticsearch log endpoint","id":"fec6429c-da48-4101-9626-b9fcfa5c4ef4","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/elasticsearch","description":"<p>Create a Elasticsearch logging endpoint for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","elasticsearch"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"8e64ccdb-4801-47be-80dc-34e0ae427346","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/elasticsearch","description":"Create a Elasticsearch logging endpoint for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"format_version\":\"2\",\"tls_hostname\":null,\"response_condition\":\"\",\"index\":\"test-index\",\"request_max_entries\":0,\"deleted_at\":null,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"password\":null,\"version\":\"1\",\"name\":\"test-log-endpoint\",\"user\":null,\"updated_at\":\"2020-07-02T23:13:17.000Z\",\"tls_client_key\":null,\"created_at\":\"2020-07-02T23:13:17.000Z\",\"request_max_bytes\":0,\"format\":\"{ \\\"timestamp\\\":\\\"%{begin:%Y-%m-%dT%H:%M:%S}t\\\",\\n  \\\"time_elapsed\\\":%{time.elapsed.usec}V,\\n  \\\"is_tls\\\":%{if(req.is_ssl, \\\"true\\\", \\\"false\\\")}V,\\n  \\\"client_ip\\\":\\\"%{req.http.Fastly-Client-IP}V\\\",\\n  \\\"geo_city\\\":\\\"%{client.geo.city}V\\\",\\n  \\\"geo_country_code\\\":\\\"%{client.geo.country_code}V\\\",\\n  \\\"request\\\":\\\"%{req.request}V\\\",\\n  \\\"host\\\":\\\"%{req.http.Fastly-Orig-Host}V\\\",\\n  \\\"url\\\":\\\"%{json.escape(req.url)}V\\\",\\n  \\\"request_referer\\\":\\\"%{json.escape(req.http.Referer)}V\\\",\\n  \\\"request_user_agent\\\":\\\"%{json.escape(req.http.User-Agent)}V\\\",\\n  \\\"request_accept_language\\\":\\\"%{json.escape(req.http.Accept-Language)}V\\\",\\n  \\\"request_accept_charset\\\":\\\"%{json.escape(req.http.Accept-Charset)}V\\\",\\n  \\\"cache_status\\\":\\\"%{regsub(fastly_info.state, \\\"^(HIT-(SYNTH)|(HITPASS|HIT|MISS|PASS|ERROR|PIPE)).*\\\", \\\"\\\\\\\\2\\\\\\\\3\\\") }V\\\"\\n}\",\"url\":\"https://www.example.com\",\"pipeline\":null,\"tls_client_cert\":null,\"tls_ca_cert\":null,\"placement\":null}"}],"_postman_id":"fec6429c-da48-4101-9626-b9fcfa5c4ef4"},{"name":"Get an Elasticsearch log endpoint","id":"18c23f11-237e-4306-9281-b495994c9836","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/elasticsearch/{{logging_elasticsearch_name}}","description":"<p>Get the Elasticsearch logging endpoint for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","elasticsearch","{{logging_elasticsearch_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"a0ea1924-7b28-4a51-9585-96796499a255","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/elasticsearch/test-log-endpoint","description":"Get the Elasticsearch logging endpoint for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"format_version\":\"2\",\"tls_hostname\":null,\"response_condition\":\"\",\"index\":\"test-index\",\"request_max_entries\":0,\"deleted_at\":null,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"password\":null,\"version\":\"1\",\"name\":\"test-log-endpoint\",\"user\":null,\"updated_at\":\"2020-07-02T23:13:17.000Z\",\"tls_client_key\":null,\"created_at\":\"2020-07-02T23:13:17.000Z\",\"request_max_bytes\":0,\"format\":\"{ \\\"timestamp\\\":\\\"%{begin:%Y-%m-%dT%H:%M:%S}t\\\",\\n  \\\"time_elapsed\\\":%{time.elapsed.usec}V,\\n  \\\"is_tls\\\":%{if(req.is_ssl, \\\"true\\\", \\\"false\\\")}V,\\n  \\\"client_ip\\\":\\\"%{req.http.Fastly-Client-IP}V\\\",\\n  \\\"geo_city\\\":\\\"%{client.geo.city}V\\\",\\n  \\\"geo_country_code\\\":\\\"%{client.geo.country_code}V\\\",\\n  \\\"request\\\":\\\"%{req.request}V\\\",\\n  \\\"host\\\":\\\"%{req.http.Fastly-Orig-Host}V\\\",\\n  \\\"url\\\":\\\"%{json.escape(req.url)}V\\\",\\n  \\\"request_referer\\\":\\\"%{json.escape(req.http.Referer)}V\\\",\\n  \\\"request_user_agent\\\":\\\"%{json.escape(req.http.User-Agent)}V\\\",\\n  \\\"request_accept_language\\\":\\\"%{json.escape(req.http.Accept-Language)}V\\\",\\n  \\\"request_accept_charset\\\":\\\"%{json.escape(req.http.Accept-Charset)}V\\\",\\n  \\\"cache_status\\\":\\\"%{regsub(fastly_info.state, \\\"^(HIT-(SYNTH)|(HITPASS|HIT|MISS|PASS|ERROR|PIPE)).*\\\", \\\"\\\\\\\\2\\\\\\\\3\\\") }V\\\"\\n}\",\"url\":\"https://www.example.com\",\"pipeline\":null,\"tls_client_cert\":null,\"tls_ca_cert\":null,\"placement\":null}"}],"_postman_id":"18c23f11-237e-4306-9281-b495994c9836"},{"name":"Update an Elasticsearch log endpoint","id":"421a884c-909f-471c-b581-a4f4b0d6dc05","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/elasticsearch/{{logging_elasticsearch_name}}","description":"<p>Update the Elasticsearch logging endpoint for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","elasticsearch","{{logging_elasticsearch_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"2afd73ee-759b-4c61-86f2-996859a1ff6f","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/elasticsearch/test-log-endpoint","description":"Update the Elasticsearch logging endpoint for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"format_version\":\"2\",\"tls_hostname\":null,\"response_condition\":\"\",\"index\":\"test-index\",\"request_max_entries\":0,\"deleted_at\":null,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"password\":null,\"version\":\"1\",\"name\":\"updated-test-log-endpoint\",\"user\":null,\"updated_at\":\"2020-07-02T23:13:17.000Z\",\"tls_client_key\":null,\"created_at\":\"2020-07-02T23:13:17.000Z\",\"request_max_bytes\":0,\"format\":\"{ \\\"timestamp\\\":\\\"%{begin:%Y-%m-%dT%H:%M:%S}t\\\",\\n  \\\"time_elapsed\\\":%{time.elapsed.usec}V,\\n  \\\"is_tls\\\":%{if(req.is_ssl, \\\"true\\\", \\\"false\\\")}V,\\n  \\\"client_ip\\\":\\\"%{req.http.Fastly-Client-IP}V\\\",\\n  \\\"geo_city\\\":\\\"%{client.geo.city}V\\\",\\n  \\\"geo_country_code\\\":\\\"%{client.geo.country_code}V\\\",\\n  \\\"request\\\":\\\"%{req.request}V\\\",\\n  \\\"host\\\":\\\"%{req.http.Fastly-Orig-Host}V\\\",\\n  \\\"url\\\":\\\"%{json.escape(req.url)}V\\\",\\n  \\\"request_referer\\\":\\\"%{json.escape(req.http.Referer)}V\\\",\\n  \\\"request_user_agent\\\":\\\"%{json.escape(req.http.User-Agent)}V\\\",\\n  \\\"request_accept_language\\\":\\\"%{json.escape(req.http.Accept-Language)}V\\\",\\n  \\\"request_accept_charset\\\":\\\"%{json.escape(req.http.Accept-Charset)}V\\\",\\n  \\\"cache_status\\\":\\\"%{regsub(fastly_info.state, \\\"^(HIT-(SYNTH)|(HITPASS|HIT|MISS|PASS|ERROR|PIPE)).*\\\", \\\"\\\\\\\\2\\\\\\\\3\\\") }V\\\"\\n}\",\"url\":\"https://www.example.com\",\"pipeline\":null,\"tls_client_cert\":null,\"tls_ca_cert\":null,\"placement\":null}"}],"_postman_id":"421a884c-909f-471c-b581-a4f4b0d6dc05"},{"name":"Delete an Elasticsearch log endpoint","id":"906dbc39-fcc7-493d-a5e6-8225f7efebdc","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/elasticsearch/{{logging_elasticsearch_name}}","description":"<p>Delete the Elasticsearch logging endpoint for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","elasticsearch","{{logging_elasticsearch_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"440221ef-dcc4-4a7f-b076-9e2b08a491fb","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/elasticsearch/test-log-endpoint","description":"Delete the Elasticsearch logging endpoint for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"906dbc39-fcc7-493d-a5e6-8225f7efebdc"}],"id":"5afdb677-7f8f-464d-a6ac-f30fe6b6bfa3","description":"<p>Fastly will upload log messages periodically to the server in the format specified in the Elasticsearch object.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>format</td>\n<td>string</td>\n<td>A Fastly log format string. Must produce valid JSON that Elasticsearch can ingest.</td>\n</tr>\n<tr>\n<td>index</td>\n<td>string</td>\n<td>The name of the Elasticsearch index to send documents (logs) to. The index must follow the Elasticsearch index format rules. We support strftime interpolated variables inside braces prefixed with a pound symbol. For example, #{%F} will interpolate as YYYY-MM-DD with today's date.</td>\n</tr>\n<tr>\n<td>password</td>\n<td>string</td>\n<td>Basic Auth password.</td>\n</tr>\n<tr>\n<td>pipeline</td>\n<td>string</td>\n<td>The ID of the Elasticsearch ingest pipeline to apply pre-process transformations to before indexing. Learn more about creating a pipeline in the Elasticsearch docs.</td>\n</tr>\n<tr>\n<td>url</td>\n<td>string</td>\n<td>The URL to stream logs to. Must use HTTPS.</td>\n</tr>\n<tr>\n<td>user</td>\n<td>string</td>\n<td>Basic Auth username.</td>\n</tr>\n<tr>\n<td>format_version</td>\n<td>integer</td>\n<td>The version of the custom logging format used for the configured endpoint. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1.</td>\n</tr>\n<tr>\n<td></td>\n<td>1</td>\n<td>Version 1 log format.</td>\n</tr>\n<tr>\n<td></td>\n<td>2</td>\n<td>Version 2 log format.</td>\n</tr>\n<tr>\n<td>log_processing_region</td>\n<td>string</td>\n<td>The geographic region where the logs will be processed before streaming. Valid values are us, eu, and none for global.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The name for the real-time logging configuration.</td>\n</tr>\n<tr>\n<td>placement</td>\n<td>string</td>\n<td>Where in the generated VCL the logging call should be placed. If not set, endpoints with format_version of 2 are placed in vcl_log and those with format_version of 1 are placed in vcl_deliver.</td>\n</tr>\n<tr>\n<td></td>\n<td>none</td>\n<td>Do not render a log statement into VCL. Use this option if you intend to write a log statement manually.</td>\n</tr>\n<tr>\n<td>request_max_bytes</td>\n<td>integer</td>\n<td>The maximum number of bytes sent in one request. Defaults 0 for unbounded.</td>\n</tr>\n<tr>\n<td>request_max_entries</td>\n<td>integer</td>\n<td>The maximum number of logs sent in one request. Defaults 0 for unbounded.</td>\n</tr>\n<tr>\n<td>response_condition</td>\n<td>string</td>\n<td>The name of an existing condition in the configured endpoint, or leave blank to always execute.</td>\n</tr>\n<tr>\n<td>tls_ca_cert</td>\n<td>string</td>\n<td>A secure certificate to authenticate a server with. Must be in PEM format.</td>\n</tr>\n<tr>\n<td>tls_client_cert</td>\n<td>string</td>\n<td>The client certificate used to make authenticated requests. Must be in PEM format.</td>\n</tr>\n<tr>\n<td>tls_client_key</td>\n<td>string</td>\n<td>The client private key used to make authenticated requests. Must be in PEM format.</td>\n</tr>\n<tr>\n<td>tls_hostname</td>\n<td>string</td>\n<td>The hostname to verify the server's certificate. This should be one of the Subject Alternative Name (SAN) fields for the certificate. Common Names (CN) are not supported.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>string</td>\n<td>String identifying a service version.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"5afdb677-7f8f-464d-a6ac-f30fe6b6bfa3"},{"name":"FTP","item":[{"name":"List FTP log endpoints","id":"098be108-74ee-451b-b9cb-7f72011e6c36","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/ftp","description":"<p>List all of the FTPs for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","ftp"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"f9306ff5-2d03-4107-a4b7-14edfbd2aa97","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/ftp","description":"List all of the FTPs for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"address\":\"example.com\",\"created_at\":\"2020-05-17T18:27:29.000Z\",\"deleted_at\":null,\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"compression_codec\":\"zstd\",\"gzip_level\":\"0\",\"hostname\":\"example.com\",\"ipv4\":\"127.0.0.1\",\"message_type\":\"classic\",\"name\":\"test-log-endpoint\",\"password\":\"ftp@example.com\",\"path\":\"/\",\"period\":\"3600\",\"placement\":null,\"port\":\"21\",\"response_condition\":\"\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"timestamp_format\":\"%Y-%m-%dT%H:%M:%S.000\",\"updated_at\":\"2020-05-17T18:27:29.000Z\",\"user\":\"anonymous\",\"version\":\"1\"}]"}],"_postman_id":"098be108-74ee-451b-b9cb-7f72011e6c36"},{"name":"Create an FTP log endpoint","id":"4341334c-1ca9-47d3-9caa-51be420408ec","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/ftp","description":"<p>Create a FTP for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","ftp"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"49a05c64-8cb8-4865-85ad-c053dcb5fb1d","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/ftp","description":"Create a FTP for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"address\":\"example.com\",\"created_at\":\"2020-05-17T18:27:29.000Z\",\"deleted_at\":null,\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"compression_codec\":\"zstd\",\"gzip_level\":\"0\",\"hostname\":\"example.com\",\"ipv4\":\"127.0.0.1\",\"message_type\":\"classic\",\"name\":\"test-log-endpoint\",\"password\":\"ftp@example.com\",\"path\":\"/\",\"period\":\"3600\",\"placement\":null,\"port\":\"21\",\"response_condition\":\"\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"timestamp_format\":\"%Y-%m-%dT%H:%M:%S.000\",\"updated_at\":\"2020-05-17T18:27:29.000Z\",\"user\":\"anonymous\",\"version\":\"1\"}"}],"_postman_id":"4341334c-1ca9-47d3-9caa-51be420408ec"},{"name":"Get an FTP log endpoint","id":"7aae950d-12f3-44da-917e-30b10d5ae0fa","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/ftp/{{logging_ftp_name}}","description":"<p>Get the FTP for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","ftp","{{logging_ftp_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"52295aa4-6a82-4fdf-aa89-982e571e7c6d","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/ftp/test-log-endpoint","description":"Get the FTP for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"address\":\"example.com\",\"created_at\":\"2020-05-17T18:27:29.000Z\",\"deleted_at\":null,\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"compression_codec\":\"zstd\",\"gzip_level\":\"0\",\"hostname\":\"example.com\",\"ipv4\":\"127.0.0.1\",\"message_type\":\"classic\",\"name\":\"test-log-endpoint\",\"password\":\"ftp@example.com\",\"path\":\"/\",\"period\":\"3600\",\"placement\":null,\"port\":\"21\",\"response_condition\":\"\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"timestamp_format\":\"%Y-%m-%dT%H:%M:%S.000\",\"updated_at\":\"2020-05-17T18:27:29.000Z\",\"user\":\"anonymous\",\"version\":\"1\"}"}],"_postman_id":"7aae950d-12f3-44da-917e-30b10d5ae0fa"},{"name":"Update an FTP log endpoint","id":"7908399d-1e0c-4a2b-926a-7d32cf7c74aa","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/ftp/{{logging_ftp_name}}","description":"<p>Update the FTP for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","ftp","{{logging_ftp_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"25f1ff31-92f2-462c-8459-ee2bcf689bf6","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/ftp/test-log-endpoint","description":"Update the FTP for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"address\":\"example.com\",\"created_at\":\"2020-05-17T18:27:29.000Z\",\"deleted_at\":null,\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"compression_codec\":\"zstd\",\"gzip_level\":\"0\",\"hostname\":\"example.com\",\"ipv4\":\"127.0.0.1\",\"message_type\":\"classic\",\"name\":\"updated-test-log-endpoint\",\"password\":\"ftp@example.com\",\"path\":\"/\",\"period\":\"3600\",\"placement\":null,\"port\":\"21\",\"response_condition\":\"\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"timestamp_format\":\"%Y-%m-%dT%H:%M:%S.000\",\"updated_at\":\"2020-05-17T18:27:29.000Z\",\"user\":\"anonymous\",\"version\":\"1\"}"}],"_postman_id":"7908399d-1e0c-4a2b-926a-7d32cf7c74aa"},{"name":"Delete an FTP log endpoint","id":"b098cdaa-7b3c-484a-a4a0-33e02dfe1b45","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/ftp/{{logging_ftp_name}}","description":"<p>Delete the FTP for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","ftp","{{logging_ftp_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"5b404840-ac3f-48a8-8d3f-1076c0a6f202","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/ftp/test-log-endpoint","description":"Delete the FTP for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"b098cdaa-7b3c-484a-a4a0-33e02dfe1b45"}],"id":"27b276cc-6d40-4750-abef-0d97d5c2e4ef","description":"<p>Fastly will upload log messages periodically to the server in the format specified in the FTP object.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>address</td>\n<td>string</td>\n<td>An hostname or IPv4 address.</td>\n</tr>\n<tr>\n<td>hostname</td>\n<td>string</td>\n<td>Hostname used.</td>\n</tr>\n<tr>\n<td>ipv4</td>\n<td>string</td>\n<td>IPv4 address of the host.</td>\n</tr>\n<tr>\n<td>password</td>\n<td>string</td>\n<td>The password for the server. For anonymous use an email address.</td>\n</tr>\n<tr>\n<td>path</td>\n<td>string</td>\n<td>The path to upload log files to. If the path ends in / then it is treated as a directory.</td>\n</tr>\n<tr>\n<td>public_key</td>\n<td>string</td>\n<td>A PGP public key that Fastly will use to encrypt your log files before writing them to disk.</td>\n</tr>\n<tr>\n<td>user</td>\n<td>string</td>\n<td>The username for the server. Can be anonymous.</td>\n</tr>\n<tr>\n<td>compression_codec</td>\n<td>string</td>\n<td>The codec used for compressing your logs. Valid values are zstd, snappy, and gzip. Specifying both compression_codec and gzip_level in the same API request will result in an error.</td>\n</tr>\n<tr>\n<td>format</td>\n<td>string</td>\n<td>A Fastly log format string.</td>\n</tr>\n<tr>\n<td>format_version</td>\n<td>integer</td>\n<td>The version of the custom logging format used for the configured endpoint. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1.</td>\n</tr>\n<tr>\n<td></td>\n<td>1</td>\n<td>Version 1 log format.</td>\n</tr>\n<tr>\n<td></td>\n<td>2</td>\n<td>Version 2 log format.</td>\n</tr>\n<tr>\n<td>gzip_level</td>\n<td>integer</td>\n<td>The level of gzip encoding when sending logs (default 0, no compression). Specifying both compression_codec and gzip_level in the same API request will result in an error.</td>\n</tr>\n<tr>\n<td>log_processing_region</td>\n<td>string</td>\n<td>The geographic region where the logs will be processed before streaming. Valid values are us, eu, and none for global.</td>\n</tr>\n<tr>\n<td>message_type</td>\n<td>string</td>\n<td>How the message should be formatted.</td>\n</tr>\n<tr>\n<td></td>\n<td>classic</td>\n<td>RFC 3164 syslog prefix.</td>\n</tr>\n<tr>\n<td></td>\n<td>loggly</td>\n<td>RFC 5424 structured syslog.</td>\n</tr>\n<tr>\n<td></td>\n<td>logplex</td>\n<td>Heroku-style length prefixed syslog.</td>\n</tr>\n<tr>\n<td></td>\n<td>blank</td>\n<td>No prefix. Useful for writing JSON and CSV.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The name for the real-time logging configuration.</td>\n</tr>\n<tr>\n<td>period</td>\n<td>integer</td>\n<td>How frequently log files are finalized so they can be available for reading (in seconds).</td>\n</tr>\n<tr>\n<td>placement</td>\n<td>string</td>\n<td>Where in the generated VCL the logging call should be placed. If not set, endpoints with format_version of 2 are placed in vcl_log and those with format_version of 1 are placed in vcl_deliver.</td>\n</tr>\n<tr>\n<td></td>\n<td>none</td>\n<td>Do not render a log statement into VCL. Use this option if you intend to write a log statement manually.</td>\n</tr>\n<tr>\n<td>port</td>\n<td>integer</td>\n<td>The port number.</td>\n</tr>\n<tr>\n<td>response_condition</td>\n<td>string</td>\n<td>The name of an existing condition in the configured endpoint, or leave blank to always execute.</td>\n</tr>\n<tr>\n<td>timestamp_format</td>\n<td>string</td>\n<td>A timestamp format.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>string</td>\n<td>String identifying a service version.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"27b276cc-6d40-4750-abef-0d97d5c2e4ef"},{"name":"GCS Logging","item":[{"name":"List GCS log endpoints","id":"b5e80801-8ef3-4dcf-9a90-1f6a1de8903f","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/gcs","description":"<p>List all of the GCS log endpoints for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","gcs"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"ef7035e0-04a5-44e5-a8ed-3939525f7f5c","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/gcs","description":"List all of the GCS log endpoints for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"placement\":null,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"name\":\"test-log-endpoint\",\"format\":\"{ \\\"timestamp\\\":\\\"%{begin:%Y-%m-%dT%H:%M:%S}t\\\",\\n  \\\"time_elapsed\\\":%{time.elapsed.usec}V,\\n  \\\"is_tls\\\":%{if(req.is_ssl, \\\"true\\\", \\\"false\\\")}V,\\n  \\\"client_ip\\\":\\\"%{req.http.Fastly-Client-IP}V\\\",\\n  \\\"geo_city\\\":\\\"%{client.geo.city}V\\\",\\n  \\\"geo_country_code\\\":\\\"%{client.geo.country_code}V\\\",\\n  \\\"request\\\":\\\"%{req.request}V\\\",\\n  \\\"host\\\":\\\"%{req.http.Fastly-Orig-Host}V\\\",\\n  \\\"url\\\":\\\"%{json.escape(req.url)}V\\\",\\n  \\\"request_referer\\\":\\\"%{json.escape(req.http.Referer)}V\\\",\\n  \\\"request_user_agent\\\":\\\"%{json.escape(req.http.User-Agent)}V\\\",\\n  \\\"request_accept_language\\\":\\\"%{json.escape(req.http.Accept-Language)}V\\\",\\n  \\\"request_accept_charset\\\":\\\"%{json.escape(req.http.Accept-Charset)}V\\\",\\n  \\\"cache_status\\\":\\\"%{regsub(fastly_info.state, \\\"^(HIT-(SYNTH)|(HITPASS|HIT|MISS|PASS|ERROR|PIPE)).*\\\", \\\"\\\\\\\\2\\\\\\\\3\\\") }V\\\"\\n}\",\"format_version\":\"2\",\"compression_codec\":\"zstd\",\"gzip_level\":\"0\",\"user\":\"test-user@test-project-id.iam.gserviceaccount.com\",\"topic\":\"test-topic\",\"secret_key\":\"-----BEGIN PRIVATE KEY-----\\n...\\n-----END PRIVATE KEY-----\\n\",\"created_at\":\"2020-05-17T20:23:15.000Z\",\"updated_at\":\"2020-05-17T20:23:15.000Z\",\"deleted_at\":null,\"response_condition\":\"\"}]"}],"_postman_id":"b5e80801-8ef3-4dcf-9a90-1f6a1de8903f"},{"name":"Create a GCS log endpoint","id":"0e474654-5265-442f-b3d5-a0abf69f7296","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/gcs","description":"<p>Create GCS logging for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","gcs"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"ca311fea-e5fa-4d13-8144-72a960195bf8","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/gcs","description":"Create GCS logging for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"placement\":null,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"name\":\"test-log-endpoint\",\"format\":\"{ \\\"timestamp\\\":\\\"%{begin:%Y-%m-%dT%H:%M:%S}t\\\",\\n  \\\"time_elapsed\\\":%{time.elapsed.usec}V,\\n  \\\"is_tls\\\":%{if(req.is_ssl, \\\"true\\\", \\\"false\\\")}V,\\n  \\\"client_ip\\\":\\\"%{req.http.Fastly-Client-IP}V\\\",\\n  \\\"geo_city\\\":\\\"%{client.geo.city}V\\\",\\n  \\\"geo_country_code\\\":\\\"%{client.geo.country_code}V\\\",\\n  \\\"request\\\":\\\"%{req.request}V\\\",\\n  \\\"host\\\":\\\"%{req.http.Fastly-Orig-Host}V\\\",\\n  \\\"url\\\":\\\"%{json.escape(req.url)}V\\\",\\n  \\\"request_referer\\\":\\\"%{json.escape(req.http.Referer)}V\\\",\\n  \\\"request_user_agent\\\":\\\"%{json.escape(req.http.User-Agent)}V\\\",\\n  \\\"request_accept_language\\\":\\\"%{json.escape(req.http.Accept-Language)}V\\\",\\n  \\\"request_accept_charset\\\":\\\"%{json.escape(req.http.Accept-Charset)}V\\\",\\n  \\\"cache_status\\\":\\\"%{regsub(fastly_info.state, \\\"^(HIT-(SYNTH)|(HITPASS|HIT|MISS|PASS|ERROR|PIPE)).*\\\", \\\"\\\\\\\\2\\\\\\\\3\\\") }V\\\"\\n}\",\"format_version\":\"2\",\"compression_codec\":\"zstd\",\"gzip_level\":\"0\",\"user\":\"test-user@test-project-id.iam.gserviceaccount.com\",\"topic\":\"test-topic\",\"secret_key\":\"-----BEGIN PRIVATE KEY-----\\n...\\n-----END PRIVATE KEY-----\\n\",\"created_at\":\"2020-05-17T20:23:15.000Z\",\"updated_at\":\"2020-05-17T20:23:15.000Z\",\"deleted_at\":null,\"response_condition\":\"\"}"}],"_postman_id":"0e474654-5265-442f-b3d5-a0abf69f7296"},{"name":"Get a GCS log endpoint","id":"51cafbaf-9519-446b-9624-33473261411c","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/gcs/{{logging_gcs_name}}","description":"<p>Get the GCS Logging for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","gcs","{{logging_gcs_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"4d9771c8-2f0a-4c8b-a2bf-6405723237a4","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/gcs/test-log-endpoint","description":"Get the GCS Logging for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"placement\":null,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"name\":\"test-log-endpoint\",\"format\":\"{ \\\"timestamp\\\":\\\"%{begin:%Y-%m-%dT%H:%M:%S}t\\\",\\n  \\\"time_elapsed\\\":%{time.elapsed.usec}V,\\n  \\\"is_tls\\\":%{if(req.is_ssl, \\\"true\\\", \\\"false\\\")}V,\\n  \\\"client_ip\\\":\\\"%{req.http.Fastly-Client-IP}V\\\",\\n  \\\"geo_city\\\":\\\"%{client.geo.city}V\\\",\\n  \\\"geo_country_code\\\":\\\"%{client.geo.country_code}V\\\",\\n  \\\"request\\\":\\\"%{req.request}V\\\",\\n  \\\"host\\\":\\\"%{req.http.Fastly-Orig-Host}V\\\",\\n  \\\"url\\\":\\\"%{json.escape(req.url)}V\\\",\\n  \\\"request_referer\\\":\\\"%{json.escape(req.http.Referer)}V\\\",\\n  \\\"request_user_agent\\\":\\\"%{json.escape(req.http.User-Agent)}V\\\",\\n  \\\"request_accept_language\\\":\\\"%{json.escape(req.http.Accept-Language)}V\\\",\\n  \\\"request_accept_charset\\\":\\\"%{json.escape(req.http.Accept-Charset)}V\\\",\\n  \\\"cache_status\\\":\\\"%{regsub(fastly_info.state, \\\"^(HIT-(SYNTH)|(HITPASS|HIT|MISS|PASS|ERROR|PIPE)).*\\\", \\\"\\\\\\\\2\\\\\\\\3\\\") }V\\\"\\n}\",\"format_version\":\"2\",\"compression_codec\":\"zstd\",\"gzip_level\":\"0\",\"user\":\"test-user@test-project-id.iam.gserviceaccount.com\",\"topic\":\"test-topic\",\"secret_key\":\"-----BEGIN PRIVATE KEY-----\\n...\\n-----END PRIVATE KEY-----\\n\",\"created_at\":\"2020-05-17T20:23:15.000Z\",\"updated_at\":\"2020-05-17T20:23:15.000Z\",\"deleted_at\":null,\"response_condition\":\"\"}"}],"_postman_id":"51cafbaf-9519-446b-9624-33473261411c"},{"name":"Update a GCS log endpoint","id":"7a3df90b-5d30-4413-8435-543a920a5e45","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/gcs/{{logging_gcs_name}}","description":"<p>Update the GCS for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","gcs","{{logging_gcs_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"467b47c0-1388-481f-a51e-c58a359bb90f","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/gcs/test-log-endpoint","description":"Update the GCS for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"placement\":null,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"name\":\"updated-test-log-endpoint\",\"format\":\"{ \\\"timestamp\\\":\\\"%{begin:%Y-%m-%dT%H:%M:%S}t\\\",\\n  \\\"time_elapsed\\\":%{time.elapsed.usec}V,\\n  \\\"is_tls\\\":%{if(req.is_ssl, \\\"true\\\", \\\"false\\\")}V,\\n  \\\"client_ip\\\":\\\"%{req.http.Fastly-Client-IP}V\\\",\\n  \\\"geo_city\\\":\\\"%{client.geo.city}V\\\",\\n  \\\"geo_country_code\\\":\\\"%{client.geo.country_code}V\\\",\\n  \\\"request\\\":\\\"%{req.request}V\\\",\\n  \\\"host\\\":\\\"%{req.http.Fastly-Orig-Host}V\\\",\\n  \\\"url\\\":\\\"%{json.escape(req.url)}V\\\",\\n  \\\"request_referer\\\":\\\"%{json.escape(req.http.Referer)}V\\\",\\n  \\\"request_user_agent\\\":\\\"%{json.escape(req.http.User-Agent)}V\\\",\\n  \\\"request_accept_language\\\":\\\"%{json.escape(req.http.Accept-Language)}V\\\",\\n  \\\"request_accept_charset\\\":\\\"%{json.escape(req.http.Accept-Charset)}V\\\",\\n  \\\"cache_status\\\":\\\"%{regsub(fastly_info.state, \\\"^(HIT-(SYNTH)|(HITPASS|HIT|MISS|PASS|ERROR|PIPE)).*\\\", \\\"\\\\\\\\2\\\\\\\\3\\\") }V\\\"\\n}\",\"format_version\":\"2\",\"compression_codec\":\"zstd\",\"gzip_level\":\"0\",\"user\":\"test-user@test-project-id.iam.gserviceaccount.com\",\"topic\":\"test-topic\",\"secret_key\":\"-----BEGIN PRIVATE KEY-----\\n...\\n-----END PRIVATE KEY-----\\n\",\"created_at\":\"2020-05-17T20:23:15.000Z\",\"updated_at\":\"2020-05-17T20:23:15.000Z\",\"deleted_at\":null,\"response_condition\":\"\"}"}],"_postman_id":"7a3df90b-5d30-4413-8435-543a920a5e45"},{"name":"Delete a GCS log endpoint","id":"88d0d18b-1ce6-46dd-bdf1-09119fe36108","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/gcs/{{logging_gcs_name}}","description":"<p>Delete the GCS Logging for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","gcs","{{logging_gcs_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"6148d2a6-48da-4974-a24b-f812cb6db981","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/gcs/test-log-endpoint","description":"Delete the GCS Logging for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"88d0d18b-1ce6-46dd-bdf1-09119fe36108"}],"id":"16c13994-f2a5-41e3-8823-d91cbff188df","description":"<p>Fastly will upload log messages to the GCS bucket in the format specified in the GCS object.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>bucket_name</td>\n<td>string</td>\n<td>The name of the GCS bucket.</td>\n</tr>\n<tr>\n<td>path</td>\n<td>string</td>\n<td>The path to upload logs to.</td>\n</tr>\n<tr>\n<td>project_id</td>\n<td>string</td>\n<td>Your Google Cloud Platform project ID. Required.</td>\n</tr>\n<tr>\n<td>public_key</td>\n<td>string</td>\n<td>A PGP public key that Fastly will use to encrypt your log files before writing them to disk.</td>\n</tr>\n<tr>\n<td>account_name</td>\n<td>string</td>\n<td>The name of the Google Cloud Platform service account associated with the target log collection service. Not required if user and secret_key are provided.</td>\n</tr>\n<tr>\n<td>compression_codec</td>\n<td>string</td>\n<td>The codec used for compressing your logs. Valid values are zstd, snappy, and gzip. Specifying both compression_codec and gzip_level in the same API request will result in an error.</td>\n</tr>\n<tr>\n<td>format</td>\n<td>string</td>\n<td>A Fastly log format string.</td>\n</tr>\n<tr>\n<td>format_version</td>\n<td>integer</td>\n<td>The version of the custom logging format used for the configured endpoint. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1.</td>\n</tr>\n<tr>\n<td></td>\n<td>1</td>\n<td>Version 1 log format.</td>\n</tr>\n<tr>\n<td></td>\n<td>2</td>\n<td>Version 2 log format.</td>\n</tr>\n<tr>\n<td>gzip_level</td>\n<td>integer</td>\n<td>The level of gzip encoding when sending logs (default 0, no compression). Specifying both compression_codec and gzip_level in the same API request will result in an error.</td>\n</tr>\n<tr>\n<td>log_processing_region</td>\n<td>string</td>\n<td>The geographic region where the logs will be processed before streaming. Valid values are us, eu, and none for global.</td>\n</tr>\n<tr>\n<td>message_type</td>\n<td>string</td>\n<td>How the message should be formatted.</td>\n</tr>\n<tr>\n<td></td>\n<td>classic</td>\n<td>RFC 3164 syslog prefix.</td>\n</tr>\n<tr>\n<td></td>\n<td>loggly</td>\n<td>RFC 5424 structured syslog.</td>\n</tr>\n<tr>\n<td></td>\n<td>logplex</td>\n<td>Heroku-style length prefixed syslog.</td>\n</tr>\n<tr>\n<td></td>\n<td>blank</td>\n<td>No prefix. Useful for writing JSON and CSV.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The name for the real-time logging configuration.</td>\n</tr>\n<tr>\n<td>period</td>\n<td>integer</td>\n<td>How frequently log files are finalized so they can be available for reading (in seconds).</td>\n</tr>\n<tr>\n<td>placement</td>\n<td>string</td>\n<td>Where in the generated VCL the logging call should be placed. If not set, endpoints with format_version of 2 are placed in vcl_log and those with format_version of 1 are placed in vcl_deliver.</td>\n</tr>\n<tr>\n<td></td>\n<td>none</td>\n<td>Do not render a log statement into VCL. Use this option if you intend to write a log statement manually.</td>\n</tr>\n<tr>\n<td>response_condition</td>\n<td>string</td>\n<td>The name of an existing condition in the configured endpoint, or leave blank to always execute.</td>\n</tr>\n<tr>\n<td>secret_key</td>\n<td>string</td>\n<td>Your Google Cloud Platform account secret key. The private_key field in your service account authentication JSON. Not required if account_name is specified.</td>\n</tr>\n<tr>\n<td>timestamp_format</td>\n<td>string</td>\n<td>A timestamp format.</td>\n</tr>\n<tr>\n<td>user</td>\n<td>string</td>\n<td>Your Google Cloud Platform service account email address. The client_email field in your service account authentication JSON. Not required if account_name is specified.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>string</td>\n<td>String identifying a service version.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"16c13994-f2a5-41e3-8823-d91cbff188df"},{"name":"Google Cloud Pub/Sub Logging","item":[{"name":"List GCP Cloud Pub/Sub log endpoints","id":"349b28da-5077-4611-ac0a-6b149c7e7aec","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/pubsub","description":"<p>List all of the Pub/Sub logging objects for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","pubsub"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"7baaecc2-78c8-45f8-b2a6-3b494a923e2f","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/pubsub","description":"List all of the Pub/Sub logging objects for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"placement\":null,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"name\":\"test-log-endpoint\",\"format\":\"{ \\\"timestamp\\\":\\\"%{begin:%Y-%m-%dT%H:%M:%S}t\\\",\\n  \\\"time_elapsed\\\":%{time.elapsed.usec}V,\\n  \\\"is_tls\\\":%{if(req.is_ssl, \\\"true\\\", \\\"false\\\")}V,\\n  \\\"client_ip\\\":\\\"%{req.http.Fastly-Client-IP}V\\\",\\n  \\\"geo_city\\\":\\\"%{client.geo.city}V\\\",\\n  \\\"geo_country_code\\\":\\\"%{client.geo.country_code}V\\\",\\n  \\\"request\\\":\\\"%{req.request}V\\\",\\n  \\\"host\\\":\\\"%{req.http.Fastly-Orig-Host}V\\\",\\n  \\\"url\\\":\\\"%{json.escape(req.url)}V\\\",\\n  \\\"request_referer\\\":\\\"%{json.escape(req.http.Referer)}V\\\",\\n  \\\"request_user_agent\\\":\\\"%{json.escape(req.http.User-Agent)}V\\\",\\n  \\\"request_accept_language\\\":\\\"%{json.escape(req.http.Accept-Language)}V\\\",\\n  \\\"request_accept_charset\\\":\\\"%{json.escape(req.http.Accept-Charset)}V\\\",\\n  \\\"cache_status\\\":\\\"%{regsub(fastly_info.state, \\\"^(HIT-(SYNTH)|(HITPASS|HIT|MISS|PASS|ERROR|PIPE)).*\\\", \\\"\\\\\\\\2\\\\\\\\3\\\") }V\\\"\\n}\",\"format_version\":\"2\",\"user\":\"test-user@test-project-id.iam.gserviceaccount.com\",\"project_id\":\"test-project-id\",\"topic\":\"test-topic\",\"secret_key\":\"-----BEGIN PRIVATE KEY-----\\n...\\n-----END PRIVATE KEY-----\\n\",\"created_at\":\"2020-05-17T20:23:15.000Z\",\"updated_at\":\"2020-05-17T20:23:15.000Z\",\"deleted_at\":null,\"response_condition\":\"\"}]"}],"_postman_id":"349b28da-5077-4611-ac0a-6b149c7e7aec"},{"name":"Create a GCP Cloud Pub/Sub log endpoint","id":"60e1a372-52af-4612-8ca1-a6628ca17d86","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/pubsub","description":"<p>Create a Pub/Sub logging object for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","pubsub"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"ca78312d-5233-4a33-ac73-d1b372554003","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/pubsub","description":"Create a Pub/Sub logging object for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"placement\":null,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"name\":\"test-log-endpoint\",\"format\":\"{ \\\"timestamp\\\":\\\"%{begin:%Y-%m-%dT%H:%M:%S}t\\\",\\n  \\\"time_elapsed\\\":%{time.elapsed.usec}V,\\n  \\\"is_tls\\\":%{if(req.is_ssl, \\\"true\\\", \\\"false\\\")}V,\\n  \\\"client_ip\\\":\\\"%{req.http.Fastly-Client-IP}V\\\",\\n  \\\"geo_city\\\":\\\"%{client.geo.city}V\\\",\\n  \\\"geo_country_code\\\":\\\"%{client.geo.country_code}V\\\",\\n  \\\"request\\\":\\\"%{req.request}V\\\",\\n  \\\"host\\\":\\\"%{req.http.Fastly-Orig-Host}V\\\",\\n  \\\"url\\\":\\\"%{json.escape(req.url)}V\\\",\\n  \\\"request_referer\\\":\\\"%{json.escape(req.http.Referer)}V\\\",\\n  \\\"request_user_agent\\\":\\\"%{json.escape(req.http.User-Agent)}V\\\",\\n  \\\"request_accept_language\\\":\\\"%{json.escape(req.http.Accept-Language)}V\\\",\\n  \\\"request_accept_charset\\\":\\\"%{json.escape(req.http.Accept-Charset)}V\\\",\\n  \\\"cache_status\\\":\\\"%{regsub(fastly_info.state, \\\"^(HIT-(SYNTH)|(HITPASS|HIT|MISS|PASS|ERROR|PIPE)).*\\\", \\\"\\\\\\\\2\\\\\\\\3\\\") }V\\\"\\n}\",\"format_version\":\"2\",\"user\":\"test-user@test-project-id.iam.gserviceaccount.com\",\"project_id\":\"test-project-id\",\"topic\":\"test-topic\",\"secret_key\":\"-----BEGIN PRIVATE KEY-----\\n...\\n-----END PRIVATE KEY-----\\n\",\"created_at\":\"2020-05-17T20:23:15.000Z\",\"updated_at\":\"2020-05-17T20:23:15.000Z\",\"deleted_at\":null,\"response_condition\":\"\"}"}],"_postman_id":"60e1a372-52af-4612-8ca1-a6628ca17d86"},{"name":"Get a GCP Cloud Pub/Sub log endpoint","id":"d384a303-38c6-47f5-bd05-90716eb913be","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/pubsub/{{logging_google_pubsub_name}}","description":"<p>Get the details for a Pub/Sub logging object for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","pubsub","{{logging_google_pubsub_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"c61cc13d-2608-42cb-9ed2-fce43b49bf2f","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/pubsub/test-log-endpoint","description":"Get the details for a Pub/Sub logging object for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"placement\":null,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"name\":\"test-log-endpoint\",\"format\":\"{ \\\"timestamp\\\":\\\"%{begin:%Y-%m-%dT%H:%M:%S}t\\\",\\n  \\\"time_elapsed\\\":%{time.elapsed.usec}V,\\n  \\\"is_tls\\\":%{if(req.is_ssl, \\\"true\\\", \\\"false\\\")}V,\\n  \\\"client_ip\\\":\\\"%{req.http.Fastly-Client-IP}V\\\",\\n  \\\"geo_city\\\":\\\"%{client.geo.city}V\\\",\\n  \\\"geo_country_code\\\":\\\"%{client.geo.country_code}V\\\",\\n  \\\"request\\\":\\\"%{req.request}V\\\",\\n  \\\"host\\\":\\\"%{req.http.Fastly-Orig-Host}V\\\",\\n  \\\"url\\\":\\\"%{json.escape(req.url)}V\\\",\\n  \\\"request_referer\\\":\\\"%{json.escape(req.http.Referer)}V\\\",\\n  \\\"request_user_agent\\\":\\\"%{json.escape(req.http.User-Agent)}V\\\",\\n  \\\"request_accept_language\\\":\\\"%{json.escape(req.http.Accept-Language)}V\\\",\\n  \\\"request_accept_charset\\\":\\\"%{json.escape(req.http.Accept-Charset)}V\\\",\\n  \\\"cache_status\\\":\\\"%{regsub(fastly_info.state, \\\"^(HIT-(SYNTH)|(HITPASS|HIT|MISS|PASS|ERROR|PIPE)).*\\\", \\\"\\\\\\\\2\\\\\\\\3\\\") }V\\\"\\n}\",\"format_version\":\"2\",\"user\":\"test-user@test-project-id.iam.gserviceaccount.com\",\"project_id\":\"test-project-id\",\"topic\":\"test-topic\",\"secret_key\":\"-----BEGIN PRIVATE KEY-----\\n...\\n-----END PRIVATE KEY-----\\n\",\"created_at\":\"2020-05-17T20:23:15.000Z\",\"updated_at\":\"2020-05-17T20:23:15.000Z\",\"deleted_at\":null,\"response_condition\":\"\"}"}],"_postman_id":"d384a303-38c6-47f5-bd05-90716eb913be"},{"name":"Update a GCP Cloud Pub/Sub log endpoint","id":"a3a1acbe-1b8a-4532-b1a5-caf5d60740ad","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/pubsub/{{logging_google_pubsub_name}}","description":"<p>Update a Pub/Sub logging object for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","pubsub","{{logging_google_pubsub_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"b4cf6cf9-722a-4b5a-8627-cb006e82c5d4","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/pubsub/test-log-endpoint","description":"Update a Pub/Sub logging object for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"placement\":null,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"name\":\"test-log-endpoint\",\"format\":\"{ \\\"timestamp\\\":\\\"%{begin:%Y-%m-%dT%H:%M:%S}t\\\",\\n  \\\"time_elapsed\\\":%{time.elapsed.usec}V,\\n  \\\"is_tls\\\":%{if(req.is_ssl, \\\"true\\\", \\\"false\\\")}V,\\n  \\\"client_ip\\\":\\\"%{req.http.Fastly-Client-IP}V\\\",\\n  \\\"geo_city\\\":\\\"%{client.geo.city}V\\\",\\n  \\\"geo_country_code\\\":\\\"%{client.geo.country_code}V\\\",\\n  \\\"request\\\":\\\"%{req.request}V\\\",\\n  \\\"host\\\":\\\"%{req.http.Fastly-Orig-Host}V\\\",\\n  \\\"url\\\":\\\"%{json.escape(req.url)}V\\\",\\n  \\\"request_referer\\\":\\\"%{json.escape(req.http.Referer)}V\\\",\\n  \\\"request_user_agent\\\":\\\"%{json.escape(req.http.User-Agent)}V\\\",\\n  \\\"request_accept_language\\\":\\\"%{json.escape(req.http.Accept-Language)}V\\\",\\n  \\\"request_accept_charset\\\":\\\"%{json.escape(req.http.Accept-Charset)}V\\\",\\n  \\\"cache_status\\\":\\\"%{regsub(fastly_info.state, \\\"^(HIT-(SYNTH)|(HITPASS|HIT|MISS|PASS|ERROR|PIPE)).*\\\", \\\"\\\\\\\\2\\\\\\\\3\\\") }V\\\"\\n}\",\"format_version\":\"2\",\"user\":\"test-user@test-project-id.iam.gserviceaccount.com\",\"project_id\":\"test-project-id\",\"topic\":\"updated-test-topic\",\"secret_key\":\"-----BEGIN PRIVATE KEY-----\\n...\\n-----END PRIVATE KEY-----\\n\",\"created_at\":\"2020-05-17T20:23:15.000Z\",\"updated_at\":\"2020-05-17T20:23:15.000Z\",\"deleted_at\":null,\"response_condition\":\"\"}"}],"_postman_id":"a3a1acbe-1b8a-4532-b1a5-caf5d60740ad"},{"name":"Delete a GCP Cloud Pub/Sub log endpoint","id":"73be3c10-8bc5-45e2-8a49-c033cef16623","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/pubsub/{{logging_google_pubsub_name}}","description":"<p>Delete a Pub/Sub logging object for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","pubsub","{{logging_google_pubsub_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"fb7e223c-8dec-4335-b8d7-a892ee3356fe","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/pubsub/test-log-endpoint","description":"Delete a Pub/Sub logging object for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"73be3c10-8bc5-45e2-8a49-c033cef16623"}],"id":"a5bb5f12-ad17-4633-a832-48f2df3bcaf6","description":"<p>Fastly will publish log messages to a Google Cloud Pub/Sub topic in the format specified in the Pub/Sub logging object.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>format</td>\n<td>string</td>\n<td>A Fastly log format string.</td>\n</tr>\n<tr>\n<td>project_id</td>\n<td>string</td>\n<td>Your Google Cloud Platform project ID. Required.</td>\n</tr>\n<tr>\n<td>topic</td>\n<td>string</td>\n<td>The Google Cloud Pub/Sub topic to which logs will be published. Required.</td>\n</tr>\n<tr>\n<td>account_name</td>\n<td>string</td>\n<td>The name of the Google Cloud Platform service account associated with the target log collection service. Not required if user and secret_key are provided.</td>\n</tr>\n<tr>\n<td>format_version</td>\n<td>integer</td>\n<td>The version of the custom logging format used for the configured endpoint. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1.</td>\n</tr>\n<tr>\n<td></td>\n<td>1</td>\n<td>Version 1 log format.</td>\n</tr>\n<tr>\n<td></td>\n<td>2</td>\n<td>Version 2 log format.</td>\n</tr>\n<tr>\n<td>log_processing_region</td>\n<td>string</td>\n<td>The geographic region where the logs will be processed before streaming. Valid values are us, eu, and none for global.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The name for the real-time logging configuration.</td>\n</tr>\n<tr>\n<td>placement</td>\n<td>string</td>\n<td>Where in the generated VCL the logging call should be placed. If not set, endpoints with format_version of 2 are placed in vcl_log and those with format_version of 1 are placed in vcl_deliver.</td>\n</tr>\n<tr>\n<td></td>\n<td>none</td>\n<td>Do not render a log statement into VCL. Use this option if you intend to write a log statement manually.</td>\n</tr>\n<tr>\n<td>response_condition</td>\n<td>string</td>\n<td>The name of an existing condition in the configured endpoint, or leave blank to always execute.</td>\n</tr>\n<tr>\n<td>secret_key</td>\n<td>string</td>\n<td>Your Google Cloud Platform account secret key. The private_key field in your service account authentication JSON. Not required if account_name is specified.</td>\n</tr>\n<tr>\n<td>user</td>\n<td>string</td>\n<td>Your Google Cloud Platform service account email address. The client_email field in your service account authentication JSON. Not required if account_name is specified.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>string</td>\n<td>String identifying a service version.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"a5bb5f12-ad17-4633-a832-48f2df3bcaf6"},{"name":"Grafana Cloud Logs Logging","item":[{"name":"List Grafana Cloud Logs log endpoints","id":"ac821373-5f77-4a6f-8058-0a08ccc0e08b","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/grafanacloudlogs","description":"<p>List all of the Grafana Cloud Logs logging objects for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","grafanacloudlogs"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"8f3e1245-e12d-4324-9614-46e1760a380e","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/grafanacloudlogs","description":"List all of the Grafana Cloud Logs logging objects for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"placement\":null,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"name\":\"test-log-endpoint\",\"format\":\"{ \\\"timestamp\\\":\\\"%{begin:%Y-%m-%dT%H:%M:%S}t\\\",\\n  \\\"time_elapsed\\\":%{time.elapsed.usec}V,\\n  \\\"is_tls\\\":%{if(req.is_ssl, \\\"true\\\", \\\"false\\\")}V,\\n  \\\"client_ip\\\":\\\"%{req.http.Fastly-Client-IP}V\\\",\\n  \\\"geo_city\\\":\\\"%{client.geo.city}V\\\",\\n  \\\"geo_country_code\\\":\\\"%{client.geo.country_code}V\\\",\\n  \\\"request\\\":\\\"%{req.request}V\\\",\\n  \\\"host\\\":\\\"%{req.http.Fastly-Orig-Host}V\\\",\\n  \\\"url\\\":\\\"%{json.escape(req.url)}V\\\",\\n  \\\"request_referer\\\":\\\"%{json.escape(req.http.Referer)}V\\\",\\n  \\\"request_user_agent\\\":\\\"%{json.escape(req.http.User-Agent)}V\\\",\\n  \\\"request_accept_language\\\":\\\"%{json.escape(req.http.Accept-Language)}V\\\",\\n  \\\"request_accept_charset\\\":\\\"%{json.escape(req.http.Accept-Charset)}V\\\",\\n  \\\"cache_status\\\":\\\"%{regsub(fastly_info.state, \\\"^(HIT-(SYNTH)|(HITPASS|HIT|MISS|PASS|ERROR|PIPE)).*\\\", \\\"\\\\\\\\2\\\\\\\\3\\\") }V\\\"\\n}\",\"format_version\":\"2\",\"token\":\"6f5902ac237024bdd0c176cb9306TEST\",\"user\":\"123456\",\"index\":\"{ \\\"app\\\": \\\"test\\\", \\\"env\\\": \\\"staging\\\" }\",\"url\":\"https://testhost-123.grafana.net\",\"response_condition\":\"\",\"created_at\":\"2020-05-17T20:23:15.000Z\",\"updated_at\":\"2020-05-17T20:23:15.000Z\",\"deleted_at\":null}]"}],"_postman_id":"ac821373-5f77-4a6f-8058-0a08ccc0e08b"},{"name":"Create a Grafana Cloud Logs log endpoint","id":"1bfc38c8-5e12-4583-a01d-64d8d2026ef3","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/grafanacloudlogs","description":"<p>Create a Grafana Cloud Logs logging object for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","grafanacloudlogs"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"6b3d1e13-9645-4c0e-8693-a0214ea13c5d","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/grafanacloudlogs","description":"Create a Grafana Cloud Logs logging object for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"placement\":null,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"name\":\"test-log-endpoint\",\"format\":\"{ \\\"timestamp\\\":\\\"%{begin:%Y-%m-%dT%H:%M:%S}t\\\",\\n  \\\"time_elapsed\\\":%{time.elapsed.usec}V,\\n  \\\"is_tls\\\":%{if(req.is_ssl, \\\"true\\\", \\\"false\\\")}V,\\n  \\\"client_ip\\\":\\\"%{req.http.Fastly-Client-IP}V\\\",\\n  \\\"geo_city\\\":\\\"%{client.geo.city}V\\\",\\n  \\\"geo_country_code\\\":\\\"%{client.geo.country_code}V\\\",\\n  \\\"request\\\":\\\"%{req.request}V\\\",\\n  \\\"host\\\":\\\"%{req.http.Fastly-Orig-Host}V\\\",\\n  \\\"url\\\":\\\"%{json.escape(req.url)}V\\\",\\n  \\\"request_referer\\\":\\\"%{json.escape(req.http.Referer)}V\\\",\\n  \\\"request_user_agent\\\":\\\"%{json.escape(req.http.User-Agent)}V\\\",\\n  \\\"request_accept_language\\\":\\\"%{json.escape(req.http.Accept-Language)}V\\\",\\n  \\\"request_accept_charset\\\":\\\"%{json.escape(req.http.Accept-Charset)}V\\\",\\n  \\\"cache_status\\\":\\\"%{regsub(fastly_info.state, \\\"^(HIT-(SYNTH)|(HITPASS|HIT|MISS|PASS|ERROR|PIPE)).*\\\", \\\"\\\\\\\\2\\\\\\\\3\\\") }V\\\"\\n}\",\"format_version\":\"2\",\"token\":\"6f5902ac237024bdd0c176cb9306TEST\",\"user\":\"123456\",\"index\":\"{ \\\"app\\\": \\\"test\\\", \\\"env\\\": \\\"staging\\\" }\",\"url\":\"https://testhost-123.grafana.net\",\"response_condition\":\"\",\"created_at\":\"2020-05-17T20:23:15.000Z\",\"updated_at\":\"2020-05-17T20:23:15.000Z\",\"deleted_at\":null}"}],"_postman_id":"1bfc38c8-5e12-4583-a01d-64d8d2026ef3"},{"name":"Get a Grafana Cloud Logs log endpoint","id":"8ba883df-98f5-4e34-91f2-e86e3ebbb938","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/grafanacloudlogs/{{logging_grafanacloudlogs_name}}","description":"<p>Get the details of a Grafana Cloud Logs logging object for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","grafanacloudlogs","{{logging_grafanacloudlogs_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"c252f8a7-e825-4f1c-b465-efe2af856eb3","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/grafanacloudlogs/test-log-endpoint","description":"Get the details of a Grafana Cloud Logs logging object for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"placement\":null,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"name\":\"test-log-endpoint\",\"format\":\"{ \\\"timestamp\\\":\\\"%{begin:%Y-%m-%dT%H:%M:%S}t\\\",\\n  \\\"time_elapsed\\\":%{time.elapsed.usec}V,\\n  \\\"is_tls\\\":%{if(req.is_ssl, \\\"true\\\", \\\"false\\\")}V,\\n  \\\"client_ip\\\":\\\"%{req.http.Fastly-Client-IP}V\\\",\\n  \\\"geo_city\\\":\\\"%{client.geo.city}V\\\",\\n  \\\"geo_country_code\\\":\\\"%{client.geo.country_code}V\\\",\\n  \\\"request\\\":\\\"%{req.request}V\\\",\\n  \\\"host\\\":\\\"%{req.http.Fastly-Orig-Host}V\\\",\\n  \\\"url\\\":\\\"%{json.escape(req.url)}V\\\",\\n  \\\"request_referer\\\":\\\"%{json.escape(req.http.Referer)}V\\\",\\n  \\\"request_user_agent\\\":\\\"%{json.escape(req.http.User-Agent)}V\\\",\\n  \\\"request_accept_language\\\":\\\"%{json.escape(req.http.Accept-Language)}V\\\",\\n  \\\"request_accept_charset\\\":\\\"%{json.escape(req.http.Accept-Charset)}V\\\",\\n  \\\"cache_status\\\":\\\"%{regsub(fastly_info.state, \\\"^(HIT-(SYNTH)|(HITPASS|HIT|MISS|PASS|ERROR|PIPE)).*\\\", \\\"\\\\\\\\2\\\\\\\\3\\\") }V\\\"\\n}\",\"format_version\":\"2\",\"token\":\"6f5902ac237024bdd0c176cb9306TEST\",\"user\":\"123456\",\"index\":\"{ \\\"app\\\": \\\"test\\\", \\\"env\\\": \\\"staging\\\" }\",\"url\":\"https://testhost-123.grafana.net\",\"response_condition\":\"\",\"created_at\":\"2020-05-17T20:23:15.000Z\",\"updated_at\":\"2020-05-17T20:23:15.000Z\",\"deleted_at\":null}"}],"_postman_id":"8ba883df-98f5-4e34-91f2-e86e3ebbb938"},{"name":"Update a Grafana Cloud Logs log endpoint","id":"f4360cff-d9ac-4af3-a009-d37803c31e81","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/grafanacloudlogs/{{logging_grafanacloudlogs_name}}","description":"<p>Update a Grafana Cloud Logs logging object for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","grafanacloudlogs","{{logging_grafanacloudlogs_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"fd5a48d0-4db2-4c82-8694-97a20807e532","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/grafanacloudlogs/test-log-endpoint","description":"Update a Grafana Cloud Logs logging object for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"placement\":null,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"name\":\"updated-test-log-endpoint\",\"format\":\"{ \\\"timestamp\\\":\\\"%{begin:%Y-%m-%dT%H:%M:%S}t\\\",\\n  \\\"time_elapsed\\\":%{time.elapsed.usec}V,\\n  \\\"is_tls\\\":%{if(req.is_ssl, \\\"true\\\", \\\"false\\\")}V,\\n  \\\"client_ip\\\":\\\"%{req.http.Fastly-Client-IP}V\\\",\\n  \\\"geo_city\\\":\\\"%{client.geo.city}V\\\",\\n  \\\"geo_country_code\\\":\\\"%{client.geo.country_code}V\\\",\\n  \\\"request\\\":\\\"%{req.request}V\\\",\\n  \\\"host\\\":\\\"%{req.http.Fastly-Orig-Host}V\\\",\\n  \\\"url\\\":\\\"%{json.escape(req.url)}V\\\",\\n  \\\"request_referer\\\":\\\"%{json.escape(req.http.Referer)}V\\\",\\n  \\\"request_user_agent\\\":\\\"%{json.escape(req.http.User-Agent)}V\\\",\\n  \\\"request_accept_language\\\":\\\"%{json.escape(req.http.Accept-Language)}V\\\",\\n  \\\"request_accept_charset\\\":\\\"%{json.escape(req.http.Accept-Charset)}V\\\",\\n  \\\"cache_status\\\":\\\"%{regsub(fastly_info.state, \\\"^(HIT-(SYNTH)|(HITPASS|HIT|MISS|PASS|ERROR|PIPE)).*\\\", \\\"\\\\\\\\2\\\\\\\\3\\\") }V\\\"\\n}\",\"format_version\":\"2\",\"token\":\"6f5902ac237024bdd0c176cb9306TEST\",\"user\":\"123456\",\"index\":\"{ \\\"app\\\": \\\"test\\\", \\\"env\\\": \\\"staging\\\" }\",\"url\":\"https://testhost-123.grafana.net\",\"response_condition\":\"\",\"created_at\":\"2020-05-17T20:23:15.000Z\",\"updated_at\":\"2020-05-17T20:23:15.000Z\",\"deleted_at\":null}"}],"_postman_id":"f4360cff-d9ac-4af3-a009-d37803c31e81"},{"name":"Delete the Grafana Cloud Logs log endpoint","id":"0489b25d-a6fd-4ae9-a6d9-9148c5a61091","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/grafanacloudlogs/{{logging_grafanacloudlogs_name}}","description":"<p>Delete the Grafana Cloud Logs logging object for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","grafanacloudlogs","{{logging_grafanacloudlogs_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"c2b56c86-ad14-457c-a202-fb05843ef7c7","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/grafanacloudlogs/test-log-endpoint","description":"Delete the Grafana Cloud Logs logging object for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"0489b25d-a6fd-4ae9-a6d9-9148c5a61091"}],"id":"d5b96e16-0401-4638-91a7-d05741f287c7","description":"<p>Fastly will upload log messages to Grafana Cloud Logs.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>format</td>\n<td>string</td>\n<td>A Fastly log format string.</td>\n</tr>\n<tr>\n<td>index</td>\n<td>string</td>\n<td>The Stream Labels, a JSON string used to identify the stream.</td>\n</tr>\n<tr>\n<td>token</td>\n<td>string</td>\n<td>The Grafana Access Policy token with logs:write access scoped to your Loki instance.</td>\n</tr>\n<tr>\n<td>url</td>\n<td>string</td>\n<td>The URL of the Loki instance in your Grafana stack.</td>\n</tr>\n<tr>\n<td>user</td>\n<td>string</td>\n<td>The Grafana Cloud Logs Dataset you want to log to.</td>\n</tr>\n<tr>\n<td>format_version</td>\n<td>integer</td>\n<td>The version of the custom logging format used for the configured endpoint. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1.</td>\n</tr>\n<tr>\n<td></td>\n<td>1</td>\n<td>Version 1 log format.</td>\n</tr>\n<tr>\n<td></td>\n<td>2</td>\n<td>Version 2 log format.</td>\n</tr>\n<tr>\n<td>log_processing_region</td>\n<td>string</td>\n<td>The geographic region where the logs will be processed before streaming. Valid values are us, eu, and none for global.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The name for the real-time logging configuration.</td>\n</tr>\n<tr>\n<td>placement</td>\n<td>string</td>\n<td>Where in the generated VCL the logging call should be placed. If not set, endpoints with format_version of 2 are placed in vcl_log and those with format_version of 1 are placed in vcl_deliver.</td>\n</tr>\n<tr>\n<td></td>\n<td>none</td>\n<td>Do not render a log statement into VCL. Use this option if you intend to write a log statement manually.</td>\n</tr>\n<tr>\n<td>response_condition</td>\n<td>string</td>\n<td>The name of an existing condition in the configured endpoint, or leave blank to always execute.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>string</td>\n<td>String identifying a service version.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"d5b96e16-0401-4638-91a7-d05741f287c7"},{"name":"Heroku","item":[{"name":"List Heroku log endpoints","id":"d42e95ef-5bf2-44a0-9ff5-1aca346b419f","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/heroku","description":"<p>List all of the Herokus for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","heroku"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"ffbf1dfb-e9c4-427a-8faa-ed10e256f394","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/heroku","description":"List all of the Herokus for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"name\":\"test-log-endpoint\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"response_condition\":\"\",\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"placement\":null,\"token\":\"test-token\",\"url\":\"https://1.us.logplex.io/logs\"}]"}],"_postman_id":"d42e95ef-5bf2-44a0-9ff5-1aca346b419f"},{"name":"Create a Heroku log endpoint","id":"82054c3c-af33-4348-b9c1-41ef5f17ca82","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/heroku","description":"<p>Create a Heroku for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","heroku"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"219416da-6d8b-4929-aabf-f4b858d8507e","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/heroku","description":"Create a Heroku for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"name\":\"test-log-endpoint\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"response_condition\":\"\",\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"placement\":null,\"token\":\"test-token\",\"url\":\"https://1.us.logplex.io/logs\"}"}],"_postman_id":"82054c3c-af33-4348-b9c1-41ef5f17ca82"},{"name":"Get a Heroku log endpoint","id":"f78b3ea0-be4b-445b-b3fd-8a84b1d596f6","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/heroku/{{logging_heroku_name}}","description":"<p>Get the Heroku for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","heroku","{{logging_heroku_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"e0aecfce-1c02-4c0e-a842-2f5c00d1b755","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/heroku/test-log-endpoint","description":"Get the Heroku for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"name\":\"test-log-endpoint\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"response_condition\":\"\",\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"placement\":null,\"token\":\"test-token\",\"url\":\"https://1.us.logplex.io/logs\"}"}],"_postman_id":"f78b3ea0-be4b-445b-b3fd-8a84b1d596f6"},{"name":"Update the Heroku log endpoint","id":"57ba4a8e-f1ec-482e-81eb-a6034dd2971f","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/heroku/{{logging_heroku_name}}","description":"<p>Update the Heroku for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","heroku","{{logging_heroku_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"8cb20325-efbf-433b-91e8-421a54808e72","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/heroku/test-log-endpoint","description":"Update the Heroku for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"name\":\"updated-test-log-endpoint\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"response_condition\":\"\",\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"placement\":null,\"token\":\"test-token\",\"url\":\"https://1.us.logplex.io/logs\"}"}],"_postman_id":"57ba4a8e-f1ec-482e-81eb-a6034dd2971f"},{"name":"Delete the Heroku log endpoint","id":"72ca49b6-0fd7-4570-9e9c-5631ecb4ab42","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/heroku/{{logging_heroku_name}}","description":"<p>Delete the Heroku for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","heroku","{{logging_heroku_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"79d47e99-5462-486f-806a-6300203ae35c","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/heroku/test-log-endpoint","description":"Delete the Heroku for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"72ca49b6-0fd7-4570-9e9c-5631ecb4ab42"}],"id":"1bbd6ed2-052b-465a-9d61-e4b137e2913e","description":"<p>Fastly will stream log messages to the Heroku account in the format specified in the Heroku object.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>token</td>\n<td>string</td>\n<td>The token to use for authentication (<a href=\"https://devcenter.heroku.com/articles/add-on-partner-log-integration\">https://devcenter.heroku.com/articles/add-on-partner-log-integration</a>).</td>\n</tr>\n<tr>\n<td>url</td>\n<td>string</td>\n<td>The URL to stream logs to.</td>\n</tr>\n<tr>\n<td>format</td>\n<td>string</td>\n<td>A Fastly log format string.</td>\n</tr>\n<tr>\n<td>format_version</td>\n<td>integer</td>\n<td>The version of the custom logging format used for the configured endpoint. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1.</td>\n</tr>\n<tr>\n<td></td>\n<td>1</td>\n<td>Version 1 log format.</td>\n</tr>\n<tr>\n<td></td>\n<td>2</td>\n<td>Version 2 log format.</td>\n</tr>\n<tr>\n<td>log_processing_region</td>\n<td>string</td>\n<td>The geographic region where the logs will be processed before streaming. Valid values are us, eu, and none for global.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The name for the real-time logging configuration.</td>\n</tr>\n<tr>\n<td>placement</td>\n<td>string</td>\n<td>Where in the generated VCL the logging call should be placed. If not set, endpoints with format_version of 2 are placed in vcl_log and those with format_version of 1 are placed in vcl_deliver.</td>\n</tr>\n<tr>\n<td></td>\n<td>none</td>\n<td>Do not render a log statement into VCL. Use this option if you intend to write a log statement manually.</td>\n</tr>\n<tr>\n<td>response_condition</td>\n<td>string</td>\n<td>The name of an existing condition in the configured endpoint, or leave blank to always execute.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>string</td>\n<td>String identifying a service version.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"1bbd6ed2-052b-465a-9d61-e4b137e2913e"},{"name":"Honeycomb Logging","item":[{"name":"List Honeycomb log endpoints","id":"0b474826-5ab5-4849-9768-fb3959a65b93","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/honeycomb","description":"<p>List all of the Honeycomb logging objects for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","honeycomb"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"1952f353-79e2-4512-a15b-0f134c8c3db0","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/honeycomb","description":"List all of the Honeycomb logging objects for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"placement\":null,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"name\":\"test-log-endpoint\",\"format\":\"{ \\\"timestamp\\\":\\\"%{begin:%Y-%m-%dT%H:%M:%S}t\\\",\\n  \\\"time_elapsed\\\":%{time.elapsed.usec}V,\\n  \\\"is_tls\\\":%{if(req.is_ssl, \\\"true\\\", \\\"false\\\")}V,\\n  \\\"client_ip\\\":\\\"%{req.http.Fastly-Client-IP}V\\\",\\n  \\\"geo_city\\\":\\\"%{client.geo.city}V\\\",\\n  \\\"geo_country_code\\\":\\\"%{client.geo.country_code}V\\\",\\n  \\\"request\\\":\\\"%{req.request}V\\\",\\n  \\\"host\\\":\\\"%{req.http.Fastly-Orig-Host}V\\\",\\n  \\\"url\\\":\\\"%{json.escape(req.url)}V\\\",\\n  \\\"request_referer\\\":\\\"%{json.escape(req.http.Referer)}V\\\",\\n  \\\"request_user_agent\\\":\\\"%{json.escape(req.http.User-Agent)}V\\\",\\n  \\\"request_accept_language\\\":\\\"%{json.escape(req.http.Accept-Language)}V\\\",\\n  \\\"request_accept_charset\\\":\\\"%{json.escape(req.http.Accept-Charset)}V\\\",\\n  \\\"cache_status\\\":\\\"%{regsub(fastly_info.state, \\\"^(HIT-(SYNTH)|(HITPASS|HIT|MISS|PASS|ERROR|PIPE)).*\\\", \\\"\\\\\\\\2\\\\\\\\3\\\") }V\\\"\\n}\",\"format_version\":\"2\",\"dataset\":\"fastly_honeycomb\",\"token\":\"6f5902ac237024bdd0c176cb9306TEST\",\"response_condition\":\"\",\"created_at\":\"2020-05-17T20:23:15.000Z\",\"updated_at\":\"2020-05-17T20:23:15.000Z\",\"deleted_at\":null}]"}],"_postman_id":"0b474826-5ab5-4849-9768-fb3959a65b93"},{"name":"Create a Honeycomb log endpoint","id":"96e08de9-0972-42b8-b032-a1636a2a1aad","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/honeycomb","description":"<p>Create a Honeycomb logging object for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","honeycomb"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"005db499-f794-4720-8773-77efe6de6cbc","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/honeycomb","description":"Create a Honeycomb logging object for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"placement\":null,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"name\":\"test-log-endpoint\",\"format\":\"{ \\\"timestamp\\\":\\\"%{begin:%Y-%m-%dT%H:%M:%S}t\\\",\\n  \\\"time_elapsed\\\":%{time.elapsed.usec}V,\\n  \\\"is_tls\\\":%{if(req.is_ssl, \\\"true\\\", \\\"false\\\")}V,\\n  \\\"client_ip\\\":\\\"%{req.http.Fastly-Client-IP}V\\\",\\n  \\\"geo_city\\\":\\\"%{client.geo.city}V\\\",\\n  \\\"geo_country_code\\\":\\\"%{client.geo.country_code}V\\\",\\n  \\\"request\\\":\\\"%{req.request}V\\\",\\n  \\\"host\\\":\\\"%{req.http.Fastly-Orig-Host}V\\\",\\n  \\\"url\\\":\\\"%{json.escape(req.url)}V\\\",\\n  \\\"request_referer\\\":\\\"%{json.escape(req.http.Referer)}V\\\",\\n  \\\"request_user_agent\\\":\\\"%{json.escape(req.http.User-Agent)}V\\\",\\n  \\\"request_accept_language\\\":\\\"%{json.escape(req.http.Accept-Language)}V\\\",\\n  \\\"request_accept_charset\\\":\\\"%{json.escape(req.http.Accept-Charset)}V\\\",\\n  \\\"cache_status\\\":\\\"%{regsub(fastly_info.state, \\\"^(HIT-(SYNTH)|(HITPASS|HIT|MISS|PASS|ERROR|PIPE)).*\\\", \\\"\\\\\\\\2\\\\\\\\3\\\") }V\\\"\\n}\",\"format_version\":\"2\",\"dataset\":\"fastly_honeycomb\",\"token\":\"6f5902ac237024bdd0c176cb9306TEST\",\"response_condition\":\"\",\"created_at\":\"2020-05-17T20:23:15.000Z\",\"updated_at\":\"2020-05-17T20:23:15.000Z\",\"deleted_at\":null}"}],"_postman_id":"96e08de9-0972-42b8-b032-a1636a2a1aad"},{"name":"Get a Honeycomb log endpoint","id":"467732cd-476e-44d8-b668-0b9c72e1fac8","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/honeycomb/{{logging_honeycomb_name}}","description":"<p>Get the details of a Honeycomb logging object for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","honeycomb","{{logging_honeycomb_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"652902f1-f6df-4fa9-85d9-242a0312fe6c","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/honeycomb/test-log-endpoint","description":"Get the details of a Honeycomb logging object for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"placement\":null,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"name\":\"test-log-endpoint\",\"format\":\"{ \\\"timestamp\\\":\\\"%{begin:%Y-%m-%dT%H:%M:%S}t\\\",\\n  \\\"time_elapsed\\\":%{time.elapsed.usec}V,\\n  \\\"is_tls\\\":%{if(req.is_ssl, \\\"true\\\", \\\"false\\\")}V,\\n  \\\"client_ip\\\":\\\"%{req.http.Fastly-Client-IP}V\\\",\\n  \\\"geo_city\\\":\\\"%{client.geo.city}V\\\",\\n  \\\"geo_country_code\\\":\\\"%{client.geo.country_code}V\\\",\\n  \\\"request\\\":\\\"%{req.request}V\\\",\\n  \\\"host\\\":\\\"%{req.http.Fastly-Orig-Host}V\\\",\\n  \\\"url\\\":\\\"%{json.escape(req.url)}V\\\",\\n  \\\"request_referer\\\":\\\"%{json.escape(req.http.Referer)}V\\\",\\n  \\\"request_user_agent\\\":\\\"%{json.escape(req.http.User-Agent)}V\\\",\\n  \\\"request_accept_language\\\":\\\"%{json.escape(req.http.Accept-Language)}V\\\",\\n  \\\"request_accept_charset\\\":\\\"%{json.escape(req.http.Accept-Charset)}V\\\",\\n  \\\"cache_status\\\":\\\"%{regsub(fastly_info.state, \\\"^(HIT-(SYNTH)|(HITPASS|HIT|MISS|PASS|ERROR|PIPE)).*\\\", \\\"\\\\\\\\2\\\\\\\\3\\\") }V\\\"\\n}\",\"format_version\":\"2\",\"dataset\":\"fastly_honeycomb\",\"token\":\"6f5902ac237024bdd0c176cb9306TEST\",\"response_condition\":\"\",\"created_at\":\"2020-05-17T20:23:15.000Z\",\"updated_at\":\"2020-05-17T20:23:15.000Z\",\"deleted_at\":null}"}],"_postman_id":"467732cd-476e-44d8-b668-0b9c72e1fac8"},{"name":"Update a Honeycomb log endpoint","id":"3a71160f-aab4-49d1-8b73-736782cb6521","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/honeycomb/{{logging_honeycomb_name}}","description":"<p>Update a Honeycomb logging object for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","honeycomb","{{logging_honeycomb_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"197e73b0-e7c5-4f0f-8369-1ad60104c370","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/honeycomb/test-log-endpoint","description":"Update a Honeycomb logging object for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"placement\":null,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"name\":\"updated-test-log-endpoint\",\"format\":\"{ \\\"timestamp\\\":\\\"%{begin:%Y-%m-%dT%H:%M:%S}t\\\",\\n  \\\"time_elapsed\\\":%{time.elapsed.usec}V,\\n  \\\"is_tls\\\":%{if(req.is_ssl, \\\"true\\\", \\\"false\\\")}V,\\n  \\\"client_ip\\\":\\\"%{req.http.Fastly-Client-IP}V\\\",\\n  \\\"geo_city\\\":\\\"%{client.geo.city}V\\\",\\n  \\\"geo_country_code\\\":\\\"%{client.geo.country_code}V\\\",\\n  \\\"request\\\":\\\"%{req.request}V\\\",\\n  \\\"host\\\":\\\"%{req.http.Fastly-Orig-Host}V\\\",\\n  \\\"url\\\":\\\"%{json.escape(req.url)}V\\\",\\n  \\\"request_referer\\\":\\\"%{json.escape(req.http.Referer)}V\\\",\\n  \\\"request_user_agent\\\":\\\"%{json.escape(req.http.User-Agent)}V\\\",\\n  \\\"request_accept_language\\\":\\\"%{json.escape(req.http.Accept-Language)}V\\\",\\n  \\\"request_accept_charset\\\":\\\"%{json.escape(req.http.Accept-Charset)}V\\\",\\n  \\\"cache_status\\\":\\\"%{regsub(fastly_info.state, \\\"^(HIT-(SYNTH)|(HITPASS|HIT|MISS|PASS|ERROR|PIPE)).*\\\", \\\"\\\\\\\\2\\\\\\\\3\\\") }V\\\"\\n}\",\"format_version\":\"2\",\"dataset\":\"fastly_honeycomb\",\"token\":\"6f5902ac237024bdd0c176cb9306TEST\",\"response_condition\":\"\",\"created_at\":\"2020-05-17T20:23:15.000Z\",\"updated_at\":\"2020-05-17T20:23:15.000Z\",\"deleted_at\":null}"}],"_postman_id":"3a71160f-aab4-49d1-8b73-736782cb6521"},{"name":"Delete the Honeycomb log endpoint","id":"32c1d88d-80a4-422b-9cea-164657669ffc","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/honeycomb/{{logging_honeycomb_name}}","description":"<p>Delete the Honeycomb logging object for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","honeycomb","{{logging_honeycomb_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"6fe4224c-1c5f-46a6-a4f9-28c5b3c0868b","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/honeycomb/test-log-endpoint","description":"Delete the Honeycomb logging object for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"32c1d88d-80a4-422b-9cea-164657669ffc"}],"id":"f65ac8b6-be9b-4427-8eaa-37cbb81d7025","description":"<p>Fastly will upload log messages to Honeycomb.io in the format specified in the Honeycomb object.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>dataset</td>\n<td>string</td>\n<td>The Honeycomb Dataset you want to log to.</td>\n</tr>\n<tr>\n<td>format</td>\n<td>string</td>\n<td>A Fastly log format string. Must produce valid JSON that Honeycomb can ingest.</td>\n</tr>\n<tr>\n<td>token</td>\n<td>string</td>\n<td>The Write Key from the Account page of your Honeycomb account.</td>\n</tr>\n<tr>\n<td>format_version</td>\n<td>integer</td>\n<td>The version of the custom logging format used for the configured endpoint. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1.</td>\n</tr>\n<tr>\n<td></td>\n<td>1</td>\n<td>Version 1 log format.</td>\n</tr>\n<tr>\n<td></td>\n<td>2</td>\n<td>Version 2 log format.</td>\n</tr>\n<tr>\n<td>log_processing_region</td>\n<td>string</td>\n<td>The geographic region where the logs will be processed before streaming. Valid values are us, eu, and none for global.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The name for the real-time logging configuration.</td>\n</tr>\n<tr>\n<td>placement</td>\n<td>string</td>\n<td>Where in the generated VCL the logging call should be placed. If not set, endpoints with format_version of 2 are placed in vcl_log and those with format_version of 1 are placed in vcl_deliver.</td>\n</tr>\n<tr>\n<td></td>\n<td>none</td>\n<td>Do not render a log statement into VCL. Use this option if you intend to write a log statement manually.</td>\n</tr>\n<tr>\n<td>response_condition</td>\n<td>string</td>\n<td>The name of an existing condition in the configured endpoint, or leave blank to always execute.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>string</td>\n<td>String identifying a service version.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"f65ac8b6-be9b-4427-8eaa-37cbb81d7025"},{"name":"HTTPS","item":[{"name":"List HTTPS log endpoints","id":"81b7fe78-3478-40aa-b4d3-83a2c8251cf7","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/https","description":"<p>List all of the HTTPS objects for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","https"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"67b96c98-c809-46fc-af48-e8340bb795a1","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/https","description":"List all of the HTTPS objects for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"name\":\"test-log-endpoint\",\"url\":\"https://example.com/logging/endpoint\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"request_max_entries\":0,\"request_max_bytes\":0,\"header_name\":null,\"method\":\"POST\",\"updated_at\":\"2020-03-05T15:25:17.000Z\",\"content_type\":null,\"response_condition\":\"\",\"tls_client_key\":null,\"message_type\":\"blank\",\"deleted_at\":null,\"tls_client_cert\":null,\"header_value\":null,\"tls_hostname\":null,\"format_version\":\"2\",\"json_format\":\"0\",\"tls_ca_cert\":null,\"period\":5,\"placement\":null,\"created_at\":\"2020-03-05T15:25:17.000Z\",\"format\":\"{ \\\"timestamp\\\":\\\"%{begin:%Y-%m-%dT%H:%M:%S}t\\\",\\n  \\\"time_elapsed\\\":%{time.elapsed.usec}V,\\n  \\\"is_tls\\\":%{if(req.is_ssl, \\\"true\\\", \\\"false\\\")}V,\\n  \\\"client_ip\\\":\\\"%{req.http.Fastly-Client-IP}V\\\",\\n  \\\"geo_city\\\":\\\"%{client.geo.city}V\\\",\\n  \\\"geo_country_code\\\":\\\"%{client.geo.country_code}V\\\",\\n  \\\"request\\\":\\\"%{req.request}V\\\",\\n  \\\"host\\\":\\\"%{req.http.Fastly-Orig-Host}V\\\",\\n  \\\"url\\\":\\\"%{json.escape(req.url)}V\\\",\\n  \\\"request_referer\\\":\\\"%{json.escape(req.http.Referer)}V\\\",\\n  \\\"request_user_agent\\\":\\\"%{json.escape(req.http.User-Agent)}V\\\",\\n  \\\"request_accept_language\\\":\\\"%{json.escape(req.http.Accept-Language)}V\\\",\\n  \\\"request_accept_charset\\\":\\\"%{json.escape(req.http.Accept-Charset)}V\\\",\\n  \\\"cache_status\\\":\\\"%{regsub(fastly_info.state, \\\"^(HIT-(SYNTH)|(HITPASS|HIT|MISS|PASS|ERROR|PIPE)).*\\\", \\\"\\\\\\\\2\\\\\\\\3\\\") }V\\\"\\n}\"}]"}],"_postman_id":"81b7fe78-3478-40aa-b4d3-83a2c8251cf7"},{"name":"Create an HTTPS log endpoint","id":"59a017c8-0dd4-499e-8940-23c2cd1d5aa4","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/https","description":"<p>Create an HTTPS object for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","https"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"04de3019-c21e-402b-9d0d-dc5a7cc8e00a","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/https","description":"Create an HTTPS object for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"name\":\"test-log-endpoint\",\"url\":\"https://example.com/logging/endpoint\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"request_max_entries\":0,\"request_max_bytes\":0,\"header_name\":null,\"method\":\"POST\",\"updated_at\":\"2020-03-05T15:25:17.000Z\",\"content_type\":null,\"response_condition\":\"\",\"tls_client_key\":null,\"message_type\":\"blank\",\"deleted_at\":null,\"tls_client_cert\":null,\"header_value\":null,\"tls_hostname\":null,\"format_version\":\"2\",\"json_format\":\"0\",\"tls_ca_cert\":null,\"period\":5,\"placement\":null,\"created_at\":\"2020-03-05T15:25:17.000Z\",\"format\":\"{ \\\"timestamp\\\":\\\"%{begin:%Y-%m-%dT%H:%M:%S}t\\\",\\n  \\\"time_elapsed\\\":%{time.elapsed.usec}V,\\n  \\\"is_tls\\\":%{if(req.is_ssl, \\\"true\\\", \\\"false\\\")}V,\\n  \\\"client_ip\\\":\\\"%{req.http.Fastly-Client-IP}V\\\",\\n  \\\"geo_city\\\":\\\"%{client.geo.city}V\\\",\\n  \\\"geo_country_code\\\":\\\"%{client.geo.country_code}V\\\",\\n  \\\"request\\\":\\\"%{req.request}V\\\",\\n  \\\"host\\\":\\\"%{req.http.Fastly-Orig-Host}V\\\",\\n  \\\"url\\\":\\\"%{json.escape(req.url)}V\\\",\\n  \\\"request_referer\\\":\\\"%{json.escape(req.http.Referer)}V\\\",\\n  \\\"request_user_agent\\\":\\\"%{json.escape(req.http.User-Agent)}V\\\",\\n  \\\"request_accept_language\\\":\\\"%{json.escape(req.http.Accept-Language)}V\\\",\\n  \\\"request_accept_charset\\\":\\\"%{json.escape(req.http.Accept-Charset)}V\\\",\\n  \\\"cache_status\\\":\\\"%{regsub(fastly_info.state, \\\"^(HIT-(SYNTH)|(HITPASS|HIT|MISS|PASS|ERROR|PIPE)).*\\\", \\\"\\\\\\\\2\\\\\\\\3\\\") }V\\\"\\n}\"}"}],"_postman_id":"59a017c8-0dd4-499e-8940-23c2cd1d5aa4"},{"name":"Get an HTTPS log endpoint","id":"cd58cdfb-85de-4228-a38d-17fcbf0d3fa6","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/https/{{logging_https_name}}","description":"<p>Get the HTTPS object for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","https","{{logging_https_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"59ce19d2-b02f-442c-9f7b-c9c50770cf4e","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/https/test-log-endpoint","description":"Get the HTTPS object for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"name\":\"test-log-endpoint\",\"url\":\"https://example.com/logging/endpoint\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"request_max_entries\":0,\"request_max_bytes\":0,\"header_name\":null,\"method\":\"POST\",\"updated_at\":\"2020-03-05T15:25:17.000Z\",\"content_type\":null,\"response_condition\":\"\",\"tls_client_key\":null,\"message_type\":\"blank\",\"deleted_at\":null,\"tls_client_cert\":null,\"header_value\":null,\"tls_hostname\":null,\"format_version\":\"2\",\"json_format\":\"0\",\"tls_ca_cert\":null,\"period\":5,\"placement\":null,\"created_at\":\"2020-03-05T15:25:17.000Z\",\"format\":\"{ \\\"timestamp\\\":\\\"%{begin:%Y-%m-%dT%H:%M:%S}t\\\",\\n  \\\"time_elapsed\\\":%{time.elapsed.usec}V,\\n  \\\"is_tls\\\":%{if(req.is_ssl, \\\"true\\\", \\\"false\\\")}V,\\n  \\\"client_ip\\\":\\\"%{req.http.Fastly-Client-IP}V\\\",\\n  \\\"geo_city\\\":\\\"%{client.geo.city}V\\\",\\n  \\\"geo_country_code\\\":\\\"%{client.geo.country_code}V\\\",\\n  \\\"request\\\":\\\"%{req.request}V\\\",\\n  \\\"host\\\":\\\"%{req.http.Fastly-Orig-Host}V\\\",\\n  \\\"url\\\":\\\"%{json.escape(req.url)}V\\\",\\n  \\\"request_referer\\\":\\\"%{json.escape(req.http.Referer)}V\\\",\\n  \\\"request_user_agent\\\":\\\"%{json.escape(req.http.User-Agent)}V\\\",\\n  \\\"request_accept_language\\\":\\\"%{json.escape(req.http.Accept-Language)}V\\\",\\n  \\\"request_accept_charset\\\":\\\"%{json.escape(req.http.Accept-Charset)}V\\\",\\n  \\\"cache_status\\\":\\\"%{regsub(fastly_info.state, \\\"^(HIT-(SYNTH)|(HITPASS|HIT|MISS|PASS|ERROR|PIPE)).*\\\", \\\"\\\\\\\\2\\\\\\\\3\\\") }V\\\"\\n}\"}"}],"_postman_id":"cd58cdfb-85de-4228-a38d-17fcbf0d3fa6"},{"name":"Update an HTTPS log endpoint","id":"a084a120-e6bf-41df-984e-3332bd0c1752","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/https/{{logging_https_name}}","description":"<p>Update the HTTPS object for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","https","{{logging_https_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"c9b04e86-4fc8-485e-b987-5d5eae2ae843","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/https/test-log-endpoint","description":"Update the HTTPS object for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"name\":\"updated-test-log-endpoint\",\"url\":\"https://example.com/logging/endpoint\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"request_max_entries\":0,\"request_max_bytes\":0,\"header_name\":null,\"method\":\"POST\",\"updated_at\":\"2020-03-05T15:25:17.000Z\",\"content_type\":null,\"response_condition\":\"\",\"tls_client_key\":null,\"message_type\":\"blank\",\"deleted_at\":null,\"tls_client_cert\":null,\"header_value\":null,\"tls_hostname\":null,\"format_version\":\"2\",\"json_format\":\"0\",\"tls_ca_cert\":null,\"period\":5,\"placement\":null,\"created_at\":\"2020-03-05T15:25:17.000Z\",\"format\":\"{ \\\"timestamp\\\":\\\"%{begin:%Y-%m-%dT%H:%M:%S}t\\\",\\n  \\\"time_elapsed\\\":%{time.elapsed.usec}V,\\n  \\\"is_tls\\\":%{if(req.is_ssl, \\\"true\\\", \\\"false\\\")}V,\\n  \\\"client_ip\\\":\\\"%{req.http.Fastly-Client-IP}V\\\",\\n  \\\"geo_city\\\":\\\"%{client.geo.city}V\\\",\\n  \\\"geo_country_code\\\":\\\"%{client.geo.country_code}V\\\",\\n  \\\"request\\\":\\\"%{req.request}V\\\",\\n  \\\"host\\\":\\\"%{req.http.Fastly-Orig-Host}V\\\",\\n  \\\"url\\\":\\\"%{json.escape(req.url)}V\\\",\\n  \\\"request_referer\\\":\\\"%{json.escape(req.http.Referer)}V\\\",\\n  \\\"request_user_agent\\\":\\\"%{json.escape(req.http.User-Agent)}V\\\",\\n  \\\"request_accept_language\\\":\\\"%{json.escape(req.http.Accept-Language)}V\\\",\\n  \\\"request_accept_charset\\\":\\\"%{json.escape(req.http.Accept-Charset)}V\\\",\\n  \\\"cache_status\\\":\\\"%{regsub(fastly_info.state, \\\"^(HIT-(SYNTH)|(HITPASS|HIT|MISS|PASS|ERROR|PIPE)).*\\\", \\\"\\\\\\\\2\\\\\\\\3\\\") }V\\\"\\n}\"}"}],"_postman_id":"a084a120-e6bf-41df-984e-3332bd0c1752"},{"name":"Delete an HTTPS log endpoint","id":"9e2a5e78-9b5e-4ac0-8212-fa6eeb4ad00b","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/https/{{logging_https_name}}","description":"<p>Delete the HTTPS object for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","https","{{logging_https_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"315dfa79-71b5-4a25-9399-cb6a8a12ba0c","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/https/test-log-endpoint","description":"Delete the HTTPS object for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"9e2a5e78-9b5e-4ac0-8212-fa6eeb4ad00b"}],"id":"5c3a6166-813b-4f6b-8d41-83c34e23eb47","description":"<p>Fastly will upload log messages to an HTTPS endpoint in the format specified in the HTTPS object. The HTTPS endpoint requires proof of domain ownership before logs can be received. Learn how to validate your domain in our HTTPS endpoint documentation.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>content_type</td>\n<td>string</td>\n<td>Content type of the header sent with the request.</td>\n</tr>\n<tr>\n<td>format</td>\n<td>string</td>\n<td>A Fastly log format string.</td>\n</tr>\n<tr>\n<td>header_name</td>\n<td>string</td>\n<td>Name of the custom header sent with the request.</td>\n</tr>\n<tr>\n<td>header_value</td>\n<td>string</td>\n<td>Value of the custom header sent with the request.</td>\n</tr>\n<tr>\n<td>json_format</td>\n<td>string</td>\n<td>Enforces valid JSON formatting for log entries.</td>\n</tr>\n<tr>\n<td></td>\n<td>0</td>\n<td>Disabled.</td>\n</tr>\n<tr>\n<td></td>\n<td>1</td>\n<td>Array of JSON. Wraps JSON log batches in an array.</td>\n</tr>\n<tr>\n<td></td>\n<td>2</td>\n<td>Newline delimited JSON. Places each JSON log entry onto a new line in a batch.</td>\n</tr>\n<tr>\n<td>message_type</td>\n<td>string</td>\n<td>How the message should be formatted.</td>\n</tr>\n<tr>\n<td></td>\n<td>classic</td>\n<td>RFC 3164 syslog prefix.</td>\n</tr>\n<tr>\n<td></td>\n<td>loggly</td>\n<td>RFC 5424 structured syslog.</td>\n</tr>\n<tr>\n<td></td>\n<td>logplex</td>\n<td>Heroku-style length prefixed syslog.</td>\n</tr>\n<tr>\n<td></td>\n<td>blank</td>\n<td>No prefix. Useful for writing JSON and CSV.</td>\n</tr>\n<tr>\n<td>method</td>\n<td>string</td>\n<td>HTTP method used for request.</td>\n</tr>\n<tr>\n<td>period</td>\n<td>integer</td>\n<td>How frequently, in seconds, batches of log data are sent to the HTTPS endpoint. A value of 0 sends logs at the same interval as the default, which is 5 seconds.</td>\n</tr>\n<tr>\n<td>request_max_bytes</td>\n<td>integer</td>\n<td>The maximum number of bytes sent in one request. Defaults 0 (100MB).</td>\n</tr>\n<tr>\n<td>request_max_entries</td>\n<td>integer</td>\n<td>The maximum number of logs sent in one request. Defaults 0 (10k).</td>\n</tr>\n<tr>\n<td>url</td>\n<td>string</td>\n<td>The URL to send logs to. Must use HTTPS. Required.</td>\n</tr>\n<tr>\n<td>format_version</td>\n<td>integer</td>\n<td>The version of the custom logging format used for the configured endpoint. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1.</td>\n</tr>\n<tr>\n<td></td>\n<td>1</td>\n<td>Version 1 log format.</td>\n</tr>\n<tr>\n<td></td>\n<td>2</td>\n<td>Version 2 log format.</td>\n</tr>\n<tr>\n<td>log_processing_region</td>\n<td>string</td>\n<td>The geographic region where the logs will be processed before streaming. Valid values are us, eu, and none for global.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The name for the real-time logging configuration.</td>\n</tr>\n<tr>\n<td>placement</td>\n<td>string</td>\n<td>Where in the generated VCL the logging call should be placed. If not set, endpoints with format_version of 2 are placed in vcl_log and those with format_version of 1 are placed in vcl_deliver.</td>\n</tr>\n<tr>\n<td></td>\n<td>none</td>\n<td>Do not render a log statement into VCL. Use this option if you intend to write a log statement manually.</td>\n</tr>\n<tr>\n<td>response_condition</td>\n<td>string</td>\n<td>The name of an existing condition in the configured endpoint, or leave blank to always execute.</td>\n</tr>\n<tr>\n<td>tls_ca_cert</td>\n<td>string</td>\n<td>A secure certificate to authenticate a server with. Must be in PEM format.</td>\n</tr>\n<tr>\n<td>tls_client_cert</td>\n<td>string</td>\n<td>The client certificate used to make authenticated requests. Must be in PEM format.</td>\n</tr>\n<tr>\n<td>tls_client_key</td>\n<td>string</td>\n<td>The client private key used to make authenticated requests. Must be in PEM format.</td>\n</tr>\n<tr>\n<td>tls_hostname</td>\n<td>string</td>\n<td>The hostname to verify the server's certificate. This should be one of the Subject Alternative Name (SAN) fields for the certificate. Common Names (CN) are not supported.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>string</td>\n<td>String identifying a service version.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"5c3a6166-813b-4f6b-8d41-83c34e23eb47"},{"name":"Kafka","item":[{"name":"List Kafka log endpoints","id":"65335ffd-70a8-4917-91bf-763388d4460e","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/kafka","description":"<p>List all of the Kafka logging endpoints for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","kafka"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"e936f18d-8d83-4223-ad38-d1e2980ce94d","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/kafka","description":"List all of the Kafka logging endpoints for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"format_version\":\"2\",\"tls_client_key\":null,\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"tls_ca_cert\":null,\"response_condition\":\"\",\"tls_hostname\":null,\"compression_codec\":null,\"name\":\"test-log-endpoint\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"topic\":\"test-topic\",\"created_at\":\"2020-04-25T20:17:00.000Z\",\"deleted_at\":null,\"brokers\":\"localhost:1234\",\"required_acks\":1,\"updated_at\":\"2020-04-25T20:17:00.000Z\",\"tls_client_cert\":null,\"use_tls\":\"0\",\"placement\":null,\"version\":\"1\"}]"}],"_postman_id":"65335ffd-70a8-4917-91bf-763388d4460e"},{"name":"Create a Kafka log endpoint","id":"7102d187-ebf1-4651-afbc-b099a91eecc9","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/kafka","description":"<p>Create a Kafka logging endpoint for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","kafka"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"beff3230-eebd-470d-932a-42202d6964ff","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/kafka","description":"Create a Kafka logging endpoint for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"format_version\":2,\"tls_client_key\":null,\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"tls_ca_cert\":null,\"response_condition\":\"\",\"tls_hostname\":null,\"compression_codec\":null,\"name\":\"test-log-endpoint\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"topic\":\"test-topic\",\"created_at\":\"2020-04-25T20:17:00.000Z\",\"deleted_at\":null,\"brokers\":\"localhost:1234\",\"required_acks\":1,\"updated_at\":\"2020-04-25T20:17:00.000Z\",\"tls_client_cert\":null,\"use_tls\":\"0\",\"placement\":null,\"version\":\"1\"}"}],"_postman_id":"7102d187-ebf1-4651-afbc-b099a91eecc9"},{"name":"Get a Kafka log endpoint","id":"3d9708df-4c9e-4359-b353-84d315d585b3","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/kafka/{{logging_kafka_name}}","description":"<p>Get the Kafka logging endpoint for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","kafka","{{logging_kafka_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"b7d51351-85ca-4b1e-86cd-96c0a2217ccc","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/kafka/test-log-endpoint","description":"Get the Kafka logging endpoint for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"format_version\":\"2\",\"tls_client_key\":null,\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"tls_ca_cert\":null,\"response_condition\":\"\",\"tls_hostname\":null,\"compression_codec\":null,\"name\":\"test-log-endpoint\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"topic\":\"test-topic\",\"created_at\":\"2020-04-25T20:17:00.000Z\",\"deleted_at\":null,\"brokers\":\"localhost:1234\",\"required_acks\":1,\"updated_at\":\"2020-04-25T20:17:00.000Z\",\"tls_client_cert\":null,\"use_tls\":\"0\",\"placement\":null,\"version\":\"1\"}"}],"_postman_id":"3d9708df-4c9e-4359-b353-84d315d585b3"},{"name":"Update the Kafka log endpoint","id":"dbc931ce-b14d-49a2-81fc-79bd6d187ffd","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/kafka/{{logging_kafka_name}}","description":"<p>Update the Kafka logging endpoint for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","kafka","{{logging_kafka_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"451f9948-d067-4233-8be1-13647bf67dd6","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/kafka/test-log-endpoint","description":"Update the Kafka logging endpoint for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"format_version\":\"2\",\"tls_client_key\":null,\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"tls_ca_cert\":null,\"response_condition\":\"\",\"tls_hostname\":null,\"compression_codec\":null,\"name\":\"updated-test-log-endpoint\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"topic\":\"test-topic\",\"created_at\":\"2020-04-25T20:17:00.000Z\",\"deleted_at\":null,\"brokers\":\"localhost:1234\",\"required_acks\":1,\"updated_at\":\"2020-04-25T20:17:00.000Z\",\"tls_client_cert\":null,\"use_tls\":\"0\",\"placement\":null,\"version\":\"1\"}"}],"_postman_id":"dbc931ce-b14d-49a2-81fc-79bd6d187ffd"},{"name":"Delete the Kafka log endpoint","id":"d9f94350-9a2b-4a83-9cfe-20fbfabe9535","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/kafka/{{logging_kafka_name}}","description":"<p>Delete the Kafka logging endpoint for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","kafka","{{logging_kafka_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"8a4561c0-20ff-43f5-88ee-edfa8ca85907","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/kafka/test-log-endpoint","description":"Delete the Kafka logging endpoint for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"d9f94350-9a2b-4a83-9cfe-20fbfabe9535"}],"id":"e2424c6d-845e-4bfd-b7be-72d1fc787050","description":"<p>Fastly will upload log messages periodically to the server in the format specified in the Kafka object.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>auth_method</td>\n<td>string</td>\n<td>SASL authentication method.</td>\n</tr>\n<tr>\n<td></td>\n<td>plain</td>\n<td>Use plain user and password authentication.</td>\n</tr>\n<tr>\n<td></td>\n<td>scram-sha-256</td>\n<td>Use salted challenge response authentication mechanism with SHA-256 hash function.</td>\n</tr>\n<tr>\n<td></td>\n<td>scram-sha-512</td>\n<td>Use salted challenge response authentication mechanism with SHA-512 hash function.</td>\n</tr>\n<tr>\n<td>brokers</td>\n<td>string</td>\n<td>A comma-separated list of IP addresses or hostnames of Kafka brokers. Required.</td>\n</tr>\n<tr>\n<td>compression_codec</td>\n<td>string</td>\n<td>The codec used for compression of your logs.</td>\n</tr>\n<tr>\n<td></td>\n<td>gzip</td>\n<td>Use gzip compression.</td>\n</tr>\n<tr>\n<td></td>\n<td>snappy</td>\n<td>Use Snappy compression.</td>\n</tr>\n<tr>\n<td></td>\n<td>lz4</td>\n<td>Use LZ4 compression.</td>\n</tr>\n<tr>\n<td></td>\n<td>null</td>\n<td></td>\n</tr>\n<tr>\n<td>parse_log_keyvals</td>\n<td>boolean</td>\n<td>Enables parsing of key=value tuples from the beginning of a logline, turning them into record headers.</td>\n</tr>\n<tr>\n<td>password</td>\n<td>string</td>\n<td>SASL password.</td>\n</tr>\n<tr>\n<td>request_max_bytes</td>\n<td>integer</td>\n<td>The maximum number of bytes sent in one request. Defaults 0 (no limit).</td>\n</tr>\n<tr>\n<td>required_acks</td>\n<td>integer</td>\n<td>The number of acknowledgements a leader must receive before a write is considered successful.</td>\n</tr>\n<tr>\n<td></td>\n<td>1</td>\n<td>One server needs to respond.</td>\n</tr>\n<tr>\n<td></td>\n<td>0</td>\n<td>No servers need to respond.</td>\n</tr>\n<tr>\n<td></td>\n<td>-1</td>\n<td>Wait for all in-sync replicas to respond.</td>\n</tr>\n<tr>\n<td>topic</td>\n<td>string</td>\n<td>The Kafka topic to send logs to. Required.</td>\n</tr>\n<tr>\n<td>use_tls</td>\n<td>string</td>\n<td>Whether to use TLS.</td>\n</tr>\n<tr>\n<td></td>\n<td>0</td>\n<td>Do not use TLS.</td>\n</tr>\n<tr>\n<td></td>\n<td>1</td>\n<td>Use TLS.</td>\n</tr>\n<tr>\n<td>user</td>\n<td>string</td>\n<td>SASL user.</td>\n</tr>\n<tr>\n<td>format</td>\n<td>string</td>\n<td>A Fastly log format string.</td>\n</tr>\n<tr>\n<td>format_version</td>\n<td>integer</td>\n<td>The version of the custom logging format used for the configured endpoint. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1.</td>\n</tr>\n<tr>\n<td></td>\n<td>1</td>\n<td>Version 1 log format.</td>\n</tr>\n<tr>\n<td></td>\n<td>2</td>\n<td>Version 2 log format.</td>\n</tr>\n<tr>\n<td>log_processing_region</td>\n<td>string</td>\n<td>The geographic region where the logs will be processed before streaming. Valid values are us, eu, and none for global.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The name for the real-time logging configuration.</td>\n</tr>\n<tr>\n<td>placement</td>\n<td>string</td>\n<td>Where in the generated VCL the logging call should be placed. If not set, endpoints with format_version of 2 are placed in vcl_log and those with format_version of 1 are placed in vcl_deliver.</td>\n</tr>\n<tr>\n<td></td>\n<td>none</td>\n<td>Do not render a log statement into VCL. Use this option if you intend to write a log statement manually.</td>\n</tr>\n<tr>\n<td>response_condition</td>\n<td>string</td>\n<td>The name of an existing condition in the configured endpoint, or leave blank to always execute.</td>\n</tr>\n<tr>\n<td>tls_ca_cert</td>\n<td>string</td>\n<td>A secure certificate to authenticate a server with. Must be in PEM format.</td>\n</tr>\n<tr>\n<td>tls_client_cert</td>\n<td>string</td>\n<td>The client certificate used to make authenticated requests. Must be in PEM format.</td>\n</tr>\n<tr>\n<td>tls_client_key</td>\n<td>string</td>\n<td>The client private key used to make authenticated requests. Must be in PEM format.</td>\n</tr>\n<tr>\n<td>tls_hostname</td>\n<td>string</td>\n<td>The hostname to verify the server's certificate. This should be one of the Subject Alternative Name (SAN) fields for the certificate. Common Names (CN) are not supported.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>string</td>\n<td>String identifying a service version.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"e2424c6d-845e-4bfd-b7be-72d1fc787050"},{"name":"Kinesis","item":[{"name":"List Amazon Kinesis log endpoints","id":"2ba79a58-8db9-4d5f-bce4-19f61c5aeab5","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/kinesis","description":"<p>List all of the Amazon Kinesis Data Streams logging objects for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","kinesis"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"f92f2820-d1af-42bb-9a65-6c61952a43d1","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/kinesis","description":"List all of the Amazon Kinesis Data Streams logging objects for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"access_key\":\"AKIAIOSFODNN7EXAMPLE\",\"created_at\":\"2020-05-23T19:48:33.000Z\",\"format\":\"{\\\"timestamp\\\":\\\"%{begin:%Y-%m-%dT%H:%M:%S}t\\\", \\\"time_elapsed\\\":%{time.elapsed.usec}V, \\\"is_tls\\\":%{if(req.is_ssl, \\\"true\\\", \\\"false\\\")}V, \\\"client_ip\\\":\\\"%{req.http.Fastly-Client-IP}V\\\", \\\"geo_city\\\":\\\"%{client.geo.city}V\\\", \\\"geo_country_code\\\":\\\"%{client.geo.country_code}V\\\", \\\"request\\\":\\\"%{req.request}V\\\", \\\"host\\\":\\\"%{req.http.Fastly-Orig-Host}V\\\", \\\"url\\\":\\\"%{json.escape(req.url)}V\\\", \\\"request_referer\\\":\\\"%{json.escape(req.http.Referer)}V\\\", \\\"request_user_agent\\\":\\\"%{json.escape(req.http.User-Agent)}V\\\", \\\"request_accept_language\\\":\\\"%{json.escape(req.http.Accept-Language)}V\\\", \\\"request_accept_charset\\\":\\\"%{json.escape(req.http.Accept-Charset)}V\\\", \\\"cache_status\\\":\\\"%{regsub(fastly_info.state, \\\"^(HIT-(SYNTH)|(HITPASS|HIT|MISS|PASS|ERROR|PIPE)).*\\\", \\\"\\\\\\\\2\\\\\\\\3\\\") }V\\\"}\",\"format_version\":\"2\",\"iam_role\":null,\"name\":\"test-log-endpoint\",\"placement\":null,\"region\":\"us-east-1\",\"secret_key\":\"wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"topic\":\"my-kinesis-stream\",\"updated_at\":\"2020-05-23T19:48:33.000Z\",\"version\":\"1\"}]"}],"_postman_id":"2ba79a58-8db9-4d5f-bce4-19f61c5aeab5"},{"name":"Create  an Amazon Kinesis log endpoint","id":"d1a2c969-deba-4170-b3e2-653e60a7f9d4","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/kinesis","description":"<p>Create an Amazon Kinesis Data Streams logging object for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","kinesis"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"a372be0b-2c01-4ab1-ad6a-9a7f52b7b47c","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/kinesis","description":"Create an Amazon Kinesis Data Streams logging object for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"access_key\":\"AKIAIOSFODNN7EXAMPLE\",\"created_at\":\"2020-05-23T19:48:33.000Z\",\"format\":\"{\\\"timestamp\\\":\\\"%{begin:%Y-%m-%dT%H:%M:%S}t\\\", \\\"time_elapsed\\\":%{time.elapsed.usec}V, \\\"is_tls\\\":%{if(req.is_ssl, \\\"true\\\", \\\"false\\\")}V, \\\"client_ip\\\":\\\"%{req.http.Fastly-Client-IP}V\\\", \\\"geo_city\\\":\\\"%{client.geo.city}V\\\", \\\"geo_country_code\\\":\\\"%{client.geo.country_code}V\\\", \\\"request\\\":\\\"%{req.request}V\\\", \\\"host\\\":\\\"%{req.http.Fastly-Orig-Host}V\\\", \\\"url\\\":\\\"%{json.escape(req.url)}V\\\", \\\"request_referer\\\":\\\"%{json.escape(req.http.Referer)}V\\\", \\\"request_user_agent\\\":\\\"%{json.escape(req.http.User-Agent)}V\\\", \\\"request_accept_language\\\":\\\"%{json.escape(req.http.Accept-Language)}V\\\", \\\"request_accept_charset\\\":\\\"%{json.escape(req.http.Accept-Charset)}V\\\", \\\"cache_status\\\":\\\"%{regsub(fastly_info.state, \\\"^(HIT-(SYNTH)|(HITPASS|HIT|MISS|PASS|ERROR|PIPE)).*\\\", \\\"\\\\\\\\2\\\\\\\\3\\\") }V\\\"}\",\"format_version\":\"2\",\"iam_role\":null,\"name\":\"test-log-endpoint\",\"placement\":null,\"region\":\"us-east-1\",\"secret_key\":\"wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"topic\":\"my-kinesis-stream\",\"updated_at\":\"2020-05-23T19:48:33.000Z\",\"version\":\"1\"}"}],"_postman_id":"d1a2c969-deba-4170-b3e2-653e60a7f9d4"},{"name":"Get an Amazon Kinesis log endpoint","id":"69a8d553-69de-49c7-9924-0f0fe4454321","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/kinesis/{{logging_kinesis_name}}","description":"<p>Get the details for an Amazon Kinesis Data Streams logging object for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","kinesis","{{logging_kinesis_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"426fe860-0721-45c3-959b-e4ef5143a24f","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/kinesis/test-log-endpoint","description":"Get the details for an Amazon Kinesis Data Streams logging object for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"access_key\":\"AKIAIOSFODNN7EXAMPLE\",\"created_at\":\"2020-05-23T19:48:33.000Z\",\"format\":\"{\\\"timestamp\\\":\\\"%{begin:%Y-%m-%dT%H:%M:%S}t\\\", \\\"time_elapsed\\\":%{time.elapsed.usec}V, \\\"is_tls\\\":%{if(req.is_ssl, \\\"true\\\", \\\"false\\\")}V, \\\"client_ip\\\":\\\"%{req.http.Fastly-Client-IP}V\\\", \\\"geo_city\\\":\\\"%{client.geo.city}V\\\", \\\"geo_country_code\\\":\\\"%{client.geo.country_code}V\\\", \\\"request\\\":\\\"%{req.request}V\\\", \\\"host\\\":\\\"%{req.http.Fastly-Orig-Host}V\\\", \\\"url\\\":\\\"%{json.escape(req.url)}V\\\", \\\"request_referer\\\":\\\"%{json.escape(req.http.Referer)}V\\\", \\\"request_user_agent\\\":\\\"%{json.escape(req.http.User-Agent)}V\\\", \\\"request_accept_language\\\":\\\"%{json.escape(req.http.Accept-Language)}V\\\", \\\"request_accept_charset\\\":\\\"%{json.escape(req.http.Accept-Charset)}V\\\", \\\"cache_status\\\":\\\"%{regsub(fastly_info.state, \\\"^(HIT-(SYNTH)|(HITPASS|HIT|MISS|PASS|ERROR|PIPE)).*\\\", \\\"\\\\\\\\2\\\\\\\\3\\\") }V\\\"}\",\"format_version\":\"2\",\"iam_role\":null,\"name\":\"test-log-endpoint\",\"placement\":null,\"region\":\"us-east-1\",\"secret_key\":\"wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"topic\":\"my-kinesis-stream\",\"updated_at\":\"2020-05-23T19:48:33.000Z\",\"version\":\"1\"}"}],"_postman_id":"69a8d553-69de-49c7-9924-0f0fe4454321"},{"name":"Update the Amazon Kinesis log endpoint","id":"6d9fe9bc-35ab-4344-a2db-e7903e1de472","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/kinesis/{{logging_kinesis_name}}","description":"<p>Update an Amazon Kinesis Data Streams logging object for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","kinesis","{{logging_kinesis_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"6484bb2c-700b-4a7d-b761-d9759d052985","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/kinesis/test-log-endpoint","description":"Update an Amazon Kinesis Data Streams logging object for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"access_key\":\"AKIAIOSFODNN7EXAMPLE\",\"created_at\":\"2020-05-23T19:48:33.000Z\",\"format\":\"{\\\"timestamp\\\":\\\"%{begin:%Y-%m-%dT%H:%M:%S}t\\\", \\\"time_elapsed\\\":%{time.elapsed.usec}V, \\\"is_tls\\\":%{if(req.is_ssl, \\\"true\\\", \\\"false\\\")}V, \\\"client_ip\\\":\\\"%{req.http.Fastly-Client-IP}V\\\", \\\"geo_city\\\":\\\"%{client.geo.city}V\\\", \\\"geo_country_code\\\":\\\"%{client.geo.country_code}V\\\", \\\"request\\\":\\\"%{req.request}V\\\", \\\"host\\\":\\\"%{req.http.Fastly-Orig-Host}V\\\", \\\"url\\\":\\\"%{json.escape(req.url)}V\\\", \\\"request_referer\\\":\\\"%{json.escape(req.http.Referer)}V\\\", \\\"request_user_agent\\\":\\\"%{json.escape(req.http.User-Agent)}V\\\", \\\"request_accept_language\\\":\\\"%{json.escape(req.http.Accept-Language)}V\\\", \\\"request_accept_charset\\\":\\\"%{json.escape(req.http.Accept-Charset)}V\\\", \\\"cache_status\\\":\\\"%{regsub(fastly_info.state, \\\"^(HIT-(SYNTH)|(HITPASS|HIT|MISS|PASS|ERROR|PIPE)).*\\\", \\\"\\\\\\\\2\\\\\\\\3\\\") }V\\\"}\",\"format_version\":\"2\",\"iam_role\":null,\"name\":\"updated-test-log-endpoint\",\"placement\":null,\"region\":\"us-east-1\",\"secret_key\":\"wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"topic\":\"my-kinesis-stream\",\"updated_at\":\"2020-05-23T19:48:33.000Z\",\"version\":\"1\"}"}],"_postman_id":"6d9fe9bc-35ab-4344-a2db-e7903e1de472"},{"name":"Delete the Amazon Kinesis log endpoint","id":"70b25033-0960-45b2-9a84-6f324f6a4e5f","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/kinesis/{{logging_kinesis_name}}","description":"<p>Delete an Amazon Kinesis Data Streams logging object for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","kinesis","{{logging_kinesis_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"fb7fd8fd-65f8-443f-876c-0688e841ff4e","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/kinesis/test-log-endpoint","description":"Delete an Amazon Kinesis Data Streams logging object for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"70b25033-0960-45b2-9a84-6f324f6a4e5f"}],"id":"6681eb6c-e3f9-476e-ab13-207794a035fc","description":"<p>Fastly will publish log messages to an Amazon Kinesis stream in the format specified in the Amazon Kinesis Data Streams logging object.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>access_key</td>\n<td>string</td>\n<td>The access key associated with the target Amazon Kinesis stream. Not required if iam_role is specified.</td>\n</tr>\n<tr>\n<td>format</td>\n<td>string</td>\n<td>A Fastly log format string.</td>\n</tr>\n<tr>\n<td>iam_role</td>\n<td>string</td>\n<td>The ARN for an IAM role granting Fastly access to the target Amazon Kinesis stream. Not required if access_key and secret_key are provided.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The name for the real-time logging configuration.</td>\n</tr>\n<tr>\n<td>placement</td>\n<td>string</td>\n<td>Where in the generated VCL the logging call should be placed. If not set, endpoints with format_version of 2 are placed in vcl_log and those with format_version of 1 are placed in vcl_deliver.</td>\n</tr>\n<tr>\n<td></td>\n<td>none</td>\n<td>Do not render a log statement into VCL. Use this option if you intend to write a log statement manually.</td>\n</tr>\n<tr>\n<td>region</td>\n<td>string</td>\n<td>A named set of AWS resources that's in the same geographical area.</td>\n</tr>\n<tr>\n<td>secret_key</td>\n<td>string</td>\n<td>The secret key associated with the target Amazon Kinesis stream. Not required if iam_role is specified.</td>\n</tr>\n<tr>\n<td>topic</td>\n<td>string</td>\n<td>The Amazon Kinesis stream to send logs to. Required.</td>\n</tr>\n<tr>\n<td>format_version</td>\n<td>integer</td>\n<td>The version of the custom logging format used for the configured endpoint. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1.</td>\n</tr>\n<tr>\n<td></td>\n<td>1</td>\n<td>Version 1 log format.</td>\n</tr>\n<tr>\n<td></td>\n<td>2</td>\n<td>Version 2 log format.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>string</td>\n<td>String identifying a service version.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"6681eb6c-e3f9-476e-ab13-207794a035fc"},{"name":"Loggly","item":[{"name":"List Loggly log endpoints","id":"a79d5831-354f-4224-bd34-bcc0bfe0974a","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/loggly","description":"<p>List all Loggly logging objects for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","loggly"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"e2aa68dc-a3eb-4e1e-81ab-98e4642ebc21","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/loggly","description":"List all Loggly logging objects for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"name\":\"test-log-endpoint\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"response_condition\":\"\",\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"token\":\"test-token\",\"placement\":null}]"}],"_postman_id":"a79d5831-354f-4224-bd34-bcc0bfe0974a"},{"name":"Create a Loggly log endpoint","id":"be633722-ff81-4792-be49-5126fa9b5eba","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/loggly","description":"<p>Create a Loggly logging object for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","loggly"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"a50bec87-a4e6-4e0f-a578-2d8a6ee3bd66","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/loggly","description":"Create a Loggly logging object for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"name\":\"test-log-endpoint\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"response_condition\":\"\",\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"token\":\"test-token\",\"placement\":null}"}],"_postman_id":"be633722-ff81-4792-be49-5126fa9b5eba"},{"name":"Get a Loggly log endpoint","id":"736aef89-245f-483d-926b-cb14f6bf80ce","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/loggly/{{logging_loggly_name}}","description":"<p>Get the Loggly logging object for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","loggly","{{logging_loggly_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"4940a75a-c7c0-4b32-a922-9a9437278424","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/loggly/test-log-endpoint","description":"Get the Loggly logging object for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"name\":\"test-log-endpoint\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"response_condition\":\"\",\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"token\":\"test-token\",\"placement\":null}"}],"_postman_id":"736aef89-245f-483d-926b-cb14f6bf80ce"},{"name":"Update a Loggly log endpoint","id":"3d7e4514-ec55-4940-acd7-94aff008e34c","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/loggly/{{logging_loggly_name}}","description":"<p>Update the Loggly logging object for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","loggly","{{logging_loggly_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"4ebe8321-de42-4837-920a-6c2a2f224f70","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/loggly/test-log-endpoint","description":"Update the Loggly logging object for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"name\":\"updated-test-log-endpoint\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"response_condition\":\"\",\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"token\":\"test-token\",\"placement\":null}"}],"_postman_id":"3d7e4514-ec55-4940-acd7-94aff008e34c"},{"name":"Delete a Loggly log endpoint","id":"3c176f7d-d752-4688-8b6b-0233d1f48cfd","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/loggly/{{logging_loggly_name}}","description":"<p>Delete the Loggly logging object for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","loggly","{{logging_loggly_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"bba61726-471a-4060-a1a1-ba0715f47550","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/loggly/test-log-endpoint","description":"Delete the Loggly logging object for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"3c176f7d-d752-4688-8b6b-0233d1f48cfd"}],"id":"e8fea51e-a233-41ea-aa53-d01cadb9a9e0","description":"<p>Fastly will stream log messages to the Loggly account in the format specified in the Loggly logging object.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>token</td>\n<td>string</td>\n<td>The token to use for authentication (<a href=\"https://www.loggly.com/docs/customer-token-authentication-token/\">https://www.loggly.com/docs/customer-token-authentication-token/</a>).</td>\n</tr>\n<tr>\n<td>format</td>\n<td>string</td>\n<td>A Fastly log format string.</td>\n</tr>\n<tr>\n<td>format_version</td>\n<td>integer</td>\n<td>The version of the custom logging format used for the configured endpoint. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1.</td>\n</tr>\n<tr>\n<td></td>\n<td>1</td>\n<td>Version 1 log format.</td>\n</tr>\n<tr>\n<td></td>\n<td>2</td>\n<td>Version 2 log format.</td>\n</tr>\n<tr>\n<td>log_processing_region</td>\n<td>string</td>\n<td>The geographic region where the logs will be processed before streaming. Valid values are us, eu, and none for global.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The name for the real-time logging configuration.</td>\n</tr>\n<tr>\n<td>placement</td>\n<td>string</td>\n<td>Where in the generated VCL the logging call should be placed. If not set, endpoints with format_version of 2 are placed in vcl_log and those with format_version of 1 are placed in vcl_deliver.</td>\n</tr>\n<tr>\n<td></td>\n<td>none</td>\n<td>Do not render a log statement into VCL. Use this option if you intend to write a log statement manually.</td>\n</tr>\n<tr>\n<td>response_condition</td>\n<td>string</td>\n<td>The name of an existing condition in the configured endpoint, or leave blank to always execute.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>string</td>\n<td>String identifying a service version.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"e8fea51e-a233-41ea-aa53-d01cadb9a9e0"},{"name":"Log Shuttle","item":[{"name":"List Log Shuttle log endpoints","id":"f2c75bbe-07b0-4e3f-aabf-8d722da0b2ab","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/logshuttle","description":"<p>List all of the Log Shuttle logging endpoints for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","logshuttle"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"955a610d-67a8-4c78-a972-caf06798621a","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/logshuttle","description":"List all of the Log Shuttle logging endpoints for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"created_at\":\"2020-06-02T22:31:06.000Z\",\"deleted_at\":null,\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"name\":\"test-log-endpoint\",\"placement\":null,\"response_condition\":\"\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"token\":null,\"updated_at\":\"2020-06-02T22:31:06.000Z\",\"url\":\"https://east.logplex.io/logs\",\"version\":\"1\"}]"}],"_postman_id":"f2c75bbe-07b0-4e3f-aabf-8d722da0b2ab"},{"name":"Create a Log Shuttle log endpoint","id":"e34dc4ee-fbff-412f-8797-cd5ae756b846","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/logshuttle","description":"<p>Create a Log Shuttle logging endpoint for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","logshuttle"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"3332d454-f064-4183-8798-d10834c184c0","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/logshuttle","description":"Create a Log Shuttle logging endpoint for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"created_at\":\"2020-06-02T22:31:06.000Z\",\"deleted_at\":null,\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"name\":\"test-log-endpoint\",\"placement\":null,\"response_condition\":\"\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"token\":null,\"updated_at\":\"2020-06-02T22:31:06.000Z\",\"url\":\"https://east.logplex.io/logs\",\"version\":\"1\"}"}],"_postman_id":"e34dc4ee-fbff-412f-8797-cd5ae756b846"},{"name":"Get a Log Shuttle log endpoint","id":"75047eb7-c301-4c93-bd32-6f514b239518","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/logshuttle/{{logging_logshuttle_name}}","description":"<p>Get the Log Shuttle logging endpoint for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","logshuttle","{{logging_logshuttle_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"b491678e-bf8a-4234-85b8-10aa2c1090da","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/logshuttle/test-log-endpoint","description":"Get the Log Shuttle logging endpoint for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"created_at\":\"2020-06-02T22:31:06.000Z\",\"deleted_at\":null,\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"name\":\"test-log-endpoint\",\"placement\":null,\"response_condition\":\"\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"token\":null,\"updated_at\":\"2020-06-02T22:31:06.000Z\",\"url\":\"https://east.logplex.io/logs\",\"version\":\"1\"}"}],"_postman_id":"75047eb7-c301-4c93-bd32-6f514b239518"},{"name":"Update a Log Shuttle log endpoint","id":"7ee79f4a-33b7-493c-864e-bebc33ba163a","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/logshuttle/{{logging_logshuttle_name}}","description":"<p>Update the Log Shuttle logging endpoint for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","logshuttle","{{logging_logshuttle_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"8532878c-74fb-4313-a78d-a7c4ccaee568","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/logshuttle/test-log-endpoint","description":"Update the Log Shuttle logging endpoint for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"created_at\":\"2020-06-02T22:31:06.000Z\",\"deleted_at\":null,\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"name\":\"updated-test-log-endpoint\",\"placement\":null,\"response_condition\":\"\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"token\":null,\"updated_at\":\"2020-06-02T22:31:06.000Z\",\"url\":\"https://east.logplex.io/logs\",\"version\":\"1\"}"}],"_postman_id":"7ee79f4a-33b7-493c-864e-bebc33ba163a"},{"name":"Delete a Log Shuttle log endpoint","id":"ada82ef5-695f-4a4a-8964-ee586494b8a4","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/logshuttle/{{logging_logshuttle_name}}","description":"<p>Delete the Log Shuttle logging endpoint for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","logshuttle","{{logging_logshuttle_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"cb610a83-e224-47d4-8745-2080adc9e938","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/logshuttle/test-log-endpoint","description":"Delete the Log Shuttle logging endpoint for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"ada82ef5-695f-4a4a-8964-ee586494b8a4"}],"id":"7bec97e3-24b7-4c96-a4db-41aa1aa49b9c","description":"<p>Fastly will upload log messages to the Log Shuttle bucket in the format specified in the logshuttle object.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>token</td>\n<td>string</td>\n<td>The data authentication token associated with this endpoint.</td>\n</tr>\n<tr>\n<td>url</td>\n<td>string</td>\n<td>The URL to stream logs to.</td>\n</tr>\n<tr>\n<td>format</td>\n<td>string</td>\n<td>A Fastly log format string.</td>\n</tr>\n<tr>\n<td>format_version</td>\n<td>integer</td>\n<td>The version of the custom logging format used for the configured endpoint. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1.</td>\n</tr>\n<tr>\n<td></td>\n<td>1</td>\n<td>Version 1 log format.</td>\n</tr>\n<tr>\n<td></td>\n<td>2</td>\n<td>Version 2 log format.</td>\n</tr>\n<tr>\n<td>log_processing_region</td>\n<td>string</td>\n<td>The geographic region where the logs will be processed before streaming. Valid values are us, eu, and none for global.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The name for the real-time logging configuration.</td>\n</tr>\n<tr>\n<td>placement</td>\n<td>string</td>\n<td>Where in the generated VCL the logging call should be placed. If not set, endpoints with format_version of 2 are placed in vcl_log and those with format_version of 1 are placed in vcl_deliver.</td>\n</tr>\n<tr>\n<td></td>\n<td>none</td>\n<td>Do not render a log statement into VCL. Use this option if you intend to write a log statement manually.</td>\n</tr>\n<tr>\n<td>response_condition</td>\n<td>string</td>\n<td>The name of an existing condition in the configured endpoint, or leave blank to always execute.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>string</td>\n<td>String identifying a service version.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"7bec97e3-24b7-4c96-a4db-41aa1aa49b9c"},{"name":"New Relic Logs","item":[{"name":"List New Relic log endpoints","id":"3c60aa56-6892-437d-88bd-45b4a006891b","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/newrelic","description":"<p>List all of the New Relic Logs logging objects for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","newrelic"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"97805cc7-82a4-4dab-a037-92f4c88f2b49","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/newrelic","description":"List all of the New Relic Logs logging objects for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"placement\":null,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"name\":\"test-log-endpoint\",\"format\":\"{\\\"time_elapsed\\\":%{time.elapsed.usec}V, \\\"is_tls\\\":%{if(req.is_ssl, \\\"true\\\", \\\"false\\\")}V, \\\"client_ip\\\":\\\"%{req.http.Fastly-Client-IP}V\\\", \\\"geo_city\\\":\\\"%{client.geo.city}V\\\", \\\"geo_country_code\\\":\\\"%{client.geo.country_code}V\\\", \\\"request\\\":\\\"%{req.request}V\\\", \\\"host\\\":\\\"%{req.http.Fastly-Orig-Host}V\\\", \\\"url\\\":\\\"%{json.escape(req.url)}V\\\", \\\"request_referer\\\":\\\"%{json.escape(req.http.Referer)}V\\\", \\\"request_user_agent\\\":\\\"%{json.escape(req.http.User-Agent)}V\\\", \\\"request_accept_language\\\":\\\"%{json.escape(req.http.Accept-Language)}V\\\", \\\"request_accept_charset\\\":\\\"%{json.escape(req.http.Accept-Charset)}V\\\", \\\"cache_status\\\":\\\"%{regsub(fastly_info.state, \\\"^(HIT-(SYNTH)|(HITPASS|HIT|MISS|PASS|ERROR|PIPE)).*\\\", \\\"\\\\2\\\\3\\\") }V\\\"}\",\"format_version\":\"2\",\"token\":\"6f5902ac237024bdd0c176cb9306TEST\",\"response_condition\":\"\",\"created_at\":\"2020-05-17T20:23:15.000Z\",\"updated_at\":\"2020-05-17T20:23:15.000Z\",\"deleted_at\":null,\"region\":\"EU\"}]"}],"_postman_id":"3c60aa56-6892-437d-88bd-45b4a006891b"},{"name":"Create a New Relic log endpoint","id":"347ca675-ebe4-444c-9b29-befce4a3828f","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/newrelic","description":"<p>Create a New Relic Logs logging object for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","newrelic"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"8b91c4ad-4a21-48a3-a399-c872d6ef696c","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/newrelic","description":"Create a New Relic Logs logging object for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"placement\":null,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"name\":\"test-log-endpoint\",\"format\":\"{\\\"time_elapsed\\\":%{time.elapsed.usec}V, \\\"is_tls\\\":%{if(req.is_ssl, \\\"true\\\", \\\"false\\\")}V, \\\"client_ip\\\":\\\"%{req.http.Fastly-Client-IP}V\\\", \\\"geo_city\\\":\\\"%{client.geo.city}V\\\", \\\"geo_country_code\\\":\\\"%{client.geo.country_code}V\\\", \\\"request\\\":\\\"%{req.request}V\\\", \\\"host\\\":\\\"%{req.http.Fastly-Orig-Host}V\\\", \\\"url\\\":\\\"%{json.escape(req.url)}V\\\", \\\"request_referer\\\":\\\"%{json.escape(req.http.Referer)}V\\\", \\\"request_user_agent\\\":\\\"%{json.escape(req.http.User-Agent)}V\\\", \\\"request_accept_language\\\":\\\"%{json.escape(req.http.Accept-Language)}V\\\", \\\"request_accept_charset\\\":\\\"%{json.escape(req.http.Accept-Charset)}V\\\", \\\"cache_status\\\":\\\"%{regsub(fastly_info.state, \\\"^(HIT-(SYNTH)|(HITPASS|HIT|MISS|PASS|ERROR|PIPE)).*\\\", \\\"\\\\2\\\\3\\\") }V\\\"}\",\"format_version\":\"2\",\"token\":\"6f5902ac237024bdd0c176cb9306TEST\",\"response_condition\":\"\",\"created_at\":\"2020-05-17T20:23:15.000Z\",\"updated_at\":\"2020-05-17T20:23:15.000Z\",\"deleted_at\":null,\"region\":\"EU\"}"}],"_postman_id":"347ca675-ebe4-444c-9b29-befce4a3828f"},{"name":"Get a New Relic log endpoint","id":"9233a62c-e1eb-47df-b3ab-9e3b4298bccd","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/newrelic/{{logging_newrelic_name}}","description":"<p>Get the details of a New Relic Logs logging object for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","newrelic","{{logging_newrelic_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"5916a6a4-f5b3-428c-a3c4-7bb692763278","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/newrelic/test-log-endpoint","description":"Get the details of a New Relic Logs logging object for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"placement\":null,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"name\":\"test-log-endpoint\",\"format\":\"{\\\"time_elapsed\\\":%{time.elapsed.usec}V, \\\"is_tls\\\":%{if(req.is_ssl, \\\"true\\\", \\\"false\\\")}V, \\\"client_ip\\\":\\\"%{req.http.Fastly-Client-IP}V\\\", \\\"geo_city\\\":\\\"%{client.geo.city}V\\\", \\\"geo_country_code\\\":\\\"%{client.geo.country_code}V\\\", \\\"request\\\":\\\"%{req.request}V\\\", \\\"host\\\":\\\"%{req.http.Fastly-Orig-Host}V\\\", \\\"url\\\":\\\"%{json.escape(req.url)}V\\\", \\\"request_referer\\\":\\\"%{json.escape(req.http.Referer)}V\\\", \\\"request_user_agent\\\":\\\"%{json.escape(req.http.User-Agent)}V\\\", \\\"request_accept_language\\\":\\\"%{json.escape(req.http.Accept-Language)}V\\\", \\\"request_accept_charset\\\":\\\"%{json.escape(req.http.Accept-Charset)}V\\\", \\\"cache_status\\\":\\\"%{regsub(fastly_info.state, \\\"^(HIT-(SYNTH)|(HITPASS|HIT|MISS|PASS|ERROR|PIPE)).*\\\", \\\"\\\\2\\\\3\\\") }V\\\"}\",\"format_version\":\"2\",\"token\":\"6f5902ac237024bdd0c176cb9306TEST\",\"response_condition\":\"\",\"created_at\":\"2020-05-17T20:23:15.000Z\",\"updated_at\":\"2020-05-17T20:23:15.000Z\",\"deleted_at\":null,\"region\":\"EU\"}"}],"_postman_id":"9233a62c-e1eb-47df-b3ab-9e3b4298bccd"},{"name":"Update a New Relic log endpoint","id":"43c5d173-b510-494a-9263-94a5eb3fee59","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/newrelic/{{logging_newrelic_name}}","description":"<p>Update a New Relic Logs logging object for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","newrelic","{{logging_newrelic_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"823e5f72-9699-4e18-866e-05a3dcb06eb4","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/newrelic/test-log-endpoint","description":"Update a New Relic Logs logging object for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"placement\":null,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"name\":\"updated-test-log-endpoint\",\"format\":\"{\\\"time_elapsed\\\":%{time.elapsed.usec}V, \\\"is_tls\\\":%{if(req.is_ssl, \\\"true\\\", \\\"false\\\")}V, \\\"client_ip\\\":\\\"%{req.http.Fastly-Client-IP}V\\\", \\\"geo_city\\\":\\\"%{client.geo.city}V\\\", \\\"geo_country_code\\\":\\\"%{client.geo.country_code}V\\\", \\\"request\\\":\\\"%{req.request}V\\\", \\\"host\\\":\\\"%{req.http.Fastly-Orig-Host}V\\\", \\\"url\\\":\\\"%{json.escape(req.url)}V\\\", \\\"request_referer\\\":\\\"%{json.escape(req.http.Referer)}V\\\", \\\"request_user_agent\\\":\\\"%{json.escape(req.http.User-Agent)}V\\\", \\\"request_accept_language\\\":\\\"%{json.escape(req.http.Accept-Language)}V\\\", \\\"request_accept_charset\\\":\\\"%{json.escape(req.http.Accept-Charset)}V\\\", \\\"cache_status\\\":\\\"%{regsub(fastly_info.state, \\\"^(HIT-(SYNTH)|(HITPASS|HIT|MISS|PASS|ERROR|PIPE)).*\\\", \\\"\\\\2\\\\3\\\") }V\\\"}\",\"format_version\":\"2\",\"token\":\"6f5902ac237024bdd0c176cb9306TEST\",\"response_condition\":\"\",\"created_at\":\"2020-05-17T20:23:15.000Z\",\"updated_at\":\"2020-05-17T20:23:15.000Z\",\"deleted_at\":null,\"region\":\"EU\"}"}],"_postman_id":"43c5d173-b510-494a-9263-94a5eb3fee59"},{"name":"Delete a New Relic log endpoint","id":"085105eb-9689-4ff2-806d-de124391769d","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/newrelic/{{logging_newrelic_name}}","description":"<p>Delete the New Relic Logs logging object for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","newrelic","{{logging_newrelic_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"df61cd7c-e9e2-4c03-8c2a-7b8eadb69119","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/newrelic/test-log-endpoint","description":"Delete the New Relic Logs logging object for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"085105eb-9689-4ff2-806d-de124391769d"}],"id":"f3974ed0-293e-4d02-8818-e3e1795ade46","description":"<p>Fastly will upload log messages to New Relic Logs in the format specified in the New Relic configuration object.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>format</td>\n<td>string</td>\n<td>A Fastly log format string. Must produce valid JSON that New Relic Logs can ingest.</td>\n</tr>\n<tr>\n<td>region</td>\n<td>string</td>\n<td>The region to which to stream logs.</td>\n</tr>\n<tr>\n<td>token</td>\n<td>string</td>\n<td>The Insert API key from the Account page of your New Relic account. Required.</td>\n</tr>\n<tr>\n<td>format_version</td>\n<td>integer</td>\n<td>The version of the custom logging format used for the configured endpoint. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1.</td>\n</tr>\n<tr>\n<td></td>\n<td>1</td>\n<td>Version 1 log format.</td>\n</tr>\n<tr>\n<td></td>\n<td>2</td>\n<td>Version 2 log format.</td>\n</tr>\n<tr>\n<td>log_processing_region</td>\n<td>string</td>\n<td>The geographic region where the logs will be processed before streaming. Valid values are us, eu, and none for global.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The name for the real-time logging configuration.</td>\n</tr>\n<tr>\n<td>placement</td>\n<td>string</td>\n<td>Where in the generated VCL the logging call should be placed. If not set, endpoints with format_version of 2 are placed in vcl_log and those with format_version of 1 are placed in vcl_deliver.</td>\n</tr>\n<tr>\n<td></td>\n<td>none</td>\n<td>Do not render a log statement into VCL. Use this option if you intend to write a log statement manually.</td>\n</tr>\n<tr>\n<td>response_condition</td>\n<td>string</td>\n<td>The name of an existing condition in the configured endpoint, or leave blank to always execute.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>string</td>\n<td>String identifying a service version.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"f3974ed0-293e-4d02-8818-e3e1795ade46"},{"name":"New Relic OTLP","item":[{"name":"List New Relic OTLP endpoints","id":"c39d8752-b82b-4db0-ad27-646c38afd98c","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/newrelicotlp","description":"<p>List all of the New Relic OTLP logging objects for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","newrelicotlp"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"3f975473-dfa0-433c-a3b7-5735d99efb98","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/newrelicotlp","description":"List all of the New Relic OTLP logging objects for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"placement\":null,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"name\":\"test-log-endpoint\",\"format\":\"{\\\"time_elapsed\\\":%{time.elapsed.usec}V, \\\"is_tls\\\":%{if(req.is_ssl, \\\"true\\\", \\\"false\\\")}V, \\\"client_ip\\\":\\\"%{req.http.Fastly-Client-IP}V\\\", \\\"geo_city\\\":\\\"%{client.geo.city}V\\\", \\\"geo_country_code\\\":\\\"%{client.geo.country_code}V\\\", \\\"request\\\":\\\"%{req.request}V\\\", \\\"host\\\":\\\"%{req.http.Fastly-Orig-Host}V\\\", \\\"url\\\":\\\"%{json.escape(req.url)}V\\\", \\\"request_referer\\\":\\\"%{json.escape(req.http.Referer)}V\\\", \\\"request_user_agent\\\":\\\"%{json.escape(req.http.User-Agent)}V\\\", \\\"request_accept_language\\\":\\\"%{json.escape(req.http.Accept-Language)}V\\\", \\\"request_accept_charset\\\":\\\"%{json.escape(req.http.Accept-Charset)}V\\\", \\\"cache_status\\\":\\\"%{regsub(fastly_info.state, \\\"^(HIT-(SYNTH)|(HITPASS|HIT|MISS|PASS|ERROR|PIPE)).*\\\", \\\"\\\\2\\\\3\\\") }V\\\"}\",\"format_version\":\"2\",\"token\":\"6f5902ac237024bdd0c176cb9306TEST\",\"response_condition\":\"\",\"created_at\":\"2020-05-17T20:23:15.000Z\",\"updated_at\":\"2020-05-17T20:23:15.000Z\",\"deleted_at\":null,\"region\":\"EU\",\"url\":null}]"}],"_postman_id":"c39d8752-b82b-4db0-ad27-646c38afd98c"},{"name":"Create a New Relic OTLP endpoint","id":"bfa78191-b2ca-409c-ac96-12aa790b9d7b","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/newrelicotlp","description":"<p>Create a New Relic OTLP logging object for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","newrelicotlp"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"0de3c4ab-f941-40a2-a654-5dd90b4b4b44","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/newrelicotlp","description":"Create a New Relic OTLP logging object for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"placement\":null,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"name\":\"test-log-endpoint\",\"format\":\"{\\\"time_elapsed\\\":%{time.elapsed.usec}V, \\\"is_tls\\\":%{if(req.is_ssl, \\\"true\\\", \\\"false\\\")}V, \\\"client_ip\\\":\\\"%{req.http.Fastly-Client-IP}V\\\", \\\"geo_city\\\":\\\"%{client.geo.city}V\\\", \\\"geo_country_code\\\":\\\"%{client.geo.country_code}V\\\", \\\"request\\\":\\\"%{req.request}V\\\", \\\"host\\\":\\\"%{req.http.Fastly-Orig-Host}V\\\", \\\"url\\\":\\\"%{json.escape(req.url)}V\\\", \\\"request_referer\\\":\\\"%{json.escape(req.http.Referer)}V\\\", \\\"request_user_agent\\\":\\\"%{json.escape(req.http.User-Agent)}V\\\", \\\"request_accept_language\\\":\\\"%{json.escape(req.http.Accept-Language)}V\\\", \\\"request_accept_charset\\\":\\\"%{json.escape(req.http.Accept-Charset)}V\\\", \\\"cache_status\\\":\\\"%{regsub(fastly_info.state, \\\"^(HIT-(SYNTH)|(HITPASS|HIT|MISS|PASS|ERROR|PIPE)).*\\\", \\\"\\\\2\\\\3\\\") }V\\\"}\",\"format_version\":\"2\",\"token\":\"6f5902ac237024bdd0c176cb9306TEST\",\"response_condition\":\"\",\"created_at\":\"2020-05-17T20:23:15.000Z\",\"updated_at\":\"2020-05-17T20:23:15.000Z\",\"deleted_at\":null,\"region\":\"EU\",\"url\":null}"}],"_postman_id":"bfa78191-b2ca-409c-ac96-12aa790b9d7b"},{"name":"Get a New Relic OTLP endpoint","id":"6c949b9b-2cc4-40e7-b1fd-ef21b4982e17","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/newrelicotlp/{{logging_newrelicotlp_name}}","description":"<p>Get the details of a New Relic OTLP logging object for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","newrelicotlp","{{logging_newrelicotlp_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"fac23dff-1233-4799-8395-b433e512124b","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/newrelicotlp/test-log-endpoint","description":"Get the details of a New Relic OTLP logging object for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"placement\":null,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"name\":\"test-log-endpoint\",\"format\":\"{\\\"time_elapsed\\\":%{time.elapsed.usec}V, \\\"is_tls\\\":%{if(req.is_ssl, \\\"true\\\", \\\"false\\\")}V, \\\"client_ip\\\":\\\"%{req.http.Fastly-Client-IP}V\\\", \\\"geo_city\\\":\\\"%{client.geo.city}V\\\", \\\"geo_country_code\\\":\\\"%{client.geo.country_code}V\\\", \\\"request\\\":\\\"%{req.request}V\\\", \\\"host\\\":\\\"%{req.http.Fastly-Orig-Host}V\\\", \\\"url\\\":\\\"%{json.escape(req.url)}V\\\", \\\"request_referer\\\":\\\"%{json.escape(req.http.Referer)}V\\\", \\\"request_user_agent\\\":\\\"%{json.escape(req.http.User-Agent)}V\\\", \\\"request_accept_language\\\":\\\"%{json.escape(req.http.Accept-Language)}V\\\", \\\"request_accept_charset\\\":\\\"%{json.escape(req.http.Accept-Charset)}V\\\", \\\"cache_status\\\":\\\"%{regsub(fastly_info.state, \\\"^(HIT-(SYNTH)|(HITPASS|HIT|MISS|PASS|ERROR|PIPE)).*\\\", \\\"\\\\2\\\\3\\\") }V\\\"}\",\"format_version\":\"2\",\"token\":\"6f5902ac237024bdd0c176cb9306TEST\",\"response_condition\":\"\",\"created_at\":\"2020-05-17T20:23:15.000Z\",\"updated_at\":\"2020-05-17T20:23:15.000Z\",\"deleted_at\":null,\"region\":\"EU\",\"url\":null}"}],"_postman_id":"6c949b9b-2cc4-40e7-b1fd-ef21b4982e17"},{"name":"Update a New Relic log endpoint","id":"ddb54fd0-5fc3-4124-8ed3-e4911293febc","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/newrelicotlp/{{logging_newrelicotlp_name}}","description":"<p>Update a New Relic OTLP logging object for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","newrelicotlp","{{logging_newrelicotlp_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"44857f7f-6809-48ee-bd7e-5ae9332e7b4b","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/newrelicotlp/test-log-endpoint","description":"Update a New Relic OTLP logging object for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"placement\":null,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"name\":\"updated-test-log-endpoint\",\"format\":\"{\\\"time_elapsed\\\":%{time.elapsed.usec}V, \\\"is_tls\\\":%{if(req.is_ssl, \\\"true\\\", \\\"false\\\")}V, \\\"client_ip\\\":\\\"%{req.http.Fastly-Client-IP}V\\\", \\\"geo_city\\\":\\\"%{client.geo.city}V\\\", \\\"geo_country_code\\\":\\\"%{client.geo.country_code}V\\\", \\\"request\\\":\\\"%{req.request}V\\\", \\\"host\\\":\\\"%{req.http.Fastly-Orig-Host}V\\\", \\\"url\\\":\\\"%{json.escape(req.url)}V\\\", \\\"request_referer\\\":\\\"%{json.escape(req.http.Referer)}V\\\", \\\"request_user_agent\\\":\\\"%{json.escape(req.http.User-Agent)}V\\\", \\\"request_accept_language\\\":\\\"%{json.escape(req.http.Accept-Language)}V\\\", \\\"request_accept_charset\\\":\\\"%{json.escape(req.http.Accept-Charset)}V\\\", \\\"cache_status\\\":\\\"%{regsub(fastly_info.state, \\\"^(HIT-(SYNTH)|(HITPASS|HIT|MISS|PASS|ERROR|PIPE)).*\\\", \\\"\\\\2\\\\3\\\") }V\\\"}\",\"format_version\":\"2\",\"token\":\"6f5902ac237024bdd0c176cb9306TEST\",\"response_condition\":\"\",\"created_at\":\"2020-05-17T20:23:15.000Z\",\"updated_at\":\"2020-05-17T20:23:15.000Z\",\"deleted_at\":null,\"region\":\"EU\",\"url\":null}"}],"_postman_id":"ddb54fd0-5fc3-4124-8ed3-e4911293febc"},{"name":"Delete a New Relic OTLP endpoint","id":"73233f07-cb13-4025-be3a-97455cc16b5a","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/newrelicotlp/{{logging_newrelicotlp_name}}","description":"<p>Delete the New Relic OTLP logging object for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","newrelicotlp","{{logging_newrelicotlp_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"5302e5a1-315a-4e8f-ad21-f5f3bb5141ba","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/newrelicotlp/test-log-endpoint","description":"Delete the New Relic OTLP logging object for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"73233f07-cb13-4025-be3a-97455cc16b5a"}],"id":"ad2bdc5b-346f-44fd-9b4a-afd36e4df7a6","description":"<p>Allows OTLP trace data to be sent to New Relic. Requires custom VCL to instrument the service to generate OTLP trace data. See <a href=\"https://www.fastly.com/documentation/guides/integrations/logging-endpoints/log-streaming-newrelic-otlp/#instrumenting-your-vcl-service\">https://www.fastly.com/documentation/guides/integrations/logging-endpoints/log-streaming-newrelic-otlp/#instrumenting-your-vcl-service</a> for details.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>format</td>\n<td>string</td>\n<td>A Fastly log format string.</td>\n</tr>\n<tr>\n<td>region</td>\n<td>string</td>\n<td>The region to which to stream logs.</td>\n</tr>\n<tr>\n<td>token</td>\n<td>string</td>\n<td>The Insert API key from the Account page of your New Relic account. Required.</td>\n</tr>\n<tr>\n<td>url</td>\n<td>string</td>\n<td>(Optional) URL of the New Relic Trace Observer, if you are using New Relic Infinite Tracing.</td>\n</tr>\n<tr>\n<td>format_version</td>\n<td>integer</td>\n<td>The version of the custom logging format used for the configured endpoint. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1.</td>\n</tr>\n<tr>\n<td></td>\n<td>1</td>\n<td>Version 1 log format.</td>\n</tr>\n<tr>\n<td></td>\n<td>2</td>\n<td>Version 2 log format.</td>\n</tr>\n<tr>\n<td>log_processing_region</td>\n<td>string</td>\n<td>The geographic region where the logs will be processed before streaming. Valid values are us, eu, and none for global.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The name for the real-time logging configuration.</td>\n</tr>\n<tr>\n<td>placement</td>\n<td>string</td>\n<td>Where in the generated VCL the logging call should be placed. If not set, endpoints with format_version of 2 are placed in vcl_log and those with format_version of 1 are placed in vcl_deliver.</td>\n</tr>\n<tr>\n<td></td>\n<td>none</td>\n<td>Do not render a log statement into VCL. Use this option if you intend to write a log statement manually.</td>\n</tr>\n<tr>\n<td>response_condition</td>\n<td>string</td>\n<td>The name of an existing condition in the configured endpoint, or leave blank to always execute.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>string</td>\n<td>String identifying a service version.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"ad2bdc5b-346f-44fd-9b4a-afd36e4df7a6"},{"name":"OpenStack","item":[{"name":"List OpenStack log endpoints","id":"14347d09-f632-4341-bb67-9b74123cd873","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/openstack","description":"<p>List all of the openstacks for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","openstack"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"98946ed7-33a4-4f04-9991-22c7dae6528a","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/openstack","description":"List all of the openstacks for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"access_key\":\"AKIAIOSFODNN7EXAMPLE\",\"bucket_name\":\"test-bucket\",\"created_at\":\"2020-06-03T21:33:16.000Z\",\"deleted_at\":null,\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"compression_codec\":\"zstd\",\"gzip_level\":\"0\",\"message_type\":\"classic\",\"name\":\"test-log-endpoint\",\"path\":\"\",\"period\":\"3600\",\"placement\":null,\"public_key\":null,\"response_condition\":\"\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"timestamp_format\":\"%Y-%m-%dT%H:%M:%S.000\",\"updated_at\":\"2020-06-03T21:37:21.000Z\",\"url\":\"https://auth.storage.memset.com/v1.0\",\"user\":\"Openstack Username\",\"version\":\"1\"}]"}],"_postman_id":"14347d09-f632-4341-bb67-9b74123cd873"},{"name":"Create an OpenStack log endpoint","id":"161b79e0-df1b-43aa-8552-beda0eb2e3c7","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/openstack","description":"<p>Create a openstack for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","openstack"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"837fb967-8e57-4a50-b551-8961d96eb40f","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/openstack","description":"Create a openstack for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"access_key\":\"AKIAIOSFODNN7EXAMPLE\",\"bucket_name\":\"test-bucket\",\"created_at\":\"2020-06-03T21:33:16.000Z\",\"deleted_at\":null,\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"compression_codec\":\"zstd\",\"gzip_level\":\"0\",\"message_type\":\"classic\",\"name\":\"test-log-endpoint\",\"path\":\"\",\"period\":\"3600\",\"placement\":null,\"public_key\":null,\"response_condition\":\"\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"timestamp_format\":\"%Y-%m-%dT%H:%M:%S.000\",\"updated_at\":\"2020-06-03T21:37:21.000Z\",\"url\":\"https://auth.storage.memset.com/v1.0\",\"user\":\"Openstack Username\",\"version\":\"1\"}"}],"_postman_id":"161b79e0-df1b-43aa-8552-beda0eb2e3c7"},{"name":"Get an OpenStack log endpoint","id":"6fd93dcd-a71a-48da-88db-7b84ab597c9a","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/openstack/{{logging_openstack_name}}","description":"<p>Get the openstack for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","openstack","{{logging_openstack_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"4fa6ba65-0631-4708-889f-22d2c844a904","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/openstack/test-log-endpoint","description":"Get the openstack for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"access_key\":\"AKIAIOSFODNN7EXAMPLE\",\"bucket_name\":\"test-bucket\",\"created_at\":\"2020-06-03T21:33:16.000Z\",\"deleted_at\":null,\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"compression_codec\":\"zstd\",\"gzip_level\":\"0\",\"message_type\":\"classic\",\"name\":\"test-log-endpoint\",\"path\":\"\",\"period\":\"3600\",\"placement\":null,\"public_key\":null,\"response_condition\":\"\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"timestamp_format\":\"%Y-%m-%dT%H:%M:%S.000\",\"updated_at\":\"2020-06-03T21:37:21.000Z\",\"url\":\"https://auth.storage.memset.com/v1.0\",\"user\":\"Openstack Username\",\"version\":\"1\"}"}],"_postman_id":"6fd93dcd-a71a-48da-88db-7b84ab597c9a"},{"name":"Update an OpenStack log endpoint","id":"41371ee9-1caf-4751-99ea-69aec67af373","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/openstack/{{logging_openstack_name}}","description":"<p>Update the openstack for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","openstack","{{logging_openstack_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"e23acaec-d399-45b1-9089-aadc8240a94d","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/openstack/test-log-endpoint","description":"Update the openstack for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"access_key\":\"AKIAIOSFODNN7EXAMPLE\",\"bucket_name\":\"test-bucket\",\"created_at\":\"2020-06-03T21:33:16.000Z\",\"deleted_at\":null,\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"compression_codec\":\"zstd\",\"gzip_level\":\"0\",\"message_type\":\"classic\",\"name\":\"updated-test-log-endpoint\",\"path\":\"\",\"period\":\"3600\",\"placement\":null,\"public_key\":null,\"response_condition\":\"\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"timestamp_format\":\"%Y-%m-%dT%H:%M:%S.000\",\"updated_at\":\"2020-06-03T21:37:21.000Z\",\"url\":\"https://auth.storage.memset.com/v1.0\",\"user\":\"Openstack Username\",\"version\":\"1\"}"}],"_postman_id":"41371ee9-1caf-4751-99ea-69aec67af373"},{"name":"Delete an OpenStack log endpoint","id":"c14eed31-1d5b-40ca-8615-35614c0eb384","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/openstack/{{logging_openstack_name}}","description":"<p>Delete the openstack for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","openstack","{{logging_openstack_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"18f61916-d51b-4350-9f20-daffd081d930","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/openstack/test-log-endpoint","description":"Delete the openstack for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"c14eed31-1d5b-40ca-8615-35614c0eb384"}],"id":"3e6f47b5-1178-4c10-b726-8e50149e8bec","description":"<p>Fastly will upload log messages to the OpenStack bucket in the format specified in the openstack object.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>access_key</td>\n<td>string</td>\n<td>Your OpenStack account access key.</td>\n</tr>\n<tr>\n<td>bucket_name</td>\n<td>string</td>\n<td>The name of your OpenStack container.</td>\n</tr>\n<tr>\n<td>path</td>\n<td>string</td>\n<td>The path to upload logs to.</td>\n</tr>\n<tr>\n<td>public_key</td>\n<td>string</td>\n<td>A PGP public key that Fastly will use to encrypt your log files before writing them to disk.</td>\n</tr>\n<tr>\n<td>url</td>\n<td>string</td>\n<td>Your OpenStack auth url.</td>\n</tr>\n<tr>\n<td>user</td>\n<td>string</td>\n<td>The username for your OpenStack account.</td>\n</tr>\n<tr>\n<td>compression_codec</td>\n<td>string</td>\n<td>The codec used for compressing your logs. Valid values are zstd, snappy, and gzip. Specifying both compression_codec and gzip_level in the same API request will result in an error.</td>\n</tr>\n<tr>\n<td>format</td>\n<td>string</td>\n<td>A Fastly log format string.</td>\n</tr>\n<tr>\n<td>format_version</td>\n<td>integer</td>\n<td>The version of the custom logging format used for the configured endpoint. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1.</td>\n</tr>\n<tr>\n<td></td>\n<td>1</td>\n<td>Version 1 log format.</td>\n</tr>\n<tr>\n<td></td>\n<td>2</td>\n<td>Version 2 log format.</td>\n</tr>\n<tr>\n<td>gzip_level</td>\n<td>integer</td>\n<td>The level of gzip encoding when sending logs (default 0, no compression). Specifying both compression_codec and gzip_level in the same API request will result in an error.</td>\n</tr>\n<tr>\n<td>log_processing_region</td>\n<td>string</td>\n<td>The geographic region where the logs will be processed before streaming. Valid values are us, eu, and none for global.</td>\n</tr>\n<tr>\n<td>message_type</td>\n<td>string</td>\n<td>How the message should be formatted.</td>\n</tr>\n<tr>\n<td></td>\n<td>classic</td>\n<td>RFC 3164 syslog prefix.</td>\n</tr>\n<tr>\n<td></td>\n<td>loggly</td>\n<td>RFC 5424 structured syslog.</td>\n</tr>\n<tr>\n<td></td>\n<td>logplex</td>\n<td>Heroku-style length prefixed syslog.</td>\n</tr>\n<tr>\n<td></td>\n<td>blank</td>\n<td>No prefix. Useful for writing JSON and CSV.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The name for the real-time logging configuration.</td>\n</tr>\n<tr>\n<td>period</td>\n<td>integer</td>\n<td>How frequently log files are finalized so they can be available for reading (in seconds).</td>\n</tr>\n<tr>\n<td>placement</td>\n<td>string</td>\n<td>Where in the generated VCL the logging call should be placed. If not set, endpoints with format_version of 2 are placed in vcl_log and those with format_version of 1 are placed in vcl_deliver.</td>\n</tr>\n<tr>\n<td></td>\n<td>none</td>\n<td>Do not render a log statement into VCL. Use this option if you intend to write a log statement manually.</td>\n</tr>\n<tr>\n<td>response_condition</td>\n<td>string</td>\n<td>The name of an existing condition in the configured endpoint, or leave blank to always execute.</td>\n</tr>\n<tr>\n<td>timestamp_format</td>\n<td>string</td>\n<td>A timestamp format.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>string</td>\n<td>String identifying a service version.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"3e6f47b5-1178-4c10-b726-8e50149e8bec"},{"name":"Papertrail","item":[{"name":"List Papertrail log endpoints","id":"e688191f-ab8c-43ce-a089-749c53c0a6ca","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/papertrail","description":"<p>List all of the Papertrails for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","papertrail"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"e29bf713-3723-41af-aa1c-ff23b2e3ed5d","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/papertrail","description":"List all of the Papertrails for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"address\":\"example.com\",\"created_at\":\"2020-05-18T18:51:50.000Z\",\"deleted_at\":null,\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"name\":\"test-log-endpoint\",\"placement\":null,\"port\":5140,\"response_condition\":\"\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"updated_at\":\"2020-05-18T18:51:50.000Z\",\"version\":\"1\"}]"}],"_postman_id":"e688191f-ab8c-43ce-a089-749c53c0a6ca"},{"name":"Create a Papertrail log endpoint","id":"8d98c1d9-554e-4568-b72a-723c1b172511","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/papertrail","description":"<p>Create a Papertrail for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","papertrail"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"2866dd42-7dde-43e6-a239-4d37af0439cb","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/papertrail","description":"Create a Papertrail for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"address\":\"example.com\",\"created_at\":\"2020-05-18T18:51:50.000Z\",\"deleted_at\":null,\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"name\":\"test-log-endpoint\",\"placement\":null,\"port\":5140,\"response_condition\":\"\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"updated_at\":\"2020-05-18T18:51:50.000Z\",\"version\":\"1\"}"}],"_postman_id":"8d98c1d9-554e-4568-b72a-723c1b172511"},{"name":"Get a Papertrail log endpoint","id":"5863065c-eb80-4f6b-8d95-5ecd277cc5c1","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/papertrail/{{logging_papertrail_name}}","description":"<p>Get the Papertrail for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","papertrail","{{logging_papertrail_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"b154f154-0131-471a-8651-3e4cb3ff82d5","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/papertrail/test-log-endpoint","description":"Get the Papertrail for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"address\":\"example.com\",\"created_at\":\"2020-05-18T18:51:50.000Z\",\"deleted_at\":null,\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"name\":\"test-log-endpoint\",\"placement\":null,\"port\":5140,\"response_condition\":\"\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"updated_at\":\"2020-05-18T18:51:50.000Z\",\"version\":\"1\"}"}],"_postman_id":"5863065c-eb80-4f6b-8d95-5ecd277cc5c1"},{"name":"Update a Papertrail log endpoint","id":"866d7b98-18b8-43f3-8c38-16692ace760b","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/papertrail/{{logging_papertrail_name}}","description":"<p>Update the Papertrail for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","papertrail","{{logging_papertrail_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"cecbdb56-120c-405a-886b-925e024a6fee","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/papertrail/test-log-endpoint","description":"Update the Papertrail for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"address\":\"example.com\",\"created_at\":\"2020-05-18T18:51:50.000Z\",\"deleted_at\":null,\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"name\":\"updated-test-log-endpoint\",\"placement\":null,\"port\":5140,\"response_condition\":\"\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"updated_at\":\"2020-05-18T18:51:50.000Z\",\"version\":\"1\"}"}],"_postman_id":"866d7b98-18b8-43f3-8c38-16692ace760b"},{"name":"Delete a Papertrail log endpoint","id":"fc564374-2700-4103-9cd4-c352b1a83b30","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/papertrail/{{logging_papertrail_name}}","description":"<p>Delete the Papertrail for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","papertrail","{{logging_papertrail_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"022700e2-ed09-4eec-b199-5f8e9e4bfe1b","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/papertrail/test-log-endpoint","description":"Delete the Papertrail for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"fc564374-2700-4103-9cd4-c352b1a83b30"}],"id":"a09c8531-b03f-4f8a-8e94-dc2734a380e2","description":"<p>Fastly will stream log messages to the Papertrail account in the format specified in the Papertrail object.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>address</td>\n<td>string</td>\n<td>A hostname or IPv4 address.</td>\n</tr>\n<tr>\n<td>format</td>\n<td>string</td>\n<td>A Fastly log format string.</td>\n</tr>\n<tr>\n<td>format_version</td>\n<td>integer</td>\n<td>The version of the custom logging format used for the configured endpoint. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1.</td>\n</tr>\n<tr>\n<td></td>\n<td>1</td>\n<td>Version 1 log format.</td>\n</tr>\n<tr>\n<td></td>\n<td>2</td>\n<td>Version 2 log format.</td>\n</tr>\n<tr>\n<td>log_processing_region</td>\n<td>string</td>\n<td>The geographic region where the logs will be processed before streaming. Valid values are us, eu, and none for global.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The name for the real-time logging configuration.</td>\n</tr>\n<tr>\n<td>placement</td>\n<td>string</td>\n<td>Where in the generated VCL the logging call should be placed. If not set, endpoints with format_version of 2 are placed in vcl_log and those with format_version of 1 are placed in vcl_deliver.</td>\n</tr>\n<tr>\n<td></td>\n<td>none</td>\n<td>Do not render a log statement into VCL. Use this option if you intend to write a log statement manually.</td>\n</tr>\n<tr>\n<td>port</td>\n<td>integer</td>\n<td>The port number.</td>\n</tr>\n<tr>\n<td>response_condition</td>\n<td>string</td>\n<td>The name of an existing condition in the configured endpoint, or leave blank to always execute.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>string</td>\n<td>String identifying a service version.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"a09c8531-b03f-4f8a-8e94-dc2734a380e2"},{"name":"S3","item":[{"name":"List AWS S3 log endpoints","id":"e3d90388-5565-4fef-9600-a322724fecd5","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/s3","description":"<p>List all of the S3s for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","s3"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"f8f0eeba-364d-49fe-944b-0a9c7959341e","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/s3","description":"List all of the S3s for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"access_key\":\"AKIAIOSFODNN7EXAMPLE\",\"acl\":\"\",\"bucket_name\":\"test-bucket\",\"created_at\":\"2020-05-23T19:48:33.000Z\",\"deleted_at\":null,\"domain\":\"s3.amazonaws.com\",\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"compression_codec\":\"zstd\",\"gzip_level\":\"0\",\"iam_role\":null,\"message_type\":\"classic\",\"name\":\"test-log-endpoint\",\"path\":null,\"period\":\"3600\",\"placement\":null,\"public_key\":null,\"redundancy\":null,\"response_condition\":\"\",\"secret_key\":\"wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"timestamp_format\":\"%Y-%m-%dT%H:%M:%S.000\",\"updated_at\":\"2020-05-23T19:48:33.000Z\",\"version\":\"1\",\"file_max_bytes\":100000000}]"}],"_postman_id":"e3d90388-5565-4fef-9600-a322724fecd5"},{"name":"Create an AWS S3 log endpoint","id":"af4bb5da-e512-4d70-89c6-1af7a2019084","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/s3","description":"<p>Create a S3 for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","s3"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"0331bde7-834c-40f3-a664-5cb6935c38e8","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/s3","description":"Create a S3 for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"access_key\":\"AKIAIOSFODNN7EXAMPLE\",\"acl\":\"\",\"bucket_name\":\"test-bucket\",\"created_at\":\"2020-05-23T19:48:33.000Z\",\"deleted_at\":null,\"domain\":\"s3.amazonaws.com\",\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"compression_codec\":\"zstd\",\"gzip_level\":\"0\",\"iam_role\":null,\"message_type\":\"classic\",\"name\":\"test-log-endpoint\",\"path\":null,\"period\":\"3600\",\"placement\":null,\"public_key\":null,\"redundancy\":null,\"response_condition\":\"\",\"secret_key\":\"wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"timestamp_format\":\"%Y-%m-%dT%H:%M:%S.000\",\"updated_at\":\"2020-05-23T19:48:33.000Z\",\"version\":\"1\",\"file_max_bytes\":100000000}"}],"_postman_id":"af4bb5da-e512-4d70-89c6-1af7a2019084"},{"name":"Get an AWS S3 log endpoint","id":"10ac619d-a8ba-4db2-b035-79ccc73ba9b2","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/s3/{{logging_s3_name}}","description":"<p>Get the S3 for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","s3","{{logging_s3_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"6879877c-174d-4b21-aa5f-3e40b2035b7b","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/s3/test-log-endpoint","description":"Get the S3 for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"access_key\":\"AKIAIOSFODNN7EXAMPLE\",\"acl\":\"\",\"bucket_name\":\"test-bucket\",\"created_at\":\"2020-05-23T19:48:33.000Z\",\"deleted_at\":null,\"domain\":\"s3.amazonaws.com\",\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"compression_codec\":\"zstd\",\"gzip_level\":\"0\",\"iam_role\":null,\"message_type\":\"classic\",\"name\":\"test-log-endpoint\",\"path\":null,\"period\":\"3600\",\"placement\":null,\"public_key\":null,\"redundancy\":null,\"response_condition\":\"\",\"secret_key\":\"wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"timestamp_format\":\"%Y-%m-%dT%H:%M:%S.000\",\"updated_at\":\"2020-05-23T19:48:33.000Z\",\"version\":\"1\",\"file_max_bytes\":100000000}"}],"_postman_id":"10ac619d-a8ba-4db2-b035-79ccc73ba9b2"},{"name":"Update an AWS S3 log endpoint","id":"5448268f-290b-4f32-b2e5-e98567466542","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/s3/{{logging_s3_name}}","description":"<p>Update the S3 for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","s3","{{logging_s3_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"01875e25-ded2-42e9-a30e-1316c9b4cd03","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/s3/test-log-endpoint","description":"Update the S3 for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"access_key\":\"AKIAIOSFODNN7EXAMPLE\",\"acl\":\"\",\"bucket_name\":\"test-bucket\",\"created_at\":\"2020-05-23T19:48:33.000Z\",\"deleted_at\":null,\"domain\":\"s3.amazonaws.com\",\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"compression_codec\":\"zstd\",\"gzip_level\":\"0\",\"iam_role\":null,\"message_type\":\"classic\",\"name\":\"updated-test-log-endpoint\",\"path\":null,\"period\":\"3600\",\"placement\":null,\"public_key\":null,\"redundancy\":null,\"response_condition\":\"\",\"secret_key\":\"wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"timestamp_format\":\"%Y-%m-%dT%H:%M:%S.000\",\"updated_at\":\"2020-05-23T19:48:33.000Z\",\"version\":\"1\",\"file_max_bytes\":100000000}"}],"_postman_id":"5448268f-290b-4f32-b2e5-e98567466542"},{"name":"Delete an AWS S3 log endpoint","id":"0788c059-6c64-4794-9c86-bba731b88afe","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/s3/{{logging_s3_name}}","description":"<p>Delete the S3 for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","s3","{{logging_s3_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"e11edb2a-5f87-4bdd-b0ee-70e3144fb190","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/s3/test-log-endpoint","description":"Delete the S3 for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"0788c059-6c64-4794-9c86-bba731b88afe"}],"id":"de9faef9-65fb-492f-971b-daf45eba7e0f","description":"<p>Fastly will upload log messages to the S3 bucket in the format specified in the S3 object.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>access_key</td>\n<td>string</td>\n<td>The access key for your S3 account. Not required if iam_role is provided.</td>\n</tr>\n<tr>\n<td>acl</td>\n<td>string</td>\n<td>The access control list (ACL) specific request header. See the AWS documentation for Access Control List (ACL) Specific Request Headers for more information.</td>\n</tr>\n<tr>\n<td>bucket_name</td>\n<td>string</td>\n<td>The bucket name for S3 account.</td>\n</tr>\n<tr>\n<td>domain</td>\n<td>string</td>\n<td>The domain of the Amazon S3 endpoint.</td>\n</tr>\n<tr>\n<td>file_max_bytes</td>\n<td>integer</td>\n<td>The maximum number of bytes for each uploaded file. A value of 0 can be used to indicate there is no limit on the size of uploaded files, otherwise the minimum value is 1048576 bytes (1 MiB.).</td>\n</tr>\n<tr>\n<td>iam_role</td>\n<td>string</td>\n<td>The Amazon Resource Name (ARN) for the IAM role granting Fastly access to S3. Not required if access_key and secret_key are provided.</td>\n</tr>\n<tr>\n<td>path</td>\n<td>string</td>\n<td>The path to upload logs to.</td>\n</tr>\n<tr>\n<td>public_key</td>\n<td>string</td>\n<td>A PGP public key that Fastly will use to encrypt your log files before writing them to disk.</td>\n</tr>\n<tr>\n<td>redundancy</td>\n<td>string</td>\n<td>The S3 redundancy level.</td>\n</tr>\n<tr>\n<td>secret_key</td>\n<td>string</td>\n<td>The secret key for your S3 account. Not required if iam_role is provided.</td>\n</tr>\n<tr>\n<td>server_side_encryption</td>\n<td>string</td>\n<td>Set this to AES256 or aws:kms to enable S3 Server Side Encryption.</td>\n</tr>\n<tr>\n<td>server_side_encryption_kms_key_id</td>\n<td>string</td>\n<td>Optional server-side KMS Key Id. Must be set if server_side_encryption is set to aws:kms or AES256.</td>\n</tr>\n<tr>\n<td>compression_codec</td>\n<td>string</td>\n<td>The codec used for compressing your logs. Valid values are zstd, snappy, and gzip. Specifying both compression_codec and gzip_level in the same API request will result in an error.</td>\n</tr>\n<tr>\n<td>format</td>\n<td>string</td>\n<td>A Fastly log format string.</td>\n</tr>\n<tr>\n<td>format_version</td>\n<td>integer</td>\n<td>The version of the custom logging format used for the configured endpoint. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1.</td>\n</tr>\n<tr>\n<td></td>\n<td>1</td>\n<td>Version 1 log format.</td>\n</tr>\n<tr>\n<td></td>\n<td>2</td>\n<td>Version 2 log format.</td>\n</tr>\n<tr>\n<td>gzip_level</td>\n<td>integer</td>\n<td>The level of gzip encoding when sending logs (default 0, no compression). Specifying both compression_codec and gzip_level in the same API request will result in an error.</td>\n</tr>\n<tr>\n<td>log_processing_region</td>\n<td>string</td>\n<td>The geographic region where the logs will be processed before streaming. Valid values are us, eu, and none for global.</td>\n</tr>\n<tr>\n<td>message_type</td>\n<td>string</td>\n<td>How the message should be formatted.</td>\n</tr>\n<tr>\n<td></td>\n<td>classic</td>\n<td>RFC 3164 syslog prefix.</td>\n</tr>\n<tr>\n<td></td>\n<td>loggly</td>\n<td>RFC 5424 structured syslog.</td>\n</tr>\n<tr>\n<td></td>\n<td>logplex</td>\n<td>Heroku-style length prefixed syslog.</td>\n</tr>\n<tr>\n<td></td>\n<td>blank</td>\n<td>No prefix. Useful for writing JSON and CSV.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The name for the real-time logging configuration.</td>\n</tr>\n<tr>\n<td>period</td>\n<td>integer</td>\n<td>How frequently log files are finalized so they can be available for reading (in seconds).</td>\n</tr>\n<tr>\n<td>placement</td>\n<td>string</td>\n<td>Where in the generated VCL the logging call should be placed. If not set, endpoints with format_version of 2 are placed in vcl_log and those with format_version of 1 are placed in vcl_deliver.</td>\n</tr>\n<tr>\n<td></td>\n<td>none</td>\n<td>Do not render a log statement into VCL. Use this option if you intend to write a log statement manually.</td>\n</tr>\n<tr>\n<td>response_condition</td>\n<td>string</td>\n<td>The name of an existing condition in the configured endpoint, or leave blank to always execute.</td>\n</tr>\n<tr>\n<td>timestamp_format</td>\n<td>string</td>\n<td>A timestamp format.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>string</td>\n<td>String identifying a service version.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"de9faef9-65fb-492f-971b-daf45eba7e0f"},{"name":"Scalyr","item":[{"name":"List Scalyr log endpoints","id":"45c07ed0-4461-469f-a51a-8f06aff196e3","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/scalyr","description":"<p>List all of the Scalyrs for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","scalyr"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"0277f5b0-7a9b-47f3-885d-63fa3c58daf1","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/scalyr","description":"List all of the Scalyrs for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"name\":\"test-log-endpoint\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"response_condition\":\"\",\"placement\":null,\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"region\":\"US\",\"token\":\"SCALYR_KEY\",\"project_id\":\"logplex\"}]"}],"_postman_id":"45c07ed0-4461-469f-a51a-8f06aff196e3"},{"name":"Create a Scalyr log endpoint","id":"4006f260-2708-423d-8fe2-d383f211499e","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/scalyr","description":"<p>Create a Scalyr for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","scalyr"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"14f60774-cf23-4bfc-9102-78d6f329a599","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/scalyr","description":"Create a Scalyr for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"name\":\"test-log-endpoint\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"response_condition\":\"\",\"placement\":null,\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"region\":\"US\",\"token\":\"SCALYR_KEY\",\"project_id\":\"logplex\"}"}],"_postman_id":"4006f260-2708-423d-8fe2-d383f211499e"},{"name":"Get a Scalyr log endpoint","id":"adb591b1-a9b6-4729-ad6d-2464a45a35f9","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/scalyr/{{logging_scalyr_name}}","description":"<p>Get the Scalyr for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","scalyr","{{logging_scalyr_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"06b4acce-7f03-4c77-8c3a-b6aabd4481a9","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/scalyr/test-log-endpoint","description":"Get the Scalyr for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"name\":\"test-log-endpoint\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"response_condition\":\"\",\"placement\":null,\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"region\":\"US\",\"token\":\"SCALYR_KEY\",\"project_id\":\"logplex\"}"}],"_postman_id":"adb591b1-a9b6-4729-ad6d-2464a45a35f9"},{"name":"Update the Scalyr log endpoint","id":"c194c434-faaf-4a90-b0e1-54181577ee47","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/scalyr/{{logging_scalyr_name}}","description":"<p>Update the Scalyr for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","scalyr","{{logging_scalyr_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"0a519c94-1e8b-4ce9-bf00-08a0d1db59bb","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/scalyr/test-log-endpoint","description":"Update the Scalyr for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"name\":\"updated-test-log-endpoint\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"response_condition\":\"\",\"placement\":null,\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"region\":\"US\",\"token\":\"SCALYR_KEY\",\"project_id\":\"logplex\"}"}],"_postman_id":"c194c434-faaf-4a90-b0e1-54181577ee47"},{"name":"Delete the Scalyr log endpoint","id":"49c8690d-0cd6-4027-9e12-8e845f6663ac","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/scalyr/{{logging_scalyr_name}}","description":"<p>Delete the Scalyr for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","scalyr","{{logging_scalyr_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"3bef8151-b12f-4500-82ec-2ca2a169fe7e","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/scalyr/test-log-endpoint","description":"Delete the Scalyr for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"49c8690d-0cd6-4027-9e12-8e845f6663ac"}],"id":"6081666e-a8e0-4f4b-9c0c-468db48c326e","description":"<p>Fastly will stream log messages to the Scalyr account in the format specified in the Scalyr object.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>project_id</td>\n<td>string</td>\n<td>The name of the logfile within Scalyr.</td>\n</tr>\n<tr>\n<td>region</td>\n<td>string</td>\n<td>The region that log data will be sent to.</td>\n</tr>\n<tr>\n<td>token</td>\n<td>string</td>\n<td>The token to use for authentication.</td>\n</tr>\n<tr>\n<td>format</td>\n<td>string</td>\n<td>A Fastly log format string.</td>\n</tr>\n<tr>\n<td>format_version</td>\n<td>integer</td>\n<td>The version of the custom logging format used for the configured endpoint. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1.</td>\n</tr>\n<tr>\n<td></td>\n<td>1</td>\n<td>Version 1 log format.</td>\n</tr>\n<tr>\n<td></td>\n<td>2</td>\n<td>Version 2 log format.</td>\n</tr>\n<tr>\n<td>log_processing_region</td>\n<td>string</td>\n<td>The geographic region where the logs will be processed before streaming. Valid values are us, eu, and none for global.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The name for the real-time logging configuration.</td>\n</tr>\n<tr>\n<td>placement</td>\n<td>string</td>\n<td>Where in the generated VCL the logging call should be placed. If not set, endpoints with format_version of 2 are placed in vcl_log and those with format_version of 1 are placed in vcl_deliver.</td>\n</tr>\n<tr>\n<td></td>\n<td>none</td>\n<td>Do not render a log statement into VCL. Use this option if you intend to write a log statement manually.</td>\n</tr>\n<tr>\n<td>response_condition</td>\n<td>string</td>\n<td>The name of an existing condition in the configured endpoint, or leave blank to always execute.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>string</td>\n<td>String identifying a service version.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"6081666e-a8e0-4f4b-9c0c-468db48c326e"},{"name":"SFTP","item":[{"name":"List SFTP log endpoints","id":"894804a4-729a-49ce-aa64-42bfbeeb71f2","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/sftp","description":"<p>List all of the SFTPs for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","sftp"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"c69352c9-73d6-4c6d-81bc-1ca6a59e361c","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/sftp","description":"List all of the SFTPs for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"address\":\"example.com\",\"created_at\":\"2020-02-25T23:39:09.000Z\",\"deleted_at\":null,\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"compression_codec\":\"zstd\",\"gzip_level\":0,\"message_type\":\"classic\",\"name\":\"test-log-endpoint\",\"password\":\"REDACTED\",\"path\":\"/\",\"period\":\"3600\",\"placement\":null,\"port\":\"22\",\"public_key\":null,\"response_condition\":\"\",\"secret_key\":\"\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"ssh_known_hosts\":\"example.com ecdsa-sha2-nistp256 abc123XYX...\",\"timestamp_format\":\"%Y-%m-%dT%H:%M:%S.000\",\"updated_at\":\"2020-03-01T12:21:37.000Z\",\"user\":\"anonymous\",\"version\":\"1\"}]"}],"_postman_id":"894804a4-729a-49ce-aa64-42bfbeeb71f2"},{"name":"Create an SFTP log endpoint","id":"8062ef33-7ccb-436c-ad4b-de86ee327b1b","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/sftp","description":"<p>Create a SFTP for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","sftp"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"c4c667a1-cac1-4289-b2b4-393af68fbd6f","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/sftp","description":"Create a SFTP for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"address\":\"example.com\",\"created_at\":\"2020-02-25T23:39:09.000Z\",\"deleted_at\":null,\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"compression_codec\":\"zstd\",\"gzip_level\":0,\"message_type\":\"classic\",\"name\":\"test-log-endpoint\",\"password\":\"REDACTED\",\"path\":\"/\",\"period\":\"3600\",\"placement\":null,\"port\":\"22\",\"public_key\":null,\"response_condition\":\"\",\"secret_key\":\"\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"ssh_known_hosts\":\"example.com ecdsa-sha2-nistp256 abc123XYX...\",\"timestamp_format\":\"%Y-%m-%dT%H:%M:%S.000\",\"updated_at\":\"2020-03-01T12:21:37.000Z\",\"user\":\"anonymous\",\"version\":\"1\"}"}],"_postman_id":"8062ef33-7ccb-436c-ad4b-de86ee327b1b"},{"name":"Get an SFTP log endpoint","id":"b2328192-3658-4824-8b9c-cf9026a38c88","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/sftp/{{logging_sftp_name}}","description":"<p>Get the SFTP for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","sftp","{{logging_sftp_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"0b896a72-456a-407b-be02-fafd467db217","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/sftp/test-log-endpoint","description":"Get the SFTP for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"address\":\"example.com\",\"created_at\":\"2020-02-25T23:39:09.000Z\",\"deleted_at\":null,\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"compression_codec\":\"zstd\",\"gzip_level\":0,\"message_type\":\"classic\",\"name\":\"test-log-endpoint\",\"password\":\"REDACTED\",\"path\":\"/\",\"period\":\"3600\",\"placement\":null,\"port\":\"22\",\"public_key\":null,\"response_condition\":\"\",\"secret_key\":\"\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"ssh_known_hosts\":\"example.com ecdsa-sha2-nistp256 abc123XYX...\",\"timestamp_format\":\"%Y-%m-%dT%H:%M:%S.000\",\"updated_at\":\"2020-03-01T12:21:37.000Z\",\"user\":\"anonymous\",\"version\":\"1\"}"}],"_postman_id":"b2328192-3658-4824-8b9c-cf9026a38c88"},{"name":"Update an SFTP log endpoint","id":"04065307-f813-4d15-9f8f-c362d0239e0c","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/sftp/{{logging_sftp_name}}","description":"<p>Update the SFTP for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","sftp","{{logging_sftp_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"af526a70-78fa-40dc-bc12-594a1f5870ac","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/sftp/test-log-endpoint","description":"Update the SFTP for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"address\":\"example.com\",\"created_at\":\"2020-02-25T23:39:09.000Z\",\"deleted_at\":null,\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"compression_codec\":\"zstd\",\"gzip_level\":0,\"message_type\":\"classic\",\"name\":\"updated-test-log-endpoint\",\"password\":\"REDACTED\",\"path\":\"/\",\"period\":\"3600\",\"placement\":null,\"port\":\"22\",\"public_key\":null,\"response_condition\":\"\",\"secret_key\":\"\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"ssh_known_hosts\":\"example.com ecdsa-sha2-nistp256 abc123XYX...\",\"timestamp_format\":\"%Y-%m-%dT%H:%M:%S.000\",\"updated_at\":\"2020-03-01T12:21:37.000Z\",\"user\":\"anonymous\",\"version\":\"1\"}"}],"_postman_id":"04065307-f813-4d15-9f8f-c362d0239e0c"},{"name":"Delete an SFTP log endpoint","id":"0e90dd54-1d24-4b55-9559-d345cdfdb93a","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/sftp/{{logging_sftp_name}}","description":"<p>Delete the SFTP for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","sftp","{{logging_sftp_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"3fded687-82d2-401a-a505-50b5488bca78","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/sftp/test-log-endpoint","description":"Delete the SFTP for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"0e90dd54-1d24-4b55-9559-d345cdfdb93a"}],"id":"c32963b3-7148-41f9-b276-b124449a9f3d","description":"<p>Fastly will upload log messages periodically to the server in the format specified in the SFTP object.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>password</td>\n<td>string</td>\n<td>The password for the server. If both password and secret_key are passed, secret_key will be used in preference.</td>\n</tr>\n<tr>\n<td>path</td>\n<td>string</td>\n<td>The path to upload logs to.</td>\n</tr>\n<tr>\n<td>public_key</td>\n<td>string</td>\n<td>A PGP public key that Fastly will use to encrypt your log files before writing them to disk.</td>\n</tr>\n<tr>\n<td>secret_key</td>\n<td>string</td>\n<td>The SSH private key for the server. If both password and secret_key are passed, secret_key will be used in preference.</td>\n</tr>\n<tr>\n<td>ssh_known_hosts</td>\n<td>string</td>\n<td>A list of host keys for all hosts we can connect to over SFTP.</td>\n</tr>\n<tr>\n<td>user</td>\n<td>string</td>\n<td>The username for the server.</td>\n</tr>\n<tr>\n<td>address</td>\n<td>string</td>\n<td>A hostname or IPv4 address.</td>\n</tr>\n<tr>\n<td>compression_codec</td>\n<td>string</td>\n<td>The codec used for compressing your logs. Valid values are zstd, snappy, and gzip. Specifying both compression_codec and gzip_level in the same API request will result in an error.</td>\n</tr>\n<tr>\n<td>format</td>\n<td>string</td>\n<td>A Fastly log format string.</td>\n</tr>\n<tr>\n<td>format_version</td>\n<td>integer</td>\n<td>The version of the custom logging format used for the configured endpoint. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1.</td>\n</tr>\n<tr>\n<td></td>\n<td>1</td>\n<td>Version 1 log format.</td>\n</tr>\n<tr>\n<td></td>\n<td>2</td>\n<td>Version 2 log format.</td>\n</tr>\n<tr>\n<td>gzip_level</td>\n<td>integer</td>\n<td>The level of gzip encoding when sending logs (default 0, no compression). Specifying both compression_codec and gzip_level in the same API request will result in an error.</td>\n</tr>\n<tr>\n<td>log_processing_region</td>\n<td>string</td>\n<td>The geographic region where the logs will be processed before streaming. Valid values are us, eu, and none for global.</td>\n</tr>\n<tr>\n<td>message_type</td>\n<td>string</td>\n<td>How the message should be formatted.</td>\n</tr>\n<tr>\n<td></td>\n<td>classic</td>\n<td>RFC 3164 syslog prefix.</td>\n</tr>\n<tr>\n<td></td>\n<td>loggly</td>\n<td>RFC 5424 structured syslog.</td>\n</tr>\n<tr>\n<td></td>\n<td>logplex</td>\n<td>Heroku-style length prefixed syslog.</td>\n</tr>\n<tr>\n<td></td>\n<td>blank</td>\n<td>No prefix. Useful for writing JSON and CSV.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The name for the real-time logging configuration.</td>\n</tr>\n<tr>\n<td>period</td>\n<td>integer</td>\n<td>How frequently log files are finalized so they can be available for reading (in seconds).</td>\n</tr>\n<tr>\n<td>placement</td>\n<td>string</td>\n<td>Where in the generated VCL the logging call should be placed. If not set, endpoints with format_version of 2 are placed in vcl_log and those with format_version of 1 are placed in vcl_deliver.</td>\n</tr>\n<tr>\n<td></td>\n<td>none</td>\n<td>Do not render a log statement into VCL. Use this option if you intend to write a log statement manually.</td>\n</tr>\n<tr>\n<td>port</td>\n<td>integer</td>\n<td>The port number.</td>\n</tr>\n<tr>\n<td>response_condition</td>\n<td>string</td>\n<td>The name of an existing condition in the configured endpoint, or leave blank to always execute.</td>\n</tr>\n<tr>\n<td>timestamp_format</td>\n<td>string</td>\n<td>A timestamp format.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>string</td>\n<td>String identifying a service version.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"c32963b3-7148-41f9-b276-b124449a9f3d"},{"name":"Splunk","item":[{"name":"List Splunk log endpoints","id":"07a31d21-b84e-43b4-b690-d9f52fecc1fd","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/splunk","description":"<p>List all of the Splunk logging objects for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","splunk"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"b4c855ae-5250-4f3b-9e76-f80c3399ff2e","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/splunk","description":"List all of the Splunk logging objects for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"deleted_at\":null,\"updated_at\":\"2020-08-23T19:54:52.000Z\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"url\":\"https://mysplunkendpoint.example.com/services/collector/event\",\"tls_hostname\":null,\"tls_ca_cert\":null,\"tls_client_key\":null,\"tls_client_cert\":null,\"version\":\"1\",\"request_max_entries\":0,\"request_max_bytes\":0,\"placement\":null,\"created_at\":\"2020-08-23T19:54:52.000Z\",\"response_condition\":\"\",\"name\":\"test-log-endpoint\",\"format_version\":\"2\",\"token\":\"test-token\",\"use_tls\":\"0\"}]"}],"_postman_id":"07a31d21-b84e-43b4-b690-d9f52fecc1fd"},{"name":"Create a Splunk log endpoint","id":"d98a2a13-a215-4a2b-9275-4dc816f60be0","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/splunk","description":"<p>Create a Splunk logging object for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","splunk"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"231a4817-8eb0-462f-b445-6a8f10c6d14e","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/splunk","description":"Create a Splunk logging object for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"deleted_at\":null,\"updated_at\":\"2020-08-23T19:54:52.000Z\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"url\":\"https://mysplunkendpoint.example.com/services/collector/event\",\"tls_hostname\":null,\"tls_ca_cert\":null,\"tls_client_key\":null,\"tls_client_cert\":null,\"version\":\"1\",\"request_max_entries\":0,\"request_max_bytes\":0,\"placement\":null,\"created_at\":\"2020-08-23T19:54:52.000Z\",\"response_condition\":\"\",\"name\":\"test-log-endpoint\",\"format_version\":\"2\",\"token\":\"test-token\",\"use_tls\":\"0\"}"}],"_postman_id":"d98a2a13-a215-4a2b-9275-4dc816f60be0"},{"name":"Get a Splunk log endpoint","id":"9600b87c-0ff1-4dde-b5b3-bdcc4e1be13c","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/splunk/{{logging_splunk_name}}","description":"<p>Get the details for a Splunk logging object for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","splunk","{{logging_splunk_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"fa294648-1168-4585-a62b-c0b2d1f18a14","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/splunk/test-log-endpoint","description":"Get the details for a Splunk logging object for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"deleted_at\":null,\"updated_at\":\"2020-08-23T19:54:52.000Z\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"url\":\"https://mysplunkendpoint.example.com/services/collector/event\",\"tls_hostname\":null,\"tls_ca_cert\":null,\"tls_client_key\":null,\"tls_client_cert\":null,\"version\":\"1\",\"request_max_entries\":0,\"request_max_bytes\":0,\"placement\":null,\"created_at\":\"2020-08-23T19:54:52.000Z\",\"response_condition\":\"\",\"name\":\"test-log-endpoint\",\"format_version\":\"2\",\"token\":\"test-token\",\"use_tls\":\"0\"}"}],"_postman_id":"9600b87c-0ff1-4dde-b5b3-bdcc4e1be13c"},{"name":"Update a Splunk log endpoint","id":"c20c4212-62f9-477d-9cdc-7fa8ba40e8df","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/splunk/{{logging_splunk_name}}","description":"<p>Update the Splunk logging object for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","splunk","{{logging_splunk_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"270c5515-0652-46aa-9a20-09800e60c441","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/splunk/test-log-endpoint","description":"Update the Splunk logging object for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"deleted_at\":null,\"updated_at\":\"2020-08-23T19:54:52.000Z\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"url\":\"https://mysplunkendpoint.example.com/services/collector/event\",\"tls_hostname\":null,\"tls_ca_cert\":null,\"tls_client_key\":null,\"tls_client_cert\":null,\"version\":\"1\",\"request_max_entries\":0,\"request_max_bytes\":0,\"placement\":null,\"created_at\":\"2020-08-23T19:54:52.000Z\",\"response_condition\":\"\",\"name\":\"updated-test-log-endpoint\",\"format_version\":\"2\",\"token\":\"test-token\",\"use_tls\":\"0\"}"}],"_postman_id":"c20c4212-62f9-477d-9cdc-7fa8ba40e8df"},{"name":"Delete a Splunk log endpoint","id":"d015ac41-99bf-4209-ae0d-a582b783a5a6","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/splunk/{{logging_splunk_name}}","description":"<p>Delete the Splunk logging object for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","splunk","{{logging_splunk_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"5154af1a-3ae8-40ea-b90d-abea5985fdbf","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/splunk/test-log-endpoint","description":"Delete the Splunk logging object for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"d015ac41-99bf-4209-ae0d-a582b783a5a6"}],"id":"daeb13dd-a8de-42b1-95a9-e4dcfe54dfb9","description":"<p>Fastly will POST messages to your Splunk account in the format specified in the Splunk object.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>token</td>\n<td>string</td>\n<td>A Splunk token for use in posting logs over HTTP to your collector.</td>\n</tr>\n<tr>\n<td>url</td>\n<td>string</td>\n<td>The URL to post logs to.</td>\n</tr>\n<tr>\n<td>use_tls</td>\n<td>string</td>\n<td>Whether to use TLS.</td>\n</tr>\n<tr>\n<td></td>\n<td>0</td>\n<td>Do not use TLS.</td>\n</tr>\n<tr>\n<td></td>\n<td>1</td>\n<td>Use TLS.</td>\n</tr>\n<tr>\n<td>format</td>\n<td>string</td>\n<td>A Fastly log format string.</td>\n</tr>\n<tr>\n<td>format_version</td>\n<td>integer</td>\n<td>The version of the custom logging format used for the configured endpoint. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1.</td>\n</tr>\n<tr>\n<td></td>\n<td>1</td>\n<td>Version 1 log format.</td>\n</tr>\n<tr>\n<td></td>\n<td>2</td>\n<td>Version 2 log format.</td>\n</tr>\n<tr>\n<td>log_processing_region</td>\n<td>string</td>\n<td>The geographic region where the logs will be processed before streaming. Valid values are us, eu, and none for global.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The name for the real-time logging configuration.</td>\n</tr>\n<tr>\n<td>placement</td>\n<td>string</td>\n<td>Where in the generated VCL the logging call should be placed. If not set, endpoints with format_version of 2 are placed in vcl_log and those with format_version of 1 are placed in vcl_deliver.</td>\n</tr>\n<tr>\n<td></td>\n<td>none</td>\n<td>Do not render a log statement into VCL. Use this option if you intend to write a log statement manually.</td>\n</tr>\n<tr>\n<td>request_max_bytes</td>\n<td>integer</td>\n<td>The maximum number of bytes sent in one request. Defaults 0 for unbounded.</td>\n</tr>\n<tr>\n<td>request_max_entries</td>\n<td>integer</td>\n<td>The maximum number of logs sent in one request. Defaults 0 for unbounded.</td>\n</tr>\n<tr>\n<td>response_condition</td>\n<td>string</td>\n<td>The name of an existing condition in the configured endpoint, or leave blank to always execute.</td>\n</tr>\n<tr>\n<td>tls_ca_cert</td>\n<td>string</td>\n<td>A secure certificate to authenticate a server with. Must be in PEM format.</td>\n</tr>\n<tr>\n<td>tls_client_cert</td>\n<td>string</td>\n<td>The client certificate used to make authenticated requests. Must be in PEM format.</td>\n</tr>\n<tr>\n<td>tls_client_key</td>\n<td>string</td>\n<td>The client private key used to make authenticated requests. Must be in PEM format.</td>\n</tr>\n<tr>\n<td>tls_hostname</td>\n<td>string</td>\n<td>The hostname to verify the server's certificate. This should be one of the Subject Alternative Name (SAN) fields for the certificate. Common Names (CN) are not supported.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>string</td>\n<td>String identifying a service version.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"daeb13dd-a8de-42b1-95a9-e4dcfe54dfb9"},{"name":"Sumologic","item":[{"name":"List Sumologic log endpoints","id":"ff283562-5c29-472c-9936-123112a3e70c","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/sumologic","description":"<p>List all of the Sumologics for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","sumologic"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"c1e1a43f-47f2-438a-9b9b-9804a3df3cf3","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/sumologic","description":"List all of the Sumologics for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"created_at\":\"2020-05-23T21:37:09.000Z\",\"deleted_at\":null,\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"message_type\":\"classic\",\"name\":\"test-log-endpoint\",\"response_condition\":\"\",\"placement\":null,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"updated_at\":\"2020-05-23T21:37:09.000Z\",\"url\":\"https://endpoint1.collection.us2.sumologic.com/receiver/v1/http/your_end_point_here\",\"version\":\"1\"}]"}],"_postman_id":"ff283562-5c29-472c-9936-123112a3e70c"},{"name":"Create a Sumologic log endpoint","id":"6d122f2c-bb29-4182-b8f3-02e93db5aef6","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/sumologic","description":"<p>Create a Sumologic for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","sumologic"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"09f138f3-857f-4047-8300-139c0ca93de3","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/sumologic","description":"Create a Sumologic for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"created_at\":\"2020-05-23T21:37:09.000Z\",\"deleted_at\":null,\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"message_type\":\"classic\",\"name\":\"test-log-endpoint\",\"response_condition\":\"\",\"placement\":null,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"updated_at\":\"2020-05-23T21:37:09.000Z\",\"url\":\"https://endpoint1.collection.us2.sumologic.com/receiver/v1/http/your_end_point_here\",\"version\":\"1\"}"}],"_postman_id":"6d122f2c-bb29-4182-b8f3-02e93db5aef6"},{"name":"Get a Sumologic log endpoint","id":"28f66b99-19c8-497a-a17b-39b22ab158f1","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/sumologic/{{logging_sumologic_name}}","description":"<p>Get the Sumologic for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","sumologic","{{logging_sumologic_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"6acc6c34-884a-40b4-94ad-2dd6c1ff9b1f","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/sumologic/test-log-endpoint","description":"Get the Sumologic for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"created_at\":\"2020-05-23T21:37:09.000Z\",\"deleted_at\":null,\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"message_type\":\"classic\",\"name\":\"test-log-endpoint\",\"response_condition\":\"\",\"placement\":null,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"updated_at\":\"2020-05-23T21:37:09.000Z\",\"url\":\"https://endpoint1.collection.us2.sumologic.com/receiver/v1/http/your_end_point_here\",\"version\":\"1\"}"}],"_postman_id":"28f66b99-19c8-497a-a17b-39b22ab158f1"},{"name":"Update a Sumologic log endpoint","id":"4889d51e-3335-41ad-aebb-263e5fadafd6","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/sumologic/{{logging_sumologic_name}}","description":"<p>Update the Sumologic for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","sumologic","{{logging_sumologic_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"61fa405a-f0c2-4d74-96e3-1bb7991baf06","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/sumologic/test-log-endpoint","description":"Update the Sumologic for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"created_at\":\"2020-05-23T21:37:09.000Z\",\"deleted_at\":null,\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"message_type\":\"classic\",\"name\":\"updated-test-log-endpoint\",\"response_condition\":\"\",\"placement\":null,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"updated_at\":\"2020-05-23T21:37:09.000Z\",\"url\":\"https://endpoint1.collection.us2.sumologic.com/receiver/v1/http/your_end_point_here\",\"version\":\"1\"}"}],"_postman_id":"4889d51e-3335-41ad-aebb-263e5fadafd6"},{"name":"Delete a Sumologic log endpoint","id":"8d224245-24ab-4204-9b96-c41c18c5422a","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/sumologic/{{logging_sumologic_name}}","description":"<p>Delete the Sumologic for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","sumologic","{{logging_sumologic_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"1d34cc6f-c067-4499-9c56-c4659d5310dc","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/sumologic/test-log-endpoint","description":"Delete the Sumologic for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"8d224245-24ab-4204-9b96-c41c18c5422a"}],"id":"7889c79a-33b5-4b1b-b39d-1dd21710210f","description":"<p>Fastly will POST messages to the Sumo Logic account in the format specified in the Sumologic object.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>message_type</td>\n<td>string</td>\n<td>How the message should be formatted.</td>\n</tr>\n<tr>\n<td></td>\n<td>classic</td>\n<td>RFC 3164 syslog prefix.</td>\n</tr>\n<tr>\n<td></td>\n<td>loggly</td>\n<td>RFC 5424 structured syslog.</td>\n</tr>\n<tr>\n<td></td>\n<td>logplex</td>\n<td>Heroku-style length prefixed syslog.</td>\n</tr>\n<tr>\n<td></td>\n<td>blank</td>\n<td>No prefix. Useful for writing JSON and CSV.</td>\n</tr>\n<tr>\n<td>url</td>\n<td>string</td>\n<td>The URL to post logs to.</td>\n</tr>\n<tr>\n<td>format</td>\n<td>string</td>\n<td>A Fastly log format string.</td>\n</tr>\n<tr>\n<td>format_version</td>\n<td>integer</td>\n<td>The version of the custom logging format used for the configured endpoint. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1.</td>\n</tr>\n<tr>\n<td></td>\n<td>1</td>\n<td>Version 1 log format.</td>\n</tr>\n<tr>\n<td></td>\n<td>2</td>\n<td>Version 2 log format.</td>\n</tr>\n<tr>\n<td>log_processing_region</td>\n<td>string</td>\n<td>The geographic region where the logs will be processed before streaming. Valid values are us, eu, and none for global.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The name for the real-time logging configuration.</td>\n</tr>\n<tr>\n<td>placement</td>\n<td>string</td>\n<td>Where in the generated VCL the logging call should be placed. If not set, endpoints with format_version of 2 are placed in vcl_log and those with format_version of 1 are placed in vcl_deliver.</td>\n</tr>\n<tr>\n<td></td>\n<td>none</td>\n<td>Do not render a log statement into VCL. Use this option if you intend to write a log statement manually.</td>\n</tr>\n<tr>\n<td>response_condition</td>\n<td>string</td>\n<td>The name of an existing condition in the configured endpoint, or leave blank to always execute.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>string</td>\n<td>String identifying a service version.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"7889c79a-33b5-4b1b-b39d-1dd21710210f"},{"name":"Syslog","item":[{"name":"List Syslog log endpoints","id":"3be4eb95-0615-487f-a336-6b792bafe61f","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/syslog","description":"<p>List all of the Syslogs for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","syslog"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"e0698240-096b-4a19-a91a-1de2cb713ca3","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/syslog","description":"List all of the Syslogs for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"address\":\"example.com\",\"created_at\":\"2020-05-26T16:41:38.000Z\",\"deleted_at\":null,\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"hostname\":\"example.com\",\"ipv4\":null,\"message_type\":\"classic\",\"name\":\"test-log-endpoint\",\"placement\":null,\"port\":514,\"response_condition\":\"\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"tls_ca_cert\":null,\"tls_client_cert\":null,\"tls_client_key\":null,\"tls_hostname\":null,\"token\":null,\"updated_at\":\"2020-05-26T16:41:38.000Z\",\"use_tls\":\"0\",\"version\":\"1\"}]"}],"_postman_id":"3be4eb95-0615-487f-a336-6b792bafe61f"},{"name":"Create a syslog log endpoint","id":"72e9a2ca-29cc-479c-8d34-e6e01b710455","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/syslog","description":"<p>Create a Syslog for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","syslog"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"1d69f288-67d4-4bea-bb16-0af3896fba83","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/syslog","description":"Create a Syslog for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"address\":\"example.com\",\"created_at\":\"2020-05-26T16:41:38.000Z\",\"deleted_at\":null,\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"hostname\":\"example.com\",\"ipv4\":null,\"message_type\":\"classic\",\"name\":\"test-log-endpoint\",\"placement\":null,\"port\":514,\"response_condition\":\"\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"tls_ca_cert\":null,\"tls_client_cert\":null,\"tls_client_key\":null,\"tls_hostname\":null,\"token\":null,\"updated_at\":\"2020-05-26T16:41:38.000Z\",\"use_tls\":\"0\",\"version\":\"1\"}"}],"_postman_id":"72e9a2ca-29cc-479c-8d34-e6e01b710455"},{"name":"Get a syslog log endpoint","id":"68994aec-8950-4611-a0cf-7ad2b6e4cb36","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/syslog/{{logging_syslog_name}}","description":"<p>Get the Syslog for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","syslog","{{logging_syslog_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"a2778360-27a7-44fd-a4f8-981e63971c14","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/syslog/test-log-endpoint","description":"Get the Syslog for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"address\":\"example.com\",\"created_at\":\"2020-05-26T16:41:38.000Z\",\"deleted_at\":null,\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"hostname\":\"example.com\",\"ipv4\":null,\"message_type\":\"classic\",\"name\":\"test-log-endpoint\",\"placement\":null,\"port\":514,\"response_condition\":\"\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"tls_ca_cert\":null,\"tls_client_cert\":null,\"tls_client_key\":null,\"tls_hostname\":null,\"token\":null,\"updated_at\":\"2020-05-26T16:41:38.000Z\",\"use_tls\":\"0\",\"version\":\"1\"}"}],"_postman_id":"68994aec-8950-4611-a0cf-7ad2b6e4cb36"},{"name":"Update a syslog log endpoint","id":"8f54b6ce-e7c4-42c1-a3be-5f493fc75751","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/syslog/{{logging_syslog_name}}","description":"<p>Update the Syslog for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","syslog","{{logging_syslog_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"c6755a35-593c-4900-b7cb-5cefc8d5360d","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/syslog/test-log-endpoint","description":"Update the Syslog for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"address\":\"example.com\",\"created_at\":\"2020-05-26T16:41:38.000Z\",\"deleted_at\":null,\"format\":\"%h %l %u %t \\\"%r\\\" %>s %b\",\"format_version\":\"2\",\"hostname\":\"example.com\",\"ipv4\":null,\"message_type\":\"classic\",\"name\":\"updated-test-log-endpoint\",\"placement\":null,\"port\":514,\"response_condition\":\"\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"tls_ca_cert\":null,\"tls_client_cert\":null,\"tls_client_key\":null,\"tls_hostname\":null,\"token\":null,\"updated_at\":\"2020-05-26T16:41:38.000Z\",\"use_tls\":\"0\",\"version\":\"1\"}"}],"_postman_id":"8f54b6ce-e7c4-42c1-a3be-5f493fc75751"},{"name":"Delete a syslog log endpoint","id":"1caf80e3-bf80-400c-8219-7436de71d7b3","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/logging/syslog/{{logging_syslog_name}}","description":"<p>Delete the Syslog for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","logging","syslog","{{logging_syslog_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"2632ff20-ddb1-4c22-b69b-1cbd9f7070b4","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/logging/syslog/test-log-endpoint","description":"Delete the Syslog for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"1caf80e3-bf80-400c-8219-7436de71d7b3"}],"id":"b9d91e45-5fc4-4dff-b1ac-0eaa39cba71e","description":"<p>Fastly will stream log messages to the location in the format specified in the Syslog object.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>hostname</td>\n<td>string</td>\n<td>The hostname used for the syslog endpoint.</td>\n</tr>\n<tr>\n<td>ipv4</td>\n<td>string</td>\n<td>The IPv4 address used for the syslog endpoint.</td>\n</tr>\n<tr>\n<td>message_type</td>\n<td>string</td>\n<td>How the message should be formatted.</td>\n</tr>\n<tr>\n<td></td>\n<td>classic</td>\n<td>RFC 3164 syslog prefix.</td>\n</tr>\n<tr>\n<td></td>\n<td>loggly</td>\n<td>RFC 5424 structured syslog.</td>\n</tr>\n<tr>\n<td></td>\n<td>logplex</td>\n<td>Heroku-style length prefixed syslog.</td>\n</tr>\n<tr>\n<td></td>\n<td>blank</td>\n<td>No prefix. Useful for writing JSON and CSV.</td>\n</tr>\n<tr>\n<td>token</td>\n<td>string</td>\n<td>Whether to prepend each message with a specific token.</td>\n</tr>\n<tr>\n<td>use_tls</td>\n<td>string</td>\n<td>Whether to use TLS.</td>\n</tr>\n<tr>\n<td></td>\n<td>0</td>\n<td>Do not use TLS.</td>\n</tr>\n<tr>\n<td></td>\n<td>1</td>\n<td>Use TLS.</td>\n</tr>\n<tr>\n<td>address</td>\n<td>string</td>\n<td>A hostname or IPv4 address.</td>\n</tr>\n<tr>\n<td>format</td>\n<td>string</td>\n<td>A Fastly log format string.</td>\n</tr>\n<tr>\n<td>format_version</td>\n<td>integer</td>\n<td>The version of the custom logging format used for the configured endpoint. The logging call gets placed by default in vcl_log if format_version is set to 2 and in vcl_deliver if format_version is set to 1.</td>\n</tr>\n<tr>\n<td></td>\n<td>1</td>\n<td>Version 1 log format.</td>\n</tr>\n<tr>\n<td></td>\n<td>2</td>\n<td>Version 2 log format.</td>\n</tr>\n<tr>\n<td>log_processing_region</td>\n<td>string</td>\n<td>The geographic region where the logs will be processed before streaming. Valid values are us, eu, and none for global.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The name for the real-time logging configuration.</td>\n</tr>\n<tr>\n<td>placement</td>\n<td>string</td>\n<td>Where in the generated VCL the logging call should be placed. If not set, endpoints with format_version of 2 are placed in vcl_log and those with format_version of 1 are placed in vcl_deliver.</td>\n</tr>\n<tr>\n<td></td>\n<td>none</td>\n<td>Do not render a log statement into VCL. Use this option if you intend to write a log statement manually.</td>\n</tr>\n<tr>\n<td>port</td>\n<td>integer</td>\n<td>The port number.</td>\n</tr>\n<tr>\n<td>response_condition</td>\n<td>string</td>\n<td>The name of an existing condition in the configured endpoint, or leave blank to always execute.</td>\n</tr>\n<tr>\n<td>tls_ca_cert</td>\n<td>string</td>\n<td>A secure certificate to authenticate a server with. Must be in PEM format.</td>\n</tr>\n<tr>\n<td>tls_client_cert</td>\n<td>string</td>\n<td>The client certificate used to make authenticated requests. Must be in PEM format.</td>\n</tr>\n<tr>\n<td>tls_client_key</td>\n<td>string</td>\n<td>The client private key used to make authenticated requests. Must be in PEM format.</td>\n</tr>\n<tr>\n<td>tls_hostname</td>\n<td>string</td>\n<td>The hostname to verify the server's certificate. This should be one of the Subject Alternative Name (SAN) fields for the certificate. Common Names (CN) are not supported.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>string</td>\n<td>String identifying a service version.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"b9d91e45-5fc4-4dff-b1ac-0eaa39cba71e"}],"id":"cd6dbe98-0920-47d5-b0a0-71e24fe2dc56","_postman_id":"cd6dbe98-0920-47d5-b0a0-71e24fe2dc56","description":""},{"name":"Domain metrics","item":[{"name":"Domain Inspector Historical API","item":[{"name":"Get historical domain data for a service","id":"e5e1b6fc-0574-40e7-a292-23d014c3d531","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/metrics/domains/services/{{service_id}}?cursor&datacenter&domain&downsample&end&group_by&limit&metric&region&start","description":"<p>Fetches historical domain metrics for a given Fastly service, optionally filtering and grouping the results by domain, region, or POP.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["metrics","domains","services","{{service_id}}"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Cursor value from the next_cursor field of a previous response, used to retrieve the next page. To request the first page, this should be empty.</p>\n","type":"text/plain"},"key":"cursor"},{"description":{"content":"<p>Limit query to one or more specific POPs. Values should be comma-separated.</p>\n","type":"text/plain"},"key":"datacenter"},{"description":{"content":"<p>Limit query to one or more specific domains. Values should be comma-separated.</p>\n","type":"text/plain"},"key":"domain"},{"description":{"content":"<p>Duration of sample windows.</p>\n","type":"text/plain"},"key":"downsample"},{"description":{"content":"<p>A valid ISO-8601-formatted date and time, or UNIX timestamp, indicating the exclusive end of the query time range. If not provided, a default is chosen based on the provided downsample value.</p>\n","type":"text/plain"},"key":"end"},{"description":{"content":"<p>Dimensions to return in the query. Multiple dimensions may be separated by commas.\nFor example, group_by=domain will return one timeseries for every domain, as a total across all datacenters (POPs).</p>\n","type":"text/plain"},"key":"group_by"},{"description":{"content":"<p>Number of results per page. The maximum is 200.</p>\n","type":"text/plain"},"key":"limit"},{"description":{"content":"<p>The metrics to retrieve. Multiple values should be comma-separated.</p>\n","type":"text/plain"},"key":"metric"},{"description":{"content":"<p>Limit query to one or more specific geographic regions. Values should be comma-separated.</p>\n","type":"text/plain"},"key":"region"},{"description":{"content":"<p>A valid ISO-8601-formatted date and time, or UNIX timestamp, indicating the inclusive start of the query time range. If not provided, a default is chosen based on the provided downsample value.</p>\n","type":"text/plain"},"key":"start"}],"variable":[]}},"response":[{"id":"299bfcf8-d35c-498d-b352-ad68ddecb22c","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/metrics/domains/services/SU1Z0isxPaozGVKXdv0eY?datacenter=SJC%2CSTP&domain=domain_1.com%2Cdomain_2.com&downsample=hour&end=2020-08-02T00%3A00%3A00.000Z&group_by=domain&metric=resp_body_bytes%2Cstatus_2xx&region=usa&start=2021-08-01T00%3A00%3A00.000Z?cursor&datacenter&domain&downsample&end&group_by&limit&metric&region&start","protocol":"https","host":["api","fastly","com"],"path":["metrics","domains","services","SU1Z0isxPaozGVKXdv0eY"],"query":[{"key":"cursor","description":"Cursor value from the next_cursor field of a previous response, used to retrieve the next page. To request the first page, this should be empty."},{"key":"datacenter","description":"Limit query to one or more specific POPs. Values should be comma-separated."},{"key":"domain","description":"Limit query to one or more specific domains. Values should be comma-separated."},{"key":"downsample","description":"Duration of sample windows."},{"key":"end","description":"A valid ISO-8601-formatted date and time, or UNIX timestamp, indicating the exclusive end of the query time range. If not provided, a default is chosen based on the provided downsample value."},{"key":"group_by","description":"Dimensions to return in the query. Multiple dimensions may be separated by commas.\nFor example, group_by=domain will return one timeseries for every domain, as a total across all datacenters (POPs)."},{"key":"limit","description":"Number of results per page. The maximum is 200."},{"key":"metric","description":"The metrics to retrieve. Multiple values should be comma-separated."},{"key":"region","description":"Limit query to one or more specific geographic regions. Values should be comma-separated."},{"key":"start","description":"A valid ISO-8601-formatted date and time, or UNIX timestamp, indicating the inclusive start of the query time range. If not provided, a default is chosen based on the provided downsample value."}]},"description":"Fetches historical domain metrics for a given Fastly service, optionally filtering and grouping the results by domain, region, or POP.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"dimensions\":{\"domain\":\"domain1.com\",\"region\":\"usa\",\"datacenter\":\"SJC\"},\"values\":[{\"timestamp\":1627772400,\"resp_body_bytes\":552256,\"status_2xx\":1},{\"timestamp\":1627776000,\"resp_body_bytes\":12323,\"status_2xx\":34}]},{\"dimensions\":{\"domain\":\"sub.domain2.com\",\"region\":\"usa\",\"datacenter\":\"STP\"},\"values\":[{\"timestamp\":1627772400,\"resp_body_bytes\":221,\"status_2xx\":1},{\"timestamp\":1627776000,\"resp_body_bytes\":234,\"status_2xx\":34}]}],\"meta\":{\"start\":\"2021-08-01T00:00:00Z\",\"end\":\"2020-08-02T00:00:00Z\",\"downsample\":\"hour\",\"metric\":\"resp_body_bytes,status_2xx\",\"limit\":100,\"next_cursor\":\"VTBwRENqVTJXVmszUz\",\"sort\":\"domain,region,datacenter\",\"group_by\":\"none\",\"filters\":{}},\"status\":\"success\"}"}],"_postman_id":"e5e1b6fc-0574-40e7-a292-23d014c3d531"}],"id":"c22181ca-d2a6-49a0-be5d-020b8522703b","description":"<p>Domain Inspector provides a JSON-formatted historical API for visibility into responses delivered from your domains by Fastly. The API offers a standardized set of data to report in minutely, hourly, or daily granularity on every domain response, byte, and status code received by a specified service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>datacenter</td>\n<td>string</td>\n<td>The POP from which the edge responses in this data entry were delivered. If unspecified, results are aggregated across POPs.</td>\n</tr>\n<tr>\n<td>domain</td>\n<td>string</td>\n<td>The domain from which the edge responses in this data entry were delivered. If unspecified, results are aggregated across domains.</td>\n</tr>\n<tr>\n<td>region</td>\n<td>string</td>\n<td>The geographic region from which the edge responses in this data entry were delivered. If unspecified, results are aggregated across regions.</td>\n</tr>\n<tr>\n<td>dimensions</td>\n<td>object</td>\n<td>The unique combination of dimensions associated with this timeseries.</td>\n</tr>\n<tr>\n<td>meta</td>\n<td>object</td>\n<td>Meta information about the scope of the query in a human readable format.</td>\n</tr>\n<tr>\n<td>msg</td>\n<td>string</td>\n<td>If the query was not successful, this will provide a string that explains why.</td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>Whether or not we were able to successfully execute the query.</td>\n</tr>\n<tr>\n<td>values</td>\n<td>array</td>\n<td>An array of values representing the metric values at each point in time.</td>\n</tr>\n<tr>\n<td>Note that this dataset is sparse: only the keys with non-zero values will be included in the record.</td>\n<td></td>\n<td></td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-1\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>dimensions</td>\n<td>object</td>\n<td>The unique combination of dimensions associated with this timeseries.</td>\n</tr>\n<tr>\n<td>values</td>\n<td>array</td>\n<td>An array of values representing the metric values at each point in time.</td>\n</tr>\n<tr>\n<td>Note that this dataset is sparse: only the keys with non-zero values will be included in the record.</td>\n<td></td>\n<td></td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-2\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>bandwidth</td>\n<td>integer</td>\n<td>Total bytes delivered (resp_header_bytes + resp_body_bytes + bereq_header_bytes + bereq_body_bytes).</td>\n</tr>\n<tr>\n<td>bereq_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes sent to origin.</td>\n</tr>\n<tr>\n<td>bereq_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes sent to origin.</td>\n</tr>\n<tr>\n<td>compute_bereq_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes sent to backends (origins) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_bereq_errors</td>\n<td>integer</td>\n<td>Number of backend request errors, including timeouts, by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_bereq_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes sent to backends (origins) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_bereqs</td>\n<td>integer</td>\n<td>Number of backend requests started by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_beresp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes received from backends (origins) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_beresp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received from backends (origins) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_execution_time_ms</td>\n<td>integer</td>\n<td>The amount of active CPU time used to process your requests (in milliseconds).</td>\n</tr>\n<tr>\n<td>compute_origin_status_1xx</td>\n<td>integer</td>\n<td>Number of \"Informational\" category status codes received from origin by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_origin_status_200</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 200 (Success) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_origin_status_204</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 204 (No Content) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_origin_status_206</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 206 (Partial Content) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_origin_status_2xx</td>\n<td>integer</td>\n<td>Number of \"Success\" status codes received from origin by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_origin_status_301</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 301 (Moved Permanently) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_origin_status_302</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 302 (Found) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_origin_status_304</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 304 (Not Modified) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_origin_status_3xx</td>\n<td>integer</td>\n<td>Number of \"Redirection\" codes received from origin by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_origin_status_400</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 400 (Bad Request) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_origin_status_401</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 401 (Unauthorized) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_origin_status_403</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 403 (Forbidden) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_origin_status_404</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 404 (Not Found) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_origin_status_416</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 416 (Range Not Satisfiable) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_origin_status_429</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 429 (Too Many Requests) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_origin_status_4xx</td>\n<td>integer</td>\n<td>Number of \"Client Error\" codes received from origin by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_origin_status_500</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 500 (Internal Server Error) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_origin_status_501</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 501 (Not Implemented) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_origin_status_502</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 502 (Bad Gateway) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_origin_status_503</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 503 (Service Unavailable) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_origin_status_504</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 504 (Gateway Timeout) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_origin_status_505</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 505 (HTTP Version Not Supported) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_origin_status_530</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 530 by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_origin_status_5xx</td>\n<td>integer</td>\n<td>Number of \"Server Error\" codes received from origin by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_req_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_req_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_request</td>\n<td>integer</td>\n<td>The total number of requests that were received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_request_time_billed_ms</td>\n<td>integer</td>\n<td>The total amount of request processing time you will be billed for, measured in 50 millisecond increments.</td>\n</tr>\n<tr>\n<td>compute_request_time_ms</td>\n<td>integer</td>\n<td>The total amount of time used to process your requests, including active CPU time (in milliseconds).</td>\n</tr>\n<tr>\n<td>compute_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes sent from Compute to the end user.</td>\n</tr>\n<tr>\n<td>compute_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes sent from Compute to the end user.</td>\n</tr>\n<tr>\n<td>compute_resp_status_103</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 103 (Early Hints) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_1xx</td>\n<td>integer</td>\n<td>Number of 1xx \"Informational\" category status codes delivered by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_200</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 200 (Success) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_204</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 204 (No Content) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_206</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 206 (Partial Content) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_2xx</td>\n<td>integer</td>\n<td>Number of 2xx \"Success\" status codes delivered by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_301</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 301 (Moved Permanently) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_302</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 302 (Found) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_304</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 304 (Not Modified) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_3xx</td>\n<td>integer</td>\n<td>Number of 3xx \"Redirection\" codes delivered by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_400</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 400 (Bad Request) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_401</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 401 (Unauthorized) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_403</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 403 (Forbidden) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_404</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 404 (Not Found) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_416</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 416 (Range Not Satisfiable) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_429</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 429 (Too Many Requests) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_4xx</td>\n<td>integer</td>\n<td>Number of 4xx \"Client Error\" codes delivered by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_500</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 500 (Internal Server Error) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_501</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 501 (Not Implemented) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_502</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 502 (Bad Gateway) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_503</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 503 (Service Unavailable) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_504</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 504 (Gateway Timeout) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_505</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 505 (HTTP Version Not Supported) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_530</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 530 by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_5xx</td>\n<td>integer</td>\n<td>Number of \"Server Error\" category status codes delivered by the Compute platform.</td>\n</tr>\n<tr>\n<td>edge_hit_ratio</td>\n<td>number</td>\n<td>Ratio of cache hits to cache misses at the edge, between 0 and 1 (edge_hit_requests / (edge_hit_requests + edge_miss_requests)).</td>\n</tr>\n<tr>\n<td>edge_hit_requests</td>\n<td>integer</td>\n<td>Number of requests sent by end users to Fastly that resulted in a hit at the edge.</td>\n</tr>\n<tr>\n<td>edge_miss_requests</td>\n<td>integer</td>\n<td>Number of requests sent by end users to Fastly that resulted in a miss at the edge.</td>\n</tr>\n<tr>\n<td>edge_requests</td>\n<td>integer</td>\n<td>Number of requests sent by end users to Fastly.</td>\n</tr>\n<tr>\n<td>edge_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes delivered from Fastly to the end user.</td>\n</tr>\n<tr>\n<td>edge_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes delivered from Fastly to the end user.</td>\n</tr>\n<tr>\n<td>origin_fetch_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes received from origin.</td>\n</tr>\n<tr>\n<td>origin_fetch_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received from origin.</td>\n</tr>\n<tr>\n<td>origin_fetches</td>\n<td>integer</td>\n<td>Number of requests sent to origin.</td>\n</tr>\n<tr>\n<td>origin_offload</td>\n<td>number</td>\n<td>Origin Offload measures the ratio of bytes served to end users that were cached by Fastly, over the bytes served to end users, between 0 and 1. ((edge_resp_body_bytes + edge_resp_header_bytes) - (origin_fetch_resp_body_bytes + origin_fetch_resp_header_bytes)) / (edge_resp_body_bytes + edge_resp_header_bytes). Previously, Origin Offload used a different formula. Learn more.</td>\n</tr>\n<tr>\n<td>origin_status_1xx</td>\n<td>integer</td>\n<td>Number of \"Informational\" category status codes received from origin.</td>\n</tr>\n<tr>\n<td>origin_status_200</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 200 (Success).</td>\n</tr>\n<tr>\n<td>origin_status_204</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 204 (No Content).</td>\n</tr>\n<tr>\n<td>origin_status_206</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 206 (Partial Content).</td>\n</tr>\n<tr>\n<td>origin_status_2xx</td>\n<td>integer</td>\n<td>Number of \"Success\" status codes received from origin.</td>\n</tr>\n<tr>\n<td>origin_status_301</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 301 (Moved Permanently).</td>\n</tr>\n<tr>\n<td>origin_status_302</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 302 (Found).</td>\n</tr>\n<tr>\n<td>origin_status_304</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 304 (Not Modified).</td>\n</tr>\n<tr>\n<td>origin_status_3xx</td>\n<td>integer</td>\n<td>Number of \"Redirection\" codes received from origin.</td>\n</tr>\n<tr>\n<td>origin_status_400</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 400 (Bad Request).</td>\n</tr>\n<tr>\n<td>origin_status_401</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 401 (Unauthorized).</td>\n</tr>\n<tr>\n<td>origin_status_403</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 403 (Forbidden).</td>\n</tr>\n<tr>\n<td>origin_status_404</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 404 (Not Found).</td>\n</tr>\n<tr>\n<td>origin_status_416</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 416 (Range Not Satisfiable).</td>\n</tr>\n<tr>\n<td>origin_status_429</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 429 (Too Many Requests).</td>\n</tr>\n<tr>\n<td>origin_status_4xx</td>\n<td>integer</td>\n<td>Number of \"Client Error\" codes received from origin.</td>\n</tr>\n<tr>\n<td>origin_status_500</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 500 (Internal Server Error).</td>\n</tr>\n<tr>\n<td>origin_status_501</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 501 (Not Implemented).</td>\n</tr>\n<tr>\n<td>origin_status_502</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 502 (Bad Gateway).</td>\n</tr>\n<tr>\n<td>origin_status_503</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 503 (Service Unavailable).</td>\n</tr>\n<tr>\n<td>origin_status_504</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 504 (Gateway Timeout).</td>\n</tr>\n<tr>\n<td>origin_status_505</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 505 (HTTP Version Not Supported).</td>\n</tr>\n<tr>\n<td>origin_status_530</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 530.</td>\n</tr>\n<tr>\n<td>origin_status_5xx</td>\n<td>integer</td>\n<td>Number of \"Server Error\" codes received from origin.</td>\n</tr>\n<tr>\n<td>requests</td>\n<td>integer</td>\n<td>Number of requests processed.</td>\n</tr>\n<tr>\n<td>resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes delivered.</td>\n</tr>\n<tr>\n<td>resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes delivered.</td>\n</tr>\n<tr>\n<td>status_1xx</td>\n<td>integer</td>\n<td>Number of 1xx \"Informational\" category status codes delivered.</td>\n</tr>\n<tr>\n<td>status_200</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 200 (Success).</td>\n</tr>\n<tr>\n<td>status_204</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 204 (No Content).</td>\n</tr>\n<tr>\n<td>status_206</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 206 (Partial Content).</td>\n</tr>\n<tr>\n<td>status_2xx</td>\n<td>integer</td>\n<td>Number of 2xx \"Success\" status codes delivered.</td>\n</tr>\n<tr>\n<td>status_301</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 301 (Moved Permanently).</td>\n</tr>\n<tr>\n<td>status_302</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 302 (Found).</td>\n</tr>\n<tr>\n<td>status_304</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 304 (Not Modified).</td>\n</tr>\n<tr>\n<td>status_3xx</td>\n<td>integer</td>\n<td>Number of 3xx \"Redirection\" codes delivered.</td>\n</tr>\n<tr>\n<td>status_400</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 400 (Bad Request).</td>\n</tr>\n<tr>\n<td>status_401</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 401 (Unauthorized).</td>\n</tr>\n<tr>\n<td>status_403</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 403 (Forbidden).</td>\n</tr>\n<tr>\n<td>status_404</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 404 (Not Found).</td>\n</tr>\n<tr>\n<td>status_416</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 416 (Range Not Satisfiable).</td>\n</tr>\n<tr>\n<td>status_429</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 429 (Too Many Requests).</td>\n</tr>\n<tr>\n<td>status_4xx</td>\n<td>integer</td>\n<td>Number of 4xx \"Client Error\" codes delivered.</td>\n</tr>\n<tr>\n<td>status_500</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 500 (Internal Server Error).</td>\n</tr>\n<tr>\n<td>status_501</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 501 (Not Implemented).</td>\n</tr>\n<tr>\n<td>status_502</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 502 (Bad Gateway).</td>\n</tr>\n<tr>\n<td>status_503</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 503 (Service Unavailable).</td>\n</tr>\n<tr>\n<td>status_504</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 504 (Gateway Timeout).</td>\n</tr>\n<tr>\n<td>status_505</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 505 (HTTP Version Not Supported).</td>\n</tr>\n<tr>\n<td>status_530</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 530.</td>\n</tr>\n<tr>\n<td>status_5xx</td>\n<td>integer</td>\n<td>Number of 5xx \"Server Error\" codes delivered.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"c22181ca-d2a6-49a0-be5d-020b8522703b"},{"name":"Domain Inspector Real-time API","item":[{"name":"Get real-time domain data from a specified time","id":"d542aeb2-3433-4924-9eb7-f94123ba5d19","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"rt.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/v1/domains/{{service_id}}/ts/{{start_timestamp}}","description":"<p>Get real-time domain data for the specified reporting period. Specify 0 to get a single entry for the last complete second. The Timestamp field included in the response provides the time index of the latest entry in the dataset and can be provided as the start_timestamp of the next request for a seamless continuation of the dataset from one request to the next.\nDue to processing latency, the earliest entry in the response dataset may be earlier than start_timestamp by the value of AggregateDelay.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["v1","domains","{{service_id}}","ts","{{start_timestamp}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"b550f42e-ca67-4274-b57e-e32486dc76d2","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"rt.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/v1/domains/SU1Z0isxPaozGVKXdv0eY/ts/1608560817","description":"Get real-time domain data for the specified reporting period. Specify 0 to get a single entry for the last complete second. The Timestamp field included in the response provides the time index of the latest entry in the dataset and can be provided as the start_timestamp of the next request for a seamless continuation of the dataset from one request to the next.\nDue to processing latency, the earliest entry in the response dataset may be earlier than start_timestamp by the value of AggregateDelay.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"Data\":[{\"datacenter\":{\"STP\":{\"www.example.com\":{\"edge\":5,\"resp_header_bytes\":1200,\"resp_body_bytes\":1850,\"status_4xx\":5,\"status_403\":5}}},\"aggregated\":{\"www.example.com\":{\"edge\":5,\"resp_header_bytes\":1200,\"resp_body_bytes\":1850,\"status_4xx\":5,\"status_403\":5}},\"recorded\":1589198016}],\"Timestamp\":1589198025,\"AggregateDelay\":9}"}],"_postman_id":"d542aeb2-3433-4924-9eb7-f94123ba5d19"},{"name":"Get real-time domain data for the last 120 seconds","id":"c70183be-679a-436a-b709-b03bce7e803a","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"rt.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/v1/domains/{{service_id}}/ts/h","description":"<p>Get data for the 120 seconds preceding the latest timestamp available for a service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["v1","domains","{{service_id}}","ts","h"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"beb3c7c9-2911-4203-8bb3-306f82b4dc31","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"rt.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/v1/domains/SU1Z0isxPaozGVKXdv0eY/ts/h","description":"Get data for the 120 seconds preceding the latest timestamp available for a service.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"Data\":[{\"datacenter\":{\"STP\":{\"www.example.com\":{\"edge\":5,\"resp_header_bytes\":1200,\"resp_body_bytes\":1850,\"status_4xx\":5,\"status_403\":5}}},\"aggregated\":{\"www.example.com\":{\"edge\":5,\"resp_header_bytes\":1200,\"resp_body_bytes\":1850,\"status_4xx\":5,\"status_403\":5}},\"recorded\":1589198016}],\"Timestamp\":1589198025,\"AggregateDelay\":9}"}],"_postman_id":"c70183be-679a-436a-b709-b03bce7e803a"},{"name":"Get a limited number of real-time domain data entries","id":"acbccf17-a3b7-43d7-bd44-f170da6e5813","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"rt.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/v1/domains/{{service_id}}/ts/h/limit/{{max_entries}}","description":"<p>Get data for the max_entries seconds preceding the latest timestamp available for a service, up to a maximum of 120 entries.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["v1","domains","{{service_id}}","ts","h","limit","{{max_entries}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"4df965ea-8473-49af-86af-afe8bd173aef","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"rt.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/v1/domains/SU1Z0isxPaozGVKXdv0eY/ts/h/limit/1","description":"Get data for the max_entries seconds preceding the latest timestamp available for a service, up to a maximum of 120 entries.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"Data\":[{\"datacenter\":{\"STP\":{\"www.example.com\":{\"edge\":5,\"resp_header_bytes\":1200,\"resp_body_bytes\":1850,\"status_4xx\":5,\"status_403\":5}}},\"aggregated\":{\"www.example.com\":{\"edge\":5,\"resp_header_bytes\":1200,\"resp_body_bytes\":1850,\"status_4xx\":5,\"status_403\":5}},\"recorded\":1589198016}],\"Timestamp\":1589198025,\"AggregateDelay\":9}"}],"_postman_id":"acbccf17-a3b7-43d7-bd44-f170da6e5813"}],"id":"09c629b6-8d95-40e0-bcc6-c8e768058809","description":"<p>The real-time domain metrics API allows you to programmatically retrieve per-domain delivery metrics derived from your Fastly services in one-second periods up to the last complete second.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>AggregateDelay</td>\n<td>integer</td>\n<td>Offset of entry timestamps from the current time due to processing time.</td>\n</tr>\n<tr>\n<td>Data</td>\n<td>array</td>\n<td>A list of report entries, each representing one second of time.</td>\n</tr>\n<tr>\n<td>Timestamp</td>\n<td>integer</td>\n<td>Value to use for subsequent requests.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-1\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>bandwidth</td>\n<td>integer</td>\n<td>Total bytes delivered (resp_header_bytes + resp_body_bytes + bereq_header_bytes + bereq_body_bytes).</td>\n</tr>\n<tr>\n<td>bereq_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes sent to origin.</td>\n</tr>\n<tr>\n<td>bereq_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes sent to origin.</td>\n</tr>\n<tr>\n<td>compute_bereq_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes sent to backends (origins) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_bereq_errors</td>\n<td>integer</td>\n<td>Number of backend request errors, including timeouts, by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_bereq_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes sent to backends (origins) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_bereqs</td>\n<td>integer</td>\n<td>Number of backend requests started by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_beresp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes received from backends (origins) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_beresp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received from backends (origins) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_execution_time_ms</td>\n<td>integer</td>\n<td>The amount of active CPU time used to process your requests (in milliseconds).</td>\n</tr>\n<tr>\n<td>compute_origin_status_1xx</td>\n<td>integer</td>\n<td>Number of \"Informational\" category status codes received from origin by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_origin_status_200</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 200 (Success) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_origin_status_204</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 204 (No Content) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_origin_status_206</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 206 (Partial Content) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_origin_status_2xx</td>\n<td>integer</td>\n<td>Number of \"Success\" status codes received from origin by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_origin_status_301</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 301 (Moved Permanently) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_origin_status_302</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 302 (Found) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_origin_status_304</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 304 (Not Modified) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_origin_status_3xx</td>\n<td>integer</td>\n<td>Number of \"Redirection\" codes received from origin by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_origin_status_400</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 400 (Bad Request) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_origin_status_401</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 401 (Unauthorized) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_origin_status_403</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 403 (Forbidden) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_origin_status_404</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 404 (Not Found) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_origin_status_416</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 416 (Range Not Satisfiable) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_origin_status_429</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 429 (Too Many Requests) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_origin_status_4xx</td>\n<td>integer</td>\n<td>Number of \"Client Error\" codes received from origin by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_origin_status_500</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 500 (Internal Server Error) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_origin_status_501</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 501 (Not Implemented) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_origin_status_502</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 502 (Bad Gateway) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_origin_status_503</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 503 (Service Unavailable) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_origin_status_504</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 504 (Gateway Timeout) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_origin_status_505</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 505 (HTTP Version Not Supported) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_origin_status_530</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 530 by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_origin_status_5xx</td>\n<td>integer</td>\n<td>Number of \"Server Error\" codes received from origin by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_req_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_req_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_request</td>\n<td>integer</td>\n<td>The total number of requests that were received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_request_time_billed_ms</td>\n<td>integer</td>\n<td>The total amount of request processing time you will be billed for, measured in 50 millisecond increments.</td>\n</tr>\n<tr>\n<td>compute_request_time_ms</td>\n<td>integer</td>\n<td>The total amount of time used to process your requests, including active CPU time (in milliseconds).</td>\n</tr>\n<tr>\n<td>compute_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes sent from Compute to the end user.</td>\n</tr>\n<tr>\n<td>compute_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes sent from Compute to the end user.</td>\n</tr>\n<tr>\n<td>compute_resp_status_103</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 103 (Early Hints) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_1xx</td>\n<td>integer</td>\n<td>Number of 1xx \"Informational\" category status codes delivered by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_200</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 200 (Success) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_204</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 204 (No Content) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_206</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 206 (Partial Content) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_2xx</td>\n<td>integer</td>\n<td>Number of 2xx \"Success\" status codes delivered by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_301</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 301 (Moved Permanently) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_302</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 302 (Found) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_304</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 304 (Not Modified) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_3xx</td>\n<td>integer</td>\n<td>Number of 3xx \"Redirection\" codes delivered by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_400</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 400 (Bad Request) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_401</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 401 (Unauthorized) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_403</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 403 (Forbidden) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_404</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 404 (Not Found) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_416</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 416 (Range Not Satisfiable) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_429</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 429 (Too Many Requests) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_4xx</td>\n<td>integer</td>\n<td>Number of 4xx \"Client Error\" codes delivered by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_500</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 500 (Internal Server Error) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_501</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 501 (Not Implemented) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_502</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 502 (Bad Gateway) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_503</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 503 (Service Unavailable) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_504</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 504 (Gateway Timeout) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_505</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 505 (HTTP Version Not Supported) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_530</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 530 by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_5xx</td>\n<td>integer</td>\n<td>Number of \"Server Error\" category status codes delivered by the Compute platform.</td>\n</tr>\n<tr>\n<td>edge_hit_ratio</td>\n<td>number</td>\n<td>Ratio of cache hits to cache misses at the edge, between 0 and 1 (edge_hit_requests / (edge_hit_requests + edge_miss_requests)).</td>\n</tr>\n<tr>\n<td>edge_hit_requests</td>\n<td>integer</td>\n<td>Number of requests sent by end users to Fastly that resulted in a hit at the edge.</td>\n</tr>\n<tr>\n<td>edge_miss_requests</td>\n<td>integer</td>\n<td>Number of requests sent by end users to Fastly that resulted in a miss at the edge.</td>\n</tr>\n<tr>\n<td>edge_requests</td>\n<td>integer</td>\n<td>Number of requests sent by end users to Fastly.</td>\n</tr>\n<tr>\n<td>edge_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes delivered from Fastly to the end user.</td>\n</tr>\n<tr>\n<td>edge_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes delivered from Fastly to the end user.</td>\n</tr>\n<tr>\n<td>origin_fetch_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes received from origin.</td>\n</tr>\n<tr>\n<td>origin_fetch_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received from origin.</td>\n</tr>\n<tr>\n<td>origin_fetches</td>\n<td>integer</td>\n<td>Number of requests sent to origin.</td>\n</tr>\n<tr>\n<td>origin_offload</td>\n<td>number</td>\n<td>Origin Offload measures the ratio of bytes served to end users that were cached by Fastly, over the bytes served to end users, between 0 and 1. ((edge_resp_body_bytes + edge_resp_header_bytes) - (origin_fetch_resp_body_bytes + origin_fetch_resp_header_bytes)) / (edge_resp_body_bytes + edge_resp_header_bytes). Previously, Origin Offload used a different formula. Learn more.</td>\n</tr>\n<tr>\n<td>origin_status_1xx</td>\n<td>integer</td>\n<td>Number of \"Informational\" category status codes received from origin.</td>\n</tr>\n<tr>\n<td>origin_status_200</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 200 (Success).</td>\n</tr>\n<tr>\n<td>origin_status_204</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 204 (No Content).</td>\n</tr>\n<tr>\n<td>origin_status_206</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 206 (Partial Content).</td>\n</tr>\n<tr>\n<td>origin_status_2xx</td>\n<td>integer</td>\n<td>Number of \"Success\" status codes received from origin.</td>\n</tr>\n<tr>\n<td>origin_status_301</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 301 (Moved Permanently).</td>\n</tr>\n<tr>\n<td>origin_status_302</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 302 (Found).</td>\n</tr>\n<tr>\n<td>origin_status_304</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 304 (Not Modified).</td>\n</tr>\n<tr>\n<td>origin_status_3xx</td>\n<td>integer</td>\n<td>Number of \"Redirection\" codes received from origin.</td>\n</tr>\n<tr>\n<td>origin_status_400</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 400 (Bad Request).</td>\n</tr>\n<tr>\n<td>origin_status_401</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 401 (Unauthorized).</td>\n</tr>\n<tr>\n<td>origin_status_403</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 403 (Forbidden).</td>\n</tr>\n<tr>\n<td>origin_status_404</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 404 (Not Found).</td>\n</tr>\n<tr>\n<td>origin_status_416</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 416 (Range Not Satisfiable).</td>\n</tr>\n<tr>\n<td>origin_status_429</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 429 (Too Many Requests).</td>\n</tr>\n<tr>\n<td>origin_status_4xx</td>\n<td>integer</td>\n<td>Number of \"Client Error\" codes received from origin.</td>\n</tr>\n<tr>\n<td>origin_status_500</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 500 (Internal Server Error).</td>\n</tr>\n<tr>\n<td>origin_status_501</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 501 (Not Implemented).</td>\n</tr>\n<tr>\n<td>origin_status_502</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 502 (Bad Gateway).</td>\n</tr>\n<tr>\n<td>origin_status_503</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 503 (Service Unavailable).</td>\n</tr>\n<tr>\n<td>origin_status_504</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 504 (Gateway Timeout).</td>\n</tr>\n<tr>\n<td>origin_status_505</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 505 (HTTP Version Not Supported).</td>\n</tr>\n<tr>\n<td>origin_status_530</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 530.</td>\n</tr>\n<tr>\n<td>origin_status_5xx</td>\n<td>integer</td>\n<td>Number of \"Server Error\" codes received from origin.</td>\n</tr>\n<tr>\n<td>requests</td>\n<td>integer</td>\n<td>Number of requests processed.</td>\n</tr>\n<tr>\n<td>resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes delivered.</td>\n</tr>\n<tr>\n<td>resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes delivered.</td>\n</tr>\n<tr>\n<td>status_1xx</td>\n<td>integer</td>\n<td>Number of 1xx \"Informational\" category status codes delivered.</td>\n</tr>\n<tr>\n<td>status_200</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 200 (Success).</td>\n</tr>\n<tr>\n<td>status_204</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 204 (No Content).</td>\n</tr>\n<tr>\n<td>status_206</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 206 (Partial Content).</td>\n</tr>\n<tr>\n<td>status_2xx</td>\n<td>integer</td>\n<td>Number of 2xx \"Success\" status codes delivered.</td>\n</tr>\n<tr>\n<td>status_301</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 301 (Moved Permanently).</td>\n</tr>\n<tr>\n<td>status_302</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 302 (Found).</td>\n</tr>\n<tr>\n<td>status_304</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 304 (Not Modified).</td>\n</tr>\n<tr>\n<td>status_3xx</td>\n<td>integer</td>\n<td>Number of 3xx \"Redirection\" codes delivered.</td>\n</tr>\n<tr>\n<td>status_400</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 400 (Bad Request).</td>\n</tr>\n<tr>\n<td>status_401</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 401 (Unauthorized).</td>\n</tr>\n<tr>\n<td>status_403</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 403 (Forbidden).</td>\n</tr>\n<tr>\n<td>status_404</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 404 (Not Found).</td>\n</tr>\n<tr>\n<td>status_416</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 416 (Range Not Satisfiable).</td>\n</tr>\n<tr>\n<td>status_429</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 429 (Too Many Requests).</td>\n</tr>\n<tr>\n<td>status_4xx</td>\n<td>integer</td>\n<td>Number of 4xx \"Client Error\" codes delivered.</td>\n</tr>\n<tr>\n<td>status_500</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 500 (Internal Server Error).</td>\n</tr>\n<tr>\n<td>status_501</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 501 (Not Implemented).</td>\n</tr>\n<tr>\n<td>status_502</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 502 (Bad Gateway).</td>\n</tr>\n<tr>\n<td>status_503</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 503 (Service Unavailable).</td>\n</tr>\n<tr>\n<td>status_504</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 504 (Gateway Timeout).</td>\n</tr>\n<tr>\n<td>status_505</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 505 (HTTP Version Not Supported).</td>\n</tr>\n<tr>\n<td>status_530</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 530.</td>\n</tr>\n<tr>\n<td>status_5xx</td>\n<td>integer</td>\n<td>Number of 5xx \"Server Error\" codes delivered.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-2\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>aggregated</td>\n<td>object</td>\n<td>Groups measurements by backend name and then by IP address.</td>\n</tr>\n<tr>\n<td>datacenter</td>\n<td>object</td>\n<td>Groups measurements by POP, then backend name, and then IP address. See the POPs API for details about POP identifiers.</td>\n</tr>\n<tr>\n<td>recorded</td>\n<td>integer</td>\n<td>The Unix timestamp at which this record's data was generated.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"09c629b6-8d95-40e0-bcc6-c8e768058809"}],"id":"f085b025-5125-423d-a9b8-0f68d171667f","_postman_id":"f085b025-5125-423d-a9b8-0f68d171667f","description":""},{"name":"Metrics and stats","item":[{"name":"Historical Stats","item":[{"name":"Get historical stats","id":"76b924e5-d730-414c-bc2d-88cda03ba311","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/stats?by&datacenter&from&region&services&to","description":"<p>Fetches historical stats for each of your Fastly services and groups the results by service ID.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["stats"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Duration of sample windows. One of:</p>\n<p>hour - Group data by hour.\nminute - Group data by minute.\nday - Group data by day.</p>\n","type":"text/plain"},"key":"by"},{"description":{"content":"<p>Limit query to one or more Fastly POPs. For multiple POPs use a comma-seperated list of POPs.\nThese must be all uppercase and be valid codes. A full list of POPs can be obtained from the\nPOPs endpoint.</p>\n","type":"text/plain"},"key":"datacenter"},{"description":{"content":"<p>Timestamp that defines the start of the window for which to fetch statistics, including the timestamp itself. Accepts Unix timestamps, or any form of input parsable by the Chronic Ruby library, such as 'yesterday', or 'two weeks ago'. Default varies based on the value of by.</p>\n","type":"text/plain"},"key":"from"},{"description":{"content":"<p>Limit query to a specific geographic region. One of:</p>\n<p>usa - North America.\neurope - Europe.\nanzac - Australia and New Zealand.\nasia - Asia.\nasia_india - India.\nasia_southkorea - South Korea.\nafrica_std - Africa.\nmexico - Mexico.\nsouthamerica_std - South America.</p>\n","type":"text/plain"},"key":"region"},{"description":{"content":"<p>Limit the query to only the specified, comma-separated list of services.</p>\n","type":"text/plain"},"key":"services"},{"description":{"content":"<p>Timestamp that defines the end of the window for which to fetch statistics. Accepts the same formats as from.</p>\n","type":"text/plain"},"key":"to"}],"variable":[]}},"response":[{"id":"2de1558f-ab45-4f3c-b976-7e4694aec63c","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/stats?by=day&datacenter=IAD%2CCHI&from=2020-04-09T18%3A14%3A30Z&region=usa&to=2020-04-09T18%3A14%3A30Z?by&datacenter&from&region&services&to","protocol":"https","host":["api","fastly","com"],"path":["stats"],"query":[{"key":"by","description":"Duration of sample windows. One of:\n\nhour - Group data by hour.\nminute - Group data by minute.\nday - Group data by day."},{"key":"datacenter","description":"Limit query to one or more Fastly POPs. For multiple POPs use a comma-seperated list of POPs.\nThese must be all uppercase and be valid codes. A full list of POPs can be obtained from the\nPOPs endpoint."},{"key":"from","description":"Timestamp that defines the start of the window for which to fetch statistics, including the timestamp itself. Accepts Unix timestamps, or any form of input parsable by the Chronic Ruby library, such as 'yesterday', or 'two weeks ago'. Default varies based on the value of by."},{"key":"region","description":"Limit query to a specific geographic region. One of:\n\nusa - North America.\neurope - Europe.\nanzac - Australia and New Zealand.\nasia - Asia.\nasia_india - India.\nasia_southkorea - South Korea.\nafrica_std - Africa.\nmexico - Mexico.\nsouthamerica_std - South America."},{"key":"services","description":"Limit the query to only the specified, comma-separated list of services."},{"key":"to","description":"Timestamp that defines the end of the window for which to fetch statistics. Accepts the same formats as from."}]},"description":"Fetches historical stats for each of your Fastly services and groups the results by service ID.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"success\",\"meta\":{\"to\":\"Thu May 16 20:08:35 UTC 2020\",\"from\":\"Tue May 14 20:08:35 UTC 2020\",\"by\":\"day\",\"region\":\"all\"},\"msg\":null,\"data\":{\"6ElZZvtumbwtLBDJvFwepx\":[{\"requests\":1925645,\"miss_time\":55.153864891000005,\"start_time\":1368662400,\"service_id\":\"6ElZZvtumbwtLBDJvFwepx\",\"bandwidth\":176544526854,\"hits\":1902348,\"hits_time\":520.0779119150006,\"miss\":8354,\"body_size\":175900019026,\"pass\":4212,\"header_size\":644507828,\"req_header_bytes\":2905859973,\"req_body_bytes\":390017958,\"resp_header_bytes\":644507828,\"resp_body_bytes\":175900019026,\"bereq_header_bytes\":1870557109,\"bereq_body_bytes\":389234083,\"status_200\":1208426,\"status_204\":0,\"status_301\":0,\"status_302\":0,\"status_304\":0,\"errors\":8418,\"hit_ratio\":0.9956,\"status_1xx\":0,\"status_2xx\":1208426,\"status_3xx\":0,\"status_4xx\":708801,\"status_503\":8418,\"pipe\":0,\"status_5xx\":8418,\"uncacheable\":0,\"tls\":2804069,\"shield\":208055,\"ipv6\":14156,\"otfp\":12006,\"video\":306053,\"pci\":3041,\"logging\":2088120,\"http2\":251589,\"attack_req_body_bytes\":1274842,\"attack_req_header_bytes\":892196,\"attack_resp_synth_bytes\":0,\"imgopto\":1404}],\"5oYej0l0heMydtjaVPOq4z\":[{\"requests\":751,\"miss_time\":1.198163271,\"start_time\":1368662400,\"service_id\":\"5oYej0l0heMydtjaVPOq4z\",\"bandwidth\":1159652,\"hits\":743,\"hits_time\":0.07059622299999999,\"miss\":8,\"body_size\":721082,\"pass\":0,\"header_size\":438570,\"req_header_bytes\":2905859973,\"req_body_bytes\":390017958,\"resp_header_bytes\":438570,\"resp_body_bytes\":721082,\"bereq_header_bytes\":1870557109,\"bereq_body_bytes\":389234083,\"status_200\":580,\"status_204\":0,\"status_301\":2,\"status_302\":0,\"status_304\":169,\"errors\":0,\"hit_ratio\":0.9893,\"status_1xx\":0,\"status_2xx\":580,\"status_3xx\":171,\"status_4xx\":0,\"status_503\":0,\"pipe\":0,\"status_5xx\":0,\"uncacheable\":0,\"tls\":2804069,\"shield\":208055,\"ipv6\":14156,\"otfp\":12006,\"video\":306053,\"pci\":3041,\"logging\":2088120,\"http2\":251589,\"attack_req_body_bytes\":1274842,\"attack_req_header_bytes\":892196,\"attack_resp_synth_bytes\":0,\"imgopto\":1404}]}}"}],"_postman_id":"76b924e5-d730-414c-bc2d-88cda03ba311"},{"name":"Get historical stats for a single field","id":"9965636c-110c-4db0-b769-2583b7f2249d","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/stats/field/{{field}}?by&datacenter&from&region&to","description":"<p>Fetches the specified field from the historical stats for each of your services and groups the results by service ID.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["stats","field","{{field}}"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Duration of sample windows. One of:</p>\n<p>hour - Group data by hour.\nminute - Group data by minute.\nday - Group data by day.</p>\n","type":"text/plain"},"key":"by"},{"description":{"content":"<p>Limit query to one or more Fastly POPs. For multiple POPs use a comma-seperated list of POPs.\nThese must be all uppercase and be valid codes. A full list of POPs can be obtained from the\nPOPs endpoint.</p>\n","type":"text/plain"},"key":"datacenter"},{"description":{"content":"<p>Timestamp that defines the start of the window for which to fetch statistics, including the timestamp itself. Accepts Unix timestamps, or any form of input parsable by the Chronic Ruby library, such as 'yesterday', or 'two weeks ago'. Default varies based on the value of by.</p>\n","type":"text/plain"},"key":"from"},{"description":{"content":"<p>Limit query to a specific geographic region. One of:</p>\n<p>usa - North America.\neurope - Europe.\nanzac - Australia and New Zealand.\nasia - Asia.\nasia_india - India.\nasia_southkorea - South Korea.\nafrica_std - Africa.\nmexico - Mexico.\nsouthamerica_std - South America.</p>\n","type":"text/plain"},"key":"region"},{"description":{"content":"<p>Timestamp that defines the end of the window for which to fetch statistics. Accepts the same formats as from.</p>\n","type":"text/plain"},"key":"to"}],"variable":[]}},"response":[{"id":"a1739361-27d5-4b06-b76e-b9bc62541d78","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/stats/field/hit_ratio?by=day&datacenter=IAD%2CCHI&from=2020-04-09T18%3A14%3A30Z&region=usa&to=2020-04-09T18%3A14%3A30Z?by&datacenter&from&region&to","protocol":"https","host":["api","fastly","com"],"path":["stats","field","hit_ratio"],"query":[{"key":"by","description":"Duration of sample windows. One of:\n\nhour - Group data by hour.\nminute - Group data by minute.\nday - Group data by day."},{"key":"datacenter","description":"Limit query to one or more Fastly POPs. For multiple POPs use a comma-seperated list of POPs.\nThese must be all uppercase and be valid codes. A full list of POPs can be obtained from the\nPOPs endpoint."},{"key":"from","description":"Timestamp that defines the start of the window for which to fetch statistics, including the timestamp itself. Accepts Unix timestamps, or any form of input parsable by the Chronic Ruby library, such as 'yesterday', or 'two weeks ago'. Default varies based on the value of by."},{"key":"region","description":"Limit query to a specific geographic region. One of:\n\nusa - North America.\neurope - Europe.\nanzac - Australia and New Zealand.\nasia - Asia.\nasia_india - India.\nasia_southkorea - South Korea.\nafrica_std - Africa.\nmexico - Mexico.\nsouthamerica_std - South America."},{"key":"to","description":"Timestamp that defines the end of the window for which to fetch statistics. Accepts the same formats as from."}]},"description":"Fetches the specified field from the historical stats for each of your services and groups the results by service ID.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"success\",\"meta\":{\"to\":\"Thu May 16 17:13:03 UTC 2020\",\"from\":\"Thu May 14 17:13:03 UTC 2020\",\"by\":\"day\",\"region\":\"all\"},\"msg\":null,\"data\":{\"6ElZZvtumbwtLBDJvFwepx\":[{\"service_id\":\"6ElZZvtumbwtLBDJvFwepx\",\"start_time\":1368720000,\"hit_ratio\":0.9769},{\"service_id\":\"6ElZZvtumbwtLBDJvFwepx\",\"start_time\":1368723600,\"hit_ratio\":0.9944}],\"5oYej0l0heMydtjaVPOq4z\":[{\"service_id\":\"5oYej0l0heMydtjaVPOq4z\",\"start_time\":1368716400,\"hit_ratio\":0.9857},{\"service_id\":\"5oYej0l0heMydtjaVPOq4z\",\"start_time\":1368723600,\"hit_ratio\":1}]}}"}],"_postman_id":"9965636c-110c-4db0-b769-2583b7f2249d"},{"name":"Get aggregated historical stats","id":"f12aba7c-47a9-4264-ba8c-dced6b8d9170","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/stats/aggregate?by&from&region&to","description":"<p>Fetches historical stats information aggregated across all of your Fastly services.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["stats","aggregate"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Duration of sample windows. One of:</p>\n<p>hour - Group data by hour.\nminute - Group data by minute.\nday - Group data by day.</p>\n","type":"text/plain"},"key":"by"},{"description":{"content":"<p>Timestamp that defines the start of the window for which to fetch statistics, including the timestamp itself. Accepts Unix timestamps, or any form of input parsable by the Chronic Ruby library, such as 'yesterday', or 'two weeks ago'. Default varies based on the value of by.</p>\n","type":"text/plain"},"key":"from"},{"description":{"content":"<p>Limit query to a specific geographic region. One of:</p>\n<p>usa - North America.\neurope - Europe.\nanzac - Australia and New Zealand.\nasia - Asia.\nasia_india - India.\nasia_southkorea - South Korea.\nafrica_std - Africa.\nmexico - Mexico.\nsouthamerica_std - South America.</p>\n","type":"text/plain"},"key":"region"},{"description":{"content":"<p>Timestamp that defines the end of the window for which to fetch statistics. Accepts the same formats as from.</p>\n","type":"text/plain"},"key":"to"}],"variable":[]}},"response":[{"id":"343a0182-fb91-42a9-be7b-5b81c5489c4e","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/stats/aggregate?by=day&from=2020-04-09T18%3A14%3A30Z&region=usa&to=2020-04-09T18%3A14%3A30Z?by&from&region&to","protocol":"https","host":["api","fastly","com"],"path":["stats","aggregate"],"query":[{"key":"by","description":"Duration of sample windows. One of:\n\nhour - Group data by hour.\nminute - Group data by minute.\nday - Group data by day."},{"key":"from","description":"Timestamp that defines the start of the window for which to fetch statistics, including the timestamp itself. Accepts Unix timestamps, or any form of input parsable by the Chronic Ruby library, such as 'yesterday', or 'two weeks ago'. Default varies based on the value of by."},{"key":"region","description":"Limit query to a specific geographic region. One of:\n\nusa - North America.\neurope - Europe.\nanzac - Australia and New Zealand.\nasia - Asia.\nasia_india - India.\nasia_southkorea - South Korea.\nafrica_std - Africa.\nmexico - Mexico.\nsouthamerica_std - South America."},{"key":"to","description":"Timestamp that defines the end of the window for which to fetch statistics. Accepts the same formats as from."}]},"description":"Fetches historical stats information aggregated across all of your Fastly services.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"success\",\"meta\":{\"to\":\"Thu May 16 20:29:37 UTC 2020\",\"from\":\"Tue May 14 20:29:37 UTC 2020\",\"by\":\"day\",\"region\":\"all\"},\"msg\":null,\"data\":[{\"requests\":7022557,\"miss_time\":43342.54711368301,\"start_time\":1368576000,\"bandwidth\":33656143431,\"hits\":1851903,\"hits_time\":284.90881923000006,\"miss\":74773,\"body_size\":31118762171,\"pass\":5076669,\"header_size\":2537381260,\"req_header_bytes\":2905859973,\"req_body_bytes\":390017958,\"resp_header_bytes\":2537381260,\"resp_body_bytes\":31118762171,\"bereq_header_bytes\":1870557109,\"bereq_body_bytes\":389234083,\"status_200\":6959769,\"status_204\":0,\"status_301\":3093,\"status_302\":60,\"status_304\":14135,\"errors\":21642,\"hit_ratio\":0.9612,\"status_1xx\":0,\"status_2xx\":6959769,\"status_3xx\":17288,\"status_4xx\":23855,\"status_503\":21631,\"pipe\":0,\"status_5xx\":21642,\"uncacheable\":0,\"tls\":2804069,\"shield\":208055,\"ipv6\":14156,\"otfp\":12006,\"video\":306053,\"pci\":3041,\"logging\":2088120,\"http2\":251589,\"attack_req_body_bytes\":1274842,\"attack_req_header_bytes\":892196,\"attack_resp_synth_bytes\":0,\"imgopto\":1404},{\"requests\":7908607,\"miss_time\":31645.078110511986,\"start_time\":1368662400,\"bandwidth\":201478840738,\"hits\":3455867,\"hits_time\":751.2703607920007,\"miss\":114580,\"body_size\":198672905955,\"pass\":4310192,\"header_size\":2805934783,\"req_header_bytes\":2905859973,\"req_body_bytes\":390017958,\"resp_header_bytes\":2805934783,\"resp_body_bytes\":198672905955,\"bereq_header_bytes\":1870557109,\"bereq_body_bytes\":389234083,\"status_200\":7128395,\"status_204\":0,\"status_301\":2649,\"status_302\":30,\"status_304\":9920,\"errors\":41389,\"hit_ratio\":0.9679,\"status_1xx\":0,\"status_2xx\":7128395,\"status_3xx\":12599,\"status_4xx\":726224,\"status_503\":41246,\"pipe\":0,\"status_5xx\":41389,\"uncacheable\":0,\"tls\":2804069,\"shield\":208055,\"ipv6\":14156,\"otfp\":12006,\"video\":306053,\"pci\":3041,\"logging\":2088120,\"http2\":251589,\"attack_req_body_bytes\":1274842,\"attack_req_header_bytes\":892196,\"attack_resp_synth_bytes\":0,\"imgopto\":1404}]}"}],"_postman_id":"f12aba7c-47a9-4264-ba8c-dced6b8d9170"},{"name":"Get historical stats for a single service","id":"01b6ac58-8073-470f-b945-6be5882899f8","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/stats/service/{{service_id}}?by&datacenter&from&region&to","description":"<p>Fetches historical stats for a given service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["stats","service","{{service_id}}"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Duration of sample windows. One of:</p>\n<p>hour - Group data by hour.\nminute - Group data by minute.\nday - Group data by day.</p>\n","type":"text/plain"},"key":"by"},{"description":{"content":"<p>Limit query to one or more Fastly POPs. For multiple POPs use a comma-seperated list of POPs.\nThese must be all uppercase and be valid codes. A full list of POPs can be obtained from the\nPOPs endpoint.</p>\n","type":"text/plain"},"key":"datacenter"},{"description":{"content":"<p>Timestamp that defines the start of the window for which to fetch statistics, including the timestamp itself. Accepts Unix timestamps, or any form of input parsable by the Chronic Ruby library, such as 'yesterday', or 'two weeks ago'. Default varies based on the value of by.</p>\n","type":"text/plain"},"key":"from"},{"description":{"content":"<p>Limit query to a specific geographic region. One of:</p>\n<p>usa - North America.\neurope - Europe.\nanzac - Australia and New Zealand.\nasia - Asia.\nasia_india - India.\nasia_southkorea - South Korea.\nafrica_std - Africa.\nmexico - Mexico.\nsouthamerica_std - South America.</p>\n","type":"text/plain"},"key":"region"},{"description":{"content":"<p>Timestamp that defines the end of the window for which to fetch statistics. Accepts the same formats as from.</p>\n","type":"text/plain"},"key":"to"}],"variable":[]}},"response":[{"id":"fe5366c6-8cb6-4a62-adfc-ac5a730fa954","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/stats/service/SU1Z0isxPaozGVKXdv0eY?by=day&datacenter=IAD%2CCHI&from=2020-04-09T18%3A14%3A30Z&region=usa&to=2020-04-09T18%3A14%3A30Z?by&datacenter&from&region&to","protocol":"https","host":["api","fastly","com"],"path":["stats","service","SU1Z0isxPaozGVKXdv0eY"],"query":[{"key":"by","description":"Duration of sample windows. One of:\n\nhour - Group data by hour.\nminute - Group data by minute.\nday - Group data by day."},{"key":"datacenter","description":"Limit query to one or more Fastly POPs. For multiple POPs use a comma-seperated list of POPs.\nThese must be all uppercase and be valid codes. A full list of POPs can be obtained from the\nPOPs endpoint."},{"key":"from","description":"Timestamp that defines the start of the window for which to fetch statistics, including the timestamp itself. Accepts Unix timestamps, or any form of input parsable by the Chronic Ruby library, such as 'yesterday', or 'two weeks ago'. Default varies based on the value of by."},{"key":"region","description":"Limit query to a specific geographic region. One of:\n\nusa - North America.\neurope - Europe.\nanzac - Australia and New Zealand.\nasia - Asia.\nasia_india - India.\nasia_southkorea - South Korea.\nafrica_std - Africa.\nmexico - Mexico.\nsouthamerica_std - South America."},{"key":"to","description":"Timestamp that defines the end of the window for which to fetch statistics. Accepts the same formats as from."}]},"description":"Fetches historical stats for a given service.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"success\",\"meta\":{\"to\":\"Thu May 16 20:39:09 UTC 2020\",\"from\":\"Tue May 14 20:39:09 UTC 2020\",\"by\":\"day\",\"region\":\"all\"},\"msg\":null,\"data\":[{\"requests\":21,\"miss_time\":0,\"start_time\":1368734160,\"service_id\":\"1jlmtMz1ncwA0KC3TBGD0X\",\"bandwidth\":160238,\"hits\":0,\"hits_time\":0,\"miss\":0,\"body_size\":150948,\"pass\":19,\"header_size\":9290,\"req_header_bytes\":2905859973,\"req_body_bytes\":390017958,\"resp_header_bytes\":9290,\"resp_body_bytes\":150948,\"bereq_header_bytes\":1870557109,\"bereq_body_bytes\":389234083,\"status_200\":14,\"status_204\":0,\"status_301\":2,\"status_302\":0,\"status_304\":0,\"errors\":0,\"hit_ratio\":null,\"status_1xx\":0,\"status_2xx\":14,\"status_3xx\":2,\"status_4xx\":5,\"status_503\":0,\"pipe\":0,\"status_5xx\":0,\"uncacheable\":0,\"tls\":2804069,\"shield\":208055,\"ipv6\":14156,\"otfp\":12006,\"video\":306053,\"pci\":3041,\"logging\":2088120,\"http2\":251589,\"attack_req_body_bytes\":1274842,\"attack_req_header_bytes\":892196,\"attack_resp_synth_bytes\":0,\"imgopto\":1404},{\"requests\":20,\"miss_time\":0,\"start_time\":1368734220,\"service_id\":\"1jlmtMz1ncwA0KC3TBGD0X\",\"bandwidth\":156504,\"hits\":0,\"hits_time\":0,\"miss\":0,\"body_size\":147806,\"pass\":17,\"header_size\":8698,\"req_header_bytes\":2905859973,\"req_body_bytes\":390017958,\"resp_header_bytes\":8698,\"resp_body_bytes\":147806,\"bereq_header_bytes\":1870557109,\"bereq_body_bytes\":389234083,\"status_200\":12,\"status_204\":0,\"status_301\":3,\"status_302\":0,\"status_304\":0,\"errors\":0,\"hit_ratio\":null,\"status_1xx\":0,\"status_2xx\":12,\"status_3xx\":3,\"status_4xx\":5,\"status_503\":0,\"pipe\":0,\"status_5xx\":0,\"uncacheable\":0,\"tls\":2804069,\"shield\":208055,\"ipv6\":14156,\"otfp\":12006,\"video\":306053,\"pci\":3041,\"logging\":2088120,\"http2\":251589,\"attack_req_body_bytes\":1274842,\"attack_req_header_bytes\":892196,\"attack_resp_synth_bytes\":0,\"imgopto\":1404}]}"}],"_postman_id":"01b6ac58-8073-470f-b945-6be5882899f8"},{"name":"Get historical stats for a single service/field combination","id":"276f6396-693e-4189-a2de-7714708909ed","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/stats/service/{{service_id}}/field/{{field}}?by&datacenter&from&region&to","description":"<p>Fetches the specified field from the historical stats for a given service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["stats","service","{{service_id}}","field","{{field}}"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Duration of sample windows. One of:</p>\n<p>hour - Group data by hour.\nminute - Group data by minute.\nday - Group data by day.</p>\n","type":"text/plain"},"key":"by"},{"description":{"content":"<p>Limit query to one or more Fastly POPs. For multiple POPs use a comma-seperated list of POPs.\nThese must be all uppercase and be valid codes. A full list of POPs can be obtained from the\nPOPs endpoint.</p>\n","type":"text/plain"},"key":"datacenter"},{"description":{"content":"<p>Timestamp that defines the start of the window for which to fetch statistics, including the timestamp itself. Accepts Unix timestamps, or any form of input parsable by the Chronic Ruby library, such as 'yesterday', or 'two weeks ago'. Default varies based on the value of by.</p>\n","type":"text/plain"},"key":"from"},{"description":{"content":"<p>Limit query to a specific geographic region. One of:</p>\n<p>usa - North America.\neurope - Europe.\nanzac - Australia and New Zealand.\nasia - Asia.\nasia_india - India.\nasia_southkorea - South Korea.\nafrica_std - Africa.\nmexico - Mexico.\nsouthamerica_std - South America.</p>\n","type":"text/plain"},"key":"region"},{"description":{"content":"<p>Timestamp that defines the end of the window for which to fetch statistics. Accepts the same formats as from.</p>\n","type":"text/plain"},"key":"to"}],"variable":[]}},"response":[{"id":"9239c665-935c-4e58-acc2-05257c95bac4","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/stats/service/SU1Z0isxPaozGVKXdv0eY/field/hit_ratio?by=day&datacenter=IAD%2CCHI&from=2020-04-09T18%3A14%3A30Z&region=usa&to=2020-04-09T18%3A14%3A30Z?by&datacenter&from&region&to","protocol":"https","host":["api","fastly","com"],"path":["stats","service","SU1Z0isxPaozGVKXdv0eY","field","hit_ratio"],"query":[{"key":"by","description":"Duration of sample windows. One of:\n\nhour - Group data by hour.\nminute - Group data by minute.\nday - Group data by day."},{"key":"datacenter","description":"Limit query to one or more Fastly POPs. For multiple POPs use a comma-seperated list of POPs.\nThese must be all uppercase and be valid codes. A full list of POPs can be obtained from the\nPOPs endpoint."},{"key":"from","description":"Timestamp that defines the start of the window for which to fetch statistics, including the timestamp itself. Accepts Unix timestamps, or any form of input parsable by the Chronic Ruby library, such as 'yesterday', or 'two weeks ago'. Default varies based on the value of by."},{"key":"region","description":"Limit query to a specific geographic region. One of:\n\nusa - North America.\neurope - Europe.\nanzac - Australia and New Zealand.\nasia - Asia.\nasia_india - India.\nasia_southkorea - South Korea.\nafrica_std - Africa.\nmexico - Mexico.\nsouthamerica_std - South America."},{"key":"to","description":"Timestamp that defines the end of the window for which to fetch statistics. Accepts the same formats as from."}]},"description":"Fetches the specified field from the historical stats for a given service.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"success\",\"meta\":{\"to\":\"Thu May 16 20:39:09 UTC 2020\",\"from\":\"Tue May 14 20:39:09 UTC 2020\",\"by\":\"day\",\"region\":\"all\"},\"msg\":null,\"data\":[{\"service_id\":\"1jlmtMz1ncwA0KC3TBGD0X\",\"start_time\":1368576000,\"hit_ratio\":0.9944},{\"service_id\":\"1jlmtMz1ncwA0KC3TBGD0X\",\"start_time\":1368662400,\"hit_ratio\":1}]}"}],"_postman_id":"276f6396-693e-4189-a2de-7714708909ed"},{"name":"Get usage statistics","id":"ac1cbed1-3e7f-4264-ac80-91dcbf46a941","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/stats/usage?from&to","description":"<p>Returns usage information aggregated across all Fastly services and grouped by region. To aggregate across all Fastly services by time period, see /stats/aggregate.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["stats","usage"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Timestamp that defines the start of the window for which to fetch statistics, including the timestamp itself. Accepts Unix timestamps, or any form of input parsable by the Chronic Ruby library, such as 'yesterday', or 'two weeks ago'. Default varies based on the value of by.</p>\n","type":"text/plain"},"key":"from"},{"description":{"content":"<p>Timestamp that defines the end of the window for which to fetch statistics. Accepts the same formats as from.</p>\n","type":"text/plain"},"key":"to"}],"variable":[]}},"response":[{"id":"99b9bcf6-a5c1-406f-8f22-f728b6988f2d","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/stats/usage?from=2020-04-09T18%3A14%3A30Z&to=2020-04-09T18%3A14%3A30Z?from&to","protocol":"https","host":["api","fastly","com"],"path":["stats","usage"],"query":[{"key":"from","description":"Timestamp that defines the start of the window for which to fetch statistics, including the timestamp itself. Accepts Unix timestamps, or any form of input parsable by the Chronic Ruby library, such as 'yesterday', or 'two weeks ago'. Default varies based on the value of by."},{"key":"to","description":"Timestamp that defines the end of the window for which to fetch statistics. Accepts the same formats as from."}]},"description":"Returns usage information aggregated across all Fastly services and grouped by region. To aggregate across all Fastly services by time period, see /stats/aggregate.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"success\",\"meta\":{\"to\":\"Thu May 16 20:39:09 UTC 2020\",\"from\":\"Tue May 14 20:39:09 UTC 2020\",\"by\":\"day\",\"region\":\"all\"},\"msg\":null,\"data\":{\"apac\":{\"requests\":163546563,\"compute_requests\":195733,\"bandwidth\":10735282284},\"ausnz\":{\"requests\":2888860,\"compute_requests\":8453890,\"bandwidth\":173220202333},\"usa\":{\"requests\":163546563,\"compute_requests\":337591,\"bandwidth\":153220202333},\"europe\":{\"requests\":2888860,\"compute_requests\":5385905,\"bandwidth\":10735282284}}}"}],"_postman_id":"ac1cbed1-3e7f-4264-ac80-91dcbf46a941"},{"name":"Get usage statistics per service","id":"64769316-511d-4eb1-b8f3-8b8512ae81bc","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/stats/usage_by_service?from&to","description":"<p>Returns usage information aggregated by service and grouped by service and region. For service stats by time period, see /stats and /stats/field/:field.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["stats","usage_by_service"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Timestamp that defines the start of the window for which to fetch statistics, including the timestamp itself. Accepts Unix timestamps, or any form of input parsable by the Chronic Ruby library, such as 'yesterday', or 'two weeks ago'. Default varies based on the value of by.</p>\n","type":"text/plain"},"key":"from"},{"description":{"content":"<p>Timestamp that defines the end of the window for which to fetch statistics. Accepts the same formats as from.</p>\n","type":"text/plain"},"key":"to"}],"variable":[]}},"response":[{"id":"0c48d7a8-c923-48c6-9859-95251357f001","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/stats/usage_by_service?from=2020-04-09T18%3A14%3A30Z&to=2020-04-09T18%3A14%3A30Z?from&to","protocol":"https","host":["api","fastly","com"],"path":["stats","usage_by_service"],"query":[{"key":"from","description":"Timestamp that defines the start of the window for which to fetch statistics, including the timestamp itself. Accepts Unix timestamps, or any form of input parsable by the Chronic Ruby library, such as 'yesterday', or 'two weeks ago'. Default varies based on the value of by."},{"key":"to","description":"Timestamp that defines the end of the window for which to fetch statistics. Accepts the same formats as from."}]},"description":"Returns usage information aggregated by service and grouped by service and region. For service stats by time period, see /stats and /stats/field/:field.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"success\",\"meta\":{\"to\":\"Thu May 16 20:39:09 UTC 2020\",\"from\":\"Tue May 14 20:39:09 UTC 2020\",\"by\":\"day\",\"region\":\"all\"},\"msg\":null,\"data\":{\"apac\":{\"1iPMGAF44YgzB7sINv4KTF\":{\"requests\":60524,\"compute_requests\":51342,\"bandwidth\":6004223792},\"7mai6mbwRz0JXxhAY8ZSN2\":{\"requests\":3,\"compute_requests\":7,\"bandwidth\":1305}},\"ausnz\":{\"1iPMGAF44YgzB7sINv4KTF\":{\"requests\":101120,\"compute_requests\":53703,\"bandwidth\":1735577606},\"7mai6mbwRz0JXxhAY8ZSN2\":{\"requests\":93294,\"compute_requests\":19750608,\"bandwidth\":38109995}},\"usa\":{\"1iPMGAF44YgzB7sINv4KTF\":{\"requests\":1109033,\"compute_requests\":29148,\"bandwidth\":21642401706},\"7mai6mbwRz0JXxhAY8ZSN2\":{\"requests\":348175,\"compute_requests\":91914,\"bandwidth\":173135847}},\"europe\":{\"1iPMGAF44YgzB7sINv4KTF\":{\"requests\":567583,\"compute_requests\":84123,\"bandwidth\":14813592344},\"7mai6mbwRz0JXxhAY8ZSN2\":{\"requests\":260025,\"compute_requests\":112977,\"bandwidth\":110928988}}}}"}],"_postman_id":"64769316-511d-4eb1-b8f3-8b8512ae81bc"},{"name":"Get month-to-date usage statistics","id":"6888270b-b7ca-4e76-935b-efc67c5c640b","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/stats/usage_by_month?billable_units&month&year","description":"<p>Returns month-to-date usage details for a given month and year. Usage details are aggregated by service and across all Fastly services, and then grouped by region. This endpoint does not use the from or to fields for selecting the date for which data is requested. Instead, it uses month and year integer fields. Both fields are optional and default to the current month and year respectively. When set, an optional billable_units field will convert bandwidth to GB and divide requests by 10,000.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>, Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["stats","usage_by_month"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>If true, return results as billable units.</p>\n","type":"text/plain"},"key":"billable_units"},{"description":{"content":"<p>2-digit month.</p>\n","type":"text/plain"},"key":"month"},{"description":{"content":"<p>4-digit year.</p>\n","type":"text/plain"},"key":"year"}],"variable":[]}},"response":[{"id":"a3374e3c-ae72-48aa-8fd4-ae562d461dd5","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/stats/usage_by_month?billable_units=true&month=05&year=2020?billable_units&month&year","protocol":"https","host":["api","fastly","com"],"path":["stats","usage_by_month"],"query":[{"key":"billable_units","description":"If true, return results as billable units."},{"key":"month","description":"2-digit month."},{"key":"year","description":"4-digit year."}]},"description":"Returns month-to-date usage details for a given month and year. Usage details are aggregated by service and across all Fastly services, and then grouped by region. This endpoint does not use the from or to fields for selecting the date for which data is requested. Instead, it uses month and year integer fields. Both fields are optional and default to the current month and year respectively. When set, an optional billable_units field will convert bandwidth to GB and divide requests by 10,000.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens), Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"success\",\"msg\":null,\"meta\":{\"from\":\"2020-05-01 00:00:00 +0000\",\"to\":\"2020-05-31 23:59:59 +0000\",\"by\":\"day\",\"region\":\"all\"},\"data\":{\"customer_id\":\"x4xCwxxJxGCx123Rx5xTx\",\"services\":{\"SU1Z0isxPaozGVKXdv0eY\":{\"name\":\"test-service\",\"anzac\":{\"bandwidth\":28.815130509,\"requests\":131.7256,\"compute_requests\":256.3968},\"asia\":{\"bandwidth\":180.182470562,\"requests\":965.4324,\"compute_requests\":801.6574},\"europe\":{\"bandwidth\":1230.23131801,\"requests\":6082.2894,\"compute_requests\":3334.6109},\"latam\":{\"bandwidth\":18.070301895,\"requests\":93.7146,\"compute_requests\":619.1009},\"south_africa\":{\"bandwidth\":8.77620445,\"requests\":37.9704,\"compute_requests\":33.1321},\"usa\":{\"bandwidth\":2330.717545144,\"requests\":5524.7604,\"compute_requests\":5718.4171}}},\"total\":{\"anzac\":{\"bandwidth\":28.815130509,\"requests\":131.7256,\"compute_requests\":256.3968},\"asia\":{\"bandwidth\":180.182470562,\"requests\":965.4324,\"compute_requests\":801.6574},\"europe\":{\"bandwidth\":1230.23131801,\"requests\":6082.2894,\"compute_requests\":3334.6109},\"latam\":{\"bandwidth\":18.070301895,\"requests\":93.7146,\"compute_requests\":619.1009},\"south_africa\":{\"bandwidth\":8.77620445,\"requests\":37.9704,\"compute_requests\":33.1321},\"usa\":{\"bandwidth\":2330.717545144,\"requests\":5524.7604,\"compute_requests\":5718.4171}}}}"}],"_postman_id":"6888270b-b7ca-4e76-935b-efc67c5c640b"},{"name":"Get region codes","id":"4a32265c-059a-48e9-954e-4124180acfa3","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/stats/regions","description":"<p>Fetches the list of codes for regions that are covered by the Fastly CDN service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["stats","regions"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"c4030717-b1e1-4c0b-9e12-d54ea0807fb0","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/stats/regions","description":"Fetches the list of codes for regions that are covered by the Fastly CDN service.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"success\",\"meta\":{\"to\":\"Thu May 16 20:39:09 UTC 2020\",\"from\":\"Tue May 14 20:39:09 UTC 2020\",\"by\":\"day\",\"region\":\"all\"},\"msg\":null,\"data\":[\"apac\",\"ausnz\",\"usa\",\"europe\"]}"}],"_postman_id":"4a32265c-059a-48e9-954e-4124180acfa3"}],"id":"a776fc5a-fb47-41f9-9939-ee2ef772003b","description":"<p>The Historical Stats API allows you to programmatically retrieve historical caching statistics derived from your Fastly services. You can use these metrics to help you optimize your site’s data caching and analyze your site’s traffic.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>meta</td>\n<td>object</td>\n<td>Meta information about the scope of the query in a human readable format.</td>\n</tr>\n<tr>\n<td>msg</td>\n<td>string</td>\n<td>If the query was not successful, this will provide a string that explains why.</td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>Whether or not we were able to successfully execute the query.</td>\n</tr>\n<tr>\n<td>customer_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the customer.</td>\n</tr>\n<tr>\n<td>services</td>\n<td>object</td>\n<td>Organized by service id.</td>\n</tr>\n<tr>\n<td>total</td>\n<td>object</td>\n<td>Organized by region.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The name of the service.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-1\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n</tbody>\n</table>\n</div><h2 id=\"data-model-2\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>aia_estimated_time_saved_ms</td>\n<td>integer</td>\n<td>The estimated amount of time saved by responses served from the AI Accelerator semantic cache.</td>\n</tr>\n<tr>\n<td>aia_origin_usage_tokens</td>\n<td>integer</td>\n<td>The number of usage tokens reported by the request to the origin from AI Accelerator.</td>\n</tr>\n<tr>\n<td>aia_requests</td>\n<td>integer</td>\n<td>Number of requests received by AI Accelerator.</td>\n</tr>\n<tr>\n<td>aia_response_usage_tokens</td>\n<td>integer</td>\n<td>The usage tokens associated with the response returned from the AI Accelerator cache.</td>\n</tr>\n<tr>\n<td>aia_status_1xx</td>\n<td>integer</td>\n<td>Number of \"Informational\" category status codes received from AI provider.</td>\n</tr>\n<tr>\n<td>aia_status_2xx</td>\n<td>integer</td>\n<td>Number of \"Success\" status codes received from AI provider.</td>\n</tr>\n<tr>\n<td>aia_status_3xx</td>\n<td>integer</td>\n<td>Number of \"Redirection\" received from AI provider.</td>\n</tr>\n<tr>\n<td>aia_status_4xx</td>\n<td>integer</td>\n<td>Number of \"Client Error\" received from AI provider.</td>\n</tr>\n<tr>\n<td>aia_status_5xx</td>\n<td>integer</td>\n<td>Number of \"Server Error\" received from AI provider.</td>\n</tr>\n<tr>\n<td>all_edge_hit_requests</td>\n<td>integer</td>\n<td>Number of requests sent by end users to Fastly that resulted in a hit at the edge for a VCL service.</td>\n</tr>\n<tr>\n<td>all_edge_miss_requests</td>\n<td>integer</td>\n<td>Number of requests sent by end users to Fastly that resulted in a miss at the edge for a VCL service.</td>\n</tr>\n<tr>\n<td>all_error_requests</td>\n<td>integer</td>\n<td>Number of cache errors for a VCL service.</td>\n</tr>\n<tr>\n<td>all_hit_requests</td>\n<td>integer</td>\n<td>Number of cache hits for a VCL service.</td>\n</tr>\n<tr>\n<td>all_miss_requests</td>\n<td>integer</td>\n<td>Number of cache misses for a VCL service.</td>\n</tr>\n<tr>\n<td>all_pass_requests</td>\n<td>integer</td>\n<td>Number of requests that passed through the CDN without being cached for a VCL service.</td>\n</tr>\n<tr>\n<td>all_status_1xx</td>\n<td>integer</td>\n<td>Number of \"Informational\" category status codes delivered for all sources.</td>\n</tr>\n<tr>\n<td>all_status_2xx</td>\n<td>integer</td>\n<td>Number of \"Success\" status codes delivered for all sources.</td>\n</tr>\n<tr>\n<td>all_status_3xx</td>\n<td>integer</td>\n<td>Number of \"Redirection\" codes delivered for all sources.</td>\n</tr>\n<tr>\n<td>all_status_4xx</td>\n<td>integer</td>\n<td>Number of \"Client Error\" codes delivered for all sources.</td>\n</tr>\n<tr>\n<td>all_status_5xx</td>\n<td>integer</td>\n<td>Number of \"Server Error\" codes delivered for all sources.</td>\n</tr>\n<tr>\n<td>all_synth_requests</td>\n<td>integer</td>\n<td>Number of requests that returned a synthetic response (i.e., response objects created with the synthetic VCL statement) for a VCL service.</td>\n</tr>\n<tr>\n<td>api_discovery_requests_count</td>\n<td>integer</td>\n<td>Number of requests processed by the API Discovery engine.</td>\n</tr>\n<tr>\n<td>attack_blocked_req_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes received from requests that triggered a WAF rule that was blocked.</td>\n</tr>\n<tr>\n<td>attack_blocked_req_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received from requests that triggered a WAF rule that was blocked.</td>\n</tr>\n<tr>\n<td>attack_logged_req_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes received from requests that triggered a WAF rule that was logged.</td>\n</tr>\n<tr>\n<td>attack_logged_req_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received from requests that triggered a WAF rule that was logged.</td>\n</tr>\n<tr>\n<td>attack_passed_req_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes received from requests that triggered a WAF rule that was passed.</td>\n</tr>\n<tr>\n<td>attack_passed_req_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received from requests that triggered a WAF rule that was passed.</td>\n</tr>\n<tr>\n<td>attack_req_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes received from requests that triggered a WAF rule.</td>\n</tr>\n<tr>\n<td>attack_req_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received from requests that triggered a WAF rule.</td>\n</tr>\n<tr>\n<td>attack_resp_synth_bytes</td>\n<td>integer</td>\n<td>Total bytes delivered for requests that triggered a WAF rule and returned a synthetic response.</td>\n</tr>\n<tr>\n<td>bandwidth</td>\n<td>integer</td>\n<td>Total bytes delivered (resp_header_bytes + resp_body_bytes + bereq_header_bytes + bereq_body_bytes + compute_resp_header_bytes + compute_resp_body_bytes + compute_bereq_header_bytes + compute_bereq_body_bytes + websocket_resp_header_bytes + websocket_resp_body_bytes + websocket_bereq_header_bytes + websocket_bereq_body_bytes + fanout_resp_header_bytes + fanout_resp_body_bytes + fanout_bereq_header_bytes + fanout_bereq_body_bytes).</td>\n</tr>\n<tr>\n<td>bereq_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes sent to origin.</td>\n</tr>\n<tr>\n<td>bereq_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes sent to origin.</td>\n</tr>\n<tr>\n<td>body_size</td>\n<td>integer</td>\n<td>Total body bytes delivered (alias for resp_body_bytes).</td>\n</tr>\n<tr>\n<td>bot_challenge_complete_tokens_checked</td>\n<td>integer</td>\n<td>The number of challenge-complete tokens checked.</td>\n</tr>\n<tr>\n<td>bot_challenge_complete_tokens_disabled</td>\n<td>integer</td>\n<td>The number of challenge-complete tokens not checked because the feature was disabled.</td>\n</tr>\n<tr>\n<td>bot_challenge_complete_tokens_failed</td>\n<td>integer</td>\n<td>The number of challenge-complete tokens that failed validation.</td>\n</tr>\n<tr>\n<td>bot_challenge_complete_tokens_issued</td>\n<td>integer</td>\n<td>The number of challenge-complete tokens issued. For example, issuing a challenge-complete token after a series of CAPTCHA challenges ending in success.</td>\n</tr>\n<tr>\n<td>bot_challenge_complete_tokens_passed</td>\n<td>integer</td>\n<td>The number of challenge-complete tokens that passed validation.</td>\n</tr>\n<tr>\n<td>bot_challenge_starts</td>\n<td>integer</td>\n<td>The number of challenge-start tokens created.</td>\n</tr>\n<tr>\n<td>bot_challenges_failed</td>\n<td>integer</td>\n<td>The number of failed challenge solutions processed. For example, an incorrect CAPTCHA solution.</td>\n</tr>\n<tr>\n<td>bot_challenges_issued</td>\n<td>integer</td>\n<td>The number of challenges issued. For example, the issuance of a CAPTCHA challenge.</td>\n</tr>\n<tr>\n<td>bot_challenges_succeeded</td>\n<td>integer</td>\n<td>The number of successful challenge solutions processed. For example, a correct CAPTCHA solution.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_accessibility_count</td>\n<td>integer</td>\n<td>Count of edge requests where an accessibility bot was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_ai_crawler_count</td>\n<td>integer</td>\n<td>Count of edge requests where an AI crawler was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_ai_fetcher_count</td>\n<td>integer</td>\n<td>Count of edge requests where an AI fetcher was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_analyzed_count</td>\n<td>integer</td>\n<td>Count of edge requests where bot detection analysis was performed.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_content_fetcher_count</td>\n<td>integer</td>\n<td>Count of edge requests where a content fetcher was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_detected_count</td>\n<td>integer</td>\n<td>Count of edge requests where a bot was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_monitoring_count</td>\n<td>integer</td>\n<td>Count of edge requests where a monitoring and site tool was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_online_marketing_count</td>\n<td>integer</td>\n<td>Count of edge requests where an online marketing bot was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_page_preview_count</td>\n<td>integer</td>\n<td>Count of edge requests where a page preview bot was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_platform_integrations_count</td>\n<td>integer</td>\n<td>Count of edge requests where a platform integration was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_research_count</td>\n<td>integer</td>\n<td>Count of edge requests where a research bot was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_search_engine_crawler_count</td>\n<td>integer</td>\n<td>Count of edge requests where a search engine crawler was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_search_engine_optimization_count</td>\n<td>integer</td>\n<td>Count of edge requests where a search engine optimization bot was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_security_tools_count</td>\n<td>integer</td>\n<td>Count of edge requests where a security tool was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_verified_count</td>\n<td>integer</td>\n<td>Count of edge requests where a verified bot was detected.</td>\n</tr>\n<tr>\n<td>bot_requests_total_count</td>\n<td>integer</td>\n<td>Total number of Bot Management requests across all deployments.</td>\n</tr>\n<tr>\n<td>compute_bereq_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes sent to backends (origins) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_bereq_errors</td>\n<td>integer</td>\n<td>Number of backend request errors, including timeouts.</td>\n</tr>\n<tr>\n<td>compute_bereq_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes sent to backends (origins) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_bereqs</td>\n<td>integer</td>\n<td>Number of backend requests started.</td>\n</tr>\n<tr>\n<td>compute_beresp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes received from backends (origins) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_beresp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received from backends (origins) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_cache_operations_count</td>\n<td>integer</td>\n<td>Number of cache operations executed by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_execution_time_ms</td>\n<td>number</td>\n<td>The amount of active CPU time used to process your requests (in milliseconds).</td>\n</tr>\n<tr>\n<td>compute_globals_limit_exceeded</td>\n<td>integer</td>\n<td>Number of times a guest exceeded its globals limit.</td>\n</tr>\n<tr>\n<td>compute_guest_errors</td>\n<td>integer</td>\n<td>Number of times a service experienced a guest code error.</td>\n</tr>\n<tr>\n<td>compute_handoff</td>\n<td>integer</td>\n<td>The number of times Compute has handed off a request to the Fanout proxy or WebSocket proxy.</td>\n</tr>\n<tr>\n<td>compute_heap_limit_exceeded</td>\n<td>integer</td>\n<td>Number of times a guest exceeded its heap limit.</td>\n</tr>\n<tr>\n<td>compute_platform_internal_error</td>\n<td>integer</td>\n<td>Fatal errors caused by internal errors in Fastly’s Compute platform.</td>\n</tr>\n<tr>\n<td>compute_platform_invalid_request_error</td>\n<td>integer</td>\n<td>Fatal errors caused by unprocessable requests to the service, such as requests with malformed CDN-Loop headers or invalid purge credentials.</td>\n</tr>\n<tr>\n<td>compute_ram_used</td>\n<td>integer</td>\n<td>The amount of RAM used for your service by Fastly (in bytes).</td>\n</tr>\n<tr>\n<td>compute_req_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_req_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_request_time_billed_ms</td>\n<td>number</td>\n<td>The total amount of request processing time you will be billed for, measured in 50 millisecond increments.</td>\n</tr>\n<tr>\n<td>compute_request_time_ms</td>\n<td>number</td>\n<td>The total, actual amount of time used to process your requests, including active CPU time (in milliseconds).</td>\n</tr>\n<tr>\n<td>compute_requests</td>\n<td>integer</td>\n<td>The total number of requests that were received for your service by Fastly.</td>\n</tr>\n<tr>\n<td>compute_resource_limit_exceeded</td>\n<td>integer</td>\n<td>Number of times a guest exceeded its resource limit, includes heap, stack, globals, and code execution timeout.</td>\n</tr>\n<tr>\n<td>compute_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes sent from Compute to end user.</td>\n</tr>\n<tr>\n<td>compute_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes sent from Compute to end user.</td>\n</tr>\n<tr>\n<td>compute_resp_status_103</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 103 (Early Hints) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_1xx</td>\n<td>integer</td>\n<td>Number of \"Informational\" category status codes delivered by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_200</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 200 (Success) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_204</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 204 (No Content) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_206</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 206 (Partial Content) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_2xx</td>\n<td>integer</td>\n<td>Number of \"Success\" category status codes delivered by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_301</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 301 (Moved Permanently) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_302</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 302 (Found) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_304</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 304 (Not Modified) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_3xx</td>\n<td>integer</td>\n<td>Number of \"Redirection\" category status codes delivered by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_400</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 400 (Bad Request) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_401</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 401 (Unauthorized) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_403</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 403 (Forbidden) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_404</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 404 (Not Found) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_416</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 416 (Range Not Satisfiable) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_429</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 429 (Too Many Requests) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_4xx</td>\n<td>integer</td>\n<td>Number of \"Client Error\" category status codes delivered by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_500</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 500 (Internal Server Error) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_501</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 501 (Not Implemented) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_502</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 502 (Bad Gateway) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_503</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 503 (Service Unavailable) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_504</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 504 (Gateway Timeout) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_505</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 505 (HTTP Version Not Supported) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_530</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 530 by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_5xx</td>\n<td>integer</td>\n<td>Number of \"Server Error\" category status codes delivered by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_runtime_errors</td>\n<td>integer</td>\n<td>Number of times a service experienced a guest runtime error.</td>\n</tr>\n<tr>\n<td>compute_sandboxes</td>\n<td>integer</td>\n<td>Number of WebAssembly (Wasm) sandboxes created.</td>\n</tr>\n<tr>\n<td>compute_service_bereq_error</td>\n<td>integer</td>\n<td>Number of backend request errors, including timeouts.</td>\n</tr>\n<tr>\n<td>compute_service_chain_error</td>\n<td>integer</td>\n<td>Fatal errors caused by the service path exceeding hop or service limits, or where a forwarding loop is detected via CDN-Loop headers.</td>\n</tr>\n<tr>\n<td>compute_service_limits_error</td>\n<td>integer</td>\n<td>Non-fatal errors caused by attempts to exceed defined operational limits, such as simultaneous backend requests or cache transactions.</td>\n</tr>\n<tr>\n<td>compute_service_memory_exceeded_error</td>\n<td>integer</td>\n<td>Number of times a guest exceeded its heap limit.</td>\n</tr>\n<tr>\n<td>compute_service_resource_limits_error</td>\n<td>integer</td>\n<td>Aggregate of fatal errors caused by exceeding allocated resource limits, specifically runtime duration, vCPU usage, and heap memory limits.</td>\n</tr>\n<tr>\n<td>compute_service_runtime_error</td>\n<td>integer</td>\n<td>Fatal errors caused by service logic faults, including stack overflows, unreachable code traps, illegal memory access, or attempts to send multiple responses.</td>\n</tr>\n<tr>\n<td>compute_service_timeout_error</td>\n<td>integer</td>\n<td>Fatal errors caused by exceeding the per-request runtime limit.</td>\n</tr>\n<tr>\n<td>compute_service_vcpu_exceeded_error</td>\n<td>integer</td>\n<td>Fatal errors caused by exceeding the per-request vCPU time limit.</td>\n</tr>\n<tr>\n<td>compute_stack_limit_exceeded</td>\n<td>integer</td>\n<td>Number of times a guest exceeded its stack limit.</td>\n</tr>\n<tr>\n<td>ddos_action_blackhole</td>\n<td>integer</td>\n<td>The number of times the blackhole action was taken. The blackhole action quietly closes a TCP connection without sending a reset. The blackhole action quietly closes a TCP connection without notifying its peer (all TCP state is dropped).</td>\n</tr>\n<tr>\n<td>ddos_action_close</td>\n<td>integer</td>\n<td>The number of times the close action was taken. The close action aborts the connection as soon as possible. The close action takes effect either right after accept, right after the client hello, or right after the response was sent.</td>\n</tr>\n<tr>\n<td>ddos_action_downgrade</td>\n<td>integer</td>\n<td>The number of times the downgrade action was taken. The downgrade action restricts the client to http1.</td>\n</tr>\n<tr>\n<td>ddos_action_downgraded_connections</td>\n<td>integer</td>\n<td>The number of connections the downgrade action was applied to. The downgrade action restricts the connection to http1.</td>\n</tr>\n<tr>\n<td>ddos_action_limit_streams_connections</td>\n<td>integer</td>\n<td>For HTTP/2, the number of connections the limit-streams action was applied to. The limit-streams action caps the allowed number of concurrent streams in a connection.</td>\n</tr>\n<tr>\n<td>ddos_action_limit_streams_requests</td>\n<td>integer</td>\n<td>For HTTP/2, the number of requests made on a connection for which the limit-streams action was taken. The limit-streams action caps the allowed number of concurrent streams in a connection.</td>\n</tr>\n<tr>\n<td>ddos_action_tarpit</td>\n<td>integer</td>\n<td>The number of times the tarpit action was taken. The tarpit action delays writing the response to the client.</td>\n</tr>\n<tr>\n<td>ddos_action_tarpit_accept</td>\n<td>integer</td>\n<td>The number of times the tarpit-accept action was taken. The tarpit-accept action adds a delay when accepting future connections.</td>\n</tr>\n<tr>\n<td>ddos_protection_requests_allow_count</td>\n<td>integer</td>\n<td>Number of requests analyzed for DDoS attacks against a customer origin or service, but with no DDoS detected.</td>\n</tr>\n<tr>\n<td>ddos_protection_requests_detect_count</td>\n<td>integer</td>\n<td>Number of requests classified as a DDoS attack against a customer origin or service.</td>\n</tr>\n<tr>\n<td>ddos_protection_requests_mitigate_count</td>\n<td>integer</td>\n<td>Number of requests classified as a DDoS attack against a customer origin or service that were mitigated by the Fastly platform.</td>\n</tr>\n<tr>\n<td>deliver_sub_count</td>\n<td>integer</td>\n<td>Number of executions of the vcl_deliver Varnish subroutine.</td>\n</tr>\n<tr>\n<td>deliver_sub_time</td>\n<td>number</td>\n<td>Time spent inside the vcl_deliver Varnish subroutine (in seconds).</td>\n</tr>\n<tr>\n<td>dns_billable_responses_count</td>\n<td>integer</td>\n<td>Number of billable DNS responses (e.g., A, CNAME).</td>\n</tr>\n<tr>\n<td>dns_nonbillable_responses_count</td>\n<td>integer</td>\n<td>Number of non-billable DNS responses (e.g., NODATA, NXDOMAIN).</td>\n</tr>\n<tr>\n<td>edge_hit_requests</td>\n<td>integer</td>\n<td>Number of requests sent by end users to Fastly that resulted in a hit at the edge.</td>\n</tr>\n<tr>\n<td>edge_hit_resp_body_bytes</td>\n<td>integer</td>\n<td>Body bytes delivered for edge hits.</td>\n</tr>\n<tr>\n<td>edge_hit_resp_header_bytes</td>\n<td>integer</td>\n<td>Header bytes delivered for edge hits.</td>\n</tr>\n<tr>\n<td>edge_miss_requests</td>\n<td>integer</td>\n<td>Number of requests sent by end users to Fastly that resulted in a miss at the edge.</td>\n</tr>\n<tr>\n<td>edge_miss_resp_body_bytes</td>\n<td>integer</td>\n<td>Body bytes delivered for edge misses.</td>\n</tr>\n<tr>\n<td>edge_miss_resp_header_bytes</td>\n<td>integer</td>\n<td>Header bytes delivered for edge misses.</td>\n</tr>\n<tr>\n<td>edge_requests</td>\n<td>integer</td>\n<td>Number of requests sent by end users to Fastly.</td>\n</tr>\n<tr>\n<td>edge_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes delivered from Fastly to the end user.</td>\n</tr>\n<tr>\n<td>edge_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes delivered from Fastly to the end user.</td>\n</tr>\n<tr>\n<td>error_sub_count</td>\n<td>integer</td>\n<td>Number of executions of the vcl_error Varnish subroutine.</td>\n</tr>\n<tr>\n<td>error_sub_time</td>\n<td>number</td>\n<td>Time spent inside the vcl_error Varnish subroutine (in seconds).</td>\n</tr>\n<tr>\n<td>errors</td>\n<td>integer</td>\n<td>Number of cache errors.</td>\n</tr>\n<tr>\n<td>fanout_bereq_body_bytes</td>\n<td>integer</td>\n<td>Total body or message content bytes sent to backends over Fanout connections.</td>\n</tr>\n<tr>\n<td>fanout_bereq_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes sent to backends over Fanout connections.</td>\n</tr>\n<tr>\n<td>fanout_beresp_body_bytes</td>\n<td>integer</td>\n<td>Total body or message content bytes received from backends over Fanout connections.</td>\n</tr>\n<tr>\n<td>fanout_beresp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received from backends over Fanout connections.</td>\n</tr>\n<tr>\n<td>fanout_conn_time_ms</td>\n<td>integer</td>\n<td>Total duration of Fanout connections with end users.</td>\n</tr>\n<tr>\n<td>fanout_recv_publishes</td>\n<td>integer</td>\n<td>Total published messages received from the publish API endpoint.</td>\n</tr>\n<tr>\n<td>fanout_req_body_bytes</td>\n<td>integer</td>\n<td>Total body or message content bytes received from end users over Fanout connections.</td>\n</tr>\n<tr>\n<td>fanout_req_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received from end users over Fanout connections.</td>\n</tr>\n<tr>\n<td>fanout_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body or message content bytes sent to end users over Fanout connections, excluding published message content.</td>\n</tr>\n<tr>\n<td>fanout_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes sent to end users over Fanout connections.</td>\n</tr>\n<tr>\n<td>fanout_send_publishes</td>\n<td>integer</td>\n<td>Total published messages sent to end users.</td>\n</tr>\n<tr>\n<td>fetch_sub_count</td>\n<td>integer</td>\n<td>Number of executions of the vcl_fetch Varnish subroutine.</td>\n</tr>\n<tr>\n<td>fetch_sub_time</td>\n<td>number</td>\n<td>Time spent inside the vcl_fetch Varnish subroutine (in seconds).</td>\n</tr>\n<tr>\n<td>hash_sub_count</td>\n<td>integer</td>\n<td>Number of executions of the vcl_hash Varnish subroutine.</td>\n</tr>\n<tr>\n<td>hash_sub_time</td>\n<td>number</td>\n<td>Time spent inside the vcl_hash Varnish subroutine (in seconds).</td>\n</tr>\n<tr>\n<td>header_size</td>\n<td>integer</td>\n<td>Total header bytes delivered (alias for resp_header_bytes).</td>\n</tr>\n<tr>\n<td>hit_ratio</td>\n<td>number</td>\n<td>Ratio of cache hits to cache misses (between 0 and 1).</td>\n</tr>\n<tr>\n<td>hit_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes delivered for cache hits.</td>\n</tr>\n<tr>\n<td>hit_sub_count</td>\n<td>integer</td>\n<td>Number of executions of the vcl_hit Varnish subroutine.</td>\n</tr>\n<tr>\n<td>hit_sub_time</td>\n<td>number</td>\n<td>Time spent inside the vcl_hit Varnish subroutine (in seconds).</td>\n</tr>\n<tr>\n<td>hits</td>\n<td>integer</td>\n<td>Number of cache hits.</td>\n</tr>\n<tr>\n<td>hits_time</td>\n<td>number</td>\n<td>Total amount of time spent processing cache hits (in seconds).</td>\n</tr>\n<tr>\n<td>http2</td>\n<td>integer</td>\n<td>Number of requests received over HTTP/2.</td>\n</tr>\n<tr>\n<td>http3</td>\n<td>integer</td>\n<td>Number of requests received over HTTP/3.</td>\n</tr>\n<tr>\n<td>imgopto</td>\n<td>integer</td>\n<td>Number of responses that came from the Fastly Image Optimizer service. If the service receives 10 requests for an image, this stat will be 10 regardless of how many times the image was transformed.</td>\n</tr>\n<tr>\n<td>imgopto_avif_count</td>\n<td>integer</td>\n<td>Count of AVIF images delivered to end user by Image Optimizer.</td>\n</tr>\n<tr>\n<td>imgopto_compute_requests</td>\n<td>integer</td>\n<td>The number of Image Optimizer requests made from Compute services.</td>\n</tr>\n<tr>\n<td>imgopto_gif_count</td>\n<td>integer</td>\n<td>Count of GIF images delivered to end user by Image Optimizer.</td>\n</tr>\n<tr>\n<td>imgopto_jpeg_count</td>\n<td>integer</td>\n<td>Count of JPEG images delivered to end user by Image Optimizer.</td>\n</tr>\n<tr>\n<td>imgopto_jpegxl_count</td>\n<td>integer</td>\n<td>Count of JPEGXL images delivered to end user by Image Optimizer.</td>\n</tr>\n<tr>\n<td>imgopto_mp4_count</td>\n<td>integer</td>\n<td>Count of MP4s delivered to end user by Image Optimizer.</td>\n</tr>\n<tr>\n<td>imgopto_png_count</td>\n<td>integer</td>\n<td>Count of PNG images delivered to end user by Image Optimizer.</td>\n</tr>\n<tr>\n<td>imgopto_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes delivered from the Fastly Image Optimizer service, including shield traffic.</td>\n</tr>\n<tr>\n<td>imgopto_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes delivered from the Fastly Image Optimizer service, including shield traffic.</td>\n</tr>\n<tr>\n<td>imgopto_shield</td>\n<td>integer</td>\n<td>Number of responses that came from the Fastly Image Optimizer service via a shield.</td>\n</tr>\n<tr>\n<td>imgopto_shield_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes delivered via a shield from the Fastly Image Optimizer service.</td>\n</tr>\n<tr>\n<td>imgopto_shield_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes delivered via a shield from the Fastly Image Optimizer service.</td>\n</tr>\n<tr>\n<td>imgopto_svg_count</td>\n<td>integer</td>\n<td>Count of SVG images delivered to end user by Image Optimizer.</td>\n</tr>\n<tr>\n<td>imgopto_transforms</td>\n<td>integer</td>\n<td>Number of transforms performed by the Fastly Image Optimizer service.</td>\n</tr>\n<tr>\n<td>imgopto_webp_count</td>\n<td>integer</td>\n<td>Count of WebP images delivered to end user by Image Optimizer.</td>\n</tr>\n<tr>\n<td>imgvideo</td>\n<td>integer</td>\n<td>Number of video responses that came from the Fastly Image Optimizer service.</td>\n</tr>\n<tr>\n<td>imgvideo_frames</td>\n<td>integer</td>\n<td>Number of video frames that came from the Fastly Image Optimizer service. A video frame is an individual image within a sequence of video.</td>\n</tr>\n<tr>\n<td>imgvideo_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes of video delivered from the Fastly Image Optimizer service.</td>\n</tr>\n<tr>\n<td>imgvideo_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes of video delivered from the Fastly Image Optimizer service.</td>\n</tr>\n<tr>\n<td>imgvideo_shield</td>\n<td>integer</td>\n<td>Number of video responses delivered via a shield that came from the Fastly Image Optimizer service.</td>\n</tr>\n<tr>\n<td>imgvideo_shield_frames</td>\n<td>integer</td>\n<td>Number of video frames delivered via a shield that came from the Fastly Image Optimizer service. A video frame is an individual image within a sequence of video.</td>\n</tr>\n<tr>\n<td>imgvideo_shield_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes of video delivered via a shield from the Fastly Image Optimizer service.</td>\n</tr>\n<tr>\n<td>imgvideo_shield_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes of video delivered via a shield from the Fastly Image Optimizer service.</td>\n</tr>\n<tr>\n<td>ipv6</td>\n<td>integer</td>\n<td>Number of requests that were received over IPv6.</td>\n</tr>\n<tr>\n<td>kv_store_class_a_operations</td>\n<td>integer</td>\n<td>The total number of class a operations for the KV store.</td>\n</tr>\n<tr>\n<td>kv_store_class_b_operations</td>\n<td>integer</td>\n<td>The total number of class b operations for the KV store.</td>\n</tr>\n<tr>\n<td>log</td>\n<td>integer</td>\n<td>Number of log lines sent.</td>\n</tr>\n<tr>\n<td>log_bytes</td>\n<td>integer</td>\n<td>Total log bytes sent.</td>\n</tr>\n<tr>\n<td>miss</td>\n<td>integer</td>\n<td>Number of cache misses.</td>\n</tr>\n<tr>\n<td>miss_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes delivered for cache misses.</td>\n</tr>\n<tr>\n<td>miss_sub_count</td>\n<td>integer</td>\n<td>Number of executions of the vcl_miss Varnish subroutine.</td>\n</tr>\n<tr>\n<td>miss_sub_time</td>\n<td>number</td>\n<td>Time spent inside the vcl_miss Varnish subroutine (in seconds).</td>\n</tr>\n<tr>\n<td>miss_time</td>\n<td>number</td>\n<td>Total amount of time spent processing cache misses (in seconds).</td>\n</tr>\n<tr>\n<td>ngwaf_bot_analysis_request_count</td>\n<td>integer</td>\n<td>Count of Next-Gen WAF Bot Management requests.</td>\n</tr>\n<tr>\n<td>ngwaf_requests_allowed_count</td>\n<td>integer</td>\n<td>Count of Next-Gen WAF (Edge WAF &amp; Core WAF) requests allowed.</td>\n</tr>\n<tr>\n<td>ngwaf_requests_blocked_count</td>\n<td>integer</td>\n<td>Count of Next-Gen WAF (Edge WAF &amp; Core WAF) requests blocked.</td>\n</tr>\n<tr>\n<td>ngwaf_requests_challenged_count</td>\n<td>integer</td>\n<td>Count of Edge WAF requests challenged.</td>\n</tr>\n<tr>\n<td>ngwaf_requests_logged_count</td>\n<td>integer</td>\n<td>Count of Edge WAF requests logged.</td>\n</tr>\n<tr>\n<td>ngwaf_requests_timeout_count</td>\n<td>integer</td>\n<td>Count of Edge WAF requests timed outcome.</td>\n</tr>\n<tr>\n<td>ngwaf_requests_total_count</td>\n<td>integer</td>\n<td>Total number of Next-Gen WAF (Edge WAF &amp; Core WAF) requests.</td>\n</tr>\n<tr>\n<td>ngwaf_requests_unknown_count</td>\n<td>integer</td>\n<td>Count of Edge WAF requests with an unknown outcome.</td>\n</tr>\n<tr>\n<td>object_size_100k</td>\n<td>integer</td>\n<td>Number of objects served that were between 10KB and 100KB in size.</td>\n</tr>\n<tr>\n<td>object_size_100m</td>\n<td>integer</td>\n<td>Number of objects served that were between 10MB and 100MB in size.</td>\n</tr>\n<tr>\n<td>object_size_10k</td>\n<td>integer</td>\n<td>Number of objects served that were between 1KB and 10KB in size.</td>\n</tr>\n<tr>\n<td>object_size_10m</td>\n<td>integer</td>\n<td>Number of objects served that were between 1MB and 10MB in size.</td>\n</tr>\n<tr>\n<td>object_size_1g</td>\n<td>integer</td>\n<td>Number of objects served that were between 100MB and 1GB in size.</td>\n</tr>\n<tr>\n<td>object_size_1k</td>\n<td>integer</td>\n<td>Number of objects served that were under 1KB in size.</td>\n</tr>\n<tr>\n<td>object_size_1m</td>\n<td>integer</td>\n<td>Number of objects served that were between 100KB and 1MB in size.</td>\n</tr>\n<tr>\n<td>object_storage_class_a_operations_count</td>\n<td>integer</td>\n<td>A count of the number of Class A Object Storage operations.</td>\n</tr>\n<tr>\n<td>object_storage_class_b_operations_count</td>\n<td>integer</td>\n<td>A count of the number of Class B Object Storage operations.</td>\n</tr>\n<tr>\n<td>object_store_class_a_operations</td>\n<td>integer</td>\n<td>Use kv_store_class_a_operations.</td>\n</tr>\n<tr>\n<td>object_store_class_b_operations</td>\n<td>integer</td>\n<td>Use kv_store_class_b_operations.</td>\n</tr>\n<tr>\n<td>origin_cache_fetch_resp_body_bytes</td>\n<td>integer</td>\n<td>Body bytes received from origin for cacheable content.</td>\n</tr>\n<tr>\n<td>origin_cache_fetch_resp_header_bytes</td>\n<td>integer</td>\n<td>Header bytes received from an origin for cacheable content.</td>\n</tr>\n<tr>\n<td>origin_cache_fetches</td>\n<td>integer</td>\n<td>The total number of completed requests made to backends (origins) that returned cacheable content.</td>\n</tr>\n<tr>\n<td>origin_fetch_body_bytes</td>\n<td>integer</td>\n<td>Total request body bytes sent to origin.</td>\n</tr>\n<tr>\n<td>origin_fetch_header_bytes</td>\n<td>integer</td>\n<td>Total request header bytes sent to origin.</td>\n</tr>\n<tr>\n<td>origin_fetch_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes received from origin.</td>\n</tr>\n<tr>\n<td>origin_fetch_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received from origin.</td>\n</tr>\n<tr>\n<td>origin_fetches</td>\n<td>integer</td>\n<td>Number of requests sent to origin.</td>\n</tr>\n<tr>\n<td>origin_offload</td>\n<td>number</td>\n<td>Origin Offload measures the ratio of bytes served to end users that were cached by Fastly, over the bytes served to end users, between 0 and 1. ((edge_resp_body_bytes + edge_resp_header_bytes) - (origin_fetch_resp_body_bytes + origin_fetch_resp_header_bytes)) / (edge_resp_body_bytes + edge_resp_header_bytes).</td>\n</tr>\n<tr>\n<td>origin_revalidations</td>\n<td>integer</td>\n<td>Number of responses received from origin with a 304 status code in response to an If-Modified-Since or If-None-Match request. Under regular scenarios, a revalidation will imply a cache hit. However, if using Fastly Image Optimizer or segmented caching this may result in a cache miss.</td>\n</tr>\n<tr>\n<td>otfp</td>\n<td>integer</td>\n<td>Number of responses that came from the Fastly On-the-Fly Packaging service for video-on-demand.</td>\n</tr>\n<tr>\n<td>otfp_deliver_time</td>\n<td>number</td>\n<td>Total amount of time spent delivering a response from the Fastly On-the-Fly Packaging service for video-on-demand (in seconds).</td>\n</tr>\n<tr>\n<td>otfp_manifests</td>\n<td>integer</td>\n<td>Number of responses that were manifest files from the Fastly On-the-Fly Packaging service for video-on-demand.</td>\n</tr>\n<tr>\n<td>otfp_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes delivered from the Fastly On-the-Fly Packaging service for video-on-demand.</td>\n</tr>\n<tr>\n<td>otfp_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes delivered from the Fastly On-the-Fly Packaging service for video-on-demand.</td>\n</tr>\n<tr>\n<td>otfp_shield_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes delivered via a shield for the Fastly On-the-Fly Packaging service for video-on-demand.</td>\n</tr>\n<tr>\n<td>otfp_shield_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes delivered via a shield for the Fastly On-the-Fly Packaging service for video-on-demand.</td>\n</tr>\n<tr>\n<td>otfp_shield_time</td>\n<td>number</td>\n<td>Total amount of time spent delivering a response via a shield from the Fastly On-the-Fly Packaging service for video-on-demand (in seconds).</td>\n</tr>\n<tr>\n<td>pass</td>\n<td>integer</td>\n<td>Number of requests that passed through the CDN without being cached.</td>\n</tr>\n<tr>\n<td>pass_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes delivered for cache passes.</td>\n</tr>\n<tr>\n<td>pass_sub_count</td>\n<td>integer</td>\n<td>Number of executions of the vcl_pass Varnish subroutine.</td>\n</tr>\n<tr>\n<td>pass_sub_time</td>\n<td>number</td>\n<td>Time spent inside the vcl_pass Varnish subroutine (in seconds).</td>\n</tr>\n<tr>\n<td>pass_time</td>\n<td>number</td>\n<td>Total amount of time spent processing cache passes (in seconds).</td>\n</tr>\n<tr>\n<td>pci</td>\n<td>integer</td>\n<td>Number of responses with the PCI flag turned on.</td>\n</tr>\n<tr>\n<td>pipe</td>\n<td>integer</td>\n<td>Optional. Pipe operations performed (legacy feature).</td>\n</tr>\n<tr>\n<td>pipe_sub_count</td>\n<td>integer</td>\n<td>Number of executions of the vcl_pipe Varnish subroutine.</td>\n</tr>\n<tr>\n<td>pipe_sub_time</td>\n<td>number</td>\n<td>Time spent inside the vcl_pipe Varnish subroutine (in seconds).</td>\n</tr>\n<tr>\n<td>predeliver_sub_count</td>\n<td>integer</td>\n<td>Number of executions of the vcl_predeliver Varnish subroutine.</td>\n</tr>\n<tr>\n<td>predeliver_sub_time</td>\n<td>number</td>\n<td>Time spent inside the vcl_predeliver Varnish subroutine (in seconds).</td>\n</tr>\n<tr>\n<td>prehash_sub_count</td>\n<td>integer</td>\n<td>Number of executions of the vcl_prehash Varnish subroutine.</td>\n</tr>\n<tr>\n<td>prehash_sub_time</td>\n<td>number</td>\n<td>Time spent inside the vcl_prehash Varnish subroutine (in seconds).</td>\n</tr>\n<tr>\n<td>recv_sub_count</td>\n<td>integer</td>\n<td>Number of executions of the vcl_recv Varnish subroutine.</td>\n</tr>\n<tr>\n<td>recv_sub_time</td>\n<td>number</td>\n<td>Time spent inside the vcl_recv Varnish subroutine (in seconds).</td>\n</tr>\n<tr>\n<td>req_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes received.</td>\n</tr>\n<tr>\n<td>req_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received.</td>\n</tr>\n<tr>\n<td>request_collapse_unusable_count</td>\n<td>integer</td>\n<td>Number of requests that were collapsed and unable to be satisfied by the resulting cache object.</td>\n</tr>\n<tr>\n<td>request_collapse_usable_count</td>\n<td>integer</td>\n<td>Number of requests that were collapsed and satisfied by a usable cache object.</td>\n</tr>\n<tr>\n<td>request_denied_get_head_body</td>\n<td>integer</td>\n<td>Number of requests where Fastly responded with 400 due to the request being a GET or HEAD request containing a body.</td>\n</tr>\n<tr>\n<td>requests</td>\n<td>integer</td>\n<td>Number of requests processed.</td>\n</tr>\n<tr>\n<td>resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes delivered (edge_resp_body_bytes + shield_resp_body_bytes).</td>\n</tr>\n<tr>\n<td>resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes delivered (edge_resp_header_bytes + shield_resp_header_bytes).</td>\n</tr>\n<tr>\n<td>restarts</td>\n<td>integer</td>\n<td>Number of restarts performed.</td>\n</tr>\n<tr>\n<td>segblock_origin_fetches</td>\n<td>integer</td>\n<td>Number of Range requests to origin for segments of resources when using segmented caching.</td>\n</tr>\n<tr>\n<td>segblock_shield_fetches</td>\n<td>integer</td>\n<td>Number of Range requests to a shield for segments of resources when using segmented caching.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>shield</td>\n<td>integer</td>\n<td>Number of requests from edge to the shield POP.</td>\n</tr>\n<tr>\n<td>shield_cache_fetches</td>\n<td>integer</td>\n<td>The total number of completed requests made to shields that returned cacheable content.</td>\n</tr>\n<tr>\n<td>shield_fetch_body_bytes</td>\n<td>integer</td>\n<td>Total request body bytes sent to a shield.</td>\n</tr>\n<tr>\n<td>shield_fetch_header_bytes</td>\n<td>integer</td>\n<td>Total request header bytes sent to a shield.</td>\n</tr>\n<tr>\n<td>shield_fetch_resp_body_bytes</td>\n<td>integer</td>\n<td>Total response body bytes sent from a shield to the edge.</td>\n</tr>\n<tr>\n<td>shield_fetch_resp_header_bytes</td>\n<td>integer</td>\n<td>Total response header bytes sent from a shield to the edge.</td>\n</tr>\n<tr>\n<td>shield_fetches</td>\n<td>integer</td>\n<td>Number of requests made from one Fastly POP to another, as part of shielding.</td>\n</tr>\n<tr>\n<td>shield_hit_requests</td>\n<td>integer</td>\n<td>Number of requests that resulted in a hit at a shield.</td>\n</tr>\n<tr>\n<td>shield_hit_resp_body_bytes</td>\n<td>integer</td>\n<td>Body bytes delivered for shield hits.</td>\n</tr>\n<tr>\n<td>shield_hit_resp_header_bytes</td>\n<td>integer</td>\n<td>Header bytes delivered for shield hits.</td>\n</tr>\n<tr>\n<td>shield_miss_requests</td>\n<td>integer</td>\n<td>Number of requests that resulted in a miss at a shield.</td>\n</tr>\n<tr>\n<td>shield_miss_resp_body_bytes</td>\n<td>integer</td>\n<td>Body bytes delivered for shield misses.</td>\n</tr>\n<tr>\n<td>shield_miss_resp_header_bytes</td>\n<td>integer</td>\n<td>Header bytes delivered for shield misses.</td>\n</tr>\n<tr>\n<td>shield_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes delivered via a shield.</td>\n</tr>\n<tr>\n<td>shield_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes delivered via a shield.</td>\n</tr>\n<tr>\n<td>shield_revalidations</td>\n<td>integer</td>\n<td>Number of responses received from origin with a 304 status code, in response to an If-Modified-Since or If-None-Match request to a shield. Under regular scenarios, a revalidation will imply a cache hit. However, if using segmented caching this may result in a cache miss.</td>\n</tr>\n<tr>\n<td>start_time</td>\n<td>integer</td>\n<td>Timestamp for the start of the time period being reported.</td>\n</tr>\n<tr>\n<td>status_1xx</td>\n<td>integer</td>\n<td>Number of \"Informational\" category status codes delivered.</td>\n</tr>\n<tr>\n<td>status_200</td>\n<td>integer</td>\n<td>Number of responses sent with status code 200 (Success).</td>\n</tr>\n<tr>\n<td>status_204</td>\n<td>integer</td>\n<td>Number of responses sent with status code 204 (No Content).</td>\n</tr>\n<tr>\n<td>status_206</td>\n<td>integer</td>\n<td>Number of responses sent with status code 206 (Partial Content).</td>\n</tr>\n<tr>\n<td>status_2xx</td>\n<td>integer</td>\n<td>Number of \"Success\" status codes delivered.</td>\n</tr>\n<tr>\n<td>status_301</td>\n<td>integer</td>\n<td>Number of responses sent with status code 301 (Moved Permanently).</td>\n</tr>\n<tr>\n<td>status_302</td>\n<td>integer</td>\n<td>Number of responses sent with status code 302 (Found).</td>\n</tr>\n<tr>\n<td>status_304</td>\n<td>integer</td>\n<td>Number of responses sent with status code 304 (Not Modified).</td>\n</tr>\n<tr>\n<td>status_3xx</td>\n<td>integer</td>\n<td>Number of \"Redirection\" codes delivered.</td>\n</tr>\n<tr>\n<td>status_400</td>\n<td>integer</td>\n<td>Number of responses sent with status code 400 (Bad Request).</td>\n</tr>\n<tr>\n<td>status_401</td>\n<td>integer</td>\n<td>Number of responses sent with status code 401 (Unauthorized).</td>\n</tr>\n<tr>\n<td>status_403</td>\n<td>integer</td>\n<td>Number of responses sent with status code 403 (Forbidden).</td>\n</tr>\n<tr>\n<td>status_404</td>\n<td>integer</td>\n<td>Number of responses sent with status code 404 (Not Found).</td>\n</tr>\n<tr>\n<td>status_406</td>\n<td>integer</td>\n<td>Number of responses sent with status code 406 (Not Acceptable).</td>\n</tr>\n<tr>\n<td>status_416</td>\n<td>integer</td>\n<td>Number of responses sent with status code 416 (Range Not Satisfiable).</td>\n</tr>\n<tr>\n<td>status_429</td>\n<td>integer</td>\n<td>Number of responses sent with status code 429 (Too Many Requests).</td>\n</tr>\n<tr>\n<td>status_4xx</td>\n<td>integer</td>\n<td>Number of \"Client Error\" codes delivered.</td>\n</tr>\n<tr>\n<td>status_500</td>\n<td>integer</td>\n<td>Number of responses sent with status code 500 (Internal Server Error).</td>\n</tr>\n<tr>\n<td>status_501</td>\n<td>integer</td>\n<td>Number of responses sent with status code 501 (Not Implemented).</td>\n</tr>\n<tr>\n<td>status_502</td>\n<td>integer</td>\n<td>Number of responses sent with status code 502 (Bad Gateway).</td>\n</tr>\n<tr>\n<td>status_503</td>\n<td>integer</td>\n<td>Number of responses sent with status code 503 (Service Unavailable).</td>\n</tr>\n<tr>\n<td>status_504</td>\n<td>integer</td>\n<td>Number of responses sent with status code 504 (Gateway Timeout).</td>\n</tr>\n<tr>\n<td>status_505</td>\n<td>integer</td>\n<td>Number of responses sent with status code 505 (HTTP Version Not Supported).</td>\n</tr>\n<tr>\n<td>status_530</td>\n<td>integer</td>\n<td>Number of responses sent with status code 530.</td>\n</tr>\n<tr>\n<td>status_5xx</td>\n<td>integer</td>\n<td>Number of \"Server Error\" codes delivered.</td>\n</tr>\n<tr>\n<td>synth</td>\n<td>integer</td>\n<td>Number of requests that returned a synthetic response (i.e., response objects created with the synthetic VCL statement).</td>\n</tr>\n<tr>\n<td>tls</td>\n<td>integer</td>\n<td>Number of requests that were received over TLS.</td>\n</tr>\n<tr>\n<td>tls_handshake_sent_bytes</td>\n<td>integer</td>\n<td>Number of bytes transferred during TLS handshake.</td>\n</tr>\n<tr>\n<td>tls_v10</td>\n<td>integer</td>\n<td>Number of requests received over TLS 1.0.</td>\n</tr>\n<tr>\n<td>tls_v11</td>\n<td>integer</td>\n<td>Number of requests received over TLS 1.1.</td>\n</tr>\n<tr>\n<td>tls_v12</td>\n<td>integer</td>\n<td>Number of requests received over TLS 1.2.</td>\n</tr>\n<tr>\n<td>tls_v13</td>\n<td>integer</td>\n<td>Number of requests received over TLS 1.3.</td>\n</tr>\n<tr>\n<td>uncacheable</td>\n<td>integer</td>\n<td>Number of requests that were designated uncachable.</td>\n</tr>\n<tr>\n<td>upgrade</td>\n<td>integer</td>\n<td>Number of requests that resulted in a WebSocket upgrade.</td>\n</tr>\n<tr>\n<td>video</td>\n<td>integer</td>\n<td>Number of responses with the video segment or video manifest MIME type (i.e., application/x-mpegurl, application/vnd.apple.mpegurl, application/f4m, application/dash+xml, application/vnd.ms-sstr+xml, ideo/mp2t, audio/aac, video/f4f, video/x-flv, video/mp4, audio/mp4).</td>\n</tr>\n<tr>\n<td>websocket_bereq_body_bytes</td>\n<td>integer</td>\n<td>Total message content bytes sent to backends over passthrough WebSocket connections.</td>\n</tr>\n<tr>\n<td>websocket_bereq_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes sent to backends over passthrough WebSocket connections.</td>\n</tr>\n<tr>\n<td>websocket_beresp_body_bytes</td>\n<td>integer</td>\n<td>Total message content bytes received from backends over passthrough WebSocket connections.</td>\n</tr>\n<tr>\n<td>websocket_beresp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received from backends over passthrough WebSocket connections.</td>\n</tr>\n<tr>\n<td>websocket_conn_time_ms</td>\n<td>integer</td>\n<td>Total duration of passthrough WebSocket connections with end users.</td>\n</tr>\n<tr>\n<td>websocket_req_body_bytes</td>\n<td>integer</td>\n<td>Total message content bytes received from end users over passthrough WebSocket connections.</td>\n</tr>\n<tr>\n<td>websocket_req_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received from end users over passthrough WebSocket connections.</td>\n</tr>\n<tr>\n<td>websocket_resp_body_bytes</td>\n<td>integer</td>\n<td>Total message content bytes sent to end users over passthrough WebSocket connections.</td>\n</tr>\n<tr>\n<td>websocket_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes sent to end users over passthrough WebSocket connections.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"a776fc5a-fb47-41f9-9939-ee2ef772003b"},{"name":"Real-time analytics","item":[{"name":"Get real-time data from specified time","id":"ca52e868-4f53-4f93-aa15-225000b2c9f5","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"rt.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/v1/channel/{{service_id}}/ts/{{timestamp_in_seconds}}","description":"<p>Get real-time data for the specified reporting period. Specify 0 to get a single entry for the last complete second. The Timestamp field included in the response provides the time index of the latest entry in the dataset and can be provided as the start_timestamp of the next request for a seamless continuation of the dataset from one request to the next.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["v1","channel","{{service_id}}","ts","{{timestamp_in_seconds}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"6b9a0a27-5b56-4837-b09a-5044f7530588","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"rt.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/v1/channel/SU1Z0isxPaozGVKXdv0eY/ts/1608560817","description":"Get real-time data for the specified reporting period. Specify 0 to get a single entry for the last complete second. The Timestamp field included in the response provides the time index of the latest entry in the dataset and can be provided as the start_timestamp of the next request for a seamless continuation of the dataset from one request to the next.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"Data\":[{\"datacenter\":{\"LCY\":{\"requests\":0,\"resp_header_bytes\":0,\"header_size\":0,\"resp_body_bytes\":0,\"body_size\":0,\"hits\":0,\"miss\":0,\"pass\":0,\"synth\":0,\"errors\":0,\"hits_time\":0,\"miss_time\":0,\"miss_histogram\":{},\"compute_requests\":1}},\"aggregated\":{\"requests\":0,\"resp_header_bytes\":0,\"header_size\":0,\"resp_body_bytes\":0,\"body_size\":0,\"hits\":0,\"miss\":0,\"pass\":0,\"synth\":0,\"errors\":0,\"hits_time\":0,\"miss_time\":0,\"miss_histogram\":{},\"compute_requests\":1},\"recorded\":1608560817},{\"datacenter\":{\"STP\":{\"requests\":0,\"logging\":2,\"log\":2,\"resp_header_bytes\":0,\"header_size\":0,\"resp_body_bytes\":0,\"body_size\":0,\"hits\":0,\"miss\":0,\"pass\":0,\"synth\":0,\"errors\":0,\"hits_time\":0,\"miss_time\":0,\"miss_histogram\":{},\"compute_requests\":1,\"compute_execution_time_ms\":725,\"compute_ram_used\":24379392,\"compute_request_time_ms\":732,\"compute_request_time_billed_ms\":750}},\"aggregated\":{\"requests\":0,\"logging\":2,\"log\":2,\"resp_header_bytes\":0,\"header_size\":0,\"resp_body_bytes\":0,\"body_size\":0,\"hits\":0,\"miss\":0,\"pass\":0,\"synth\":0,\"errors\":0,\"hits_time\":0,\"miss_time\":0,\"miss_histogram\":{},\"compute_requests\":1,\"compute_execution_time_ms\":725,\"compute_ram_used\":24379392,\"compute_request_time_ms\":732,\"compute_request_time_billed_ms\":750},\"recorded\":1608560818}],\"Timestamp\":1608560827,\"AggregateDelay\":9}"}],"_postman_id":"ca52e868-4f53-4f93-aa15-225000b2c9f5"},{"name":"Get real-time data for the last 120 seconds","id":"6f93e36d-d16f-452f-aa3c-4a9b30cf9ed1","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"rt.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/v1/channel/{{service_id}}/ts/h","description":"<p>Get data for the 120 seconds preceding the latest timestamp available for a service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["v1","channel","{{service_id}}","ts","h"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"f2e76aaa-fba9-44c5-86b1-d5b5d4752c17","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"rt.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/v1/channel/SU1Z0isxPaozGVKXdv0eY/ts/h","description":"Get data for the 120 seconds preceding the latest timestamp available for a service.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"Data\":[{\"datacenter\":{\"LCY\":{\"requests\":0,\"resp_header_bytes\":0,\"header_size\":0,\"resp_body_bytes\":0,\"body_size\":0,\"hits\":0,\"miss\":0,\"pass\":0,\"synth\":0,\"errors\":0,\"hits_time\":0,\"miss_time\":0,\"miss_histogram\":{},\"compute_requests\":1}},\"aggregated\":{\"requests\":0,\"resp_header_bytes\":0,\"header_size\":0,\"resp_body_bytes\":0,\"body_size\":0,\"hits\":0,\"miss\":0,\"pass\":0,\"synth\":0,\"errors\":0,\"hits_time\":0,\"miss_time\":0,\"miss_histogram\":{},\"compute_requests\":1},\"recorded\":1608560817},{\"datacenter\":{\"STP\":{\"requests\":0,\"logging\":2,\"log\":2,\"resp_header_bytes\":0,\"header_size\":0,\"resp_body_bytes\":0,\"body_size\":0,\"hits\":0,\"miss\":0,\"pass\":0,\"synth\":0,\"errors\":0,\"hits_time\":0,\"miss_time\":0,\"miss_histogram\":{},\"compute_requests\":1,\"compute_execution_time_ms\":725,\"compute_ram_used\":24379392,\"compute_request_time_ms\":732,\"compute_request_time_billed_ms\":750}},\"aggregated\":{\"requests\":0,\"logging\":2,\"log\":2,\"resp_header_bytes\":0,\"header_size\":0,\"resp_body_bytes\":0,\"body_size\":0,\"hits\":0,\"miss\":0,\"pass\":0,\"synth\":0,\"errors\":0,\"hits_time\":0,\"miss_time\":0,\"miss_histogram\":{},\"compute_requests\":1,\"compute_execution_time_ms\":725,\"compute_ram_used\":24379392,\"compute_request_time_ms\":732,\"compute_request_time_billed_ms\":750},\"recorded\":1608560818}],\"Timestamp\":1608560827,\"AggregateDelay\":9}"}],"_postman_id":"6f93e36d-d16f-452f-aa3c-4a9b30cf9ed1"},{"name":"Get a limited number of real-time data entries","id":"7a79862a-cde3-4db0-9853-0e0ba107dc95","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"rt.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/v1/channel/{{service_id}}/ts/h/limit/{{max_entries}}","description":"<p>Get data for the 120 seconds preceding the latest timestamp available for a service, up to a maximum of max_entries entries.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["v1","channel","{{service_id}}","ts","h","limit","{{max_entries}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"42ac9507-0086-46fd-abe7-b03b19bcb807","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"rt.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/v1/channel/SU1Z0isxPaozGVKXdv0eY/ts/h/limit/1","description":"Get data for the 120 seconds preceding the latest timestamp available for a service, up to a maximum of max_entries entries.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"Data\":[{\"datacenter\":{\"LCY\":{\"requests\":0,\"resp_header_bytes\":0,\"header_size\":0,\"resp_body_bytes\":0,\"body_size\":0,\"hits\":0,\"miss\":0,\"pass\":0,\"synth\":0,\"errors\":0,\"hits_time\":0,\"miss_time\":0,\"miss_histogram\":{},\"compute_requests\":1}},\"aggregated\":{\"requests\":0,\"resp_header_bytes\":0,\"header_size\":0,\"resp_body_bytes\":0,\"body_size\":0,\"hits\":0,\"miss\":0,\"pass\":0,\"synth\":0,\"errors\":0,\"hits_time\":0,\"miss_time\":0,\"miss_histogram\":{},\"compute_requests\":1},\"recorded\":1608560817},{\"datacenter\":{\"STP\":{\"requests\":0,\"logging\":2,\"log\":2,\"resp_header_bytes\":0,\"header_size\":0,\"resp_body_bytes\":0,\"body_size\":0,\"hits\":0,\"miss\":0,\"pass\":0,\"synth\":0,\"errors\":0,\"hits_time\":0,\"miss_time\":0,\"miss_histogram\":{},\"compute_requests\":1,\"compute_execution_time_ms\":725,\"compute_ram_used\":24379392,\"compute_request_time_ms\":732,\"compute_request_time_billed_ms\":750}},\"aggregated\":{\"requests\":0,\"logging\":2,\"log\":2,\"resp_header_bytes\":0,\"header_size\":0,\"resp_body_bytes\":0,\"body_size\":0,\"hits\":0,\"miss\":0,\"pass\":0,\"synth\":0,\"errors\":0,\"hits_time\":0,\"miss_time\":0,\"miss_histogram\":{},\"compute_requests\":1,\"compute_execution_time_ms\":725,\"compute_ram_used\":24379392,\"compute_request_time_ms\":732,\"compute_request_time_billed_ms\":750},\"recorded\":1608560818}],\"Timestamp\":1608560827,\"AggregateDelay\":9}"}],"_postman_id":"7a79862a-cde3-4db0-9853-0e0ba107dc95"}],"id":"ef5e8a50-0b87-46c4-9771-8e87bcea8a66","description":"<p>The real-time analytics API offers a standardized set of data about traffic received by a specified service in one-second time periods up to the last complete second.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>AggregateDelay</td>\n<td>integer</td>\n<td>How long the system will wait before aggregating messages for each second. The most recent data returned will have happened at the moment of the request, minus the aggregation delay.</td>\n</tr>\n<tr>\n<td>Data</td>\n<td>array</td>\n<td>A list of records, each representing one second of time.</td>\n</tr>\n<tr>\n<td>Timestamp</td>\n<td>integer</td>\n<td>Value to use for subsequent requests.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-1\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>aggregated</td>\n<td>object</td>\n<td>Aggregates measurements across all Fastly POPs.</td>\n</tr>\n<tr>\n<td>datacenter</td>\n<td>object</td>\n<td>Groups measurements by POP. See the POPs API for details of POP identifiers.</td>\n</tr>\n<tr>\n<td>recorded</td>\n<td>integer</td>\n<td>The Unix timestamp at which this record's data was generated.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-2\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>aia_estimated_time_saved_ms</td>\n<td>integer</td>\n<td>The estimated amount of time saved by responses served from the AI Accelerator semantic cache.</td>\n</tr>\n<tr>\n<td>aia_origin_usage_tokens</td>\n<td>integer</td>\n<td>The number of usage tokens reported by the request to the origin from AI Accelerator.</td>\n</tr>\n<tr>\n<td>aia_requests</td>\n<td>integer</td>\n<td>Number of requests received by AI Accelerator.</td>\n</tr>\n<tr>\n<td>aia_response_usage_tokens</td>\n<td>integer</td>\n<td>The usage tokens associated with the response returned from the AI Accelerator cache.</td>\n</tr>\n<tr>\n<td>aia_status_1xx</td>\n<td>integer</td>\n<td>Number of \"Informational\" category status codes received from AI provider.</td>\n</tr>\n<tr>\n<td>aia_status_2xx</td>\n<td>integer</td>\n<td>Number of \"Success\" status codes received from AI provider.</td>\n</tr>\n<tr>\n<td>aia_status_3xx</td>\n<td>integer</td>\n<td>Number of \"Redirection\" received from AI provider.</td>\n</tr>\n<tr>\n<td>aia_status_4xx</td>\n<td>integer</td>\n<td>Number of \"Client Error\" received from AI provider.</td>\n</tr>\n<tr>\n<td>aia_status_5xx</td>\n<td>integer</td>\n<td>Number of \"Server Error\" received from AI provider.</td>\n</tr>\n<tr>\n<td>all_edge_hit_requests</td>\n<td>integer</td>\n<td>Number of requests sent by end users to Fastly that resulted in a hit at the edge for a VCL service.</td>\n</tr>\n<tr>\n<td>all_edge_miss_requests</td>\n<td>integer</td>\n<td>Number of requests sent by end users to Fastly that resulted in a miss at the edge for a VCL service.</td>\n</tr>\n<tr>\n<td>all_error_requests</td>\n<td>integer</td>\n<td>Number of cache errors for a VCL service.</td>\n</tr>\n<tr>\n<td>all_hit_requests</td>\n<td>integer</td>\n<td>Number of cache hits for a VCL service.</td>\n</tr>\n<tr>\n<td>all_miss_requests</td>\n<td>integer</td>\n<td>Number of cache misses for a VCL service.</td>\n</tr>\n<tr>\n<td>all_pass_requests</td>\n<td>integer</td>\n<td>Number of requests that passed through the CDN without being cached for a VCL service.</td>\n</tr>\n<tr>\n<td>all_status_1xx</td>\n<td>integer</td>\n<td>Number of \"Informational\" category status codes delivered for all sources.</td>\n</tr>\n<tr>\n<td>all_status_2xx</td>\n<td>integer</td>\n<td>Number of \"Success\" status codes delivered for all sources.</td>\n</tr>\n<tr>\n<td>all_status_3xx</td>\n<td>integer</td>\n<td>Number of \"Redirection\" codes delivered for all sources.</td>\n</tr>\n<tr>\n<td>all_status_4xx</td>\n<td>integer</td>\n<td>Number of \"Client Error\" codes delivered for all sources.</td>\n</tr>\n<tr>\n<td>all_status_5xx</td>\n<td>integer</td>\n<td>Number of \"Server Error\" codes delivered for all sources.</td>\n</tr>\n<tr>\n<td>all_synth_requests</td>\n<td>integer</td>\n<td>Number of requests that returned a synthetic response (i.e., response objects created with the synthetic VCL statement) for a VCL service.</td>\n</tr>\n<tr>\n<td>api_discovery_requests_count</td>\n<td>integer</td>\n<td>Number of requests processed by the API Discovery engine.</td>\n</tr>\n<tr>\n<td>attack_blocked_req_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes received from requests that triggered a WAF rule that was blocked.</td>\n</tr>\n<tr>\n<td>attack_blocked_req_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received from requests that triggered a WAF rule that was blocked.</td>\n</tr>\n<tr>\n<td>attack_logged_req_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes received from requests that triggered a WAF rule that was logged.</td>\n</tr>\n<tr>\n<td>attack_logged_req_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received from requests that triggered a WAF rule that was logged.</td>\n</tr>\n<tr>\n<td>attack_passed_req_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes received from requests that triggered a WAF rule that was passed.</td>\n</tr>\n<tr>\n<td>attack_passed_req_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received from requests that triggered a WAF rule that was passed.</td>\n</tr>\n<tr>\n<td>attack_req_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes received from requests that triggered a WAF rule.</td>\n</tr>\n<tr>\n<td>attack_req_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received from requests that triggered a WAF rule.</td>\n</tr>\n<tr>\n<td>attack_resp_synth_bytes</td>\n<td>integer</td>\n<td>Total bytes delivered for requests that triggered a WAF rule and returned a synthetic response.</td>\n</tr>\n<tr>\n<td>bereq_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes sent to origin.</td>\n</tr>\n<tr>\n<td>bereq_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes sent to origin.</td>\n</tr>\n<tr>\n<td>body_size</td>\n<td>integer</td>\n<td>Total body bytes delivered (alias for resp_body_bytes).</td>\n</tr>\n<tr>\n<td>bot_challenge_complete_tokens_checked</td>\n<td>integer</td>\n<td>The number of challenge-complete tokens checked.</td>\n</tr>\n<tr>\n<td>bot_challenge_complete_tokens_disabled</td>\n<td>integer</td>\n<td>The number of challenge-complete tokens not checked because the feature was disabled.</td>\n</tr>\n<tr>\n<td>bot_challenge_complete_tokens_failed</td>\n<td>integer</td>\n<td>The number of challenge-complete tokens that failed validation.</td>\n</tr>\n<tr>\n<td>bot_challenge_complete_tokens_issued</td>\n<td>integer</td>\n<td>The number of challenge-complete tokens issued. For example, issuing a challenge-complete token after a series of CAPTCHA challenges ending in success.</td>\n</tr>\n<tr>\n<td>bot_challenge_complete_tokens_passed</td>\n<td>integer</td>\n<td>The number of challenge-complete tokens that passed validation.</td>\n</tr>\n<tr>\n<td>bot_challenge_starts</td>\n<td>integer</td>\n<td>The number of challenge-start tokens created.</td>\n</tr>\n<tr>\n<td>bot_challenges_failed</td>\n<td>integer</td>\n<td>The number of failed challenge solutions processed. For example, an incorrect CAPTCHA solution.</td>\n</tr>\n<tr>\n<td>bot_challenges_issued</td>\n<td>integer</td>\n<td>The number of challenges issued. For example, the issuance of a CAPTCHA challenge.</td>\n</tr>\n<tr>\n<td>bot_challenges_succeeded</td>\n<td>integer</td>\n<td>The number of successful challenge solutions processed. For example, a correct CAPTCHA solution.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_accessibility_count</td>\n<td>integer</td>\n<td>Count of edge requests where an accessibility bot was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_ai_crawler_count</td>\n<td>integer</td>\n<td>Count of edge requests where an AI crawler was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_ai_fetcher_count</td>\n<td>integer</td>\n<td>Count of edge requests where an AI fetcher was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_analyzed_count</td>\n<td>integer</td>\n<td>Count of edge requests where bot detection analysis was performed.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_content_fetcher_count</td>\n<td>integer</td>\n<td>Count of edge requests where a content fetcher was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_detected_count</td>\n<td>integer</td>\n<td>Count of edge requests where a bot was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_monitoring_count</td>\n<td>integer</td>\n<td>Count of edge requests where a monitoring and site tool was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_online_marketing_count</td>\n<td>integer</td>\n<td>Count of edge requests where an online marketing bot was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_page_preview_count</td>\n<td>integer</td>\n<td>Count of edge requests where a page preview bot was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_platform_integrations_count</td>\n<td>integer</td>\n<td>Count of edge requests where a platform integration was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_research_count</td>\n<td>integer</td>\n<td>Count of edge requests where a research bot was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_search_engine_crawler_count</td>\n<td>integer</td>\n<td>Count of edge requests where a search engine crawler was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_search_engine_optimization_count</td>\n<td>integer</td>\n<td>Count of edge requests where a search engine optimization bot was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_security_tools_count</td>\n<td>integer</td>\n<td>Count of edge requests where a security tool was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_verified_count</td>\n<td>integer</td>\n<td>Count of edge requests where a verified bot was detected.</td>\n</tr>\n<tr>\n<td>bot_requests_total_count</td>\n<td>integer</td>\n<td>Total number of Bot Management requests across all deployments.</td>\n</tr>\n<tr>\n<td>compute_bereq_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes sent to backends (origins) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_bereq_errors</td>\n<td>integer</td>\n<td>Number of backend request errors, including timeouts.</td>\n</tr>\n<tr>\n<td>compute_bereq_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes sent to backends (origins) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_bereqs</td>\n<td>integer</td>\n<td>Number of backend requests started.</td>\n</tr>\n<tr>\n<td>compute_beresp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes received from backends (origins) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_beresp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received from backends (origins) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_cache_operations_count</td>\n<td>integer</td>\n<td>Number of cache operations executed by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_execution_time_ms</td>\n<td>number</td>\n<td>The amount of active CPU time used to process your requests (in milliseconds).</td>\n</tr>\n<tr>\n<td>compute_globals_limit_exceeded</td>\n<td>integer</td>\n<td>Number of times a guest exceeded its globals limit.</td>\n</tr>\n<tr>\n<td>compute_guest_errors</td>\n<td>integer</td>\n<td>Number of times a service experienced a guest code error.</td>\n</tr>\n<tr>\n<td>compute_handoff</td>\n<td>integer</td>\n<td>The number of times Compute has handed off a request to the Fanout proxy or WebSocket proxy.</td>\n</tr>\n<tr>\n<td>compute_heap_limit_exceeded</td>\n<td>integer</td>\n<td>Number of times a guest exceeded its heap limit.</td>\n</tr>\n<tr>\n<td>compute_platform_internal_error</td>\n<td>integer</td>\n<td>Fatal errors caused by internal errors in Fastly’s Compute platform.</td>\n</tr>\n<tr>\n<td>compute_platform_invalid_request_error</td>\n<td>integer</td>\n<td>Fatal errors caused by unprocessable requests to the service, such as requests with malformed CDN-Loop headers or invalid purge credentials.</td>\n</tr>\n<tr>\n<td>compute_ram_used</td>\n<td>integer</td>\n<td>The amount of RAM used for your service by Fastly (in bytes).</td>\n</tr>\n<tr>\n<td>compute_req_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_req_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_request_time_billed_ms</td>\n<td>number</td>\n<td>The total amount of request processing time you will be billed for, measured in 50 millisecond increments.</td>\n</tr>\n<tr>\n<td>compute_request_time_ms</td>\n<td>number</td>\n<td>The total, actual amount of time used to process your requests, including active CPU time (in milliseconds).</td>\n</tr>\n<tr>\n<td>compute_requests</td>\n<td>integer</td>\n<td>The total number of requests that were received for your service by Fastly.</td>\n</tr>\n<tr>\n<td>compute_resource_limit_exceeded</td>\n<td>integer</td>\n<td>Number of times a guest exceeded its resource limit, includes heap, stack, globals, and code execution timeout.</td>\n</tr>\n<tr>\n<td>compute_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes sent from Compute to end user.</td>\n</tr>\n<tr>\n<td>compute_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes sent from Compute to end user.</td>\n</tr>\n<tr>\n<td>compute_resp_status_103</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 103 (Early Hints) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_1xx</td>\n<td>integer</td>\n<td>Number of \"Informational\" category status codes delivered by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_200</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 200 (Success) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_204</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 204 (No Content) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_206</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 206 (Partial Content) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_2xx</td>\n<td>integer</td>\n<td>Number of \"Success\" category status codes delivered by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_301</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 301 (Moved Permanently) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_302</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 302 (Found) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_304</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 304 (Not Modified) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_3xx</td>\n<td>integer</td>\n<td>Number of \"Redirection\" category status codes delivered by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_400</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 400 (Bad Request) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_401</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 401 (Unauthorized) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_403</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 403 (Forbidden) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_404</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 404 (Not Found) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_416</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 416 (Range Not Satisfiable) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_429</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 429 (Too Many Requests) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_4xx</td>\n<td>integer</td>\n<td>Number of \"Client Error\" category status codes delivered by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_500</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 500 (Internal Server Error) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_501</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 501 (Not Implemented) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_502</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 502 (Bad Gateway) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_503</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 503 (Service Unavailable) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_504</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 504 (Gateway Timeout) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_505</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 505 (HTTP Version Not Supported) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_530</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 530 by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_5xx</td>\n<td>integer</td>\n<td>Number of \"Server Error\" category status codes delivered by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_runtime_errors</td>\n<td>integer</td>\n<td>Number of times a service experienced a guest runtime error.</td>\n</tr>\n<tr>\n<td>compute_sandboxes</td>\n<td>integer</td>\n<td>Number of WebAssembly (Wasm) sandboxes created.</td>\n</tr>\n<tr>\n<td>compute_service_bereq_error</td>\n<td>integer</td>\n<td>Number of backend request errors, including timeouts.</td>\n</tr>\n<tr>\n<td>compute_service_chain_error</td>\n<td>integer</td>\n<td>Fatal errors caused by the service path exceeding hop or service limits, or where a forwarding loop is detected via CDN-Loop headers.</td>\n</tr>\n<tr>\n<td>compute_service_limits_error</td>\n<td>integer</td>\n<td>Non-fatal errors caused by attempts to exceed defined operational limits, such as simultaneous backend requests or cache transactions.</td>\n</tr>\n<tr>\n<td>compute_service_memory_exceeded_error</td>\n<td>integer</td>\n<td>Number of times a guest exceeded its heap limit.</td>\n</tr>\n<tr>\n<td>compute_service_resource_limits_error</td>\n<td>integer</td>\n<td>Aggregate of fatal errors caused by exceeding allocated resource limits, specifically runtime duration, vCPU usage, and heap memory limits.</td>\n</tr>\n<tr>\n<td>compute_service_runtime_error</td>\n<td>integer</td>\n<td>Fatal errors caused by service logic faults, including stack overflows, unreachable code traps, illegal memory access, or attempts to send multiple responses.</td>\n</tr>\n<tr>\n<td>compute_service_timeout_error</td>\n<td>integer</td>\n<td>Fatal errors caused by exceeding the per-request runtime limit.</td>\n</tr>\n<tr>\n<td>compute_service_vcpu_exceeded_error</td>\n<td>integer</td>\n<td>Fatal errors caused by exceeding the per-request vCPU time limit.</td>\n</tr>\n<tr>\n<td>compute_stack_limit_exceeded</td>\n<td>integer</td>\n<td>Number of times a guest exceeded its stack limit.</td>\n</tr>\n<tr>\n<td>ddos_action_blackhole</td>\n<td>integer</td>\n<td>The number of times the blackhole action was taken. The blackhole action quietly closes a TCP connection without sending a reset. The blackhole action quietly closes a TCP connection without notifying its peer (all TCP state is dropped).</td>\n</tr>\n<tr>\n<td>ddos_action_close</td>\n<td>integer</td>\n<td>The number of times the close action was taken. The close action aborts the connection as soon as possible. The close action takes effect either right after accept, right after the client hello, or right after the response was sent.</td>\n</tr>\n<tr>\n<td>ddos_action_downgrade</td>\n<td>integer</td>\n<td>The number of times the downgrade action was taken. The downgrade action restricts the client to http1.</td>\n</tr>\n<tr>\n<td>ddos_action_downgraded_connections</td>\n<td>integer</td>\n<td>The number of connections the downgrade action was applied to. The downgrade action restricts the connection to http1.</td>\n</tr>\n<tr>\n<td>ddos_action_limit_streams_connections</td>\n<td>integer</td>\n<td>For HTTP/2, the number of connections the limit-streams action was applied to. The limit-streams action caps the allowed number of concurrent streams in a connection.</td>\n</tr>\n<tr>\n<td>ddos_action_limit_streams_requests</td>\n<td>integer</td>\n<td>For HTTP/2, the number of requests made on a connection for which the limit-streams action was taken. The limit-streams action caps the allowed number of concurrent streams in a connection.</td>\n</tr>\n<tr>\n<td>ddos_action_tarpit</td>\n<td>integer</td>\n<td>The number of times the tarpit action was taken. The tarpit action delays writing the response to the client.</td>\n</tr>\n<tr>\n<td>ddos_action_tarpit_accept</td>\n<td>integer</td>\n<td>The number of times the tarpit-accept action was taken. The tarpit-accept action adds a delay when accepting future connections.</td>\n</tr>\n<tr>\n<td>ddos_protection_requests_allow_count</td>\n<td>integer</td>\n<td>Number of requests analyzed for DDoS attacks against a customer origin or service, but with no DDoS detected.</td>\n</tr>\n<tr>\n<td>ddos_protection_requests_detect_count</td>\n<td>integer</td>\n<td>Number of requests classified as a DDoS attack against a customer origin or service.</td>\n</tr>\n<tr>\n<td>ddos_protection_requests_mitigate_count</td>\n<td>integer</td>\n<td>Number of requests classified as a DDoS attack against a customer origin or service that were mitigated by the Fastly platform.</td>\n</tr>\n<tr>\n<td>deliver_sub_count</td>\n<td>integer</td>\n<td>Number of executions of the vcl_deliver Varnish subroutine.</td>\n</tr>\n<tr>\n<td>deliver_sub_time</td>\n<td>number</td>\n<td>Time spent inside the vcl_deliver Varnish subroutine (in nanoseconds).</td>\n</tr>\n<tr>\n<td>dns_billable_responses_count</td>\n<td>integer</td>\n<td>Number of billable DNS responses (e.g., A, CNAME).</td>\n</tr>\n<tr>\n<td>dns_nonbillable_responses_count</td>\n<td>integer</td>\n<td>Number of non-billable DNS responses (e.g., NODATA, NXDOMAIN).</td>\n</tr>\n<tr>\n<td>edge_hit_requests</td>\n<td>integer</td>\n<td>Number of requests sent by end users to Fastly that resulted in a hit at the edge.</td>\n</tr>\n<tr>\n<td>edge_hit_resp_body_bytes</td>\n<td>integer</td>\n<td>Body bytes delivered for edge hits.</td>\n</tr>\n<tr>\n<td>edge_hit_resp_header_bytes</td>\n<td>integer</td>\n<td>Header bytes delivered for edge hits.</td>\n</tr>\n<tr>\n<td>edge_miss_requests</td>\n<td>integer</td>\n<td>Number of requests sent by end users to Fastly that resulted in a miss at the edge.</td>\n</tr>\n<tr>\n<td>edge_miss_resp_body_bytes</td>\n<td>integer</td>\n<td>Body bytes delivered for edge misses.</td>\n</tr>\n<tr>\n<td>edge_miss_resp_header_bytes</td>\n<td>integer</td>\n<td>Header bytes delivered for edge misses.</td>\n</tr>\n<tr>\n<td>edge_requests</td>\n<td>integer</td>\n<td>Number of requests sent by end users to Fastly.</td>\n</tr>\n<tr>\n<td>edge_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes delivered from Fastly to the end user.</td>\n</tr>\n<tr>\n<td>edge_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes delivered from Fastly to the end user.</td>\n</tr>\n<tr>\n<td>error_sub_count</td>\n<td>integer</td>\n<td>Number of executions of the vcl_error Varnish subroutine.</td>\n</tr>\n<tr>\n<td>error_sub_time</td>\n<td>number</td>\n<td>Time spent inside the vcl_error Varnish subroutine (in nanoseconds).</td>\n</tr>\n<tr>\n<td>errors</td>\n<td>integer</td>\n<td>Number of cache errors.</td>\n</tr>\n<tr>\n<td>fanout_bereq_body_bytes</td>\n<td>integer</td>\n<td>Total body or message content bytes sent to backends over Fanout connections.</td>\n</tr>\n<tr>\n<td>fanout_bereq_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes sent to backends over Fanout connections.</td>\n</tr>\n<tr>\n<td>fanout_beresp_body_bytes</td>\n<td>integer</td>\n<td>Total body or message content bytes received from backends over Fanout connections.</td>\n</tr>\n<tr>\n<td>fanout_beresp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received from backends over Fanout connections.</td>\n</tr>\n<tr>\n<td>fanout_conn_time_ms</td>\n<td>integer</td>\n<td>Total duration of Fanout connections with end users.</td>\n</tr>\n<tr>\n<td>fanout_recv_publishes</td>\n<td>integer</td>\n<td>Total published messages received from the publish API endpoint.</td>\n</tr>\n<tr>\n<td>fanout_req_body_bytes</td>\n<td>integer</td>\n<td>Total body or message content bytes received from end users over Fanout connections.</td>\n</tr>\n<tr>\n<td>fanout_req_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received from end users over Fanout connections.</td>\n</tr>\n<tr>\n<td>fanout_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body or message content bytes sent to end users over Fanout connections, excluding published message content.</td>\n</tr>\n<tr>\n<td>fanout_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes sent to end users over Fanout connections.</td>\n</tr>\n<tr>\n<td>fanout_send_publishes</td>\n<td>integer</td>\n<td>Total published messages sent to end users.</td>\n</tr>\n<tr>\n<td>fetch_sub_count</td>\n<td>integer</td>\n<td>Number of executions of the vcl_fetch Varnish subroutine.</td>\n</tr>\n<tr>\n<td>fetch_sub_time</td>\n<td>number</td>\n<td>Time spent inside the vcl_fetch Varnish subroutine (in nanoseconds).</td>\n</tr>\n<tr>\n<td>hash_sub_count</td>\n<td>integer</td>\n<td>Number of executions of the vcl_hash Varnish subroutine.</td>\n</tr>\n<tr>\n<td>hash_sub_time</td>\n<td>number</td>\n<td>Time spent inside the vcl_hash Varnish subroutine (in nanoseconds).</td>\n</tr>\n<tr>\n<td>header_size</td>\n<td>integer</td>\n<td>Total header bytes delivered (alias for resp_header_bytes).</td>\n</tr>\n<tr>\n<td>hit_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes delivered for cache hits.</td>\n</tr>\n<tr>\n<td>hit_sub_count</td>\n<td>integer</td>\n<td>Number of executions of the vcl_hit Varnish subroutine.</td>\n</tr>\n<tr>\n<td>hit_sub_time</td>\n<td>number</td>\n<td>Time spent inside the vcl_hit Varnish subroutine (in nanoseconds).</td>\n</tr>\n<tr>\n<td>hits</td>\n<td>integer</td>\n<td>Number of cache hits.</td>\n</tr>\n<tr>\n<td>hits_time</td>\n<td>number</td>\n<td>Total amount of time spent processing cache hits (in seconds).</td>\n</tr>\n<tr>\n<td>http2</td>\n<td>integer</td>\n<td>Number of requests received over HTTP/2.</td>\n</tr>\n<tr>\n<td>http3</td>\n<td>integer</td>\n<td>Number of requests received over HTTP/3.</td>\n</tr>\n<tr>\n<td>imgopto</td>\n<td>integer</td>\n<td>Number of responses that came from the Fastly Image Optimizer service. If the service receives 10 requests for an image, this stat will be 10 regardless of how many times the image was transformed.</td>\n</tr>\n<tr>\n<td>imgopto_avif_count</td>\n<td>integer</td>\n<td>Count of AVIF images delivered to end user by Image Optimizer.</td>\n</tr>\n<tr>\n<td>imgopto_compute_requests</td>\n<td>integer</td>\n<td>The number of Image Optimizer requests made from Compute services.</td>\n</tr>\n<tr>\n<td>imgopto_gif_count</td>\n<td>integer</td>\n<td>Count of GIF images delivered to end user by Image Optimizer.</td>\n</tr>\n<tr>\n<td>imgopto_jpeg_count</td>\n<td>integer</td>\n<td>Count of JPEG images delivered to end user by Image Optimizer.</td>\n</tr>\n<tr>\n<td>imgopto_jpegxl_count</td>\n<td>integer</td>\n<td>Count of JPEGXL images delivered to end user by Image Optimizer.</td>\n</tr>\n<tr>\n<td>imgopto_mp4_count</td>\n<td>integer</td>\n<td>Count of MP4s delivered to end user by Image Optimizer.</td>\n</tr>\n<tr>\n<td>imgopto_png_count</td>\n<td>integer</td>\n<td>Count of PNG images delivered to end user by Image Optimizer.</td>\n</tr>\n<tr>\n<td>imgopto_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes delivered from the Fastly Image Optimizer service, including shield traffic.</td>\n</tr>\n<tr>\n<td>imgopto_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes delivered from the Fastly Image Optimizer service, including shield traffic.</td>\n</tr>\n<tr>\n<td>imgopto_shield</td>\n<td>integer</td>\n<td>Number of responses that came from the Fastly Image Optimizer service via a shield.</td>\n</tr>\n<tr>\n<td>imgopto_shield_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes delivered via a shield from the Fastly Image Optimizer service.</td>\n</tr>\n<tr>\n<td>imgopto_shield_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes delivered via a shield from the Fastly Image Optimizer service.</td>\n</tr>\n<tr>\n<td>imgopto_svg_count</td>\n<td>integer</td>\n<td>Count of SVG images delivered to end user by Image Optimizer.</td>\n</tr>\n<tr>\n<td>imgopto_transforms</td>\n<td>integer</td>\n<td>Number of transforms performed by the Fastly Image Optimizer service.</td>\n</tr>\n<tr>\n<td>imgopto_webp_count</td>\n<td>integer</td>\n<td>Count of WebP images delivered to end user by Image Optimizer.</td>\n</tr>\n<tr>\n<td>imgvideo</td>\n<td>integer</td>\n<td>Number of video responses that came from the Fastly Image Optimizer service.</td>\n</tr>\n<tr>\n<td>imgvideo_frames</td>\n<td>integer</td>\n<td>Number of video frames that came from the Fastly Image Optimizer service. A video frame is an individual image within a sequence of video.</td>\n</tr>\n<tr>\n<td>imgvideo_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes of video delivered from the Fastly Image Optimizer service.</td>\n</tr>\n<tr>\n<td>imgvideo_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes of video delivered from the Fastly Image Optimizer service.</td>\n</tr>\n<tr>\n<td>imgvideo_shield</td>\n<td>integer</td>\n<td>Number of video responses delivered via a shield that came from the Fastly Image Optimizer service.</td>\n</tr>\n<tr>\n<td>imgvideo_shield_frames</td>\n<td>integer</td>\n<td>Number of video frames delivered via a shield that came from the Fastly Image Optimizer service. A video frame is an individual image within a sequence of video.</td>\n</tr>\n<tr>\n<td>imgvideo_shield_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes of video delivered via a shield from the Fastly Image Optimizer service.</td>\n</tr>\n<tr>\n<td>imgvideo_shield_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes of video delivered via a shield from the Fastly Image Optimizer service.</td>\n</tr>\n<tr>\n<td>ipv6</td>\n<td>integer</td>\n<td>Number of requests that were received over IPv6.</td>\n</tr>\n<tr>\n<td>kv_store_class_a_operations</td>\n<td>integer</td>\n<td>The total number of class a operations for the KV store.</td>\n</tr>\n<tr>\n<td>kv_store_class_b_operations</td>\n<td>integer</td>\n<td>The total number of class b operations for the KV store.</td>\n</tr>\n<tr>\n<td>log</td>\n<td>integer</td>\n<td>Number of log lines sent.</td>\n</tr>\n<tr>\n<td>log_bytes</td>\n<td>integer</td>\n<td>Total log bytes sent.</td>\n</tr>\n<tr>\n<td>logging</td>\n<td>integer</td>\n<td>Number of log lines sent (alias for log).</td>\n</tr>\n<tr>\n<td>miss</td>\n<td>integer</td>\n<td>Number of cache misses.</td>\n</tr>\n<tr>\n<td>miss_histogram</td>\n<td>object</td>\n<td>A histogram. The value in each bucket is the number of requests to the origin whose responses arrived during the time period represented by the bucket. The key of each bucket represents the upper bound (in response time) of that bucket. The buckets vary in width and cover the time periods 0-10ms (in 1ms increments), 10-250ms (in 10ms increments), 250-1,000ms (in 50ms increments), 1,000-3,000ms (in 100ms increments), 3,000-10,000ms (in 500 ms increments), 10,000-20,000ms (in 1,000ms increments), 20,000-60,000ms (in 5,000ms increments), and 60,000ms through infinity (in a single bucket).</td>\n</tr>\n<tr>\n<td>miss_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes delivered for cache misses.</td>\n</tr>\n<tr>\n<td>miss_sub_count</td>\n<td>integer</td>\n<td>Number of executions of the vcl_miss Varnish subroutine.</td>\n</tr>\n<tr>\n<td>miss_sub_time</td>\n<td>number</td>\n<td>Time spent inside the vcl_miss Varnish subroutine (in nanoseconds).</td>\n</tr>\n<tr>\n<td>miss_time</td>\n<td>number</td>\n<td>Total amount of time spent processing cache misses (in seconds).</td>\n</tr>\n<tr>\n<td>ngwaf_bot_analysis_request_count</td>\n<td>integer</td>\n<td>Count of Next-Gen WAF Bot Management requests.</td>\n</tr>\n<tr>\n<td>object_size_100k</td>\n<td>integer</td>\n<td>Number of objects served that were between 10KB and 100KB in size.</td>\n</tr>\n<tr>\n<td>object_size_100m</td>\n<td>integer</td>\n<td>Number of objects served that were between 10MB and 100MB in size.</td>\n</tr>\n<tr>\n<td>object_size_10k</td>\n<td>integer</td>\n<td>Number of objects served that were between 1KB and 10KB in size.</td>\n</tr>\n<tr>\n<td>object_size_10m</td>\n<td>integer</td>\n<td>Number of objects served that were between 1MB and 10MB in size.</td>\n</tr>\n<tr>\n<td>object_size_1g</td>\n<td>integer</td>\n<td>Number of objects served that were between 100MB and 1GB in size.</td>\n</tr>\n<tr>\n<td>object_size_1k</td>\n<td>integer</td>\n<td>Number of objects served that were under 1KB in size.</td>\n</tr>\n<tr>\n<td>object_size_1m</td>\n<td>integer</td>\n<td>Number of objects served that were between 100KB and 1MB in size.</td>\n</tr>\n<tr>\n<td>object_size_other</td>\n<td>integer</td>\n<td>Number of objects served that were larger than 1GB in size.</td>\n</tr>\n<tr>\n<td>object_storage_class_a_operations_count</td>\n<td>integer</td>\n<td>A count of the number of Class A Object Storage operations.</td>\n</tr>\n<tr>\n<td>object_storage_class_b_operations_count</td>\n<td>integer</td>\n<td>A count of the number of Class B Object Storage operations.</td>\n</tr>\n<tr>\n<td>object_store_class_a_operations</td>\n<td>integer</td>\n<td>Use kv_store_class_a_operations.</td>\n</tr>\n<tr>\n<td>object_store_class_b_operations</td>\n<td>integer</td>\n<td>Use kv_store_class_b_operations.</td>\n</tr>\n<tr>\n<td>origin_cache_fetch_resp_body_bytes</td>\n<td>integer</td>\n<td>Body bytes received from origin for cacheable content.</td>\n</tr>\n<tr>\n<td>origin_cache_fetch_resp_header_bytes</td>\n<td>integer</td>\n<td>Header bytes received from an origin for cacheable content.</td>\n</tr>\n<tr>\n<td>origin_cache_fetches</td>\n<td>integer</td>\n<td>The total number of completed requests made to backends (origins) that returned cacheable content.</td>\n</tr>\n<tr>\n<td>origin_fetch_body_bytes</td>\n<td>integer</td>\n<td>Total request body bytes sent to origin.</td>\n</tr>\n<tr>\n<td>origin_fetch_header_bytes</td>\n<td>integer</td>\n<td>Total request header bytes sent to origin.</td>\n</tr>\n<tr>\n<td>origin_fetch_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes received from origin.</td>\n</tr>\n<tr>\n<td>origin_fetch_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received from origin.</td>\n</tr>\n<tr>\n<td>origin_fetches</td>\n<td>integer</td>\n<td>Number of requests sent to origin.</td>\n</tr>\n<tr>\n<td>origin_offload</td>\n<td>number</td>\n<td>Origin Offload measures the ratio of bytes served to end users that were cached by Fastly, over the bytes served to end users, between 0 and 1. ((edge_resp_body_bytes + edge_resp_header_bytes) - (origin_fetch_resp_body_bytes + origin_fetch_resp_header_bytes)) / (edge_resp_body_bytes + edge_resp_header_bytes).</td>\n</tr>\n<tr>\n<td>origin_revalidations</td>\n<td>integer</td>\n<td>Number of responses received from origin with a 304 status code in response to an If-Modified-Since or If-None-Match request. Under regular scenarios, a revalidation will imply a cache hit. However, if using Fastly Image Optimizer or segmented caching this may result in a cache miss.</td>\n</tr>\n<tr>\n<td>otfp</td>\n<td>integer</td>\n<td>Number of responses that came from the Fastly On-the-Fly Packaging service for video-on-demand.</td>\n</tr>\n<tr>\n<td>otfp_deliver_time</td>\n<td>number</td>\n<td>Total amount of time spent delivering a response from the Fastly On-the-Fly Packaging service for video-on-demand (in seconds).</td>\n</tr>\n<tr>\n<td>otfp_manifests</td>\n<td>integer</td>\n<td>Number of responses that were manifest files from the Fastly On-the-Fly Packaging service for video-on-demand.</td>\n</tr>\n<tr>\n<td>otfp_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes delivered from the Fastly On-the-Fly Packaging service for video-on-demand.</td>\n</tr>\n<tr>\n<td>otfp_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes delivered from the Fastly On-the-Fly Packaging service for video-on-demand.</td>\n</tr>\n<tr>\n<td>otfp_shield</td>\n<td>integer</td>\n<td>Number of responses that came from the Fastly On-the-Fly Packaging service for video-on-demand via a shield.</td>\n</tr>\n<tr>\n<td>otfp_shield_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes delivered via a shield for the Fastly On-the-Fly Packaging service for video-on-demand.</td>\n</tr>\n<tr>\n<td>otfp_shield_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes delivered via a shield for the Fastly On-the-Fly Packaging service for video-on-demand.</td>\n</tr>\n<tr>\n<td>otfp_shield_time</td>\n<td>number</td>\n<td>Total amount of time spent delivering a response via a shield from the Fastly On-the-Fly Packaging service for video-on-demand (in seconds).</td>\n</tr>\n<tr>\n<td>pass</td>\n<td>integer</td>\n<td>Number of requests that passed through the CDN without being cached.</td>\n</tr>\n<tr>\n<td>pass_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes delivered for cache passes.</td>\n</tr>\n<tr>\n<td>pass_sub_count</td>\n<td>integer</td>\n<td>Number of executions of the vcl_pass Varnish subroutine.</td>\n</tr>\n<tr>\n<td>pass_sub_time</td>\n<td>number</td>\n<td>Time spent inside the vcl_pass Varnish subroutine (in nanoseconds).</td>\n</tr>\n<tr>\n<td>pass_time</td>\n<td>number</td>\n<td>Total amount of time spent processing cache passes (in seconds).</td>\n</tr>\n<tr>\n<td>pci</td>\n<td>integer</td>\n<td>Number of responses with the PCI flag turned on.</td>\n</tr>\n<tr>\n<td>pipe_sub_count</td>\n<td>integer</td>\n<td>Number of executions of the vcl_pipe Varnish subroutine.</td>\n</tr>\n<tr>\n<td>pipe_sub_time</td>\n<td>number</td>\n<td>Time spent inside the vcl_pipe Varnish subroutine (in nanoseconds).</td>\n</tr>\n<tr>\n<td>predeliver_sub_count</td>\n<td>integer</td>\n<td>Number of executions of the vcl_predeliver Varnish subroutine.</td>\n</tr>\n<tr>\n<td>predeliver_sub_time</td>\n<td>number</td>\n<td>Time spent inside the vcl_predeliver Varnish subroutine (in nanoseconds).</td>\n</tr>\n<tr>\n<td>prehash_sub_count</td>\n<td>integer</td>\n<td>Number of executions of the vcl_prehash Varnish subroutine.</td>\n</tr>\n<tr>\n<td>prehash_sub_time</td>\n<td>number</td>\n<td>Time spent inside the vcl_prehash Varnish subroutine (in nanoseconds).</td>\n</tr>\n<tr>\n<td>recv_sub_count</td>\n<td>integer</td>\n<td>Number of executions of the vcl_recv Varnish subroutine.</td>\n</tr>\n<tr>\n<td>recv_sub_time</td>\n<td>number</td>\n<td>Time spent inside the vcl_recv Varnish subroutine (in nanoseconds).</td>\n</tr>\n<tr>\n<td>req_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes received.</td>\n</tr>\n<tr>\n<td>req_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received.</td>\n</tr>\n<tr>\n<td>request_collapse_unusable_count</td>\n<td>integer</td>\n<td>Number of requests that were collapsed and unable to be satisfied by the resulting cache object.</td>\n</tr>\n<tr>\n<td>request_collapse_usable_count</td>\n<td>integer</td>\n<td>Number of requests that were collapsed and satisfied by a usable cache object.</td>\n</tr>\n<tr>\n<td>request_denied_get_head_body</td>\n<td>integer</td>\n<td>Number of requests where Fastly responded with 400 due to the request being a GET or HEAD request containing a body.</td>\n</tr>\n<tr>\n<td>requests</td>\n<td>integer</td>\n<td>Number of requests processed.</td>\n</tr>\n<tr>\n<td>resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes delivered (edge_resp_body_bytes + shield_resp_body_bytes).</td>\n</tr>\n<tr>\n<td>resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes delivered (edge_resp_header_bytes + shield_resp_header_bytes).</td>\n</tr>\n<tr>\n<td>restarts</td>\n<td>integer</td>\n<td>Number of restarts performed.</td>\n</tr>\n<tr>\n<td>segblock_origin_fetches</td>\n<td>integer</td>\n<td>Number of Range requests to origin for segments of resources when using segmented caching.</td>\n</tr>\n<tr>\n<td>segblock_shield_fetches</td>\n<td>integer</td>\n<td>Number of Range requests to a shield for segments of resources when using segmented caching.</td>\n</tr>\n<tr>\n<td>shield</td>\n<td>integer</td>\n<td>Number of requests from edge to the shield POP.</td>\n</tr>\n<tr>\n<td>shield_cache_fetches</td>\n<td>integer</td>\n<td>The total number of completed requests made to shields that returned cacheable content.</td>\n</tr>\n<tr>\n<td>shield_fetch_body_bytes</td>\n<td>integer</td>\n<td>Total request body bytes sent to a shield.</td>\n</tr>\n<tr>\n<td>shield_fetch_header_bytes</td>\n<td>integer</td>\n<td>Total request header bytes sent to a shield.</td>\n</tr>\n<tr>\n<td>shield_fetch_resp_body_bytes</td>\n<td>integer</td>\n<td>Total response body bytes sent from a shield to the edge.</td>\n</tr>\n<tr>\n<td>shield_fetch_resp_header_bytes</td>\n<td>integer</td>\n<td>Total response header bytes sent from a shield to the edge.</td>\n</tr>\n<tr>\n<td>shield_fetches</td>\n<td>integer</td>\n<td>Number of requests made from one Fastly POP to another, as part of shielding.</td>\n</tr>\n<tr>\n<td>shield_hit_requests</td>\n<td>integer</td>\n<td>Number of requests that resulted in a hit at a shield.</td>\n</tr>\n<tr>\n<td>shield_hit_resp_body_bytes</td>\n<td>integer</td>\n<td>Body bytes delivered for shield hits.</td>\n</tr>\n<tr>\n<td>shield_hit_resp_header_bytes</td>\n<td>integer</td>\n<td>Header bytes delivered for shield hits.</td>\n</tr>\n<tr>\n<td>shield_miss_requests</td>\n<td>integer</td>\n<td>Number of requests that resulted in a miss at a shield.</td>\n</tr>\n<tr>\n<td>shield_miss_resp_body_bytes</td>\n<td>integer</td>\n<td>Body bytes delivered for shield misses.</td>\n</tr>\n<tr>\n<td>shield_miss_resp_header_bytes</td>\n<td>integer</td>\n<td>Header bytes delivered for shield misses.</td>\n</tr>\n<tr>\n<td>shield_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes delivered via a shield.</td>\n</tr>\n<tr>\n<td>shield_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes delivered via a shield.</td>\n</tr>\n<tr>\n<td>shield_revalidations</td>\n<td>integer</td>\n<td>Number of responses received from origin with a 304 status code, in response to an If-Modified-Since or If-None-Match request to a shield. Under regular scenarios, a revalidation will imply a cache hit. However, if using segmented caching this may result in a cache miss.</td>\n</tr>\n<tr>\n<td>status_1xx</td>\n<td>integer</td>\n<td>Number of \"Informational\" category status codes delivered.</td>\n</tr>\n<tr>\n<td>status_200</td>\n<td>integer</td>\n<td>Number of responses sent with status code 200 (Success).</td>\n</tr>\n<tr>\n<td>status_204</td>\n<td>integer</td>\n<td>Number of responses sent with status code 204 (No Content).</td>\n</tr>\n<tr>\n<td>status_206</td>\n<td>integer</td>\n<td>Number of responses sent with status code 206 (Partial Content).</td>\n</tr>\n<tr>\n<td>status_2xx</td>\n<td>integer</td>\n<td>Number of \"Success\" status codes delivered.</td>\n</tr>\n<tr>\n<td>status_301</td>\n<td>integer</td>\n<td>Number of responses sent with status code 301 (Moved Permanently).</td>\n</tr>\n<tr>\n<td>status_302</td>\n<td>integer</td>\n<td>Number of responses sent with status code 302 (Found).</td>\n</tr>\n<tr>\n<td>status_304</td>\n<td>integer</td>\n<td>Number of responses sent with status code 304 (Not Modified).</td>\n</tr>\n<tr>\n<td>status_3xx</td>\n<td>integer</td>\n<td>Number of \"Redirection\" codes delivered.</td>\n</tr>\n<tr>\n<td>status_400</td>\n<td>integer</td>\n<td>Number of responses sent with status code 400 (Bad Request).</td>\n</tr>\n<tr>\n<td>status_401</td>\n<td>integer</td>\n<td>Number of responses sent with status code 401 (Unauthorized).</td>\n</tr>\n<tr>\n<td>status_403</td>\n<td>integer</td>\n<td>Number of responses sent with status code 403 (Forbidden).</td>\n</tr>\n<tr>\n<td>status_404</td>\n<td>integer</td>\n<td>Number of responses sent with status code 404 (Not Found).</td>\n</tr>\n<tr>\n<td>status_406</td>\n<td>integer</td>\n<td>Number of responses sent with status code 406 (Not Acceptable).</td>\n</tr>\n<tr>\n<td>status_416</td>\n<td>integer</td>\n<td>Number of responses sent with status code 416 (Range Not Satisfiable).</td>\n</tr>\n<tr>\n<td>status_429</td>\n<td>integer</td>\n<td>Number of responses sent with status code 429 (Too Many Requests).</td>\n</tr>\n<tr>\n<td>status_4xx</td>\n<td>integer</td>\n<td>Number of \"Client Error\" codes delivered.</td>\n</tr>\n<tr>\n<td>status_500</td>\n<td>integer</td>\n<td>Number of responses sent with status code 500 (Internal Server Error).</td>\n</tr>\n<tr>\n<td>status_501</td>\n<td>integer</td>\n<td>Number of responses sent with status code 501 (Not Implemented).</td>\n</tr>\n<tr>\n<td>status_502</td>\n<td>integer</td>\n<td>Number of responses sent with status code 502 (Bad Gateway).</td>\n</tr>\n<tr>\n<td>status_503</td>\n<td>integer</td>\n<td>Number of responses sent with status code 503 (Service Unavailable).</td>\n</tr>\n<tr>\n<td>status_504</td>\n<td>integer</td>\n<td>Number of responses sent with status code 504 (Gateway Timeout).</td>\n</tr>\n<tr>\n<td>status_505</td>\n<td>integer</td>\n<td>Number of responses sent with status code 505 (HTTP Version Not Supported).</td>\n</tr>\n<tr>\n<td>status_530</td>\n<td>integer</td>\n<td>Number of responses sent with status code 530.</td>\n</tr>\n<tr>\n<td>status_5xx</td>\n<td>integer</td>\n<td>Number of \"Server Error\" codes delivered.</td>\n</tr>\n<tr>\n<td>synth</td>\n<td>integer</td>\n<td>Number of requests that returned a synthetic response (i.e., response objects created with the synthetic VCL statement).</td>\n</tr>\n<tr>\n<td>tls</td>\n<td>integer</td>\n<td>Number of requests that were received over TLS.</td>\n</tr>\n<tr>\n<td>tls_v10</td>\n<td>integer</td>\n<td>Number of requests received over TLS 1.0.</td>\n</tr>\n<tr>\n<td>tls_v11</td>\n<td>integer</td>\n<td>Number of requests received over TLS 1.1.</td>\n</tr>\n<tr>\n<td>tls_v12</td>\n<td>integer</td>\n<td>Number of requests received over TLS 1.2.</td>\n</tr>\n<tr>\n<td>tls_v13</td>\n<td>integer</td>\n<td>Number of requests received over TLS 1.3.</td>\n</tr>\n<tr>\n<td>uncacheable</td>\n<td>integer</td>\n<td>Number of requests that were designated uncachable.</td>\n</tr>\n<tr>\n<td>upgrade</td>\n<td>integer</td>\n<td>Number of requests that resulted in a WebSocket upgrade.</td>\n</tr>\n<tr>\n<td>video</td>\n<td>integer</td>\n<td>Number of responses with the video segment or video manifest MIME type (i.e., application/x-mpegurl, application/vnd.apple.mpegurl, application/f4m, application/dash+xml, application/vnd.ms-sstr+xml, ideo/mp2t, audio/aac, video/f4f, video/x-flv, video/mp4, audio/mp4).</td>\n</tr>\n<tr>\n<td>websocket_bereq_body_bytes</td>\n<td>integer</td>\n<td>Total message content bytes sent to backends over passthrough WebSocket connections.</td>\n</tr>\n<tr>\n<td>websocket_bereq_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes sent to backends over passthrough WebSocket connections.</td>\n</tr>\n<tr>\n<td>websocket_beresp_body_bytes</td>\n<td>integer</td>\n<td>Total message content bytes received from backends over passthrough WebSocket connections.</td>\n</tr>\n<tr>\n<td>websocket_beresp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received from backends over passthrough WebSocket connections.</td>\n</tr>\n<tr>\n<td>websocket_conn_time_ms</td>\n<td>integer</td>\n<td>Total duration of passthrough WebSocket connections with end users.</td>\n</tr>\n<tr>\n<td>websocket_req_body_bytes</td>\n<td>integer</td>\n<td>Total message content bytes received from end users over passthrough WebSocket connections.</td>\n</tr>\n<tr>\n<td>websocket_req_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received from end users over passthrough WebSocket connections.</td>\n</tr>\n<tr>\n<td>websocket_resp_body_bytes</td>\n<td>integer</td>\n<td>Total message content bytes sent to end users over passthrough WebSocket connections.</td>\n</tr>\n<tr>\n<td>websocket_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes sent to end users over passthrough WebSocket connections.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-3\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>aia_estimated_time_saved_ms</td>\n<td>integer</td>\n<td>The estimated amount of time saved by responses served from the AI Accelerator semantic cache.</td>\n</tr>\n<tr>\n<td>aia_origin_usage_tokens</td>\n<td>integer</td>\n<td>The number of usage tokens reported by the request to the origin from AI Accelerator.</td>\n</tr>\n<tr>\n<td>aia_requests</td>\n<td>integer</td>\n<td>Number of requests received by AI Accelerator.</td>\n</tr>\n<tr>\n<td>aia_response_usage_tokens</td>\n<td>integer</td>\n<td>The usage tokens associated with the response returned from the AI Accelerator cache.</td>\n</tr>\n<tr>\n<td>aia_status_1xx</td>\n<td>integer</td>\n<td>Number of \"Informational\" category status codes received from AI provider.</td>\n</tr>\n<tr>\n<td>aia_status_2xx</td>\n<td>integer</td>\n<td>Number of \"Success\" status codes received from AI provider.</td>\n</tr>\n<tr>\n<td>aia_status_3xx</td>\n<td>integer</td>\n<td>Number of \"Redirection\" received from AI provider.</td>\n</tr>\n<tr>\n<td>aia_status_4xx</td>\n<td>integer</td>\n<td>Number of \"Client Error\" received from AI provider.</td>\n</tr>\n<tr>\n<td>aia_status_5xx</td>\n<td>integer</td>\n<td>Number of \"Server Error\" received from AI provider.</td>\n</tr>\n<tr>\n<td>all_edge_hit_requests</td>\n<td>integer</td>\n<td>Number of requests sent by end users to Fastly that resulted in a hit at the edge for a VCL service.</td>\n</tr>\n<tr>\n<td>all_edge_miss_requests</td>\n<td>integer</td>\n<td>Number of requests sent by end users to Fastly that resulted in a miss at the edge for a VCL service.</td>\n</tr>\n<tr>\n<td>all_error_requests</td>\n<td>integer</td>\n<td>Number of cache errors for a VCL service.</td>\n</tr>\n<tr>\n<td>all_hit_requests</td>\n<td>integer</td>\n<td>Number of cache hits for a VCL service.</td>\n</tr>\n<tr>\n<td>all_miss_requests</td>\n<td>integer</td>\n<td>Number of cache misses for a VCL service.</td>\n</tr>\n<tr>\n<td>all_pass_requests</td>\n<td>integer</td>\n<td>Number of requests that passed through the CDN without being cached for a VCL service.</td>\n</tr>\n<tr>\n<td>all_status_1xx</td>\n<td>integer</td>\n<td>Number of \"Informational\" category status codes delivered for all sources.</td>\n</tr>\n<tr>\n<td>all_status_2xx</td>\n<td>integer</td>\n<td>Number of \"Success\" status codes delivered for all sources.</td>\n</tr>\n<tr>\n<td>all_status_3xx</td>\n<td>integer</td>\n<td>Number of \"Redirection\" codes delivered for all sources.</td>\n</tr>\n<tr>\n<td>all_status_4xx</td>\n<td>integer</td>\n<td>Number of \"Client Error\" codes delivered for all sources.</td>\n</tr>\n<tr>\n<td>all_status_5xx</td>\n<td>integer</td>\n<td>Number of \"Server Error\" codes delivered for all sources.</td>\n</tr>\n<tr>\n<td>all_synth_requests</td>\n<td>integer</td>\n<td>Number of requests that returned a synthetic response (i.e., response objects created with the synthetic VCL statement) for a VCL service.</td>\n</tr>\n<tr>\n<td>api_discovery_requests_count</td>\n<td>integer</td>\n<td>Number of requests processed by the API Discovery engine.</td>\n</tr>\n<tr>\n<td>attack_blocked_req_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes received from requests that triggered a WAF rule that was blocked.</td>\n</tr>\n<tr>\n<td>attack_blocked_req_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received from requests that triggered a WAF rule that was blocked.</td>\n</tr>\n<tr>\n<td>attack_logged_req_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes received from requests that triggered a WAF rule that was logged.</td>\n</tr>\n<tr>\n<td>attack_logged_req_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received from requests that triggered a WAF rule that was logged.</td>\n</tr>\n<tr>\n<td>attack_passed_req_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes received from requests that triggered a WAF rule that was passed.</td>\n</tr>\n<tr>\n<td>attack_passed_req_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received from requests that triggered a WAF rule that was passed.</td>\n</tr>\n<tr>\n<td>attack_req_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes received from requests that triggered a WAF rule.</td>\n</tr>\n<tr>\n<td>attack_req_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received from requests that triggered a WAF rule.</td>\n</tr>\n<tr>\n<td>attack_resp_synth_bytes</td>\n<td>integer</td>\n<td>Total bytes delivered for requests that triggered a WAF rule and returned a synthetic response.</td>\n</tr>\n<tr>\n<td>bereq_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes sent to origin.</td>\n</tr>\n<tr>\n<td>bereq_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes sent to origin.</td>\n</tr>\n<tr>\n<td>body_size</td>\n<td>integer</td>\n<td>Total body bytes delivered (alias for resp_body_bytes).</td>\n</tr>\n<tr>\n<td>bot_challenge_complete_tokens_checked</td>\n<td>integer</td>\n<td>The number of challenge-complete tokens checked.</td>\n</tr>\n<tr>\n<td>bot_challenge_complete_tokens_disabled</td>\n<td>integer</td>\n<td>The number of challenge-complete tokens not checked because the feature was disabled.</td>\n</tr>\n<tr>\n<td>bot_challenge_complete_tokens_failed</td>\n<td>integer</td>\n<td>The number of challenge-complete tokens that failed validation.</td>\n</tr>\n<tr>\n<td>bot_challenge_complete_tokens_issued</td>\n<td>integer</td>\n<td>The number of challenge-complete tokens issued. For example, issuing a challenge-complete token after a series of CAPTCHA challenges ending in success.</td>\n</tr>\n<tr>\n<td>bot_challenge_complete_tokens_passed</td>\n<td>integer</td>\n<td>The number of challenge-complete tokens that passed validation.</td>\n</tr>\n<tr>\n<td>bot_challenge_starts</td>\n<td>integer</td>\n<td>The number of challenge-start tokens created.</td>\n</tr>\n<tr>\n<td>bot_challenges_failed</td>\n<td>integer</td>\n<td>The number of failed challenge solutions processed. For example, an incorrect CAPTCHA solution.</td>\n</tr>\n<tr>\n<td>bot_challenges_issued</td>\n<td>integer</td>\n<td>The number of challenges issued. For example, the issuance of a CAPTCHA challenge.</td>\n</tr>\n<tr>\n<td>bot_challenges_succeeded</td>\n<td>integer</td>\n<td>The number of successful challenge solutions processed. For example, a correct CAPTCHA solution.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_accessibility_count</td>\n<td>integer</td>\n<td>Count of edge requests where an accessibility bot was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_ai_crawler_count</td>\n<td>integer</td>\n<td>Count of edge requests where an AI crawler was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_ai_fetcher_count</td>\n<td>integer</td>\n<td>Count of edge requests where an AI fetcher was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_analyzed_count</td>\n<td>integer</td>\n<td>Count of edge requests where bot detection analysis was performed.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_content_fetcher_count</td>\n<td>integer</td>\n<td>Count of edge requests where a content fetcher was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_detected_count</td>\n<td>integer</td>\n<td>Count of edge requests where a bot was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_monitoring_count</td>\n<td>integer</td>\n<td>Count of edge requests where a monitoring and site tool was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_online_marketing_count</td>\n<td>integer</td>\n<td>Count of edge requests where an online marketing bot was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_page_preview_count</td>\n<td>integer</td>\n<td>Count of edge requests where a page preview bot was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_platform_integrations_count</td>\n<td>integer</td>\n<td>Count of edge requests where a platform integration was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_research_count</td>\n<td>integer</td>\n<td>Count of edge requests where a research bot was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_search_engine_crawler_count</td>\n<td>integer</td>\n<td>Count of edge requests where a search engine crawler was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_search_engine_optimization_count</td>\n<td>integer</td>\n<td>Count of edge requests where a search engine optimization bot was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_security_tools_count</td>\n<td>integer</td>\n<td>Count of edge requests where a security tool was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_verified_count</td>\n<td>integer</td>\n<td>Count of edge requests where a verified bot was detected.</td>\n</tr>\n<tr>\n<td>bot_requests_total_count</td>\n<td>integer</td>\n<td>Total number of Bot Management requests across all deployments.</td>\n</tr>\n<tr>\n<td>compute_bereq_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes sent to backends (origins) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_bereq_errors</td>\n<td>integer</td>\n<td>Number of backend request errors, including timeouts.</td>\n</tr>\n<tr>\n<td>compute_bereq_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes sent to backends (origins) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_bereqs</td>\n<td>integer</td>\n<td>Number of backend requests started.</td>\n</tr>\n<tr>\n<td>compute_beresp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes received from backends (origins) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_beresp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received from backends (origins) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_cache_operations_count</td>\n<td>integer</td>\n<td>Number of cache operations executed by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_execution_time_ms</td>\n<td>number</td>\n<td>The amount of active CPU time used to process your requests (in milliseconds).</td>\n</tr>\n<tr>\n<td>compute_globals_limit_exceeded</td>\n<td>integer</td>\n<td>Number of times a guest exceeded its globals limit.</td>\n</tr>\n<tr>\n<td>compute_guest_errors</td>\n<td>integer</td>\n<td>Number of times a service experienced a guest code error.</td>\n</tr>\n<tr>\n<td>compute_handoff</td>\n<td>integer</td>\n<td>The number of times Compute has handed off a request to the Fanout proxy or WebSocket proxy.</td>\n</tr>\n<tr>\n<td>compute_heap_limit_exceeded</td>\n<td>integer</td>\n<td>Number of times a guest exceeded its heap limit.</td>\n</tr>\n<tr>\n<td>compute_platform_internal_error</td>\n<td>integer</td>\n<td>Fatal errors caused by internal errors in Fastly’s Compute platform.</td>\n</tr>\n<tr>\n<td>compute_platform_invalid_request_error</td>\n<td>integer</td>\n<td>Fatal errors caused by unprocessable requests to the service, such as requests with malformed CDN-Loop headers or invalid purge credentials.</td>\n</tr>\n<tr>\n<td>compute_ram_used</td>\n<td>integer</td>\n<td>The amount of RAM used for your service by Fastly (in bytes).</td>\n</tr>\n<tr>\n<td>compute_req_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_req_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_request_time_billed_ms</td>\n<td>number</td>\n<td>The total amount of request processing time you will be billed for, measured in 50 millisecond increments.</td>\n</tr>\n<tr>\n<td>compute_request_time_ms</td>\n<td>number</td>\n<td>The total, actual amount of time used to process your requests, including active CPU time (in milliseconds).</td>\n</tr>\n<tr>\n<td>compute_requests</td>\n<td>integer</td>\n<td>The total number of requests that were received for your service by Fastly.</td>\n</tr>\n<tr>\n<td>compute_resource_limit_exceeded</td>\n<td>integer</td>\n<td>Number of times a guest exceeded its resource limit, includes heap, stack, globals, and code execution timeout.</td>\n</tr>\n<tr>\n<td>compute_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes sent from Compute to end user.</td>\n</tr>\n<tr>\n<td>compute_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes sent from Compute to end user.</td>\n</tr>\n<tr>\n<td>compute_resp_status_103</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 103 (Early Hints) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_1xx</td>\n<td>integer</td>\n<td>Number of \"Informational\" category status codes delivered by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_200</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 200 (Success) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_204</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 204 (No Content) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_206</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 206 (Partial Content) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_2xx</td>\n<td>integer</td>\n<td>Number of \"Success\" category status codes delivered by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_301</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 301 (Moved Permanently) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_302</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 302 (Found) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_304</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 304 (Not Modified) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_3xx</td>\n<td>integer</td>\n<td>Number of \"Redirection\" category status codes delivered by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_400</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 400 (Bad Request) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_401</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 401 (Unauthorized) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_403</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 403 (Forbidden) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_404</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 404 (Not Found) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_416</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 416 (Range Not Satisfiable) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_429</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 429 (Too Many Requests) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_4xx</td>\n<td>integer</td>\n<td>Number of \"Client Error\" category status codes delivered by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_500</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 500 (Internal Server Error) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_501</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 501 (Not Implemented) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_502</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 502 (Bad Gateway) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_503</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 503 (Service Unavailable) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_504</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 504 (Gateway Timeout) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_505</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 505 (HTTP Version Not Supported) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_530</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 530 by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_5xx</td>\n<td>integer</td>\n<td>Number of \"Server Error\" category status codes delivered by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_runtime_errors</td>\n<td>integer</td>\n<td>Number of times a service experienced a guest runtime error.</td>\n</tr>\n<tr>\n<td>compute_sandboxes</td>\n<td>integer</td>\n<td>Number of WebAssembly (Wasm) sandboxes created.</td>\n</tr>\n<tr>\n<td>compute_service_bereq_error</td>\n<td>integer</td>\n<td>Number of backend request errors, including timeouts.</td>\n</tr>\n<tr>\n<td>compute_service_chain_error</td>\n<td>integer</td>\n<td>Fatal errors caused by the service path exceeding hop or service limits, or where a forwarding loop is detected via CDN-Loop headers.</td>\n</tr>\n<tr>\n<td>compute_service_limits_error</td>\n<td>integer</td>\n<td>Non-fatal errors caused by attempts to exceed defined operational limits, such as simultaneous backend requests or cache transactions.</td>\n</tr>\n<tr>\n<td>compute_service_memory_exceeded_error</td>\n<td>integer</td>\n<td>Number of times a guest exceeded its heap limit.</td>\n</tr>\n<tr>\n<td>compute_service_resource_limits_error</td>\n<td>integer</td>\n<td>Aggregate of fatal errors caused by exceeding allocated resource limits, specifically runtime duration, vCPU usage, and heap memory limits.</td>\n</tr>\n<tr>\n<td>compute_service_runtime_error</td>\n<td>integer</td>\n<td>Fatal errors caused by service logic faults, including stack overflows, unreachable code traps, illegal memory access, or attempts to send multiple responses.</td>\n</tr>\n<tr>\n<td>compute_service_timeout_error</td>\n<td>integer</td>\n<td>Fatal errors caused by exceeding the per-request runtime limit.</td>\n</tr>\n<tr>\n<td>compute_service_vcpu_exceeded_error</td>\n<td>integer</td>\n<td>Fatal errors caused by exceeding the per-request vCPU time limit.</td>\n</tr>\n<tr>\n<td>compute_stack_limit_exceeded</td>\n<td>integer</td>\n<td>Number of times a guest exceeded its stack limit.</td>\n</tr>\n<tr>\n<td>ddos_action_blackhole</td>\n<td>integer</td>\n<td>The number of times the blackhole action was taken. The blackhole action quietly closes a TCP connection without sending a reset. The blackhole action quietly closes a TCP connection without notifying its peer (all TCP state is dropped).</td>\n</tr>\n<tr>\n<td>ddos_action_close</td>\n<td>integer</td>\n<td>The number of times the close action was taken. The close action aborts the connection as soon as possible. The close action takes effect either right after accept, right after the client hello, or right after the response was sent.</td>\n</tr>\n<tr>\n<td>ddos_action_downgrade</td>\n<td>integer</td>\n<td>The number of times the downgrade action was taken. The downgrade action restricts the client to http1.</td>\n</tr>\n<tr>\n<td>ddos_action_downgraded_connections</td>\n<td>integer</td>\n<td>The number of connections the downgrade action was applied to. The downgrade action restricts the connection to http1.</td>\n</tr>\n<tr>\n<td>ddos_action_limit_streams_connections</td>\n<td>integer</td>\n<td>For HTTP/2, the number of connections the limit-streams action was applied to. The limit-streams action caps the allowed number of concurrent streams in a connection.</td>\n</tr>\n<tr>\n<td>ddos_action_limit_streams_requests</td>\n<td>integer</td>\n<td>For HTTP/2, the number of requests made on a connection for which the limit-streams action was taken. The limit-streams action caps the allowed number of concurrent streams in a connection.</td>\n</tr>\n<tr>\n<td>ddos_action_tarpit</td>\n<td>integer</td>\n<td>The number of times the tarpit action was taken. The tarpit action delays writing the response to the client.</td>\n</tr>\n<tr>\n<td>ddos_action_tarpit_accept</td>\n<td>integer</td>\n<td>The number of times the tarpit-accept action was taken. The tarpit-accept action adds a delay when accepting future connections.</td>\n</tr>\n<tr>\n<td>ddos_protection_requests_allow_count</td>\n<td>integer</td>\n<td>Number of requests analyzed for DDoS attacks against a customer origin or service, but with no DDoS detected.</td>\n</tr>\n<tr>\n<td>ddos_protection_requests_detect_count</td>\n<td>integer</td>\n<td>Number of requests classified as a DDoS attack against a customer origin or service.</td>\n</tr>\n<tr>\n<td>ddos_protection_requests_mitigate_count</td>\n<td>integer</td>\n<td>Number of requests classified as a DDoS attack against a customer origin or service that were mitigated by the Fastly platform.</td>\n</tr>\n<tr>\n<td>deliver_sub_count</td>\n<td>integer</td>\n<td>Number of executions of the vcl_deliver Varnish subroutine.</td>\n</tr>\n<tr>\n<td>deliver_sub_time</td>\n<td>number</td>\n<td>Time spent inside the vcl_deliver Varnish subroutine (in nanoseconds).</td>\n</tr>\n<tr>\n<td>dns_billable_responses_count</td>\n<td>integer</td>\n<td>Number of billable DNS responses (e.g., A, CNAME).</td>\n</tr>\n<tr>\n<td>dns_nonbillable_responses_count</td>\n<td>integer</td>\n<td>Number of non-billable DNS responses (e.g., NODATA, NXDOMAIN).</td>\n</tr>\n<tr>\n<td>edge_hit_requests</td>\n<td>integer</td>\n<td>Number of requests sent by end users to Fastly that resulted in a hit at the edge.</td>\n</tr>\n<tr>\n<td>edge_hit_resp_body_bytes</td>\n<td>integer</td>\n<td>Body bytes delivered for edge hits.</td>\n</tr>\n<tr>\n<td>edge_hit_resp_header_bytes</td>\n<td>integer</td>\n<td>Header bytes delivered for edge hits.</td>\n</tr>\n<tr>\n<td>edge_miss_requests</td>\n<td>integer</td>\n<td>Number of requests sent by end users to Fastly that resulted in a miss at the edge.</td>\n</tr>\n<tr>\n<td>edge_miss_resp_body_bytes</td>\n<td>integer</td>\n<td>Body bytes delivered for edge misses.</td>\n</tr>\n<tr>\n<td>edge_miss_resp_header_bytes</td>\n<td>integer</td>\n<td>Header bytes delivered for edge misses.</td>\n</tr>\n<tr>\n<td>edge_requests</td>\n<td>integer</td>\n<td>Number of requests sent by end users to Fastly.</td>\n</tr>\n<tr>\n<td>edge_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes delivered from Fastly to the end user.</td>\n</tr>\n<tr>\n<td>edge_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes delivered from Fastly to the end user.</td>\n</tr>\n<tr>\n<td>error_sub_count</td>\n<td>integer</td>\n<td>Number of executions of the vcl_error Varnish subroutine.</td>\n</tr>\n<tr>\n<td>error_sub_time</td>\n<td>number</td>\n<td>Time spent inside the vcl_error Varnish subroutine (in nanoseconds).</td>\n</tr>\n<tr>\n<td>errors</td>\n<td>integer</td>\n<td>Number of cache errors.</td>\n</tr>\n<tr>\n<td>fanout_bereq_body_bytes</td>\n<td>integer</td>\n<td>Total body or message content bytes sent to backends over Fanout connections.</td>\n</tr>\n<tr>\n<td>fanout_bereq_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes sent to backends over Fanout connections.</td>\n</tr>\n<tr>\n<td>fanout_beresp_body_bytes</td>\n<td>integer</td>\n<td>Total body or message content bytes received from backends over Fanout connections.</td>\n</tr>\n<tr>\n<td>fanout_beresp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received from backends over Fanout connections.</td>\n</tr>\n<tr>\n<td>fanout_conn_time_ms</td>\n<td>integer</td>\n<td>Total duration of Fanout connections with end users.</td>\n</tr>\n<tr>\n<td>fanout_recv_publishes</td>\n<td>integer</td>\n<td>Total published messages received from the publish API endpoint.</td>\n</tr>\n<tr>\n<td>fanout_req_body_bytes</td>\n<td>integer</td>\n<td>Total body or message content bytes received from end users over Fanout connections.</td>\n</tr>\n<tr>\n<td>fanout_req_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received from end users over Fanout connections.</td>\n</tr>\n<tr>\n<td>fanout_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body or message content bytes sent to end users over Fanout connections, excluding published message content.</td>\n</tr>\n<tr>\n<td>fanout_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes sent to end users over Fanout connections.</td>\n</tr>\n<tr>\n<td>fanout_send_publishes</td>\n<td>integer</td>\n<td>Total published messages sent to end users.</td>\n</tr>\n<tr>\n<td>fetch_sub_count</td>\n<td>integer</td>\n<td>Number of executions of the vcl_fetch Varnish subroutine.</td>\n</tr>\n<tr>\n<td>fetch_sub_time</td>\n<td>number</td>\n<td>Time spent inside the vcl_fetch Varnish subroutine (in nanoseconds).</td>\n</tr>\n<tr>\n<td>hash_sub_count</td>\n<td>integer</td>\n<td>Number of executions of the vcl_hash Varnish subroutine.</td>\n</tr>\n<tr>\n<td>hash_sub_time</td>\n<td>number</td>\n<td>Time spent inside the vcl_hash Varnish subroutine (in nanoseconds).</td>\n</tr>\n<tr>\n<td>header_size</td>\n<td>integer</td>\n<td>Total header bytes delivered (alias for resp_header_bytes).</td>\n</tr>\n<tr>\n<td>hit_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes delivered for cache hits.</td>\n</tr>\n<tr>\n<td>hit_sub_count</td>\n<td>integer</td>\n<td>Number of executions of the vcl_hit Varnish subroutine.</td>\n</tr>\n<tr>\n<td>hit_sub_time</td>\n<td>number</td>\n<td>Time spent inside the vcl_hit Varnish subroutine (in nanoseconds).</td>\n</tr>\n<tr>\n<td>hits</td>\n<td>integer</td>\n<td>Number of cache hits.</td>\n</tr>\n<tr>\n<td>hits_time</td>\n<td>number</td>\n<td>Total amount of time spent processing cache hits (in seconds).</td>\n</tr>\n<tr>\n<td>http2</td>\n<td>integer</td>\n<td>Number of requests received over HTTP/2.</td>\n</tr>\n<tr>\n<td>http3</td>\n<td>integer</td>\n<td>Number of requests received over HTTP/3.</td>\n</tr>\n<tr>\n<td>imgopto</td>\n<td>integer</td>\n<td>Number of responses that came from the Fastly Image Optimizer service. If the service receives 10 requests for an image, this stat will be 10 regardless of how many times the image was transformed.</td>\n</tr>\n<tr>\n<td>imgopto_avif_count</td>\n<td>integer</td>\n<td>Count of AVIF images delivered to end user by Image Optimizer.</td>\n</tr>\n<tr>\n<td>imgopto_compute_requests</td>\n<td>integer</td>\n<td>The number of Image Optimizer requests made from Compute services.</td>\n</tr>\n<tr>\n<td>imgopto_gif_count</td>\n<td>integer</td>\n<td>Count of GIF images delivered to end user by Image Optimizer.</td>\n</tr>\n<tr>\n<td>imgopto_jpeg_count</td>\n<td>integer</td>\n<td>Count of JPEG images delivered to end user by Image Optimizer.</td>\n</tr>\n<tr>\n<td>imgopto_jpegxl_count</td>\n<td>integer</td>\n<td>Count of JPEGXL images delivered to end user by Image Optimizer.</td>\n</tr>\n<tr>\n<td>imgopto_mp4_count</td>\n<td>integer</td>\n<td>Count of MP4s delivered to end user by Image Optimizer.</td>\n</tr>\n<tr>\n<td>imgopto_png_count</td>\n<td>integer</td>\n<td>Count of PNG images delivered to end user by Image Optimizer.</td>\n</tr>\n<tr>\n<td>imgopto_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes delivered from the Fastly Image Optimizer service, including shield traffic.</td>\n</tr>\n<tr>\n<td>imgopto_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes delivered from the Fastly Image Optimizer service, including shield traffic.</td>\n</tr>\n<tr>\n<td>imgopto_shield</td>\n<td>integer</td>\n<td>Number of responses that came from the Fastly Image Optimizer service via a shield.</td>\n</tr>\n<tr>\n<td>imgopto_shield_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes delivered via a shield from the Fastly Image Optimizer service.</td>\n</tr>\n<tr>\n<td>imgopto_shield_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes delivered via a shield from the Fastly Image Optimizer service.</td>\n</tr>\n<tr>\n<td>imgopto_svg_count</td>\n<td>integer</td>\n<td>Count of SVG images delivered to end user by Image Optimizer.</td>\n</tr>\n<tr>\n<td>imgopto_transforms</td>\n<td>integer</td>\n<td>Number of transforms performed by the Fastly Image Optimizer service.</td>\n</tr>\n<tr>\n<td>imgopto_webp_count</td>\n<td>integer</td>\n<td>Count of WebP images delivered to end user by Image Optimizer.</td>\n</tr>\n<tr>\n<td>imgvideo</td>\n<td>integer</td>\n<td>Number of video responses that came from the Fastly Image Optimizer service.</td>\n</tr>\n<tr>\n<td>imgvideo_frames</td>\n<td>integer</td>\n<td>Number of video frames that came from the Fastly Image Optimizer service. A video frame is an individual image within a sequence of video.</td>\n</tr>\n<tr>\n<td>imgvideo_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes of video delivered from the Fastly Image Optimizer service.</td>\n</tr>\n<tr>\n<td>imgvideo_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes of video delivered from the Fastly Image Optimizer service.</td>\n</tr>\n<tr>\n<td>imgvideo_shield</td>\n<td>integer</td>\n<td>Number of video responses delivered via a shield that came from the Fastly Image Optimizer service.</td>\n</tr>\n<tr>\n<td>imgvideo_shield_frames</td>\n<td>integer</td>\n<td>Number of video frames delivered via a shield that came from the Fastly Image Optimizer service. A video frame is an individual image within a sequence of video.</td>\n</tr>\n<tr>\n<td>imgvideo_shield_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes of video delivered via a shield from the Fastly Image Optimizer service.</td>\n</tr>\n<tr>\n<td>imgvideo_shield_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes of video delivered via a shield from the Fastly Image Optimizer service.</td>\n</tr>\n<tr>\n<td>ipv6</td>\n<td>integer</td>\n<td>Number of requests that were received over IPv6.</td>\n</tr>\n<tr>\n<td>kv_store_class_a_operations</td>\n<td>integer</td>\n<td>The total number of class a operations for the KV store.</td>\n</tr>\n<tr>\n<td>kv_store_class_b_operations</td>\n<td>integer</td>\n<td>The total number of class b operations for the KV store.</td>\n</tr>\n<tr>\n<td>log</td>\n<td>integer</td>\n<td>Number of log lines sent.</td>\n</tr>\n<tr>\n<td>log_bytes</td>\n<td>integer</td>\n<td>Total log bytes sent.</td>\n</tr>\n<tr>\n<td>logging</td>\n<td>integer</td>\n<td>Number of log lines sent (alias for log).</td>\n</tr>\n<tr>\n<td>miss</td>\n<td>integer</td>\n<td>Number of cache misses.</td>\n</tr>\n<tr>\n<td>miss_histogram</td>\n<td>object</td>\n<td>A histogram. The value in each bucket is the number of requests to the origin whose responses arrived during the time period represented by the bucket. The key of each bucket represents the upper bound (in response time) of that bucket. The buckets vary in width and cover the time periods 0-10ms (in 1ms increments), 10-250ms (in 10ms increments), 250-1,000ms (in 50ms increments), 1,000-3,000ms (in 100ms increments), 3,000-10,000ms (in 500 ms increments), 10,000-20,000ms (in 1,000ms increments), 20,000-60,000ms (in 5,000ms increments), and 60,000ms through infinity (in a single bucket).</td>\n</tr>\n<tr>\n<td>miss_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes delivered for cache misses.</td>\n</tr>\n<tr>\n<td>miss_sub_count</td>\n<td>integer</td>\n<td>Number of executions of the vcl_miss Varnish subroutine.</td>\n</tr>\n<tr>\n<td>miss_sub_time</td>\n<td>number</td>\n<td>Time spent inside the vcl_miss Varnish subroutine (in nanoseconds).</td>\n</tr>\n<tr>\n<td>miss_time</td>\n<td>number</td>\n<td>Total amount of time spent processing cache misses (in seconds).</td>\n</tr>\n<tr>\n<td>ngwaf_bot_analysis_request_count</td>\n<td>integer</td>\n<td>Count of Next-Gen WAF Bot Management requests.</td>\n</tr>\n<tr>\n<td>object_size_100k</td>\n<td>integer</td>\n<td>Number of objects served that were between 10KB and 100KB in size.</td>\n</tr>\n<tr>\n<td>object_size_100m</td>\n<td>integer</td>\n<td>Number of objects served that were between 10MB and 100MB in size.</td>\n</tr>\n<tr>\n<td>object_size_10k</td>\n<td>integer</td>\n<td>Number of objects served that were between 1KB and 10KB in size.</td>\n</tr>\n<tr>\n<td>object_size_10m</td>\n<td>integer</td>\n<td>Number of objects served that were between 1MB and 10MB in size.</td>\n</tr>\n<tr>\n<td>object_size_1g</td>\n<td>integer</td>\n<td>Number of objects served that were between 100MB and 1GB in size.</td>\n</tr>\n<tr>\n<td>object_size_1k</td>\n<td>integer</td>\n<td>Number of objects served that were under 1KB in size.</td>\n</tr>\n<tr>\n<td>object_size_1m</td>\n<td>integer</td>\n<td>Number of objects served that were between 100KB and 1MB in size.</td>\n</tr>\n<tr>\n<td>object_size_other</td>\n<td>integer</td>\n<td>Number of objects served that were larger than 1GB in size.</td>\n</tr>\n<tr>\n<td>object_storage_class_a_operations_count</td>\n<td>integer</td>\n<td>A count of the number of Class A Object Storage operations.</td>\n</tr>\n<tr>\n<td>object_storage_class_b_operations_count</td>\n<td>integer</td>\n<td>A count of the number of Class B Object Storage operations.</td>\n</tr>\n<tr>\n<td>object_store_class_a_operations</td>\n<td>integer</td>\n<td>Use kv_store_class_a_operations.</td>\n</tr>\n<tr>\n<td>object_store_class_b_operations</td>\n<td>integer</td>\n<td>Use kv_store_class_b_operations.</td>\n</tr>\n<tr>\n<td>origin_cache_fetch_resp_body_bytes</td>\n<td>integer</td>\n<td>Body bytes received from origin for cacheable content.</td>\n</tr>\n<tr>\n<td>origin_cache_fetch_resp_header_bytes</td>\n<td>integer</td>\n<td>Header bytes received from an origin for cacheable content.</td>\n</tr>\n<tr>\n<td>origin_cache_fetches</td>\n<td>integer</td>\n<td>The total number of completed requests made to backends (origins) that returned cacheable content.</td>\n</tr>\n<tr>\n<td>origin_fetch_body_bytes</td>\n<td>integer</td>\n<td>Total request body bytes sent to origin.</td>\n</tr>\n<tr>\n<td>origin_fetch_header_bytes</td>\n<td>integer</td>\n<td>Total request header bytes sent to origin.</td>\n</tr>\n<tr>\n<td>origin_fetch_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes received from origin.</td>\n</tr>\n<tr>\n<td>origin_fetch_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received from origin.</td>\n</tr>\n<tr>\n<td>origin_fetches</td>\n<td>integer</td>\n<td>Number of requests sent to origin.</td>\n</tr>\n<tr>\n<td>origin_offload</td>\n<td>number</td>\n<td>Origin Offload measures the ratio of bytes served to end users that were cached by Fastly, over the bytes served to end users, between 0 and 1. ((edge_resp_body_bytes + edge_resp_header_bytes) - (origin_fetch_resp_body_bytes + origin_fetch_resp_header_bytes)) / (edge_resp_body_bytes + edge_resp_header_bytes).</td>\n</tr>\n<tr>\n<td>origin_revalidations</td>\n<td>integer</td>\n<td>Number of responses received from origin with a 304 status code in response to an If-Modified-Since or If-None-Match request. Under regular scenarios, a revalidation will imply a cache hit. However, if using Fastly Image Optimizer or segmented caching this may result in a cache miss.</td>\n</tr>\n<tr>\n<td>otfp</td>\n<td>integer</td>\n<td>Number of responses that came from the Fastly On-the-Fly Packaging service for video-on-demand.</td>\n</tr>\n<tr>\n<td>otfp_deliver_time</td>\n<td>number</td>\n<td>Total amount of time spent delivering a response from the Fastly On-the-Fly Packaging service for video-on-demand (in seconds).</td>\n</tr>\n<tr>\n<td>otfp_manifests</td>\n<td>integer</td>\n<td>Number of responses that were manifest files from the Fastly On-the-Fly Packaging service for video-on-demand.</td>\n</tr>\n<tr>\n<td>otfp_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes delivered from the Fastly On-the-Fly Packaging service for video-on-demand.</td>\n</tr>\n<tr>\n<td>otfp_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes delivered from the Fastly On-the-Fly Packaging service for video-on-demand.</td>\n</tr>\n<tr>\n<td>otfp_shield</td>\n<td>integer</td>\n<td>Number of responses that came from the Fastly On-the-Fly Packaging service for video-on-demand via a shield.</td>\n</tr>\n<tr>\n<td>otfp_shield_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes delivered via a shield for the Fastly On-the-Fly Packaging service for video-on-demand.</td>\n</tr>\n<tr>\n<td>otfp_shield_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes delivered via a shield for the Fastly On-the-Fly Packaging service for video-on-demand.</td>\n</tr>\n<tr>\n<td>otfp_shield_time</td>\n<td>number</td>\n<td>Total amount of time spent delivering a response via a shield from the Fastly On-the-Fly Packaging service for video-on-demand (in seconds).</td>\n</tr>\n<tr>\n<td>pass</td>\n<td>integer</td>\n<td>Number of requests that passed through the CDN without being cached.</td>\n</tr>\n<tr>\n<td>pass_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes delivered for cache passes.</td>\n</tr>\n<tr>\n<td>pass_sub_count</td>\n<td>integer</td>\n<td>Number of executions of the vcl_pass Varnish subroutine.</td>\n</tr>\n<tr>\n<td>pass_sub_time</td>\n<td>number</td>\n<td>Time spent inside the vcl_pass Varnish subroutine (in nanoseconds).</td>\n</tr>\n<tr>\n<td>pass_time</td>\n<td>number</td>\n<td>Total amount of time spent processing cache passes (in seconds).</td>\n</tr>\n<tr>\n<td>pci</td>\n<td>integer</td>\n<td>Number of responses with the PCI flag turned on.</td>\n</tr>\n<tr>\n<td>pipe_sub_count</td>\n<td>integer</td>\n<td>Number of executions of the vcl_pipe Varnish subroutine.</td>\n</tr>\n<tr>\n<td>pipe_sub_time</td>\n<td>number</td>\n<td>Time spent inside the vcl_pipe Varnish subroutine (in nanoseconds).</td>\n</tr>\n<tr>\n<td>predeliver_sub_count</td>\n<td>integer</td>\n<td>Number of executions of the vcl_predeliver Varnish subroutine.</td>\n</tr>\n<tr>\n<td>predeliver_sub_time</td>\n<td>number</td>\n<td>Time spent inside the vcl_predeliver Varnish subroutine (in nanoseconds).</td>\n</tr>\n<tr>\n<td>prehash_sub_count</td>\n<td>integer</td>\n<td>Number of executions of the vcl_prehash Varnish subroutine.</td>\n</tr>\n<tr>\n<td>prehash_sub_time</td>\n<td>number</td>\n<td>Time spent inside the vcl_prehash Varnish subroutine (in nanoseconds).</td>\n</tr>\n<tr>\n<td>recv_sub_count</td>\n<td>integer</td>\n<td>Number of executions of the vcl_recv Varnish subroutine.</td>\n</tr>\n<tr>\n<td>recv_sub_time</td>\n<td>number</td>\n<td>Time spent inside the vcl_recv Varnish subroutine (in nanoseconds).</td>\n</tr>\n<tr>\n<td>req_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes received.</td>\n</tr>\n<tr>\n<td>req_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received.</td>\n</tr>\n<tr>\n<td>request_collapse_unusable_count</td>\n<td>integer</td>\n<td>Number of requests that were collapsed and unable to be satisfied by the resulting cache object.</td>\n</tr>\n<tr>\n<td>request_collapse_usable_count</td>\n<td>integer</td>\n<td>Number of requests that were collapsed and satisfied by a usable cache object.</td>\n</tr>\n<tr>\n<td>request_denied_get_head_body</td>\n<td>integer</td>\n<td>Number of requests where Fastly responded with 400 due to the request being a GET or HEAD request containing a body.</td>\n</tr>\n<tr>\n<td>requests</td>\n<td>integer</td>\n<td>Number of requests processed.</td>\n</tr>\n<tr>\n<td>resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes delivered (edge_resp_body_bytes + shield_resp_body_bytes).</td>\n</tr>\n<tr>\n<td>resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes delivered (edge_resp_header_bytes + shield_resp_header_bytes).</td>\n</tr>\n<tr>\n<td>restarts</td>\n<td>integer</td>\n<td>Number of restarts performed.</td>\n</tr>\n<tr>\n<td>segblock_origin_fetches</td>\n<td>integer</td>\n<td>Number of Range requests to origin for segments of resources when using segmented caching.</td>\n</tr>\n<tr>\n<td>segblock_shield_fetches</td>\n<td>integer</td>\n<td>Number of Range requests to a shield for segments of resources when using segmented caching.</td>\n</tr>\n<tr>\n<td>shield</td>\n<td>integer</td>\n<td>Number of requests from edge to the shield POP.</td>\n</tr>\n<tr>\n<td>shield_cache_fetches</td>\n<td>integer</td>\n<td>The total number of completed requests made to shields that returned cacheable content.</td>\n</tr>\n<tr>\n<td>shield_fetch_body_bytes</td>\n<td>integer</td>\n<td>Total request body bytes sent to a shield.</td>\n</tr>\n<tr>\n<td>shield_fetch_header_bytes</td>\n<td>integer</td>\n<td>Total request header bytes sent to a shield.</td>\n</tr>\n<tr>\n<td>shield_fetch_resp_body_bytes</td>\n<td>integer</td>\n<td>Total response body bytes sent from a shield to the edge.</td>\n</tr>\n<tr>\n<td>shield_fetch_resp_header_bytes</td>\n<td>integer</td>\n<td>Total response header bytes sent from a shield to the edge.</td>\n</tr>\n<tr>\n<td>shield_fetches</td>\n<td>integer</td>\n<td>Number of requests made from one Fastly POP to another, as part of shielding.</td>\n</tr>\n<tr>\n<td>shield_hit_requests</td>\n<td>integer</td>\n<td>Number of requests that resulted in a hit at a shield.</td>\n</tr>\n<tr>\n<td>shield_hit_resp_body_bytes</td>\n<td>integer</td>\n<td>Body bytes delivered for shield hits.</td>\n</tr>\n<tr>\n<td>shield_hit_resp_header_bytes</td>\n<td>integer</td>\n<td>Header bytes delivered for shield hits.</td>\n</tr>\n<tr>\n<td>shield_miss_requests</td>\n<td>integer</td>\n<td>Number of requests that resulted in a miss at a shield.</td>\n</tr>\n<tr>\n<td>shield_miss_resp_body_bytes</td>\n<td>integer</td>\n<td>Body bytes delivered for shield misses.</td>\n</tr>\n<tr>\n<td>shield_miss_resp_header_bytes</td>\n<td>integer</td>\n<td>Header bytes delivered for shield misses.</td>\n</tr>\n<tr>\n<td>shield_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes delivered via a shield.</td>\n</tr>\n<tr>\n<td>shield_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes delivered via a shield.</td>\n</tr>\n<tr>\n<td>shield_revalidations</td>\n<td>integer</td>\n<td>Number of responses received from origin with a 304 status code, in response to an If-Modified-Since or If-None-Match request to a shield. Under regular scenarios, a revalidation will imply a cache hit. However, if using segmented caching this may result in a cache miss.</td>\n</tr>\n<tr>\n<td>status_1xx</td>\n<td>integer</td>\n<td>Number of \"Informational\" category status codes delivered.</td>\n</tr>\n<tr>\n<td>status_200</td>\n<td>integer</td>\n<td>Number of responses sent with status code 200 (Success).</td>\n</tr>\n<tr>\n<td>status_204</td>\n<td>integer</td>\n<td>Number of responses sent with status code 204 (No Content).</td>\n</tr>\n<tr>\n<td>status_206</td>\n<td>integer</td>\n<td>Number of responses sent with status code 206 (Partial Content).</td>\n</tr>\n<tr>\n<td>status_2xx</td>\n<td>integer</td>\n<td>Number of \"Success\" status codes delivered.</td>\n</tr>\n<tr>\n<td>status_301</td>\n<td>integer</td>\n<td>Number of responses sent with status code 301 (Moved Permanently).</td>\n</tr>\n<tr>\n<td>status_302</td>\n<td>integer</td>\n<td>Number of responses sent with status code 302 (Found).</td>\n</tr>\n<tr>\n<td>status_304</td>\n<td>integer</td>\n<td>Number of responses sent with status code 304 (Not Modified).</td>\n</tr>\n<tr>\n<td>status_3xx</td>\n<td>integer</td>\n<td>Number of \"Redirection\" codes delivered.</td>\n</tr>\n<tr>\n<td>status_400</td>\n<td>integer</td>\n<td>Number of responses sent with status code 400 (Bad Request).</td>\n</tr>\n<tr>\n<td>status_401</td>\n<td>integer</td>\n<td>Number of responses sent with status code 401 (Unauthorized).</td>\n</tr>\n<tr>\n<td>status_403</td>\n<td>integer</td>\n<td>Number of responses sent with status code 403 (Forbidden).</td>\n</tr>\n<tr>\n<td>status_404</td>\n<td>integer</td>\n<td>Number of responses sent with status code 404 (Not Found).</td>\n</tr>\n<tr>\n<td>status_406</td>\n<td>integer</td>\n<td>Number of responses sent with status code 406 (Not Acceptable).</td>\n</tr>\n<tr>\n<td>status_416</td>\n<td>integer</td>\n<td>Number of responses sent with status code 416 (Range Not Satisfiable).</td>\n</tr>\n<tr>\n<td>status_429</td>\n<td>integer</td>\n<td>Number of responses sent with status code 429 (Too Many Requests).</td>\n</tr>\n<tr>\n<td>status_4xx</td>\n<td>integer</td>\n<td>Number of \"Client Error\" codes delivered.</td>\n</tr>\n<tr>\n<td>status_500</td>\n<td>integer</td>\n<td>Number of responses sent with status code 500 (Internal Server Error).</td>\n</tr>\n<tr>\n<td>status_501</td>\n<td>integer</td>\n<td>Number of responses sent with status code 501 (Not Implemented).</td>\n</tr>\n<tr>\n<td>status_502</td>\n<td>integer</td>\n<td>Number of responses sent with status code 502 (Bad Gateway).</td>\n</tr>\n<tr>\n<td>status_503</td>\n<td>integer</td>\n<td>Number of responses sent with status code 503 (Service Unavailable).</td>\n</tr>\n<tr>\n<td>status_504</td>\n<td>integer</td>\n<td>Number of responses sent with status code 504 (Gateway Timeout).</td>\n</tr>\n<tr>\n<td>status_505</td>\n<td>integer</td>\n<td>Number of responses sent with status code 505 (HTTP Version Not Supported).</td>\n</tr>\n<tr>\n<td>status_530</td>\n<td>integer</td>\n<td>Number of responses sent with status code 530.</td>\n</tr>\n<tr>\n<td>status_5xx</td>\n<td>integer</td>\n<td>Number of \"Server Error\" codes delivered.</td>\n</tr>\n<tr>\n<td>synth</td>\n<td>integer</td>\n<td>Number of requests that returned a synthetic response (i.e., response objects created with the synthetic VCL statement).</td>\n</tr>\n<tr>\n<td>tls</td>\n<td>integer</td>\n<td>Number of requests that were received over TLS.</td>\n</tr>\n<tr>\n<td>tls_v10</td>\n<td>integer</td>\n<td>Number of requests received over TLS 1.0.</td>\n</tr>\n<tr>\n<td>tls_v11</td>\n<td>integer</td>\n<td>Number of requests received over TLS 1.1.</td>\n</tr>\n<tr>\n<td>tls_v12</td>\n<td>integer</td>\n<td>Number of requests received over TLS 1.2.</td>\n</tr>\n<tr>\n<td>tls_v13</td>\n<td>integer</td>\n<td>Number of requests received over TLS 1.3.</td>\n</tr>\n<tr>\n<td>uncacheable</td>\n<td>integer</td>\n<td>Number of requests that were designated uncachable.</td>\n</tr>\n<tr>\n<td>upgrade</td>\n<td>integer</td>\n<td>Number of requests that resulted in a WebSocket upgrade.</td>\n</tr>\n<tr>\n<td>video</td>\n<td>integer</td>\n<td>Number of responses with the video segment or video manifest MIME type (i.e., application/x-mpegurl, application/vnd.apple.mpegurl, application/f4m, application/dash+xml, application/vnd.ms-sstr+xml, ideo/mp2t, audio/aac, video/f4f, video/x-flv, video/mp4, audio/mp4).</td>\n</tr>\n<tr>\n<td>websocket_bereq_body_bytes</td>\n<td>integer</td>\n<td>Total message content bytes sent to backends over passthrough WebSocket connections.</td>\n</tr>\n<tr>\n<td>websocket_bereq_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes sent to backends over passthrough WebSocket connections.</td>\n</tr>\n<tr>\n<td>websocket_beresp_body_bytes</td>\n<td>integer</td>\n<td>Total message content bytes received from backends over passthrough WebSocket connections.</td>\n</tr>\n<tr>\n<td>websocket_beresp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received from backends over passthrough WebSocket connections.</td>\n</tr>\n<tr>\n<td>websocket_conn_time_ms</td>\n<td>integer</td>\n<td>Total duration of passthrough WebSocket connections with end users.</td>\n</tr>\n<tr>\n<td>websocket_req_body_bytes</td>\n<td>integer</td>\n<td>Total message content bytes received from end users over passthrough WebSocket connections.</td>\n</tr>\n<tr>\n<td>websocket_req_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received from end users over passthrough WebSocket connections.</td>\n</tr>\n<tr>\n<td>websocket_resp_body_bytes</td>\n<td>integer</td>\n<td>Total message content bytes sent to end users over passthrough WebSocket connections.</td>\n</tr>\n<tr>\n<td>websocket_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes sent to end users over passthrough WebSocket connections.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-4\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>aia_estimated_time_saved_ms</td>\n<td>integer</td>\n<td>The estimated amount of time saved by responses served from the AI Accelerator semantic cache.</td>\n</tr>\n<tr>\n<td>aia_origin_usage_tokens</td>\n<td>integer</td>\n<td>The number of usage tokens reported by the request to the origin from AI Accelerator.</td>\n</tr>\n<tr>\n<td>aia_requests</td>\n<td>integer</td>\n<td>Number of requests received by AI Accelerator.</td>\n</tr>\n<tr>\n<td>aia_response_usage_tokens</td>\n<td>integer</td>\n<td>The usage tokens associated with the response returned from the AI Accelerator cache.</td>\n</tr>\n<tr>\n<td>aia_status_1xx</td>\n<td>integer</td>\n<td>Number of \"Informational\" category status codes received from AI provider.</td>\n</tr>\n<tr>\n<td>aia_status_2xx</td>\n<td>integer</td>\n<td>Number of \"Success\" status codes received from AI provider.</td>\n</tr>\n<tr>\n<td>aia_status_3xx</td>\n<td>integer</td>\n<td>Number of \"Redirection\" received from AI provider.</td>\n</tr>\n<tr>\n<td>aia_status_4xx</td>\n<td>integer</td>\n<td>Number of \"Client Error\" received from AI provider.</td>\n</tr>\n<tr>\n<td>aia_status_5xx</td>\n<td>integer</td>\n<td>Number of \"Server Error\" received from AI provider.</td>\n</tr>\n<tr>\n<td>all_edge_hit_requests</td>\n<td>integer</td>\n<td>Number of requests sent by end users to Fastly that resulted in a hit at the edge for a VCL service.</td>\n</tr>\n<tr>\n<td>all_edge_miss_requests</td>\n<td>integer</td>\n<td>Number of requests sent by end users to Fastly that resulted in a miss at the edge for a VCL service.</td>\n</tr>\n<tr>\n<td>all_error_requests</td>\n<td>integer</td>\n<td>Number of cache errors for a VCL service.</td>\n</tr>\n<tr>\n<td>all_hit_requests</td>\n<td>integer</td>\n<td>Number of cache hits for a VCL service.</td>\n</tr>\n<tr>\n<td>all_miss_requests</td>\n<td>integer</td>\n<td>Number of cache misses for a VCL service.</td>\n</tr>\n<tr>\n<td>all_pass_requests</td>\n<td>integer</td>\n<td>Number of requests that passed through the CDN without being cached for a VCL service.</td>\n</tr>\n<tr>\n<td>all_status_1xx</td>\n<td>integer</td>\n<td>Number of \"Informational\" category status codes delivered for all sources.</td>\n</tr>\n<tr>\n<td>all_status_2xx</td>\n<td>integer</td>\n<td>Number of \"Success\" status codes delivered for all sources.</td>\n</tr>\n<tr>\n<td>all_status_3xx</td>\n<td>integer</td>\n<td>Number of \"Redirection\" codes delivered for all sources.</td>\n</tr>\n<tr>\n<td>all_status_4xx</td>\n<td>integer</td>\n<td>Number of \"Client Error\" codes delivered for all sources.</td>\n</tr>\n<tr>\n<td>all_status_5xx</td>\n<td>integer</td>\n<td>Number of \"Server Error\" codes delivered for all sources.</td>\n</tr>\n<tr>\n<td>all_synth_requests</td>\n<td>integer</td>\n<td>Number of requests that returned a synthetic response (i.e., response objects created with the synthetic VCL statement) for a VCL service.</td>\n</tr>\n<tr>\n<td>api_discovery_requests_count</td>\n<td>integer</td>\n<td>Number of requests processed by the API Discovery engine.</td>\n</tr>\n<tr>\n<td>attack_blocked_req_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes received from requests that triggered a WAF rule that was blocked.</td>\n</tr>\n<tr>\n<td>attack_blocked_req_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received from requests that triggered a WAF rule that was blocked.</td>\n</tr>\n<tr>\n<td>attack_logged_req_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes received from requests that triggered a WAF rule that was logged.</td>\n</tr>\n<tr>\n<td>attack_logged_req_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received from requests that triggered a WAF rule that was logged.</td>\n</tr>\n<tr>\n<td>attack_passed_req_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes received from requests that triggered a WAF rule that was passed.</td>\n</tr>\n<tr>\n<td>attack_passed_req_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received from requests that triggered a WAF rule that was passed.</td>\n</tr>\n<tr>\n<td>attack_req_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes received from requests that triggered a WAF rule.</td>\n</tr>\n<tr>\n<td>attack_req_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received from requests that triggered a WAF rule.</td>\n</tr>\n<tr>\n<td>attack_resp_synth_bytes</td>\n<td>integer</td>\n<td>Total bytes delivered for requests that triggered a WAF rule and returned a synthetic response.</td>\n</tr>\n<tr>\n<td>bereq_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes sent to origin.</td>\n</tr>\n<tr>\n<td>bereq_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes sent to origin.</td>\n</tr>\n<tr>\n<td>body_size</td>\n<td>integer</td>\n<td>Total body bytes delivered (alias for resp_body_bytes).</td>\n</tr>\n<tr>\n<td>bot_challenge_complete_tokens_checked</td>\n<td>integer</td>\n<td>The number of challenge-complete tokens checked.</td>\n</tr>\n<tr>\n<td>bot_challenge_complete_tokens_disabled</td>\n<td>integer</td>\n<td>The number of challenge-complete tokens not checked because the feature was disabled.</td>\n</tr>\n<tr>\n<td>bot_challenge_complete_tokens_failed</td>\n<td>integer</td>\n<td>The number of challenge-complete tokens that failed validation.</td>\n</tr>\n<tr>\n<td>bot_challenge_complete_tokens_issued</td>\n<td>integer</td>\n<td>The number of challenge-complete tokens issued. For example, issuing a challenge-complete token after a series of CAPTCHA challenges ending in success.</td>\n</tr>\n<tr>\n<td>bot_challenge_complete_tokens_passed</td>\n<td>integer</td>\n<td>The number of challenge-complete tokens that passed validation.</td>\n</tr>\n<tr>\n<td>bot_challenge_starts</td>\n<td>integer</td>\n<td>The number of challenge-start tokens created.</td>\n</tr>\n<tr>\n<td>bot_challenges_failed</td>\n<td>integer</td>\n<td>The number of failed challenge solutions processed. For example, an incorrect CAPTCHA solution.</td>\n</tr>\n<tr>\n<td>bot_challenges_issued</td>\n<td>integer</td>\n<td>The number of challenges issued. For example, the issuance of a CAPTCHA challenge.</td>\n</tr>\n<tr>\n<td>bot_challenges_succeeded</td>\n<td>integer</td>\n<td>The number of successful challenge solutions processed. For example, a correct CAPTCHA solution.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_accessibility_count</td>\n<td>integer</td>\n<td>Count of edge requests where an accessibility bot was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_ai_crawler_count</td>\n<td>integer</td>\n<td>Count of edge requests where an AI crawler was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_ai_fetcher_count</td>\n<td>integer</td>\n<td>Count of edge requests where an AI fetcher was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_analyzed_count</td>\n<td>integer</td>\n<td>Count of edge requests where bot detection analysis was performed.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_content_fetcher_count</td>\n<td>integer</td>\n<td>Count of edge requests where a content fetcher was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_detected_count</td>\n<td>integer</td>\n<td>Count of edge requests where a bot was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_monitoring_count</td>\n<td>integer</td>\n<td>Count of edge requests where a monitoring and site tool was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_online_marketing_count</td>\n<td>integer</td>\n<td>Count of edge requests where an online marketing bot was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_page_preview_count</td>\n<td>integer</td>\n<td>Count of edge requests where a page preview bot was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_platform_integrations_count</td>\n<td>integer</td>\n<td>Count of edge requests where a platform integration was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_research_count</td>\n<td>integer</td>\n<td>Count of edge requests where a research bot was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_search_engine_crawler_count</td>\n<td>integer</td>\n<td>Count of edge requests where a search engine crawler was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_search_engine_optimization_count</td>\n<td>integer</td>\n<td>Count of edge requests where a search engine optimization bot was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_security_tools_count</td>\n<td>integer</td>\n<td>Count of edge requests where a security tool was detected.</td>\n</tr>\n<tr>\n<td>bot_edge_requests_verified_count</td>\n<td>integer</td>\n<td>Count of edge requests where a verified bot was detected.</td>\n</tr>\n<tr>\n<td>bot_requests_total_count</td>\n<td>integer</td>\n<td>Total number of Bot Management requests across all deployments.</td>\n</tr>\n<tr>\n<td>compute_bereq_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes sent to backends (origins) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_bereq_errors</td>\n<td>integer</td>\n<td>Number of backend request errors, including timeouts.</td>\n</tr>\n<tr>\n<td>compute_bereq_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes sent to backends (origins) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_bereqs</td>\n<td>integer</td>\n<td>Number of backend requests started.</td>\n</tr>\n<tr>\n<td>compute_beresp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes received from backends (origins) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_beresp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received from backends (origins) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_cache_operations_count</td>\n<td>integer</td>\n<td>Number of cache operations executed by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_execution_time_ms</td>\n<td>number</td>\n<td>The amount of active CPU time used to process your requests (in milliseconds).</td>\n</tr>\n<tr>\n<td>compute_globals_limit_exceeded</td>\n<td>integer</td>\n<td>Number of times a guest exceeded its globals limit.</td>\n</tr>\n<tr>\n<td>compute_guest_errors</td>\n<td>integer</td>\n<td>Number of times a service experienced a guest code error.</td>\n</tr>\n<tr>\n<td>compute_handoff</td>\n<td>integer</td>\n<td>The number of times Compute has handed off a request to the Fanout proxy or WebSocket proxy.</td>\n</tr>\n<tr>\n<td>compute_heap_limit_exceeded</td>\n<td>integer</td>\n<td>Number of times a guest exceeded its heap limit.</td>\n</tr>\n<tr>\n<td>compute_platform_internal_error</td>\n<td>integer</td>\n<td>Fatal errors caused by internal errors in Fastly’s Compute platform.</td>\n</tr>\n<tr>\n<td>compute_platform_invalid_request_error</td>\n<td>integer</td>\n<td>Fatal errors caused by unprocessable requests to the service, such as requests with malformed CDN-Loop headers or invalid purge credentials.</td>\n</tr>\n<tr>\n<td>compute_ram_used</td>\n<td>integer</td>\n<td>The amount of RAM used for your service by Fastly (in bytes).</td>\n</tr>\n<tr>\n<td>compute_req_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_req_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_request_time_billed_ms</td>\n<td>number</td>\n<td>The total amount of request processing time you will be billed for, measured in 50 millisecond increments.</td>\n</tr>\n<tr>\n<td>compute_request_time_ms</td>\n<td>number</td>\n<td>The total, actual amount of time used to process your requests, including active CPU time (in milliseconds).</td>\n</tr>\n<tr>\n<td>compute_requests</td>\n<td>integer</td>\n<td>The total number of requests that were received for your service by Fastly.</td>\n</tr>\n<tr>\n<td>compute_resource_limit_exceeded</td>\n<td>integer</td>\n<td>Number of times a guest exceeded its resource limit, includes heap, stack, globals, and code execution timeout.</td>\n</tr>\n<tr>\n<td>compute_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes sent from Compute to end user.</td>\n</tr>\n<tr>\n<td>compute_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes sent from Compute to end user.</td>\n</tr>\n<tr>\n<td>compute_resp_status_103</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 103 (Early Hints) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_1xx</td>\n<td>integer</td>\n<td>Number of \"Informational\" category status codes delivered by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_200</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 200 (Success) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_204</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 204 (No Content) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_206</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 206 (Partial Content) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_2xx</td>\n<td>integer</td>\n<td>Number of \"Success\" category status codes delivered by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_301</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 301 (Moved Permanently) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_302</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 302 (Found) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_304</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 304 (Not Modified) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_3xx</td>\n<td>integer</td>\n<td>Number of \"Redirection\" category status codes delivered by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_400</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 400 (Bad Request) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_401</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 401 (Unauthorized) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_403</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 403 (Forbidden) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_404</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 404 (Not Found) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_416</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 416 (Range Not Satisfiable) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_429</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 429 (Too Many Requests) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_4xx</td>\n<td>integer</td>\n<td>Number of \"Client Error\" category status codes delivered by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_500</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 500 (Internal Server Error) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_501</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 501 (Not Implemented) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_502</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 502 (Bad Gateway) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_503</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 503 (Service Unavailable) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_504</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 504 (Gateway Timeout) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_505</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 505 (HTTP Version Not Supported) by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_530</td>\n<td>integer</td>\n<td>Number of responses delivered with status code 530 by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_status_5xx</td>\n<td>integer</td>\n<td>Number of \"Server Error\" category status codes delivered by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_runtime_errors</td>\n<td>integer</td>\n<td>Number of times a service experienced a guest runtime error.</td>\n</tr>\n<tr>\n<td>compute_sandboxes</td>\n<td>integer</td>\n<td>Number of WebAssembly (Wasm) sandboxes created.</td>\n</tr>\n<tr>\n<td>compute_service_bereq_error</td>\n<td>integer</td>\n<td>Number of backend request errors, including timeouts.</td>\n</tr>\n<tr>\n<td>compute_service_chain_error</td>\n<td>integer</td>\n<td>Fatal errors caused by the service path exceeding hop or service limits, or where a forwarding loop is detected via CDN-Loop headers.</td>\n</tr>\n<tr>\n<td>compute_service_limits_error</td>\n<td>integer</td>\n<td>Non-fatal errors caused by attempts to exceed defined operational limits, such as simultaneous backend requests or cache transactions.</td>\n</tr>\n<tr>\n<td>compute_service_memory_exceeded_error</td>\n<td>integer</td>\n<td>Number of times a guest exceeded its heap limit.</td>\n</tr>\n<tr>\n<td>compute_service_resource_limits_error</td>\n<td>integer</td>\n<td>Aggregate of fatal errors caused by exceeding allocated resource limits, specifically runtime duration, vCPU usage, and heap memory limits.</td>\n</tr>\n<tr>\n<td>compute_service_runtime_error</td>\n<td>integer</td>\n<td>Fatal errors caused by service logic faults, including stack overflows, unreachable code traps, illegal memory access, or attempts to send multiple responses.</td>\n</tr>\n<tr>\n<td>compute_service_timeout_error</td>\n<td>integer</td>\n<td>Fatal errors caused by exceeding the per-request runtime limit.</td>\n</tr>\n<tr>\n<td>compute_service_vcpu_exceeded_error</td>\n<td>integer</td>\n<td>Fatal errors caused by exceeding the per-request vCPU time limit.</td>\n</tr>\n<tr>\n<td>compute_stack_limit_exceeded</td>\n<td>integer</td>\n<td>Number of times a guest exceeded its stack limit.</td>\n</tr>\n<tr>\n<td>ddos_action_blackhole</td>\n<td>integer</td>\n<td>The number of times the blackhole action was taken. The blackhole action quietly closes a TCP connection without sending a reset. The blackhole action quietly closes a TCP connection without notifying its peer (all TCP state is dropped).</td>\n</tr>\n<tr>\n<td>ddos_action_close</td>\n<td>integer</td>\n<td>The number of times the close action was taken. The close action aborts the connection as soon as possible. The close action takes effect either right after accept, right after the client hello, or right after the response was sent.</td>\n</tr>\n<tr>\n<td>ddos_action_downgrade</td>\n<td>integer</td>\n<td>The number of times the downgrade action was taken. The downgrade action restricts the client to http1.</td>\n</tr>\n<tr>\n<td>ddos_action_downgraded_connections</td>\n<td>integer</td>\n<td>The number of connections the downgrade action was applied to. The downgrade action restricts the connection to http1.</td>\n</tr>\n<tr>\n<td>ddos_action_limit_streams_connections</td>\n<td>integer</td>\n<td>For HTTP/2, the number of connections the limit-streams action was applied to. The limit-streams action caps the allowed number of concurrent streams in a connection.</td>\n</tr>\n<tr>\n<td>ddos_action_limit_streams_requests</td>\n<td>integer</td>\n<td>For HTTP/2, the number of requests made on a connection for which the limit-streams action was taken. The limit-streams action caps the allowed number of concurrent streams in a connection.</td>\n</tr>\n<tr>\n<td>ddos_action_tarpit</td>\n<td>integer</td>\n<td>The number of times the tarpit action was taken. The tarpit action delays writing the response to the client.</td>\n</tr>\n<tr>\n<td>ddos_action_tarpit_accept</td>\n<td>integer</td>\n<td>The number of times the tarpit-accept action was taken. The tarpit-accept action adds a delay when accepting future connections.</td>\n</tr>\n<tr>\n<td>ddos_protection_requests_allow_count</td>\n<td>integer</td>\n<td>Number of requests analyzed for DDoS attacks against a customer origin or service, but with no DDoS detected.</td>\n</tr>\n<tr>\n<td>ddos_protection_requests_detect_count</td>\n<td>integer</td>\n<td>Number of requests classified as a DDoS attack against a customer origin or service.</td>\n</tr>\n<tr>\n<td>ddos_protection_requests_mitigate_count</td>\n<td>integer</td>\n<td>Number of requests classified as a DDoS attack against a customer origin or service that were mitigated by the Fastly platform.</td>\n</tr>\n<tr>\n<td>deliver_sub_count</td>\n<td>integer</td>\n<td>Number of executions of the vcl_deliver Varnish subroutine.</td>\n</tr>\n<tr>\n<td>deliver_sub_time</td>\n<td>number</td>\n<td>Time spent inside the vcl_deliver Varnish subroutine (in nanoseconds).</td>\n</tr>\n<tr>\n<td>dns_billable_responses_count</td>\n<td>integer</td>\n<td>Number of billable DNS responses (e.g., A, CNAME).</td>\n</tr>\n<tr>\n<td>dns_nonbillable_responses_count</td>\n<td>integer</td>\n<td>Number of non-billable DNS responses (e.g., NODATA, NXDOMAIN).</td>\n</tr>\n<tr>\n<td>edge_hit_requests</td>\n<td>integer</td>\n<td>Number of requests sent by end users to Fastly that resulted in a hit at the edge.</td>\n</tr>\n<tr>\n<td>edge_hit_resp_body_bytes</td>\n<td>integer</td>\n<td>Body bytes delivered for edge hits.</td>\n</tr>\n<tr>\n<td>edge_hit_resp_header_bytes</td>\n<td>integer</td>\n<td>Header bytes delivered for edge hits.</td>\n</tr>\n<tr>\n<td>edge_miss_requests</td>\n<td>integer</td>\n<td>Number of requests sent by end users to Fastly that resulted in a miss at the edge.</td>\n</tr>\n<tr>\n<td>edge_miss_resp_body_bytes</td>\n<td>integer</td>\n<td>Body bytes delivered for edge misses.</td>\n</tr>\n<tr>\n<td>edge_miss_resp_header_bytes</td>\n<td>integer</td>\n<td>Header bytes delivered for edge misses.</td>\n</tr>\n<tr>\n<td>edge_requests</td>\n<td>integer</td>\n<td>Number of requests sent by end users to Fastly.</td>\n</tr>\n<tr>\n<td>edge_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes delivered from Fastly to the end user.</td>\n</tr>\n<tr>\n<td>edge_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes delivered from Fastly to the end user.</td>\n</tr>\n<tr>\n<td>error_sub_count</td>\n<td>integer</td>\n<td>Number of executions of the vcl_error Varnish subroutine.</td>\n</tr>\n<tr>\n<td>error_sub_time</td>\n<td>number</td>\n<td>Time spent inside the vcl_error Varnish subroutine (in nanoseconds).</td>\n</tr>\n<tr>\n<td>errors</td>\n<td>integer</td>\n<td>Number of cache errors.</td>\n</tr>\n<tr>\n<td>fanout_bereq_body_bytes</td>\n<td>integer</td>\n<td>Total body or message content bytes sent to backends over Fanout connections.</td>\n</tr>\n<tr>\n<td>fanout_bereq_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes sent to backends over Fanout connections.</td>\n</tr>\n<tr>\n<td>fanout_beresp_body_bytes</td>\n<td>integer</td>\n<td>Total body or message content bytes received from backends over Fanout connections.</td>\n</tr>\n<tr>\n<td>fanout_beresp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received from backends over Fanout connections.</td>\n</tr>\n<tr>\n<td>fanout_conn_time_ms</td>\n<td>integer</td>\n<td>Total duration of Fanout connections with end users.</td>\n</tr>\n<tr>\n<td>fanout_recv_publishes</td>\n<td>integer</td>\n<td>Total published messages received from the publish API endpoint.</td>\n</tr>\n<tr>\n<td>fanout_req_body_bytes</td>\n<td>integer</td>\n<td>Total body or message content bytes received from end users over Fanout connections.</td>\n</tr>\n<tr>\n<td>fanout_req_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received from end users over Fanout connections.</td>\n</tr>\n<tr>\n<td>fanout_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body or message content bytes sent to end users over Fanout connections, excluding published message content.</td>\n</tr>\n<tr>\n<td>fanout_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes sent to end users over Fanout connections.</td>\n</tr>\n<tr>\n<td>fanout_send_publishes</td>\n<td>integer</td>\n<td>Total published messages sent to end users.</td>\n</tr>\n<tr>\n<td>fetch_sub_count</td>\n<td>integer</td>\n<td>Number of executions of the vcl_fetch Varnish subroutine.</td>\n</tr>\n<tr>\n<td>fetch_sub_time</td>\n<td>number</td>\n<td>Time spent inside the vcl_fetch Varnish subroutine (in nanoseconds).</td>\n</tr>\n<tr>\n<td>hash_sub_count</td>\n<td>integer</td>\n<td>Number of executions of the vcl_hash Varnish subroutine.</td>\n</tr>\n<tr>\n<td>hash_sub_time</td>\n<td>number</td>\n<td>Time spent inside the vcl_hash Varnish subroutine (in nanoseconds).</td>\n</tr>\n<tr>\n<td>header_size</td>\n<td>integer</td>\n<td>Total header bytes delivered (alias for resp_header_bytes).</td>\n</tr>\n<tr>\n<td>hit_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes delivered for cache hits.</td>\n</tr>\n<tr>\n<td>hit_sub_count</td>\n<td>integer</td>\n<td>Number of executions of the vcl_hit Varnish subroutine.</td>\n</tr>\n<tr>\n<td>hit_sub_time</td>\n<td>number</td>\n<td>Time spent inside the vcl_hit Varnish subroutine (in nanoseconds).</td>\n</tr>\n<tr>\n<td>hits</td>\n<td>integer</td>\n<td>Number of cache hits.</td>\n</tr>\n<tr>\n<td>hits_time</td>\n<td>number</td>\n<td>Total amount of time spent processing cache hits (in seconds).</td>\n</tr>\n<tr>\n<td>http2</td>\n<td>integer</td>\n<td>Number of requests received over HTTP/2.</td>\n</tr>\n<tr>\n<td>http3</td>\n<td>integer</td>\n<td>Number of requests received over HTTP/3.</td>\n</tr>\n<tr>\n<td>imgopto</td>\n<td>integer</td>\n<td>Number of responses that came from the Fastly Image Optimizer service. If the service receives 10 requests for an image, this stat will be 10 regardless of how many times the image was transformed.</td>\n</tr>\n<tr>\n<td>imgopto_avif_count</td>\n<td>integer</td>\n<td>Count of AVIF images delivered to end user by Image Optimizer.</td>\n</tr>\n<tr>\n<td>imgopto_compute_requests</td>\n<td>integer</td>\n<td>The number of Image Optimizer requests made from Compute services.</td>\n</tr>\n<tr>\n<td>imgopto_gif_count</td>\n<td>integer</td>\n<td>Count of GIF images delivered to end user by Image Optimizer.</td>\n</tr>\n<tr>\n<td>imgopto_jpeg_count</td>\n<td>integer</td>\n<td>Count of JPEG images delivered to end user by Image Optimizer.</td>\n</tr>\n<tr>\n<td>imgopto_jpegxl_count</td>\n<td>integer</td>\n<td>Count of JPEGXL images delivered to end user by Image Optimizer.</td>\n</tr>\n<tr>\n<td>imgopto_mp4_count</td>\n<td>integer</td>\n<td>Count of MP4s delivered to end user by Image Optimizer.</td>\n</tr>\n<tr>\n<td>imgopto_png_count</td>\n<td>integer</td>\n<td>Count of PNG images delivered to end user by Image Optimizer.</td>\n</tr>\n<tr>\n<td>imgopto_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes delivered from the Fastly Image Optimizer service, including shield traffic.</td>\n</tr>\n<tr>\n<td>imgopto_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes delivered from the Fastly Image Optimizer service, including shield traffic.</td>\n</tr>\n<tr>\n<td>imgopto_shield</td>\n<td>integer</td>\n<td>Number of responses that came from the Fastly Image Optimizer service via a shield.</td>\n</tr>\n<tr>\n<td>imgopto_shield_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes delivered via a shield from the Fastly Image Optimizer service.</td>\n</tr>\n<tr>\n<td>imgopto_shield_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes delivered via a shield from the Fastly Image Optimizer service.</td>\n</tr>\n<tr>\n<td>imgopto_svg_count</td>\n<td>integer</td>\n<td>Count of SVG images delivered to end user by Image Optimizer.</td>\n</tr>\n<tr>\n<td>imgopto_transforms</td>\n<td>integer</td>\n<td>Number of transforms performed by the Fastly Image Optimizer service.</td>\n</tr>\n<tr>\n<td>imgopto_webp_count</td>\n<td>integer</td>\n<td>Count of WebP images delivered to end user by Image Optimizer.</td>\n</tr>\n<tr>\n<td>imgvideo</td>\n<td>integer</td>\n<td>Number of video responses that came from the Fastly Image Optimizer service.</td>\n</tr>\n<tr>\n<td>imgvideo_frames</td>\n<td>integer</td>\n<td>Number of video frames that came from the Fastly Image Optimizer service. A video frame is an individual image within a sequence of video.</td>\n</tr>\n<tr>\n<td>imgvideo_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes of video delivered from the Fastly Image Optimizer service.</td>\n</tr>\n<tr>\n<td>imgvideo_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes of video delivered from the Fastly Image Optimizer service.</td>\n</tr>\n<tr>\n<td>imgvideo_shield</td>\n<td>integer</td>\n<td>Number of video responses delivered via a shield that came from the Fastly Image Optimizer service.</td>\n</tr>\n<tr>\n<td>imgvideo_shield_frames</td>\n<td>integer</td>\n<td>Number of video frames delivered via a shield that came from the Fastly Image Optimizer service. A video frame is an individual image within a sequence of video.</td>\n</tr>\n<tr>\n<td>imgvideo_shield_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes of video delivered via a shield from the Fastly Image Optimizer service.</td>\n</tr>\n<tr>\n<td>imgvideo_shield_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes of video delivered via a shield from the Fastly Image Optimizer service.</td>\n</tr>\n<tr>\n<td>ipv6</td>\n<td>integer</td>\n<td>Number of requests that were received over IPv6.</td>\n</tr>\n<tr>\n<td>kv_store_class_a_operations</td>\n<td>integer</td>\n<td>The total number of class a operations for the KV store.</td>\n</tr>\n<tr>\n<td>kv_store_class_b_operations</td>\n<td>integer</td>\n<td>The total number of class b operations for the KV store.</td>\n</tr>\n<tr>\n<td>log</td>\n<td>integer</td>\n<td>Number of log lines sent.</td>\n</tr>\n<tr>\n<td>log_bytes</td>\n<td>integer</td>\n<td>Total log bytes sent.</td>\n</tr>\n<tr>\n<td>logging</td>\n<td>integer</td>\n<td>Number of log lines sent (alias for log).</td>\n</tr>\n<tr>\n<td>miss</td>\n<td>integer</td>\n<td>Number of cache misses.</td>\n</tr>\n<tr>\n<td>miss_histogram</td>\n<td>object</td>\n<td>A histogram. The value in each bucket is the number of requests to the origin whose responses arrived during the time period represented by the bucket. The key of each bucket represents the upper bound (in response time) of that bucket. The buckets vary in width and cover the time periods 0-10ms (in 1ms increments), 10-250ms (in 10ms increments), 250-1,000ms (in 50ms increments), 1,000-3,000ms (in 100ms increments), 3,000-10,000ms (in 500 ms increments), 10,000-20,000ms (in 1,000ms increments), 20,000-60,000ms (in 5,000ms increments), and 60,000ms through infinity (in a single bucket).</td>\n</tr>\n<tr>\n<td>miss_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes delivered for cache misses.</td>\n</tr>\n<tr>\n<td>miss_sub_count</td>\n<td>integer</td>\n<td>Number of executions of the vcl_miss Varnish subroutine.</td>\n</tr>\n<tr>\n<td>miss_sub_time</td>\n<td>number</td>\n<td>Time spent inside the vcl_miss Varnish subroutine (in nanoseconds).</td>\n</tr>\n<tr>\n<td>miss_time</td>\n<td>number</td>\n<td>Total amount of time spent processing cache misses (in seconds).</td>\n</tr>\n<tr>\n<td>ngwaf_bot_analysis_request_count</td>\n<td>integer</td>\n<td>Count of Next-Gen WAF Bot Management requests.</td>\n</tr>\n<tr>\n<td>object_size_100k</td>\n<td>integer</td>\n<td>Number of objects served that were between 10KB and 100KB in size.</td>\n</tr>\n<tr>\n<td>object_size_100m</td>\n<td>integer</td>\n<td>Number of objects served that were between 10MB and 100MB in size.</td>\n</tr>\n<tr>\n<td>object_size_10k</td>\n<td>integer</td>\n<td>Number of objects served that were between 1KB and 10KB in size.</td>\n</tr>\n<tr>\n<td>object_size_10m</td>\n<td>integer</td>\n<td>Number of objects served that were between 1MB and 10MB in size.</td>\n</tr>\n<tr>\n<td>object_size_1g</td>\n<td>integer</td>\n<td>Number of objects served that were between 100MB and 1GB in size.</td>\n</tr>\n<tr>\n<td>object_size_1k</td>\n<td>integer</td>\n<td>Number of objects served that were under 1KB in size.</td>\n</tr>\n<tr>\n<td>object_size_1m</td>\n<td>integer</td>\n<td>Number of objects served that were between 100KB and 1MB in size.</td>\n</tr>\n<tr>\n<td>object_size_other</td>\n<td>integer</td>\n<td>Number of objects served that were larger than 1GB in size.</td>\n</tr>\n<tr>\n<td>object_storage_class_a_operations_count</td>\n<td>integer</td>\n<td>A count of the number of Class A Object Storage operations.</td>\n</tr>\n<tr>\n<td>object_storage_class_b_operations_count</td>\n<td>integer</td>\n<td>A count of the number of Class B Object Storage operations.</td>\n</tr>\n<tr>\n<td>object_store_class_a_operations</td>\n<td>integer</td>\n<td>Use kv_store_class_a_operations.</td>\n</tr>\n<tr>\n<td>object_store_class_b_operations</td>\n<td>integer</td>\n<td>Use kv_store_class_b_operations.</td>\n</tr>\n<tr>\n<td>origin_cache_fetch_resp_body_bytes</td>\n<td>integer</td>\n<td>Body bytes received from origin for cacheable content.</td>\n</tr>\n<tr>\n<td>origin_cache_fetch_resp_header_bytes</td>\n<td>integer</td>\n<td>Header bytes received from an origin for cacheable content.</td>\n</tr>\n<tr>\n<td>origin_cache_fetches</td>\n<td>integer</td>\n<td>The total number of completed requests made to backends (origins) that returned cacheable content.</td>\n</tr>\n<tr>\n<td>origin_fetch_body_bytes</td>\n<td>integer</td>\n<td>Total request body bytes sent to origin.</td>\n</tr>\n<tr>\n<td>origin_fetch_header_bytes</td>\n<td>integer</td>\n<td>Total request header bytes sent to origin.</td>\n</tr>\n<tr>\n<td>origin_fetch_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes received from origin.</td>\n</tr>\n<tr>\n<td>origin_fetch_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received from origin.</td>\n</tr>\n<tr>\n<td>origin_fetches</td>\n<td>integer</td>\n<td>Number of requests sent to origin.</td>\n</tr>\n<tr>\n<td>origin_offload</td>\n<td>number</td>\n<td>Origin Offload measures the ratio of bytes served to end users that were cached by Fastly, over the bytes served to end users, between 0 and 1. ((edge_resp_body_bytes + edge_resp_header_bytes) - (origin_fetch_resp_body_bytes + origin_fetch_resp_header_bytes)) / (edge_resp_body_bytes + edge_resp_header_bytes).</td>\n</tr>\n<tr>\n<td>origin_revalidations</td>\n<td>integer</td>\n<td>Number of responses received from origin with a 304 status code in response to an If-Modified-Since or If-None-Match request. Under regular scenarios, a revalidation will imply a cache hit. However, if using Fastly Image Optimizer or segmented caching this may result in a cache miss.</td>\n</tr>\n<tr>\n<td>otfp</td>\n<td>integer</td>\n<td>Number of responses that came from the Fastly On-the-Fly Packaging service for video-on-demand.</td>\n</tr>\n<tr>\n<td>otfp_deliver_time</td>\n<td>number</td>\n<td>Total amount of time spent delivering a response from the Fastly On-the-Fly Packaging service for video-on-demand (in seconds).</td>\n</tr>\n<tr>\n<td>otfp_manifests</td>\n<td>integer</td>\n<td>Number of responses that were manifest files from the Fastly On-the-Fly Packaging service for video-on-demand.</td>\n</tr>\n<tr>\n<td>otfp_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes delivered from the Fastly On-the-Fly Packaging service for video-on-demand.</td>\n</tr>\n<tr>\n<td>otfp_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes delivered from the Fastly On-the-Fly Packaging service for video-on-demand.</td>\n</tr>\n<tr>\n<td>otfp_shield</td>\n<td>integer</td>\n<td>Number of responses that came from the Fastly On-the-Fly Packaging service for video-on-demand via a shield.</td>\n</tr>\n<tr>\n<td>otfp_shield_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes delivered via a shield for the Fastly On-the-Fly Packaging service for video-on-demand.</td>\n</tr>\n<tr>\n<td>otfp_shield_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes delivered via a shield for the Fastly On-the-Fly Packaging service for video-on-demand.</td>\n</tr>\n<tr>\n<td>otfp_shield_time</td>\n<td>number</td>\n<td>Total amount of time spent delivering a response via a shield from the Fastly On-the-Fly Packaging service for video-on-demand (in seconds).</td>\n</tr>\n<tr>\n<td>pass</td>\n<td>integer</td>\n<td>Number of requests that passed through the CDN without being cached.</td>\n</tr>\n<tr>\n<td>pass_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes delivered for cache passes.</td>\n</tr>\n<tr>\n<td>pass_sub_count</td>\n<td>integer</td>\n<td>Number of executions of the vcl_pass Varnish subroutine.</td>\n</tr>\n<tr>\n<td>pass_sub_time</td>\n<td>number</td>\n<td>Time spent inside the vcl_pass Varnish subroutine (in nanoseconds).</td>\n</tr>\n<tr>\n<td>pass_time</td>\n<td>number</td>\n<td>Total amount of time spent processing cache passes (in seconds).</td>\n</tr>\n<tr>\n<td>pci</td>\n<td>integer</td>\n<td>Number of responses with the PCI flag turned on.</td>\n</tr>\n<tr>\n<td>pipe_sub_count</td>\n<td>integer</td>\n<td>Number of executions of the vcl_pipe Varnish subroutine.</td>\n</tr>\n<tr>\n<td>pipe_sub_time</td>\n<td>number</td>\n<td>Time spent inside the vcl_pipe Varnish subroutine (in nanoseconds).</td>\n</tr>\n<tr>\n<td>predeliver_sub_count</td>\n<td>integer</td>\n<td>Number of executions of the vcl_predeliver Varnish subroutine.</td>\n</tr>\n<tr>\n<td>predeliver_sub_time</td>\n<td>number</td>\n<td>Time spent inside the vcl_predeliver Varnish subroutine (in nanoseconds).</td>\n</tr>\n<tr>\n<td>prehash_sub_count</td>\n<td>integer</td>\n<td>Number of executions of the vcl_prehash Varnish subroutine.</td>\n</tr>\n<tr>\n<td>prehash_sub_time</td>\n<td>number</td>\n<td>Time spent inside the vcl_prehash Varnish subroutine (in nanoseconds).</td>\n</tr>\n<tr>\n<td>recv_sub_count</td>\n<td>integer</td>\n<td>Number of executions of the vcl_recv Varnish subroutine.</td>\n</tr>\n<tr>\n<td>recv_sub_time</td>\n<td>number</td>\n<td>Time spent inside the vcl_recv Varnish subroutine (in nanoseconds).</td>\n</tr>\n<tr>\n<td>req_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes received.</td>\n</tr>\n<tr>\n<td>req_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received.</td>\n</tr>\n<tr>\n<td>request_collapse_unusable_count</td>\n<td>integer</td>\n<td>Number of requests that were collapsed and unable to be satisfied by the resulting cache object.</td>\n</tr>\n<tr>\n<td>request_collapse_usable_count</td>\n<td>integer</td>\n<td>Number of requests that were collapsed and satisfied by a usable cache object.</td>\n</tr>\n<tr>\n<td>request_denied_get_head_body</td>\n<td>integer</td>\n<td>Number of requests where Fastly responded with 400 due to the request being a GET or HEAD request containing a body.</td>\n</tr>\n<tr>\n<td>requests</td>\n<td>integer</td>\n<td>Number of requests processed.</td>\n</tr>\n<tr>\n<td>resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes delivered (edge_resp_body_bytes + shield_resp_body_bytes).</td>\n</tr>\n<tr>\n<td>resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes delivered (edge_resp_header_bytes + shield_resp_header_bytes).</td>\n</tr>\n<tr>\n<td>restarts</td>\n<td>integer</td>\n<td>Number of restarts performed.</td>\n</tr>\n<tr>\n<td>segblock_origin_fetches</td>\n<td>integer</td>\n<td>Number of Range requests to origin for segments of resources when using segmented caching.</td>\n</tr>\n<tr>\n<td>segblock_shield_fetches</td>\n<td>integer</td>\n<td>Number of Range requests to a shield for segments of resources when using segmented caching.</td>\n</tr>\n<tr>\n<td>shield</td>\n<td>integer</td>\n<td>Number of requests from edge to the shield POP.</td>\n</tr>\n<tr>\n<td>shield_cache_fetches</td>\n<td>integer</td>\n<td>The total number of completed requests made to shields that returned cacheable content.</td>\n</tr>\n<tr>\n<td>shield_fetch_body_bytes</td>\n<td>integer</td>\n<td>Total request body bytes sent to a shield.</td>\n</tr>\n<tr>\n<td>shield_fetch_header_bytes</td>\n<td>integer</td>\n<td>Total request header bytes sent to a shield.</td>\n</tr>\n<tr>\n<td>shield_fetch_resp_body_bytes</td>\n<td>integer</td>\n<td>Total response body bytes sent from a shield to the edge.</td>\n</tr>\n<tr>\n<td>shield_fetch_resp_header_bytes</td>\n<td>integer</td>\n<td>Total response header bytes sent from a shield to the edge.</td>\n</tr>\n<tr>\n<td>shield_fetches</td>\n<td>integer</td>\n<td>Number of requests made from one Fastly POP to another, as part of shielding.</td>\n</tr>\n<tr>\n<td>shield_hit_requests</td>\n<td>integer</td>\n<td>Number of requests that resulted in a hit at a shield.</td>\n</tr>\n<tr>\n<td>shield_hit_resp_body_bytes</td>\n<td>integer</td>\n<td>Body bytes delivered for shield hits.</td>\n</tr>\n<tr>\n<td>shield_hit_resp_header_bytes</td>\n<td>integer</td>\n<td>Header bytes delivered for shield hits.</td>\n</tr>\n<tr>\n<td>shield_miss_requests</td>\n<td>integer</td>\n<td>Number of requests that resulted in a miss at a shield.</td>\n</tr>\n<tr>\n<td>shield_miss_resp_body_bytes</td>\n<td>integer</td>\n<td>Body bytes delivered for shield misses.</td>\n</tr>\n<tr>\n<td>shield_miss_resp_header_bytes</td>\n<td>integer</td>\n<td>Header bytes delivered for shield misses.</td>\n</tr>\n<tr>\n<td>shield_resp_body_bytes</td>\n<td>integer</td>\n<td>Total body bytes delivered via a shield.</td>\n</tr>\n<tr>\n<td>shield_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes delivered via a shield.</td>\n</tr>\n<tr>\n<td>shield_revalidations</td>\n<td>integer</td>\n<td>Number of responses received from origin with a 304 status code, in response to an If-Modified-Since or If-None-Match request to a shield. Under regular scenarios, a revalidation will imply a cache hit. However, if using segmented caching this may result in a cache miss.</td>\n</tr>\n<tr>\n<td>status_1xx</td>\n<td>integer</td>\n<td>Number of \"Informational\" category status codes delivered.</td>\n</tr>\n<tr>\n<td>status_200</td>\n<td>integer</td>\n<td>Number of responses sent with status code 200 (Success).</td>\n</tr>\n<tr>\n<td>status_204</td>\n<td>integer</td>\n<td>Number of responses sent with status code 204 (No Content).</td>\n</tr>\n<tr>\n<td>status_206</td>\n<td>integer</td>\n<td>Number of responses sent with status code 206 (Partial Content).</td>\n</tr>\n<tr>\n<td>status_2xx</td>\n<td>integer</td>\n<td>Number of \"Success\" status codes delivered.</td>\n</tr>\n<tr>\n<td>status_301</td>\n<td>integer</td>\n<td>Number of responses sent with status code 301 (Moved Permanently).</td>\n</tr>\n<tr>\n<td>status_302</td>\n<td>integer</td>\n<td>Number of responses sent with status code 302 (Found).</td>\n</tr>\n<tr>\n<td>status_304</td>\n<td>integer</td>\n<td>Number of responses sent with status code 304 (Not Modified).</td>\n</tr>\n<tr>\n<td>status_3xx</td>\n<td>integer</td>\n<td>Number of \"Redirection\" codes delivered.</td>\n</tr>\n<tr>\n<td>status_400</td>\n<td>integer</td>\n<td>Number of responses sent with status code 400 (Bad Request).</td>\n</tr>\n<tr>\n<td>status_401</td>\n<td>integer</td>\n<td>Number of responses sent with status code 401 (Unauthorized).</td>\n</tr>\n<tr>\n<td>status_403</td>\n<td>integer</td>\n<td>Number of responses sent with status code 403 (Forbidden).</td>\n</tr>\n<tr>\n<td>status_404</td>\n<td>integer</td>\n<td>Number of responses sent with status code 404 (Not Found).</td>\n</tr>\n<tr>\n<td>status_406</td>\n<td>integer</td>\n<td>Number of responses sent with status code 406 (Not Acceptable).</td>\n</tr>\n<tr>\n<td>status_416</td>\n<td>integer</td>\n<td>Number of responses sent with status code 416 (Range Not Satisfiable).</td>\n</tr>\n<tr>\n<td>status_429</td>\n<td>integer</td>\n<td>Number of responses sent with status code 429 (Too Many Requests).</td>\n</tr>\n<tr>\n<td>status_4xx</td>\n<td>integer</td>\n<td>Number of \"Client Error\" codes delivered.</td>\n</tr>\n<tr>\n<td>status_500</td>\n<td>integer</td>\n<td>Number of responses sent with status code 500 (Internal Server Error).</td>\n</tr>\n<tr>\n<td>status_501</td>\n<td>integer</td>\n<td>Number of responses sent with status code 501 (Not Implemented).</td>\n</tr>\n<tr>\n<td>status_502</td>\n<td>integer</td>\n<td>Number of responses sent with status code 502 (Bad Gateway).</td>\n</tr>\n<tr>\n<td>status_503</td>\n<td>integer</td>\n<td>Number of responses sent with status code 503 (Service Unavailable).</td>\n</tr>\n<tr>\n<td>status_504</td>\n<td>integer</td>\n<td>Number of responses sent with status code 504 (Gateway Timeout).</td>\n</tr>\n<tr>\n<td>status_505</td>\n<td>integer</td>\n<td>Number of responses sent with status code 505 (HTTP Version Not Supported).</td>\n</tr>\n<tr>\n<td>status_530</td>\n<td>integer</td>\n<td>Number of responses sent with status code 530.</td>\n</tr>\n<tr>\n<td>status_5xx</td>\n<td>integer</td>\n<td>Number of \"Server Error\" codes delivered.</td>\n</tr>\n<tr>\n<td>synth</td>\n<td>integer</td>\n<td>Number of requests that returned a synthetic response (i.e., response objects created with the synthetic VCL statement).</td>\n</tr>\n<tr>\n<td>tls</td>\n<td>integer</td>\n<td>Number of requests that were received over TLS.</td>\n</tr>\n<tr>\n<td>tls_v10</td>\n<td>integer</td>\n<td>Number of requests received over TLS 1.0.</td>\n</tr>\n<tr>\n<td>tls_v11</td>\n<td>integer</td>\n<td>Number of requests received over TLS 1.1.</td>\n</tr>\n<tr>\n<td>tls_v12</td>\n<td>integer</td>\n<td>Number of requests received over TLS 1.2.</td>\n</tr>\n<tr>\n<td>tls_v13</td>\n<td>integer</td>\n<td>Number of requests received over TLS 1.3.</td>\n</tr>\n<tr>\n<td>uncacheable</td>\n<td>integer</td>\n<td>Number of requests that were designated uncachable.</td>\n</tr>\n<tr>\n<td>upgrade</td>\n<td>integer</td>\n<td>Number of requests that resulted in a WebSocket upgrade.</td>\n</tr>\n<tr>\n<td>video</td>\n<td>integer</td>\n<td>Number of responses with the video segment or video manifest MIME type (i.e., application/x-mpegurl, application/vnd.apple.mpegurl, application/f4m, application/dash+xml, application/vnd.ms-sstr+xml, ideo/mp2t, audio/aac, video/f4f, video/x-flv, video/mp4, audio/mp4).</td>\n</tr>\n<tr>\n<td>websocket_bereq_body_bytes</td>\n<td>integer</td>\n<td>Total message content bytes sent to backends over passthrough WebSocket connections.</td>\n</tr>\n<tr>\n<td>websocket_bereq_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes sent to backends over passthrough WebSocket connections.</td>\n</tr>\n<tr>\n<td>websocket_beresp_body_bytes</td>\n<td>integer</td>\n<td>Total message content bytes received from backends over passthrough WebSocket connections.</td>\n</tr>\n<tr>\n<td>websocket_beresp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received from backends over passthrough WebSocket connections.</td>\n</tr>\n<tr>\n<td>websocket_conn_time_ms</td>\n<td>integer</td>\n<td>Total duration of passthrough WebSocket connections with end users.</td>\n</tr>\n<tr>\n<td>websocket_req_body_bytes</td>\n<td>integer</td>\n<td>Total message content bytes received from end users over passthrough WebSocket connections.</td>\n</tr>\n<tr>\n<td>websocket_req_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes received from end users over passthrough WebSocket connections.</td>\n</tr>\n<tr>\n<td>websocket_resp_body_bytes</td>\n<td>integer</td>\n<td>Total message content bytes sent to end users over passthrough WebSocket connections.</td>\n</tr>\n<tr>\n<td>websocket_resp_header_bytes</td>\n<td>integer</td>\n<td>Total header bytes sent to end users over passthrough WebSocket connections.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"ef5e8a50-0b87-46c4-9771-8e87bcea8a66"},{"name":"Stats","item":[{"name":"Get stats for a service","id":"6b579715-c9e8-4f3f-aa89-1d41d2eb521f","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/stats/summary?end_time&month&start_time&year","description":"<p>Get the stats from a service for a block of time. This lists all stats by PoP location, starting with AMS. This call requires parameters to select block of time to query. Use either a timestamp range (using start_time and end_time) or a specified month/year combo (using month and year).</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","stats","summary"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Epoch timestamp. Limits the results returned.</p>\n","type":"text/plain"},"key":"end_time"},{"description":{"content":"<p>2-digit month.</p>\n","type":"text/plain"},"key":"month"},{"description":{"content":"<p>Epoch timestamp. Limits the results returned.</p>\n","type":"text/plain"},"key":"start_time"},{"description":{"content":"<p>4-digit year.</p>\n","type":"text/plain"},"key":"year"}],"variable":[]}},"response":[{"id":"2461472f-ecae-4c59-87fc-b63920f0e71c","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/stats/summary?end_time=1608560817&month=05&start_time=1608560817&year=2020?end_time&month&start_time&year","protocol":"https","host":["api","fastly","com"],"path":["service","SU1Z0isxPaozGVKXdv0eY","stats","summary"],"query":[{"key":"end_time","description":"Epoch timestamp. Limits the results returned."},{"key":"month","description":"2-digit month."},{"key":"start_time","description":"Epoch timestamp. Limits the results returned."},{"key":"year","description":"4-digit year."}]},"description":"Get the stats from a service for a block of time. This lists all stats by PoP location, starting with AMS. This call requires parameters to select block of time to query. Use either a timestamp range (using start_time and end_time) or a specified month/year combo (using month and year).\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"stats\":{\"LHR\":{\"resp_header_bytes\":0,\"resp_body_bytes\":0,\"requests\":0,\"hits\":0,\"miss\":0,\"uncacheable\":0,\"restarts\":0,\"pass\":0,\"pass_time\":0,\"pipe\":0,\"synth\":0,\"hits_time\":0,\"miss_time\":0,\"status_1xx\":0,\"status_2xx\":0,\"status_3xx\":0,\"status_4xx\":0,\"status_5xx\":0,\"status_200\":0,\"status_204\":0,\"status_206\":0,\"status_301\":0,\"status_302\":0,\"status_304\":0,\"status_400\":0,\"status_401\":0,\"status_403\":0,\"status_404\":0,\"status_416\":0,\"status_429\":0,\"status_500\":0,\"status_501\":0,\"status_502\":0,\"status_503\":0,\"status_504\":0,\"status_505\":0,\"attack_req_header_bytes\":0,\"attack_req_body_bytes\":0,\"attack_logged_req_header_bytes\":0,\"attack_logged_req_body_bytes\":0,\"attack_blocked_req_header_bytes\":0,\"attack_blocked_req_body_bytes\":0,\"attack_passed_req_header_bytes\":0,\"attack_passed_req_body_bytes\":0,\"attack_resp_synth_bytes\":0,\"bereq_header_bytes\":0,\"bereq_body_bytes\":0,\"req_header_bytes\":0,\"req_body_bytes\":0,\"blacklist\":0,\"tls\":0,\"tls_v10\":0,\"tls_v11\":0,\"tls_v12\":0,\"tls_v13\":0,\"shield\":0,\"shield_resp_header_bytes\":0,\"shield_resp_body_bytes\":0,\"ipv6\":0,\"http2\":0,\"pci\":0,\"object_size_1k\":0,\"object_size_10k\":0,\"object_size_100k\":0,\"object_size_1m\":0,\"object_size_10m\":0,\"object_size_100m\":0,\"object_size_1g\":0,\"otfp\":0,\"otfp_resp_header_bytes\":0,\"otfp_resp_body_bytes\":0,\"otfp_shield_resp_header_bytes\":0,\"otfp_shield_resp_body_bytes\":0,\"otfp_manifests\":0,\"otfp_deliver_time\":0,\"otfp_shield_time\":0,\"imgopto\":0,\"imgopto_resp_header_bytes\":0,\"imgopto_resp_body_bytes\":0,\"imgopto_shield_resp_header_bytes\":0,\"imgopto_shield_resp_body_bytes\":0,\"video\":0,\"recv_sub_time\":0,\"recv_sub_count\":0,\"hash_sub_time\":0,\"hash_sub_count\":0,\"miss_sub_time\":0,\"miss_sub_count\":0,\"fetch_sub_time\":0,\"fetch_sub_count\":0,\"pass_sub_time\":0,\"pass_sub_count\":0,\"pipe_sub_time\":0,\"pipe_sub_count\":0,\"deliver_sub_time\":0,\"deliver_sub_count\":0,\"error_sub_time\":0,\"error_sub_count\":0,\"hit_sub_time\":0,\"hit_sub_count\":0,\"prehash_sub_time\":0,\"prehash_sub_count\":0,\"predeliver_sub_time\":0,\"predeliver_sub_count\":0,\"tls_handshake_sent_bytes\":0,\"hit_resp_body_bytes\":2232360,\"miss_resp_body_bytes\":2181748,\"pass_resp_body_bytes\":2242,\"log\":0,\"log_bytes\":0,\"edge_resp_header_bytes\":0,\"edge_resp_body_bytes\":0,\"origin_revalidations\":0,\"origin_fetches\":25,\"origin_fetch_header_bytes\":24821,\"origin_fetch_body_bytes\":464,\"origin_fetch_resp_header_bytes\":29434,\"origin_fetch_resp_body_bytes\":2183990,\"shield_revalidations\":0,\"shield_fetches\":0,\"shield_fetch_header_bytes\":0,\"shield_fetch_body_bytes\":0,\"shield_fetch_resp_header_bytes\":0,\"shield_fetch_resp_body_bytes\":0,\"segblock_origin_fetches\":0,\"segblock_shield_fetches\":0,\"origin_cache_fetches\":7,\"header_size\":0,\"body_size\":0,\"orig_req_header_size\":0,\"orig_req_body_size\":0,\"orig_resp_header_size\":0,\"orig_resp_body_size\":0,\"edge_requests\":0,\"errors\":0,\"compute_requests\":20,\"compute_request_time_ms\":9158.1,\"compute_request_time_billed_ms\":9400,\"compute_ram_used\":28835840,\"compute_execution_time_ms\":114.048,\"compute_req_header_bytes\":23478,\"compute_resp_header_bytes\":10850,\"compute_resp_body_bytes\":4414108,\"compute_resp_status_2xx\":16,\"compute_resp_status_3xx\":4,\"compute_bereq_header_bytes\":33916,\"compute_bereq_body_bytes\":464,\"compute_beresp_header_bytes\":35349,\"compute_beresp_body_bytes\":4415630}}}"}],"_postman_id":"6b579715-c9e8-4f3f-aa89-1d41d2eb521f"}],"id":"d245bd12-b693-4b00-9e8d-86abf2e5b181","description":"<p>Stats give you information on the usage and performance of your Service. They can be requested by Service and over a particular time span. Stats are broken down per POP, giving you information on how your Services are being used across the world. There is now a more flexible, and fully featured Stats API available.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"d245bd12-b693-4b00-9e8d-86abf2e5b181"}],"id":"147f092c-2ba7-4d69-a61a-ebfb77445ccf","_postman_id":"147f092c-2ba7-4d69-a61a-ebfb77445ccf","description":""},{"name":"Origin metrics","item":[{"name":"Origin Inspector Historical API","item":[{"name":"Get historical origin data for a service","id":"cda98eb6-4d78-46ae-96e3-5a52e647f289","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/metrics/origins/services/{{service_id}}?cursor&datacenter&downsample&end&group_by&host&limit&metric&region&start","description":"<p>Fetches historical origin metrics for a given Fastly service, optionally filtering and grouping the results by origin host, region, or POP.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["metrics","origins","services","{{service_id}}"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Cursor value from the next_cursor field of a previous response, used to retrieve the next page. To request the first page, this should be empty.</p>\n","type":"text/plain"},"key":"cursor"},{"description":{"content":"<p>Limit query to one or more specific POPs. Values should be comma-separated.</p>\n","type":"text/plain"},"key":"datacenter"},{"description":{"content":"<p>Duration of sample windows.</p>\n","type":"text/plain"},"key":"downsample"},{"description":{"content":"<p>A valid ISO-8601-formatted date and time, or UNIX timestamp, indicating the exclusive end of the query time range. If not provided, a default is chosen based on the provided downsample value.</p>\n","type":"text/plain"},"key":"end"},{"description":{"content":"<p>Dimensions to return in the query. Multiple dimensions may be separated by commas.\nFor example, group_by=host will return one timeseries for every origin host, as a total across all POPs.</p>\n","type":"text/plain"},"key":"group_by"},{"description":{"content":"<p>Limit query to one or more specific origin hosts. Values should be comma-separated.</p>\n","type":"text/plain"},"key":"host"},{"description":{"content":"<p>Number of results per page. The maximum is 200.</p>\n","type":"text/plain"},"key":"limit"},{"description":{"content":"<p>The metrics to retrieve. Multiple values should be comma-separated.</p>\n","type":"text/plain"},"key":"metric"},{"description":{"content":"<p>Limit query to one or more specific geographic regions. Values should be comma-separated.</p>\n","type":"text/plain"},"key":"region"},{"description":{"content":"<p>A valid ISO-8601-formatted date and time, or UNIX timestamp, indicating the inclusive start of the query time range. If not provided, a default is chosen based on the provided downsample value.</p>\n","type":"text/plain"},"key":"start"}],"variable":[]}},"response":[{"id":"24327003-2231-4d52-9e98-6de93713f6bb","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/metrics/origins/services/SU1Z0isxPaozGVKXdv0eY?datacenter=SJC%2CSTP&downsample=hour&end=2020-08-02T00%3A00%3A00.000Z&group_by=host&host=origin_1%2Corigin_2&metric=resp_body_bytes%2Cstatus_2xx&region=usa&start=2021-08-01T00%3A00%3A00.000Z?cursor&datacenter&downsample&end&group_by&host&limit&metric&region&start","protocol":"https","host":["api","fastly","com"],"path":["metrics","origins","services","SU1Z0isxPaozGVKXdv0eY"],"query":[{"key":"cursor","description":"Cursor value from the next_cursor field of a previous response, used to retrieve the next page. To request the first page, this should be empty."},{"key":"datacenter","description":"Limit query to one or more specific POPs. Values should be comma-separated."},{"key":"downsample","description":"Duration of sample windows."},{"key":"end","description":"A valid ISO-8601-formatted date and time, or UNIX timestamp, indicating the exclusive end of the query time range. If not provided, a default is chosen based on the provided downsample value."},{"key":"group_by","description":"Dimensions to return in the query. Multiple dimensions may be separated by commas.\nFor example, group_by=host will return one timeseries for every origin host, as a total across all POPs."},{"key":"host","description":"Limit query to one or more specific origin hosts. Values should be comma-separated."},{"key":"limit","description":"Number of results per page. The maximum is 200."},{"key":"metric","description":"The metrics to retrieve. Multiple values should be comma-separated."},{"key":"region","description":"Limit query to one or more specific geographic regions. Values should be comma-separated."},{"key":"start","description":"A valid ISO-8601-formatted date and time, or UNIX timestamp, indicating the inclusive start of the query time range. If not provided, a default is chosen based on the provided downsample value."}]},"description":"Fetches historical origin metrics for a given Fastly service, optionally filtering and grouping the results by origin host, region, or POP.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"dimensions\":{\"host\":\"origin_1\",\"region\":\"usa\",\"datacenter\":\"SJC\"},\"values\":[{\"timestamp\":1627772400,\"resp_body_bytes\":552256,\"status_2xx\":1},{\"timestamp\":1627776000,\"resp_body_bytes\":12323,\"status_2xx\":34}]},{\"dimensions\":{\"host\":\"origin_2\",\"region\":\"usa\",\"datacenter\":\"STP\"},\"values\":[{\"timestamp\":1627772400,\"resp_body_bytes\":221,\"status_2xx\":1},{\"timestamp\":1627776000,\"resp_body_bytes\":234,\"status_2xx\":34}]}],\"meta\":{\"start\":\"2021-08-01T00:00:00Z\",\"end\":\"2020-08-02T00:00:00Z\",\"downsample\":\"hour\",\"metric\":\"resp_body_bytes,status_2xx\",\"limit\":100,\"next_cursor\":\"VTBwRENqVTJXVmszUz\",\"sort\":\"host,region,datacenter\",\"group_by\":\"none\",\"filters\":{}},\"status\":\"success\"}"}],"_postman_id":"cda98eb6-4d78-46ae-96e3-5a52e647f289"}],"id":"ab5dd43e-cb1b-433c-947d-41ac93924d3a","description":"<p>Origin Inspector provides a JSON-formatted historical API for visibility into responses delivered from your origin servers to Fastly. The API offers a standardized set of data to report in minutely, hourly or daily granularity on every origin response, byte, and status code received by a specified service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>dimensions</td>\n<td>object</td>\n<td>The unique combination of dimensions associated with this timeseries.</td>\n</tr>\n<tr>\n<td>meta</td>\n<td>object</td>\n<td>Meta information about the scope of the query in a human readable format.</td>\n</tr>\n<tr>\n<td>msg</td>\n<td>string</td>\n<td>If the query was not successful, this will provide a string that explains why.</td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>Whether or not we were able to successfully execute the query.</td>\n</tr>\n<tr>\n<td>values</td>\n<td>array</td>\n<td>An array of values representing the metric values at each point in time.</td>\n</tr>\n<tr>\n<td>Note that this dataset is sparse: only the keys with non-zero values will be included in the record.</td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td>datacenter</td>\n<td>string</td>\n<td>The POP from which the edge responses in this data entry were delivered. If unspecified, results are aggregated across POPs.</td>\n</tr>\n<tr>\n<td>host</td>\n<td>string</td>\n<td>The origin host from which the edge responses in this data entry were delivered. If unspecified, results are aggregated across origin hosts.</td>\n</tr>\n<tr>\n<td>region</td>\n<td>string</td>\n<td>The geographic region from which the edge responses in this data entry were delivered. If unspecified, results are aggregated across regions.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-1\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>dimensions</td>\n<td>object</td>\n<td>The unique combination of dimensions associated with this timeseries.</td>\n</tr>\n<tr>\n<td>values</td>\n<td>array</td>\n<td>An array of values representing the metric values at each point in time.</td>\n</tr>\n<tr>\n<td>Note that this dataset is sparse: only the keys with non-zero values will be included in the record.</td>\n<td></td>\n<td></td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-2\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>all_latency_0_to_1ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 0 and 1 millisecond received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_latency_10000_to_60000ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 10,000 and 60,000 milliseconds received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_latency_1000_to_5000ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 1,000 and 5,000 milliseconds received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_latency_100_to_250ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 100 and 250 milliseconds received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_latency_10_to_50ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 10 and 50 milliseconds received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_latency_1_to_5ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 1 and 5 milliseconds received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_latency_250_to_500ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 250 and 500 milliseconds received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_latency_5000_to_10000ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 5,000 and 10,000 milliseconds received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_latency_500_to_1000ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 500 and 1,000 milliseconds received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_latency_50_to_100ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 50 and 100 milliseconds received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_latency_5_to_10ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 5 and 10 milliseconds received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_latency_60000ms</td>\n<td>integer</td>\n<td>Number of responses with latency of 60,000 milliseconds and above received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_resp_body_bytes</td>\n<td>integer</td>\n<td>Number of body bytes received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_resp_header_bytes</td>\n<td>integer</td>\n<td>Number of header bytes received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_responses</td>\n<td>integer</td>\n<td>Number of responses received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_1xx</td>\n<td>integer</td>\n<td>Number of 1xx \"Informational\" category status codes delivered received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_200</td>\n<td>integer</td>\n<td>Number of responses received with status code 200 (Success) received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_204</td>\n<td>integer</td>\n<td>Number of responses received with status code 204 (No Content) received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_206</td>\n<td>integer</td>\n<td>Number of responses received with status code 206 (Partial Content) received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_2xx</td>\n<td>integer</td>\n<td>Number of 2xx \"Success\" status codes received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_301</td>\n<td>integer</td>\n<td>Number of responses received with status code 301 (Moved Permanently) received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_302</td>\n<td>integer</td>\n<td>Number of responses received with status code 302 (Found) received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_304</td>\n<td>integer</td>\n<td>Number of responses received with status code 304 (Not Modified) received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_3xx</td>\n<td>integer</td>\n<td>Number of 3xx \"Redirection\" codes received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_400</td>\n<td>integer</td>\n<td>Number of responses received with status code 400 (Bad Request) received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_401</td>\n<td>integer</td>\n<td>Number of responses received with status code 401 (Unauthorized) received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_403</td>\n<td>integer</td>\n<td>Number of responses received with status code 403 (Forbidden) received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_404</td>\n<td>integer</td>\n<td>Number of responses received with status code 404 (Not Found) received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_416</td>\n<td>integer</td>\n<td>Number of responses received with status code 416 (Range Not Satisfiable) received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_429</td>\n<td>integer</td>\n<td>Number of responses received with status code 429 (Too Many Requests) received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_4xx</td>\n<td>integer</td>\n<td>Number of 4xx \"Client Error\" codes received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_500</td>\n<td>integer</td>\n<td>Number of responses received with status code 500 (Internal Server Error) received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_501</td>\n<td>integer</td>\n<td>Number of responses received with status code 501 (Not Implemented) received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_502</td>\n<td>integer</td>\n<td>Number of responses received with status code 502 (Bad Gateway) received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_503</td>\n<td>integer</td>\n<td>Number of responses received with status code 503 (Service Unavailable) received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_504</td>\n<td>integer</td>\n<td>Number of responses received with status code 504 (Gateway Timeout) received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_505</td>\n<td>integer</td>\n<td>Number of responses received with status code 505 (HTTP Version Not Supported) received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_530</td>\n<td>integer</td>\n<td>Number of responses received with status code 530 received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_5xx</td>\n<td>integer</td>\n<td>Number of 5xx \"Server Error\" codes received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>compute_latency_0_to_1ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 0 and 1 millisecond for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_latency_10000_to_60000ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 10,000 and 60,000 milliseconds for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_latency_1000_to_5000ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 1,000 and 5,000 milliseconds for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_latency_100_to_250ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 100 and 250 milliseconds for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_latency_10_to_50ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 10 and 50 milliseconds for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_latency_1_to_5ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 1 and 5 milliseconds for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_latency_250_to_500ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 250 and 500 milliseconds for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_latency_5000_to_10000ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 5,000 and 10,000 milliseconds for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_latency_500_to_1000ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 500 and 1,000 milliseconds for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_latency_50_to_100ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 50 and 100 milliseconds for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_latency_5_to_10ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 5 and 10 milliseconds for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_latency_60000ms</td>\n<td>integer</td>\n<td>Number of responses with latency of 60,000 milliseconds and above for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_body_bytes</td>\n<td>integer</td>\n<td>Number of body bytes for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_header_bytes</td>\n<td>integer</td>\n<td>Number of header bytes for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_responses</td>\n<td>integer</td>\n<td>Number of responses for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_1xx</td>\n<td>integer</td>\n<td>Number of 1xx \"Informational\" status codes for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_200</td>\n<td>integer</td>\n<td>Number of responses received with status code 200 (Success) for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_204</td>\n<td>integer</td>\n<td>Number of responses received with status code 204 (No Content) for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_206</td>\n<td>integer</td>\n<td>Number of responses received with status code 206 (Partial Content) for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_2xx</td>\n<td>integer</td>\n<td>Number of 2xx \"Success\" status codes for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_301</td>\n<td>integer</td>\n<td>Number of responses received with status code 301 (Moved Permanently) for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_302</td>\n<td>integer</td>\n<td>Number of responses received with status code 302 (Found) for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_304</td>\n<td>integer</td>\n<td>Number of responses received with status code 304 (Not Modified) for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_3xx</td>\n<td>integer</td>\n<td>Number of 3xx \"Redirection\" codes for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_400</td>\n<td>integer</td>\n<td>Number of responses received with status code 400 (Bad Request) for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_401</td>\n<td>integer</td>\n<td>Number of responses received with status code 401 (Unauthorized) for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_403</td>\n<td>integer</td>\n<td>Number of responses received with status code 403 (Forbidden) for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_404</td>\n<td>integer</td>\n<td>Number of responses received with status code 404 (Not Found) for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_416</td>\n<td>integer</td>\n<td>Number of responses received with status code 416 (Range Not Satisfiable) for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_429</td>\n<td>integer</td>\n<td>Number of responses received with status code 429 (Too Many Requests) for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_4xx</td>\n<td>integer</td>\n<td>Number of 4xx \"Client Error\" codes for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_500</td>\n<td>integer</td>\n<td>Number of responses received with status code 500 (Internal Server Error) for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_501</td>\n<td>integer</td>\n<td>Number of responses received with status code 501 (Not Implemented) for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_502</td>\n<td>integer</td>\n<td>Number of responses received with status code 502 (Bad Gateway) for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_503</td>\n<td>integer</td>\n<td>Number of responses received with status code 503 (Service Unavailable) for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_504</td>\n<td>integer</td>\n<td>Number of responses received with status code 504 (Gateway Timeout) for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_505</td>\n<td>integer</td>\n<td>Number of responses received with status code 505 (HTTP Version Not Supported) for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_530</td>\n<td>integer</td>\n<td>Number of responses received with status code 530 for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_5xx</td>\n<td>integer</td>\n<td>Number of 5xx \"Server Error\" codes for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>latency_0_to_1ms</td>\n<td>integer</td>\n<td>Number of responses from origin with latency between 0 and 1 millisecond.</td>\n</tr>\n<tr>\n<td>latency_10000_to_60000ms</td>\n<td>integer</td>\n<td>Number of responses from origin with latency between 10,000 and 60,000 milliseconds.</td>\n</tr>\n<tr>\n<td>latency_1000_to_5000ms</td>\n<td>integer</td>\n<td>Number of responses from origin with latency between 1,000 and 5,000 milliseconds.</td>\n</tr>\n<tr>\n<td>latency_100_to_250ms</td>\n<td>integer</td>\n<td>Number of responses from origin with latency between 100 and 250 milliseconds.</td>\n</tr>\n<tr>\n<td>latency_10_to_50ms</td>\n<td>integer</td>\n<td>Number of responses from origin with latency between 10 and 50 milliseconds.</td>\n</tr>\n<tr>\n<td>latency_1_to_5ms</td>\n<td>integer</td>\n<td>Number of responses from origin with latency between 1 and 5 milliseconds.</td>\n</tr>\n<tr>\n<td>latency_250_to_500ms</td>\n<td>integer</td>\n<td>Number of responses from origin with latency between 250 and 500 milliseconds.</td>\n</tr>\n<tr>\n<td>latency_5000_to_10000ms</td>\n<td>integer</td>\n<td>Number of responses from origin with latency between 5,000 and 10,000 milliseconds.</td>\n</tr>\n<tr>\n<td>latency_500_to_1000ms</td>\n<td>integer</td>\n<td>Number of responses from origin with latency between 500 and 1,000 milliseconds.</td>\n</tr>\n<tr>\n<td>latency_50_to_100ms</td>\n<td>integer</td>\n<td>Number of responses from origin with latency between 50 and 100 milliseconds.</td>\n</tr>\n<tr>\n<td>latency_5_to_10ms</td>\n<td>integer</td>\n<td>Number of responses from origin with latency between 5 and 10 milliseconds.</td>\n</tr>\n<tr>\n<td>latency_60000ms</td>\n<td>integer</td>\n<td>Number of responses from origin with latency of 60,000 milliseconds and above.</td>\n</tr>\n<tr>\n<td>resp_body_bytes</td>\n<td>integer</td>\n<td>Number of body bytes from origin.</td>\n</tr>\n<tr>\n<td>resp_header_bytes</td>\n<td>integer</td>\n<td>Number of header bytes from origin.</td>\n</tr>\n<tr>\n<td>responses</td>\n<td>integer</td>\n<td>Number of responses from origin.</td>\n</tr>\n<tr>\n<td>status_1xx</td>\n<td>integer</td>\n<td>Number of 1xx \"Informational\" status codes delivered from origin.</td>\n</tr>\n<tr>\n<td>status_200</td>\n<td>integer</td>\n<td>Number of responses received with status code 200 (Success) from origin.</td>\n</tr>\n<tr>\n<td>status_204</td>\n<td>integer</td>\n<td>Number of responses received with status code 204 (No Content) from origin.</td>\n</tr>\n<tr>\n<td>status_206</td>\n<td>integer</td>\n<td>Number of responses received with status code 206 (Partial Content) from origin.</td>\n</tr>\n<tr>\n<td>status_2xx</td>\n<td>integer</td>\n<td>Number of 2xx \"Success\" status codes delivered from origin.</td>\n</tr>\n<tr>\n<td>status_301</td>\n<td>integer</td>\n<td>Number of responses received with status code 301 (Moved Permanently) from origin.</td>\n</tr>\n<tr>\n<td>status_302</td>\n<td>integer</td>\n<td>Number of responses received with status code 302 (Found) from origin.</td>\n</tr>\n<tr>\n<td>status_304</td>\n<td>integer</td>\n<td>Number of responses received with status code 304 (Not Modified) from origin.</td>\n</tr>\n<tr>\n<td>status_3xx</td>\n<td>integer</td>\n<td>Number of 3xx \"Redirection\" codes delivered from origin.</td>\n</tr>\n<tr>\n<td>status_400</td>\n<td>integer</td>\n<td>Number of responses received with status code 400 (Bad Request) from origin.</td>\n</tr>\n<tr>\n<td>status_401</td>\n<td>integer</td>\n<td>Number of responses received with status code 401 (Unauthorized) from origin.</td>\n</tr>\n<tr>\n<td>status_403</td>\n<td>integer</td>\n<td>Number of responses received with status code 403 (Forbidden) from origin.</td>\n</tr>\n<tr>\n<td>status_404</td>\n<td>integer</td>\n<td>Number of responses received with status code 404 (Not Found) from origin.</td>\n</tr>\n<tr>\n<td>status_416</td>\n<td>integer</td>\n<td>Number of responses received with status code 416 (Range Not Satisfiable) from origin.</td>\n</tr>\n<tr>\n<td>status_429</td>\n<td>integer</td>\n<td>Number of responses received with status code 429 (Too Many Requests) from origin.</td>\n</tr>\n<tr>\n<td>status_4xx</td>\n<td>integer</td>\n<td>Number of 4xx \"Client Error\" codes delivered from origin.</td>\n</tr>\n<tr>\n<td>status_500</td>\n<td>integer</td>\n<td>Number of responses received with status code 500 (Internal Server Error) from origin.</td>\n</tr>\n<tr>\n<td>status_501</td>\n<td>integer</td>\n<td>Number of responses received with status code 501 (Not Implemented) from origin.</td>\n</tr>\n<tr>\n<td>status_502</td>\n<td>integer</td>\n<td>Number of responses received with status code 502 (Bad Gateway) from origin.</td>\n</tr>\n<tr>\n<td>status_503</td>\n<td>integer</td>\n<td>Number of responses received with status code 503 (Service Unavailable) from origin.</td>\n</tr>\n<tr>\n<td>status_504</td>\n<td>integer</td>\n<td>Number of responses received with status code 504 (Gateway Timeout) from origin.</td>\n</tr>\n<tr>\n<td>status_505</td>\n<td>integer</td>\n<td>Number of responses received with status code 505 (HTTP Version Not Supported) from origin.</td>\n</tr>\n<tr>\n<td>status_530</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 530.</td>\n</tr>\n<tr>\n<td>status_5xx</td>\n<td>integer</td>\n<td>Number of 5xx \"Server Error\" codes delivered from origin.</td>\n</tr>\n<tr>\n<td>waf_latency_0_to_1ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 0 and 1 millisecond received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_latency_10000_to_60000ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 10,000 and 60,000 milliseconds received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_latency_1000_to_5000ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 1,000 and 5,000 milliseconds received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_latency_100_to_250ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 100 and 250 milliseconds received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_latency_10_to_50ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 10 and 50 milliseconds received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_latency_1_to_5ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 1 and 5 milliseconds received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_latency_250_to_500ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 250 and 500 milliseconds received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_latency_5000_to_10000ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 5,000 and 10,000 milliseconds received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_latency_500_to_1000ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 500 and 1,000 milliseconds received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_latency_50_to_100ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 50 and 100 milliseconds received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_latency_5_to_10ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 5 and 10 milliseconds received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_latency_60000ms</td>\n<td>integer</td>\n<td>Number of responses with latency of 60,000 milliseconds and above received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_resp_body_bytes</td>\n<td>integer</td>\n<td>Number of body bytes received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_resp_header_bytes</td>\n<td>integer</td>\n<td>Number of header bytes received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_responses</td>\n<td>integer</td>\n<td>Number of responses received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_1xx</td>\n<td>integer</td>\n<td>Number of 1xx \"Informational\" status codes received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_200</td>\n<td>integer</td>\n<td>Number of responses received with status code 200 (Success) received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_204</td>\n<td>integer</td>\n<td>Number of responses received with status code 204 (No Content) received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_206</td>\n<td>integer</td>\n<td>Number of responses received with status code 206 (Partial Content) received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_2xx</td>\n<td>integer</td>\n<td>Number of 2xx \"Success\" status codes received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_301</td>\n<td>integer</td>\n<td>Number of responses received with status code 301 (Moved Permanently) received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_302</td>\n<td>integer</td>\n<td>Number of responses received with status code 302 (Found) received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_304</td>\n<td>integer</td>\n<td>Number of responses received with status code 304 (Not Modified) received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_3xx</td>\n<td>integer</td>\n<td>Number of 3xx \"Redirection\" codes received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_400</td>\n<td>integer</td>\n<td>Number of responses received with status code 400 (Bad Request) received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_401</td>\n<td>integer</td>\n<td>Number of responses received with status code 401 (Unauthorized) received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_403</td>\n<td>integer</td>\n<td>Number of responses received with status code 403 (Forbidden) received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_404</td>\n<td>integer</td>\n<td>Number of responses received with status code 404 (Not Found) received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_416</td>\n<td>integer</td>\n<td>Number of responses received with status code 416 (Range Not Satisfiable) received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_429</td>\n<td>integer</td>\n<td>Number of responses received with status code 429 (Too Many Requests) received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_4xx</td>\n<td>integer</td>\n<td>Number of 4xx \"Client Error\" codes received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_500</td>\n<td>integer</td>\n<td>Number of responses received with status code 500 (Internal Server Error) received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_501</td>\n<td>integer</td>\n<td>Number of responses received with status code 501 (Not Implemented) received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_502</td>\n<td>integer</td>\n<td>Number of responses received with status code 502 (Bad Gateway) received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_503</td>\n<td>integer</td>\n<td>Number of responses received with status code 503 (Service Unavailable) received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_504</td>\n<td>integer</td>\n<td>Number of responses received with status code 504 (Gateway Timeout) received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_505</td>\n<td>integer</td>\n<td>Number of responses received with status code 505 (HTTP Version Not Supported) received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_530</td>\n<td>integer</td>\n<td>Number of responses received with status code 530 received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_5xx</td>\n<td>integer</td>\n<td>Number of 5xx \"Server Error\" codes received for origin requests made by the Fastly WAF.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"ab5dd43e-cb1b-433c-947d-41ac93924d3a"},{"name":"Origin Inspector Real-time API","item":[{"name":"Get real-time origin data from specific time","id":"7482e86c-b1a1-4af7-882f-52d372a05236","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"rt.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/v1/origins/{{service_id}}/ts/{{start_timestamp}}","description":"<p>Get real-time origin data for the specified reporting period. Specify 0 to get a single entry for the last complete second. The Timestamp field included in the response provides the time index of the latest entry in the dataset and can be provided as the start_timestamp of the next request for a seamless continuation of the dataset from one request to the next.\nDue to processing latency, the earliest entry in the response dataset may be earlier than start_timestamp by the value of AggregateDelay.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["v1","origins","{{service_id}}","ts","{{start_timestamp}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"8091ad93-6324-408e-8a70-f5b4f57948f9","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"rt.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/v1/origins/SU1Z0isxPaozGVKXdv0eY/ts/1608560817","description":"Get real-time origin data for the specified reporting period. Specify 0 to get a single entry for the last complete second. The Timestamp field included in the response provides the time index of the latest entry in the dataset and can be provided as the start_timestamp of the next request for a seamless continuation of the dataset from one request to the next.\nDue to processing latency, the earliest entry in the response dataset may be earlier than start_timestamp by the value of AggregateDelay.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"Data\":[{\"datacenter\":{\"STP\":{\"origin_1\":{\"responses\":5,\"resp_header_bytes\":1200,\"resp_body_bytes\":1850,\"status_4xx\":5,\"status_403\":5}}},\"aggregated\":{\"origin_1\":{\"responses\":5,\"resp_header_bytes\":1200,\"resp_body_bytes\":1850,\"status_4xx\":5,\"status_403\":5}},\"recorded\":1589198016}],\"Timestamp\":1589198025,\"AggregateDelay\":9}"}],"_postman_id":"7482e86c-b1a1-4af7-882f-52d372a05236"},{"name":"Get real-time origin data for the last 120 seconds","id":"c6f4a829-6663-4283-a6fa-f44d76ffe4eb","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"rt.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/v1/origins/{{service_id}}/ts/h","description":"<p>Get data for the 120 seconds preceding the latest timestamp available for a service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["v1","origins","{{service_id}}","ts","h"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"cefcc051-3652-4500-9ec8-4aa0bdcefcdd","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"rt.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/v1/origins/SU1Z0isxPaozGVKXdv0eY/ts/h","description":"Get data for the 120 seconds preceding the latest timestamp available for a service.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"Data\":[{\"datacenter\":{\"STP\":{\"origin_1\":{\"responses\":5,\"resp_header_bytes\":1200,\"resp_body_bytes\":1850,\"status_4xx\":5,\"status_403\":5}}},\"aggregated\":{\"origin_1\":{\"responses\":5,\"resp_header_bytes\":1200,\"resp_body_bytes\":1850,\"status_4xx\":5,\"status_403\":5}},\"recorded\":1589198016}],\"Timestamp\":1589198025,\"AggregateDelay\":9}"}],"_postman_id":"c6f4a829-6663-4283-a6fa-f44d76ffe4eb"},{"name":"Get a limited number of real-time origin data entries","id":"b6a0fc6b-e292-4af4-a694-c020c2f6a9df","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"rt.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/v1/origins/{{service_id}}/ts/h/limit/{{max_entries}}","description":"<p>Get data for the max_entries seconds preceding the latest timestamp available for a service, up to a maximum of 120 entries.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["v1","origins","{{service_id}}","ts","h","limit","{{max_entries}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"b47d662b-4e0d-4854-97fb-9e93e7eb3a74","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"rt.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/v1/origins/SU1Z0isxPaozGVKXdv0eY/ts/h/limit/1","description":"Get data for the max_entries seconds preceding the latest timestamp available for a service, up to a maximum of 120 entries.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"Data\":[{\"datacenter\":{\"STP\":{\"origin_1\":{\"responses\":5,\"resp_header_bytes\":1200,\"resp_body_bytes\":1850,\"status_4xx\":5,\"status_403\":5}}},\"aggregated\":{\"origin_1\":{\"responses\":5,\"resp_header_bytes\":1200,\"resp_body_bytes\":1850,\"status_4xx\":5,\"status_403\":5}},\"recorded\":1589198016}],\"Timestamp\":1589198025,\"AggregateDelay\":9}"}],"_postman_id":"b6a0fc6b-e292-4af4-a694-c020c2f6a9df"}],"id":"8d421069-d00c-4952-9669-62383a777414","description":"<p>Origin Inspector offers a real-time JSON-formatted data stream providing visibility into responses delivered from your origin servers to Fastly. The API offers a standardized set of data to report in real-time every origin response, byte, and status code received by a specified service in one-second periods up to the last complete second.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>AggregateDelay</td>\n<td>integer</td>\n<td>Offset of entry timestamps from the current time due to processing time.</td>\n</tr>\n<tr>\n<td>Data</td>\n<td>array</td>\n<td>A list of report entries, each representing one second of time.</td>\n</tr>\n<tr>\n<td>Timestamp</td>\n<td>integer</td>\n<td>Value to use for subsequent requests.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-1\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>all_latency_0_to_1ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 0 and 1 millisecond received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_latency_10000_to_60000ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 10,000 and 60,000 milliseconds received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_latency_1000_to_5000ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 1,000 and 5,000 milliseconds received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_latency_100_to_250ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 100 and 250 milliseconds received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_latency_10_to_50ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 10 and 50 milliseconds received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_latency_1_to_5ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 1 and 5 milliseconds received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_latency_250_to_500ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 250 and 500 milliseconds received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_latency_5000_to_10000ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 5,000 and 10,000 milliseconds received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_latency_500_to_1000ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 500 and 1,000 milliseconds received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_latency_50_to_100ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 50 and 100 milliseconds received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_latency_5_to_10ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 5 and 10 milliseconds received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_latency_60000ms</td>\n<td>integer</td>\n<td>Number of responses with latency of 60,000 milliseconds and above received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_resp_body_bytes</td>\n<td>integer</td>\n<td>Number of body bytes received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_resp_header_bytes</td>\n<td>integer</td>\n<td>Number of header bytes received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_responses</td>\n<td>integer</td>\n<td>Number of responses received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_1xx</td>\n<td>integer</td>\n<td>Number of 1xx \"Informational\" category status codes delivered received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_200</td>\n<td>integer</td>\n<td>Number of responses received with status code 200 (Success) received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_204</td>\n<td>integer</td>\n<td>Number of responses received with status code 204 (No Content) received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_206</td>\n<td>integer</td>\n<td>Number of responses received with status code 206 (Partial Content) received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_2xx</td>\n<td>integer</td>\n<td>Number of 2xx \"Success\" status codes received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_301</td>\n<td>integer</td>\n<td>Number of responses received with status code 301 (Moved Permanently) received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_302</td>\n<td>integer</td>\n<td>Number of responses received with status code 302 (Found) received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_304</td>\n<td>integer</td>\n<td>Number of responses received with status code 304 (Not Modified) received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_3xx</td>\n<td>integer</td>\n<td>Number of 3xx \"Redirection\" codes received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_400</td>\n<td>integer</td>\n<td>Number of responses received with status code 400 (Bad Request) received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_401</td>\n<td>integer</td>\n<td>Number of responses received with status code 401 (Unauthorized) received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_403</td>\n<td>integer</td>\n<td>Number of responses received with status code 403 (Forbidden) received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_404</td>\n<td>integer</td>\n<td>Number of responses received with status code 404 (Not Found) received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_416</td>\n<td>integer</td>\n<td>Number of responses received with status code 416 (Range Not Satisfiable) received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_429</td>\n<td>integer</td>\n<td>Number of responses received with status code 429 (Too Many Requests) received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_4xx</td>\n<td>integer</td>\n<td>Number of 4xx \"Client Error\" codes received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_500</td>\n<td>integer</td>\n<td>Number of responses received with status code 500 (Internal Server Error) received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_501</td>\n<td>integer</td>\n<td>Number of responses received with status code 501 (Not Implemented) received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_502</td>\n<td>integer</td>\n<td>Number of responses received with status code 502 (Bad Gateway) received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_503</td>\n<td>integer</td>\n<td>Number of responses received with status code 503 (Service Unavailable) received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_504</td>\n<td>integer</td>\n<td>Number of responses received with status code 504 (Gateway Timeout) received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_505</td>\n<td>integer</td>\n<td>Number of responses received with status code 505 (HTTP Version Not Supported) received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_530</td>\n<td>integer</td>\n<td>Number of responses received with status code 530 received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>all_status_5xx</td>\n<td>integer</td>\n<td>Number of 5xx \"Server Error\" codes received for origin requests made by all sources.</td>\n</tr>\n<tr>\n<td>compute_latency_0_to_1ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 0 and 1 millisecond for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_latency_10000_to_60000ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 10,000 and 60,000 milliseconds for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_latency_1000_to_5000ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 1,000 and 5,000 milliseconds for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_latency_100_to_250ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 100 and 250 milliseconds for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_latency_10_to_50ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 10 and 50 milliseconds for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_latency_1_to_5ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 1 and 5 milliseconds for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_latency_250_to_500ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 250 and 500 milliseconds for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_latency_5000_to_10000ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 5,000 and 10,000 milliseconds for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_latency_500_to_1000ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 500 and 1,000 milliseconds for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_latency_50_to_100ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 50 and 100 milliseconds for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_latency_5_to_10ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 5 and 10 milliseconds for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_latency_60000ms</td>\n<td>integer</td>\n<td>Number of responses with latency of 60,000 milliseconds and above for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_body_bytes</td>\n<td>integer</td>\n<td>Number of body bytes for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_resp_header_bytes</td>\n<td>integer</td>\n<td>Number of header bytes for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_responses</td>\n<td>integer</td>\n<td>Number of responses for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_1xx</td>\n<td>integer</td>\n<td>Number of 1xx \"Informational\" status codes for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_200</td>\n<td>integer</td>\n<td>Number of responses received with status code 200 (Success) for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_204</td>\n<td>integer</td>\n<td>Number of responses received with status code 204 (No Content) for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_206</td>\n<td>integer</td>\n<td>Number of responses received with status code 206 (Partial Content) for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_2xx</td>\n<td>integer</td>\n<td>Number of 2xx \"Success\" status codes for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_301</td>\n<td>integer</td>\n<td>Number of responses received with status code 301 (Moved Permanently) for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_302</td>\n<td>integer</td>\n<td>Number of responses received with status code 302 (Found) for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_304</td>\n<td>integer</td>\n<td>Number of responses received with status code 304 (Not Modified) for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_3xx</td>\n<td>integer</td>\n<td>Number of 3xx \"Redirection\" codes for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_400</td>\n<td>integer</td>\n<td>Number of responses received with status code 400 (Bad Request) for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_401</td>\n<td>integer</td>\n<td>Number of responses received with status code 401 (Unauthorized) for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_403</td>\n<td>integer</td>\n<td>Number of responses received with status code 403 (Forbidden) for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_404</td>\n<td>integer</td>\n<td>Number of responses received with status code 404 (Not Found) for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_416</td>\n<td>integer</td>\n<td>Number of responses received with status code 416 (Range Not Satisfiable) for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_429</td>\n<td>integer</td>\n<td>Number of responses received with status code 429 (Too Many Requests) for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_4xx</td>\n<td>integer</td>\n<td>Number of 4xx \"Client Error\" codes for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_500</td>\n<td>integer</td>\n<td>Number of responses received with status code 500 (Internal Server Error) for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_501</td>\n<td>integer</td>\n<td>Number of responses received with status code 501 (Not Implemented) for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_502</td>\n<td>integer</td>\n<td>Number of responses received with status code 502 (Bad Gateway) for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_503</td>\n<td>integer</td>\n<td>Number of responses received with status code 503 (Service Unavailable) for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_504</td>\n<td>integer</td>\n<td>Number of responses received with status code 504 (Gateway Timeout) for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_505</td>\n<td>integer</td>\n<td>Number of responses received with status code 505 (HTTP Version Not Supported) for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_530</td>\n<td>integer</td>\n<td>Number of responses received with status code 530 for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>compute_status_5xx</td>\n<td>integer</td>\n<td>Number of 5xx \"Server Error\" codes for origin received by the Compute platform.</td>\n</tr>\n<tr>\n<td>latency_0_to_1ms</td>\n<td>integer</td>\n<td>Number of responses from origin with latency between 0 and 1 millisecond.</td>\n</tr>\n<tr>\n<td>latency_10000_to_60000ms</td>\n<td>integer</td>\n<td>Number of responses from origin with latency between 10,000 and 60,000 milliseconds.</td>\n</tr>\n<tr>\n<td>latency_1000_to_5000ms</td>\n<td>integer</td>\n<td>Number of responses from origin with latency between 1,000 and 5,000 milliseconds.</td>\n</tr>\n<tr>\n<td>latency_100_to_250ms</td>\n<td>integer</td>\n<td>Number of responses from origin with latency between 100 and 250 milliseconds.</td>\n</tr>\n<tr>\n<td>latency_10_to_50ms</td>\n<td>integer</td>\n<td>Number of responses from origin with latency between 10 and 50 milliseconds.</td>\n</tr>\n<tr>\n<td>latency_1_to_5ms</td>\n<td>integer</td>\n<td>Number of responses from origin with latency between 1 and 5 milliseconds.</td>\n</tr>\n<tr>\n<td>latency_250_to_500ms</td>\n<td>integer</td>\n<td>Number of responses from origin with latency between 250 and 500 milliseconds.</td>\n</tr>\n<tr>\n<td>latency_5000_to_10000ms</td>\n<td>integer</td>\n<td>Number of responses from origin with latency between 5,000 and 10,000 milliseconds.</td>\n</tr>\n<tr>\n<td>latency_500_to_1000ms</td>\n<td>integer</td>\n<td>Number of responses from origin with latency between 500 and 1,000 milliseconds.</td>\n</tr>\n<tr>\n<td>latency_50_to_100ms</td>\n<td>integer</td>\n<td>Number of responses from origin with latency between 50 and 100 milliseconds.</td>\n</tr>\n<tr>\n<td>latency_5_to_10ms</td>\n<td>integer</td>\n<td>Number of responses from origin with latency between 5 and 10 milliseconds.</td>\n</tr>\n<tr>\n<td>latency_60000ms</td>\n<td>integer</td>\n<td>Number of responses from origin with latency of 60,000 milliseconds and above.</td>\n</tr>\n<tr>\n<td>resp_body_bytes</td>\n<td>integer</td>\n<td>Number of body bytes from origin.</td>\n</tr>\n<tr>\n<td>resp_header_bytes</td>\n<td>integer</td>\n<td>Number of header bytes from origin.</td>\n</tr>\n<tr>\n<td>responses</td>\n<td>integer</td>\n<td>Number of responses from origin.</td>\n</tr>\n<tr>\n<td>status_1xx</td>\n<td>integer</td>\n<td>Number of 1xx \"Informational\" status codes delivered from origin.</td>\n</tr>\n<tr>\n<td>status_200</td>\n<td>integer</td>\n<td>Number of responses received with status code 200 (Success) from origin.</td>\n</tr>\n<tr>\n<td>status_204</td>\n<td>integer</td>\n<td>Number of responses received with status code 204 (No Content) from origin.</td>\n</tr>\n<tr>\n<td>status_206</td>\n<td>integer</td>\n<td>Number of responses received with status code 206 (Partial Content) from origin.</td>\n</tr>\n<tr>\n<td>status_2xx</td>\n<td>integer</td>\n<td>Number of 2xx \"Success\" status codes delivered from origin.</td>\n</tr>\n<tr>\n<td>status_301</td>\n<td>integer</td>\n<td>Number of responses received with status code 301 (Moved Permanently) from origin.</td>\n</tr>\n<tr>\n<td>status_302</td>\n<td>integer</td>\n<td>Number of responses received with status code 302 (Found) from origin.</td>\n</tr>\n<tr>\n<td>status_304</td>\n<td>integer</td>\n<td>Number of responses received with status code 304 (Not Modified) from origin.</td>\n</tr>\n<tr>\n<td>status_3xx</td>\n<td>integer</td>\n<td>Number of 3xx \"Redirection\" codes delivered from origin.</td>\n</tr>\n<tr>\n<td>status_400</td>\n<td>integer</td>\n<td>Number of responses received with status code 400 (Bad Request) from origin.</td>\n</tr>\n<tr>\n<td>status_401</td>\n<td>integer</td>\n<td>Number of responses received with status code 401 (Unauthorized) from origin.</td>\n</tr>\n<tr>\n<td>status_403</td>\n<td>integer</td>\n<td>Number of responses received with status code 403 (Forbidden) from origin.</td>\n</tr>\n<tr>\n<td>status_404</td>\n<td>integer</td>\n<td>Number of responses received with status code 404 (Not Found) from origin.</td>\n</tr>\n<tr>\n<td>status_416</td>\n<td>integer</td>\n<td>Number of responses received with status code 416 (Range Not Satisfiable) from origin.</td>\n</tr>\n<tr>\n<td>status_429</td>\n<td>integer</td>\n<td>Number of responses received with status code 429 (Too Many Requests) from origin.</td>\n</tr>\n<tr>\n<td>status_4xx</td>\n<td>integer</td>\n<td>Number of 4xx \"Client Error\" codes delivered from origin.</td>\n</tr>\n<tr>\n<td>status_500</td>\n<td>integer</td>\n<td>Number of responses received with status code 500 (Internal Server Error) from origin.</td>\n</tr>\n<tr>\n<td>status_501</td>\n<td>integer</td>\n<td>Number of responses received with status code 501 (Not Implemented) from origin.</td>\n</tr>\n<tr>\n<td>status_502</td>\n<td>integer</td>\n<td>Number of responses received with status code 502 (Bad Gateway) from origin.</td>\n</tr>\n<tr>\n<td>status_503</td>\n<td>integer</td>\n<td>Number of responses received with status code 503 (Service Unavailable) from origin.</td>\n</tr>\n<tr>\n<td>status_504</td>\n<td>integer</td>\n<td>Number of responses received with status code 504 (Gateway Timeout) from origin.</td>\n</tr>\n<tr>\n<td>status_505</td>\n<td>integer</td>\n<td>Number of responses received with status code 505 (HTTP Version Not Supported) from origin.</td>\n</tr>\n<tr>\n<td>status_530</td>\n<td>integer</td>\n<td>Number of responses received from origin with status code 530.</td>\n</tr>\n<tr>\n<td>status_5xx</td>\n<td>integer</td>\n<td>Number of 5xx \"Server Error\" codes delivered from origin.</td>\n</tr>\n<tr>\n<td>waf_latency_0_to_1ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 0 and 1 millisecond received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_latency_10000_to_60000ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 10,000 and 60,000 milliseconds received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_latency_1000_to_5000ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 1,000 and 5,000 milliseconds received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_latency_100_to_250ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 100 and 250 milliseconds received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_latency_10_to_50ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 10 and 50 milliseconds received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_latency_1_to_5ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 1 and 5 milliseconds received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_latency_250_to_500ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 250 and 500 milliseconds received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_latency_5000_to_10000ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 5,000 and 10,000 milliseconds received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_latency_500_to_1000ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 500 and 1,000 milliseconds received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_latency_50_to_100ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 50 and 100 milliseconds received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_latency_5_to_10ms</td>\n<td>integer</td>\n<td>Number of responses with latency between 5 and 10 milliseconds received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_latency_60000ms</td>\n<td>integer</td>\n<td>Number of responses with latency of 60,000 milliseconds and above received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_resp_body_bytes</td>\n<td>integer</td>\n<td>Number of body bytes received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_resp_header_bytes</td>\n<td>integer</td>\n<td>Number of header bytes received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_responses</td>\n<td>integer</td>\n<td>Number of responses received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_1xx</td>\n<td>integer</td>\n<td>Number of 1xx \"Informational\" status codes received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_200</td>\n<td>integer</td>\n<td>Number of responses received with status code 200 (Success) received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_204</td>\n<td>integer</td>\n<td>Number of responses received with status code 204 (No Content) received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_206</td>\n<td>integer</td>\n<td>Number of responses received with status code 206 (Partial Content) received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_2xx</td>\n<td>integer</td>\n<td>Number of 2xx \"Success\" status codes received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_301</td>\n<td>integer</td>\n<td>Number of responses received with status code 301 (Moved Permanently) received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_302</td>\n<td>integer</td>\n<td>Number of responses received with status code 302 (Found) received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_304</td>\n<td>integer</td>\n<td>Number of responses received with status code 304 (Not Modified) received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_3xx</td>\n<td>integer</td>\n<td>Number of 3xx \"Redirection\" codes received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_400</td>\n<td>integer</td>\n<td>Number of responses received with status code 400 (Bad Request) received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_401</td>\n<td>integer</td>\n<td>Number of responses received with status code 401 (Unauthorized) received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_403</td>\n<td>integer</td>\n<td>Number of responses received with status code 403 (Forbidden) received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_404</td>\n<td>integer</td>\n<td>Number of responses received with status code 404 (Not Found) received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_416</td>\n<td>integer</td>\n<td>Number of responses received with status code 416 (Range Not Satisfiable) received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_429</td>\n<td>integer</td>\n<td>Number of responses received with status code 429 (Too Many Requests) received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_4xx</td>\n<td>integer</td>\n<td>Number of 4xx \"Client Error\" codes received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_500</td>\n<td>integer</td>\n<td>Number of responses received with status code 500 (Internal Server Error) received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_501</td>\n<td>integer</td>\n<td>Number of responses received with status code 501 (Not Implemented) received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_502</td>\n<td>integer</td>\n<td>Number of responses received with status code 502 (Bad Gateway) received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_503</td>\n<td>integer</td>\n<td>Number of responses received with status code 503 (Service Unavailable) received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_504</td>\n<td>integer</td>\n<td>Number of responses received with status code 504 (Gateway Timeout) received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_505</td>\n<td>integer</td>\n<td>Number of responses received with status code 505 (HTTP Version Not Supported) received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_530</td>\n<td>integer</td>\n<td>Number of responses received with status code 530 received for origin requests made by the Fastly WAF.</td>\n</tr>\n<tr>\n<td>waf_status_5xx</td>\n<td>integer</td>\n<td>Number of 5xx \"Server Error\" codes received for origin requests made by the Fastly WAF.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-2\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>aggregated</td>\n<td>object</td>\n<td>Groups measurements by backend name.</td>\n</tr>\n<tr>\n<td>datacenter</td>\n<td>object</td>\n<td>Groups measurements by POP, then backend name. See the POPs API for details about POP identifiers.</td>\n</tr>\n<tr>\n<td>recorded</td>\n<td>integer</td>\n<td>The Unix timestamp at which this record's data was generated.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"8d421069-d00c-4952-9669-62383a777414"}],"id":"c00b18ed-dfbb-498b-b58c-fb6227689937","_postman_id":"c00b18ed-dfbb-498b-b58c-fb6227689937","description":""},{"name":"Next-Gen WAF","item":[{"name":"Agent Keys","item":[{"name":"List agent keys for a workspace","id":"ecae3f6b-26c4-4d4a-80a6-5521c3c1f018","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/agent-keys","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/ngwaf/agent-keys/#ngwafListAgentKeys\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","agent-keys"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"b64c6c47-8c85-4d1a-925b-c41e94949a01","name":"200 List of agent keys.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/agent-keys","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/ngwaf/agent-keys/#ngwafListAgentKeys)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 List of agent keys.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"meta\":{\"total\":2},\"data\":[{\"access_key\":\"d217f023-616e-4389-a230-1665c7c44010\",\"secret_key\":\"rNs7ti7dvbt0k2Ob4qCCL-Prob5QIRSNOyyp3cj79vs\",\"is_primary\":true,\"created_at\":\"2019-08-20T18:07:33Z\",\"updated_at\":\"2021-04-19T03:29:30Z\"},{\"access_key\":\"a3b5c7d9-e1f2-3456-a789-0bc1d2e3f456\",\"secret_key\":\"Ks8Yt2Qb7Xn4Lm6Wp0Rj3Hv5Fd9Gc1Ae8Bi4Co7Du\",\"is_primary\":false,\"created_at\":\"2020-03-15T10:22:45Z\",\"updated_at\":\"2020-03-15T10:22:45Z\"}]}"}],"_postman_id":"ecae3f6b-26c4-4d4a-80a6-5521c3c1f018"}],"id":"644f843c-9a76-4626-b0ba-b49e1fe00dce","description":"<p>Agent keys endpoints provide functionality for listing agent configuration keys associated with a workspace.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>access_key</td>\n<td>string</td>\n<td>Agent configuration access key value.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time the agent key was created.</td>\n</tr>\n<tr>\n<td>is_primary</td>\n<td>boolean</td>\n<td>Whether the agent key is the primary key that should be used to configure the agent.</td>\n</tr>\n<tr>\n<td>secret_key</td>\n<td>string</td>\n<td>Agent configuration secret key value.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time the agent key was last updated.</td>\n</tr>\n<tr>\n<td>total</td>\n<td>integer</td>\n<td>Total number of agent keys.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"644f843c-9a76-4626-b0ba-b49e1fe00dce"},{"name":"Agents","item":[{"name":"List agents","id":"c8d65546-245d-4609-b756-57af9df7a2a5","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/agents","description":"<p>List all agents deployed in a workspace.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","agents"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"d0bf0dd3-30a7-44d5-9f16-544b14db0dbb","name":"200 List of agents in the workspace.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/agents","description":"List all agents deployed in a workspace.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 List of agents in the workspace.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"meta\":{\"total\":2},\"data\":[{\"agent_id\":\"54de69dcba53b02fbf000018\",\"agent_name\":\"web-server-01\",\"agent_active\":true,\"agent_args\":\"\",\"agent_build_id\":\"a1b2c3d4\",\"agent_cgroup\":\"\",\"agent_connections_dropped_count\":0,\"agent_connections_open_count\":5,\"agent_connections_total_count\":12345,\"agent_current_requests\":42,\"agent_decision_time_50th\":0.5,\"agent_decision_time_95th\":1.2,\"agent_decision_time_99th\":2.1,\"agent_enabled\":true,\"agent_last_rule_updated_at\":\"2025-06-15T10:30:00Z\",\"agent_last_seen_at\":\"2026-02-17T12:00:00Z\",\"agent_max_procs\":4,\"agent_read_bytes\":1048576,\"agent_rule_update_count\":150,\"agent_pid\":12345,\"agent_status\":\"online\",\"agent_timestamp\":\"2026-02-17T12:00:00Z\",\"agent_timezone\":\"UTC\",\"agent_timezone_offset\":0,\"agent_upload_metadata_failure_count\":0,\"agent_upload_size\":4096,\"agent_uptime\":86400,\"agent_version\":\"4.27.0\",\"agent_versions_behind\":0,\"agent_write_bytes\":2097152,\"agent_latency_time_50th\":1.22343,\"agent_latency_time_95th\":1.22343,\"agent_latency_time_99th\":1.16432,\"host_agent_cpu\":2.5,\"host_clock_skew\":2,\"host_cpu\":45.3,\"host_os\":\"linux/ubuntu/debian/22.04\",\"host_remote_ip\":\"203.0.113.50\",\"module_detected\":true,\"module_server\":\"nginx/1.24.0\",\"module_type\":\"fastly-module-nginx\",\"module_version\":\"2.3.1\",\"module_versions_behind\":0,\"runtime_gc_pause_millis\":12.5,\"runtime_memory_bytes_used\":52428800,\"runtime_num_gc\":320,\"runtime_num_goroutines\":15},{\"agent_id\":\"54de69dcba53b02fbf000019\",\"agent_name\":\"web-server-02\",\"agent_active\":false,\"agent_args\":\"\",\"agent_build_id\":\"a1b2c3d4\",\"agent_cgroup\":\"\",\"agent_connections_dropped_count\":0,\"agent_connections_open_count\":0,\"agent_connections_total_count\":9876,\"agent_current_requests\":0,\"agent_decision_time_50th\":0.4,\"agent_decision_time_95th\":1,\"agent_decision_time_99th\":1.8,\"agent_enabled\":true,\"agent_last_rule_updated_at\":\"2025-06-15T10:30:00Z\",\"agent_last_seen_at\":\"2026-02-16T08:15:00Z\",\"agent_max_procs\":4,\"agent_read_bytes\":524288,\"agent_rule_update_count\":148,\"agent_pid\":54321,\"agent_status\":\"offline\",\"agent_timestamp\":\"2026-02-16T08:15:00Z\",\"agent_timezone\":\"America/New_York\",\"agent_timezone_offset\":-18000,\"agent_upload_metadata_failure_count\":3,\"agent_upload_size\":2048,\"agent_uptime\":172800,\"agent_version\":\"4.26.0\",\"agent_versions_behind\":1,\"agent_write_bytes\":1048576,\"agent_latency_time_50th\":1.1,\"agent_latency_time_95th\":1.5,\"agent_latency_time_99th\":2,\"host_agent_cpu\":0,\"host_clock_skew\":5,\"host_cpu\":12.1,\"host_os\":\"linux/ubuntu/debian/20.04\",\"host_remote_ip\":\"203.0.113.51\",\"module_detected\":true,\"module_server\":\"nginx/1.22.0\",\"module_type\":\"fastly-module-nginx\",\"module_version\":\"2.2.0\",\"module_versions_behind\":1,\"runtime_gc_pause_millis\":8.2,\"runtime_memory_bytes_used\":41943040,\"runtime_num_gc\":280,\"runtime_num_goroutines\":10}]}"}],"_postman_id":"c8d65546-245d-4609-b756-57af9df7a2a5"},{"name":"Get an agent","id":"c205d2be-3c03-4e8a-9711-87912d3b7ff2","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/agents/{{agent_id}}","description":"<p>Retrieve a specific agent deployed in a workspace.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","agents","{{agent_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"75725285-86f4-4507-b376-103f12a2525c","name":"200 Requested agent.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/agents/54de69dcba53b02fbf000018","description":"Retrieve a specific agent deployed in a workspace.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Requested agent.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"agent_id\":\"54de69dcba53b02fbf000018\",\"agent_name\":\"web-server-01\",\"agent_active\":true,\"agent_args\":\"\",\"agent_build_id\":\"a1b2c3d4\",\"agent_cgroup\":\"\",\"agent_connections_dropped_count\":0,\"agent_connections_open_count\":5,\"agent_connections_total_count\":12345,\"agent_current_requests\":42,\"agent_decision_time_50th\":0.5,\"agent_decision_time_95th\":1.2,\"agent_decision_time_99th\":2.1,\"agent_enabled\":true,\"agent_last_rule_updated_at\":\"2025-06-15T10:30:00Z\",\"agent_last_seen_at\":\"2026-02-17T12:00:00Z\",\"agent_max_procs\":4,\"agent_read_bytes\":1048576,\"agent_rule_update_count\":150,\"agent_pid\":12345,\"agent_status\":\"online\",\"agent_timestamp\":\"2026-02-17T12:00:00Z\",\"agent_timezone\":\"UTC\",\"agent_timezone_offset\":0,\"agent_upload_metadata_failure_count\":0,\"agent_upload_size\":4096,\"agent_uptime\":86400,\"agent_version\":\"4.27.0\",\"agent_versions_behind\":0,\"agent_write_bytes\":2097152,\"agent_latency_time_50th\":1.22343,\"agent_latency_time_95th\":1.22343,\"agent_latency_time_99th\":1.16432,\"host_agent_cpu\":2.5,\"host_clock_skew\":2,\"host_cpu\":45.3,\"host_os\":\"linux/ubuntu/debian/22.04\",\"host_remote_ip\":\"203.0.113.50\",\"module_detected\":true,\"module_server\":\"nginx/1.24.0\",\"module_type\":\"fastly-module-nginx\",\"module_version\":\"2.3.1\",\"module_versions_behind\":0,\"runtime_gc_pause_millis\":12.5,\"runtime_memory_bytes_used\":52428800,\"runtime_num_gc\":320,\"runtime_num_goroutines\":15}"}],"_postman_id":"c205d2be-3c03-4e8a-9711-87912d3b7ff2"}],"id":"383a0480-b4b1-436d-930f-a42a95b9f61e","description":"<p>Agents allows you to list and retrieve Next-Gen WAF agents deployed in a workspace.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>agent_active</td>\n<td>boolean</td>\n<td>Whether the agent was seen in the past 5 minutes.</td>\n</tr>\n<tr>\n<td>agent_args</td>\n<td>string</td>\n<td>Command-line arguments the agent was started with.</td>\n</tr>\n<tr>\n<td>agent_build_id</td>\n<td>string</td>\n<td>Commit SHA of the current agent build.</td>\n</tr>\n<tr>\n<td>agent_cgroup</td>\n<td>string</td>\n<td>Control group of the agent process.</td>\n</tr>\n<tr>\n<td>agent_connections_dropped_count</td>\n<td>integer</td>\n<td>Number of connections dropped by the agent.</td>\n</tr>\n<tr>\n<td>agent_connections_open_count</td>\n<td>integer</td>\n<td>Gauge of simultaneous open connections.</td>\n</tr>\n<tr>\n<td>agent_connections_total_count</td>\n<td>integer</td>\n<td>Total number of connections handled by the agent.</td>\n</tr>\n<tr>\n<td>agent_current_requests</td>\n<td>integer</td>\n<td>Number of requests processed in the last reporting interval.</td>\n</tr>\n<tr>\n<td>agent_decision_time_50th</td>\n<td>number</td>\n<td>Agent decision time in milliseconds at the 50th percentile.</td>\n</tr>\n<tr>\n<td>agent_decision_time_95th</td>\n<td>number</td>\n<td>Agent decision time in milliseconds at the 95th percentile.</td>\n</tr>\n<tr>\n<td>agent_decision_time_99th</td>\n<td>number</td>\n<td>Agent decision time in milliseconds at the 99th percentile.</td>\n</tr>\n<tr>\n<td>agent_enabled</td>\n<td>boolean</td>\n<td>Whether the agent is enabled.</td>\n</tr>\n<tr>\n<td>agent_id</td>\n<td>string</td>\n<td>Unique ID of the agent.</td>\n</tr>\n<tr>\n<td>agent_last_rule_updated_at</td>\n<td>string</td>\n<td>Timestamp of last rules update in RFC 3339 format.</td>\n</tr>\n<tr>\n<td>agent_last_seen_at</td>\n<td>string</td>\n<td>Timestamp when the agent last reported in.</td>\n</tr>\n<tr>\n<td>agent_latency_time_50th</td>\n<td>number</td>\n<td>Latency time at the 50th percentile in milliseconds.</td>\n</tr>\n<tr>\n<td>agent_latency_time_95th</td>\n<td>number</td>\n<td>Latency time at the 95th percentile in milliseconds.</td>\n</tr>\n<tr>\n<td>agent_latency_time_99th</td>\n<td>number</td>\n<td>Latency time at the 99th percentile in milliseconds.</td>\n</tr>\n<tr>\n<td>agent_max_procs</td>\n<td>integer</td>\n<td>GOMAXPROCS setting for the agent process.</td>\n</tr>\n<tr>\n<td>agent_name</td>\n<td>string</td>\n<td>Display name of the agent.</td>\n</tr>\n<tr>\n<td>agent_pid</td>\n<td>integer</td>\n<td>Process ID of the agent.</td>\n</tr>\n<tr>\n<td>agent_read_bytes</td>\n<td>integer</td>\n<td>Total bytes read by the agent.</td>\n</tr>\n<tr>\n<td>agent_rule_update_count</td>\n<td>integer</td>\n<td>Counter of rule updates received by the agent.</td>\n</tr>\n<tr>\n<td>agent_status</td>\n<td>string</td>\n<td>Current status of the agent.</td>\n</tr>\n<tr>\n<td>agent_timestamp</td>\n<td>string</td>\n<td>The agent's current UTC time.</td>\n</tr>\n<tr>\n<td>agent_timezone</td>\n<td>string</td>\n<td>Timezone of the agent's host.</td>\n</tr>\n<tr>\n<td>agent_timezone_offset</td>\n<td>integer</td>\n<td>Timezone offset of the agent's host in seconds.</td>\n</tr>\n<tr>\n<td>agent_upload_metadata_failure_count</td>\n<td>integer</td>\n<td>Number of consecutive failures sending data to the Fastly platform.</td>\n</tr>\n<tr>\n<td>agent_upload_size</td>\n<td>integer</td>\n<td>Byte size of the last message uploaded to the Fastly platform.</td>\n</tr>\n<tr>\n<td>agent_uptime</td>\n<td>integer</td>\n<td>Agent uptime in seconds.</td>\n</tr>\n<tr>\n<td>agent_version</td>\n<td>string</td>\n<td>Version of the agent software.</td>\n</tr>\n<tr>\n<td>agent_versions_behind</td>\n<td>integer</td>\n<td>Number of agent releases published since the installed version.</td>\n</tr>\n<tr>\n<td>agent_write_bytes</td>\n<td>integer</td>\n<td>Total bytes written by the agent.</td>\n</tr>\n<tr>\n<td>host_agent_cpu</td>\n<td>number</td>\n<td>CPU usage percentage of the agent process on the host.</td>\n</tr>\n<tr>\n<td>host_clock_skew</td>\n<td>integer</td>\n<td>Number of milliseconds the host clock differs from known correct time.</td>\n</tr>\n<tr>\n<td>host_cpu</td>\n<td>number</td>\n<td>CPU usage percentage of the host machine.</td>\n</tr>\n<tr>\n<td>host_os</td>\n<td>string</td>\n<td>Operating system of the agent's host.</td>\n</tr>\n<tr>\n<td>host_remote_ip</td>\n<td>string</td>\n<td>IP address of the agent's host.</td>\n</tr>\n<tr>\n<td>module_detected</td>\n<td>boolean</td>\n<td>Whether a web server module has been detected.</td>\n</tr>\n<tr>\n<td>module_server</td>\n<td>string</td>\n<td>Server software detected by the module.</td>\n</tr>\n<tr>\n<td>module_type</td>\n<td>string</td>\n<td>Type of the web server module.</td>\n</tr>\n<tr>\n<td>module_version</td>\n<td>string</td>\n<td>Version of the web server module.</td>\n</tr>\n<tr>\n<td>module_versions_behind</td>\n<td>integer</td>\n<td>Number of module releases published since the installed version.</td>\n</tr>\n<tr>\n<td>runtime_gc_pause_millis</td>\n<td>number</td>\n<td>Cumulative garbage collection pause time in milliseconds.</td>\n</tr>\n<tr>\n<td>runtime_memory_bytes_used</td>\n<td>integer</td>\n<td>Memory consumed by the agent in bytes.</td>\n</tr>\n<tr>\n<td>runtime_num_gc</td>\n<td>integer</td>\n<td>Counter of garbage collections performed.</td>\n</tr>\n<tr>\n<td>runtime_num_goroutines</td>\n<td>integer</td>\n<td>Current number of goroutines in the agent process.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"383a0480-b4b1-436d-930f-a42a95b9f61e"},{"name":"Custom dashboards","item":[{"name":"List default dashboards","id":"95346a14-7408-40e6-a17b-282f3c8d1090","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/default-dashboards?limit","description":"<p>Returns all default dashboards across all workspaces for the current user.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","default-dashboards"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Limit how many results are returned.</p>\n","type":"text/plain"},"key":"limit"}],"variable":[]}},"response":[{"id":"ab5ccfe9-d4be-4369-8db2-b713d4ebffc0","name":"200 List of default dashboards.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/ngwaf/v1/default-dashboards?limit=100?limit","protocol":"https","host":["api","fastly","com"],"path":["ngwaf","v1","default-dashboards"],"query":[{"key":"limit","description":"Limit how many results are returned."}]},"description":"Returns all default dashboards across all workspaces for the current user.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 List of default dashboards.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"workspace_id\":\"6EbvL2deHPgDm7ap5mS6D9\",\"dashboard_id\":\"SU1Z0isxPaozGVKXdv0eY\"}],\"meta\":{\"limit\":100}}"}],"_postman_id":"95346a14-7408-40e6-a17b-282f3c8d1090"},{"name":"Get workspace default dashboard","id":"2f672edf-80fe-4174-9f39-1654caf4d1cf","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/default-dashboard","description":"<p>Retrieves the default dashboard configuration for a workspace.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","default-dashboard"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"87cf221f-152f-421c-bdad-f4ab2956d911","name":"200 Workspace default dashboard configuration retrieved successfully.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/default-dashboard","description":"Retrieves the default dashboard configuration for a workspace.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Workspace default dashboard configuration retrieved successfully.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"dashboard_id\":\"SU1Z0isxPaozGVKXdv0eY\"}"}],"_postman_id":"2f672edf-80fe-4174-9f39-1654caf4d1cf"},{"name":"Set workspace default dashboard","id":"180b65a5-aaa5-4d7d-862d-477064a4dbcb","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"dashboard_id\":\"SU1Z0isxPaozGVKXdv0eY\"}"},"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/default-dashboard","description":"<p>Updates the default dashboard for a workspace.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","default-dashboard"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"fe41890f-7b99-43df-bfd3-eba8c239c46e","name":"200 Workspace default dashboard updated successfully.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"dashboard_id\":\"SU1Z0isxPaozGVKXdv0eY\"}"},"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/default-dashboard","description":"Updates the default dashboard for a workspace.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Workspace default dashboard updated successfully.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"dashboard_id\":\"SU1Z0isxPaozGVKXdv0eY\"}"}],"_postman_id":"180b65a5-aaa5-4d7d-862d-477064a4dbcb"},{"name":"List custom dashboards","id":"f0c39733-2f57-4ed4-b443-6b9851eec67d","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/dashboards?limit","description":"<p>Returns all custom dashboards in a workspace.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","dashboards"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Limit how many results are returned.</p>\n","type":"text/plain"},"key":"limit"}],"variable":[]}},"response":[{"id":"14b6835d-13be-4c61-a91e-31e26f7d5801","name":"200 List of custom dashboards.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/dashboards?limit=100?limit","protocol":"https","host":["api","fastly","com"],"path":["ngwaf","v1","workspaces","SU1Z0isxPaozGVKXdv0eY","dashboards"],"query":[{"key":"limit","description":"Limit how many results are returned."}]},"description":"Returns all custom dashboards in a workspace.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 List of custom dashboards.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"name\":\"Next-Gen WAF Dashboard\",\"description\":\"Main security monitoring dashboard\",\"items\":[{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"title\":\"Trending Signals\",\"subtitle\":\"Top trending signals\",\"data_source\":{\"type\":\"ngwaf.v1.workspaces.timeseries\",\"config\":{\"metrics\":[\"SQLI\",\"XSS\",\"CMDEXE\"]}},\"visualization\":{\"type\":\"chart\",\"config\":{\"calculation_method\":\"sum\",\"format\":\"number\",\"plot_type\":\"bar\"}},\"span\":4},{\"id\":\"SU1Z0isxPaozGVKXdv0eZ\",\"title\":\"Request Rate\",\"subtitle\":\"Requests per second over time\",\"data_source\":{\"type\":\"ngwaf.v1.workspaces.events\"},\"visualization\":{\"type\":\"list\"},\"span\":4}],\"created_at\":\"2006-01-02T15:04:05Z\",\"updated_at\":\"2006-01-02T15:04:05Z\"}],\"meta\":{\"limit\":100}}"}],"_postman_id":"f0c39733-2f57-4ed4-b443-6b9851eec67d"},{"name":"Create custom dashboard","id":"46f5b82c-c971-4e01-81a1-800c7333518b","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"Next-Gen WAF Dashboard\",\"description\":\"Main security monitoring dashboard\",\"items\":[{\"title\":\"Trending Signals\",\"subtitle\":\"Top trending signals\",\"data_source\":{\"type\":\"ngwaf.v1.workspaces.timeseries\",\"config\":{\"metrics\":[\"SQLI\",\"XSS\",\"CMDEXE\"]}},\"visualization\":{\"type\":\"chart\",\"config\":{\"calculation_method\":\"sum\",\"format\":\"number\",\"plot_type\":\"bar\"}},\"span\":4},{\"title\":\"Request Rate\",\"subtitle\":\"Requests per second over time\",\"data_source\":{\"type\":\"ngwaf.v1.workspaces.events\"},\"visualization\":{\"type\":\"list\"},\"span\":4}]}"},"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/dashboards","description":"<p>Creates a custom dashboard in a workspace.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","dashboards"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"57ade78e-3522-41e9-a044-182a8cfbc113","name":"201 Custom dashboard created successfully.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"Next-Gen WAF Dashboard\",\"description\":\"Main security monitoring dashboard\",\"items\":[{\"title\":\"Trending Signals\",\"subtitle\":\"Top trending signals\",\"data_source\":{\"type\":\"ngwaf.v1.workspaces.timeseries\",\"config\":{\"metrics\":[\"SQLI\",\"XSS\",\"CMDEXE\"]}},\"visualization\":{\"type\":\"chart\",\"config\":{\"calculation_method\":\"sum\",\"format\":\"number\",\"plot_type\":\"bar\"}},\"span\":4},{\"title\":\"Request Rate\",\"subtitle\":\"Requests per second over time\",\"data_source\":{\"type\":\"ngwaf.v1.workspaces.events\"},\"visualization\":{\"type\":\"list\"},\"span\":4}]}"},"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/dashboards","description":"Creates a custom dashboard in a workspace.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"201 Custom dashboard created successfully.","code":201,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"6EbvL2deHPgDm7ap5mS6D9\",\"name\":\"Next-Gen WAF Dashboard\",\"description\":\"Main security monitoring dashboard\",\"items\":[{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"title\":\"Trending Signals\",\"subtitle\":\"Top trending signals\",\"data_source\":{\"type\":\"ngwaf.v1.workspaces.timeseries\",\"config\":{\"metrics\":[\"SQLI\",\"XSS\",\"CMDEXE\"]}},\"visualization\":{\"type\":\"chart\",\"config\":{\"calculation_method\":\"sum\",\"format\":\"number\",\"plot_type\":\"bar\"}},\"span\":4},{\"id\":\"SU1Z0isxPaozGVKXdv0eZ\",\"title\":\"Request Rate\",\"subtitle\":\"Requests per second over time\",\"data_source\":{\"type\":\"ngwaf.v1.workspaces.events\"},\"visualization\":{\"type\":\"list\"},\"span\":4}],\"created_at\":\"2006-01-02T15:04:05Z\",\"updated_at\":\"2006-01-02T15:04:05Z\"}"}],"_postman_id":"46f5b82c-c971-4e01-81a1-800c7333518b"},{"name":"Get custom dashboard","id":"045049f4-ea95-42cb-b2f4-af5196889cf9","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/dashboards/{{dashboard_id}}","description":"<p>Retrieves a custom dashboard by ID.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","dashboards","{{dashboard_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"ba59cf0d-3614-4490-b14a-fef367bcbbcf","name":"200 Custom dashboard retrieved successfully.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/dashboards/SU1Z0isxPaozGVKXdv0eY","description":"Retrieves a custom dashboard by ID.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Custom dashboard retrieved successfully.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"name\":\"Next-Gen WAF Dashboard\",\"description\":\"Main security monitoring dashboard\",\"items\":[{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"title\":\"Trending Signals\",\"subtitle\":\"Top trending signals\",\"data_source\":{\"type\":\"ngwaf.v1.workspaces.timeseries\",\"config\":{\"metrics\":[\"SQLI\",\"XSS\",\"CMDEXE\"]}},\"visualization\":{\"type\":\"chart\",\"config\":{\"calculation_method\":\"sum\",\"format\":\"number\",\"plot_type\":\"bar\"}},\"span\":4},{\"id\":\"SU1Z0isxPaozGVKXdv0eZ\",\"title\":\"Request Rate\",\"subtitle\":\"Requests per second over time\",\"data_source\":{\"type\":\"ngwaf.v1.workspaces.events\"},\"visualization\":{\"type\":\"list\"},\"span\":4}],\"created_at\":\"2006-01-02T15:04:05Z\",\"updated_at\":\"2006-01-02T15:04:05Z\"}"}],"_postman_id":"045049f4-ea95-42cb-b2f4-af5196889cf9"},{"name":"Delete custom dashboard","id":"dd37528c-6b48-4178-8f43-410d1c7e23b1","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/dashboards/{{dashboard_id}}","description":"<p>Removes a custom dashboard by ID.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","dashboards","{{dashboard_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"2ef62801-9ac6-4975-bd0f-bfdef220cde0","name":"204 Custom dashboard deleted successfully.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/dashboards/SU1Z0isxPaozGVKXdv0eY","description":"Removes a custom dashboard by ID.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 Custom dashboard deleted successfully.","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"dd37528c-6b48-4178-8f43-410d1c7e23b1"},{"name":"Update custom dashboard","id":"a7e6a2e4-7a33-4c4a-9957-7f2e99789eba","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"Next-Gen WAF Dashboard revised\",\"items\":[{\"data_source\":{\"config\":{\"metrics\":[\"SQLI\",\"XSS\",\"CMDEXE\",\"TRAVERSAL\"]}}}]}"},"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/dashboards/{{dashboard_id}}","description":"<p>Updates a custom dashboard.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","dashboards","{{dashboard_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"63543636-a02b-4c6e-8b6d-dd39580548c9","name":"200 Custom dashboard updated successfully.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"Next-Gen WAF Dashboard revised\",\"items\":[{\"data_source\":{\"config\":{\"metrics\":[\"SQLI\",\"XSS\",\"CMDEXE\",\"TRAVERSAL\"]}}}]}"},"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/dashboards/SU1Z0isxPaozGVKXdv0eY","description":"Updates a custom dashboard.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Custom dashboard updated successfully.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"name\":\"Next-Gen WAF Dashboard revised\",\"description\":\"Main security monitoring dashboard\",\"items\":[{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"title\":\"Request Rate\",\"subtitle\":\"Requests per second over time\",\"data_source\":{\"type\":\"ngwaf.v1.workspaces.timeseries\",\"config\":{\"metrics\":[\"SQLI\",\"XSS\",\"CMDEXE\",\"TRAVERSAL\"]}},\"visualization\":{\"type\":\"chart\",\"config\":{\"plot_type\":\"bar\",\"format\":\"number\",\"calculation_method\":\"sum\"}},\"span\":4}],\"created_at\":\"2006-01-02T15:04:05Z\",\"updated_at\":\"2006-01-02T15:04:05Z\"}"}],"_postman_id":"a7e6a2e4-7a33-4c4a-9957-7f2e99789eba"}],"id":"d83ce423-e890-4336-b5c8-c079f411a967","description":"<p>Custom dashboards allow you to build tailored visualizations of Next-Gen WAF security data and configure which dashboard displays by default when accessing a workspace.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>data_source</td>\n<td>object</td>\n<td>Configuration for the dashboard item's data_source. The exact fields depend on data_source.type.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>ID of the dashboard item.</td>\n</tr>\n<tr>\n<td>span</td>\n<td>integer</td>\n<td>Grid span for the dashboard item.</td>\n</tr>\n<tr>\n<td>subtitle</td>\n<td>string</td>\n<td>Subtitle of the dashboard item.</td>\n</tr>\n<tr>\n<td>title</td>\n<td>string</td>\n<td>Title of the dashboard item.</td>\n</tr>\n<tr>\n<td>visualization</td>\n<td>object</td>\n<td>Configuration for the dashboard item's visualization. The exact fields depend on visualization.type.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Timestamp when the dashboard was created.</td>\n</tr>\n<tr>\n<td>description</td>\n<td>string</td>\n<td>Description of the dashboard.</td>\n</tr>\n<tr>\n<td>items</td>\n<td>array</td>\n<td>Array of dashboard items.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>Name of the dashboard.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Timestamp when the dashboard was last updated.</td>\n</tr>\n<tr>\n<td>dashboard_id</td>\n<td>string</td>\n<td>ID of the default dashboard to set for the workspace.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-1\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>type</td>\n<td>string</td>\n<td>Type of data source.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-2\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>config</td>\n<td>object</td>\n<td>Data source config object for data source type ngwaf.v1.workspaces.timeseries. Use this object as data_source.config.</td>\n</tr>\n<tr>\n<td>type</td>\n<td>string</td>\n<td>Type of data source.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-3\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>metrics</td>\n<td>array</td>\n<td>Array of metric names.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-4\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>config</td>\n<td>object</td>\n<td>Visualization config object for visualization type chart. Use this object as visualization.config.</td>\n</tr>\n<tr>\n<td>type</td>\n<td>string</td>\n<td>Type of visualization.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-5\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>calculation_method</td>\n<td>string</td>\n<td>Method for calculating aggregated values.</td>\n</tr>\n<tr>\n<td>format</td>\n<td>string</td>\n<td>Format for displaying values.</td>\n</tr>\n<tr>\n<td>plot_type</td>\n<td>string</td>\n<td>Type of plot for visualization.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-6\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>type</td>\n<td>string</td>\n<td>Type of visualization.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-7\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>type</td>\n<td>string</td>\n<td>Type of visualization.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"d83ce423-e890-4336-b5c8-c079f411a967"},{"name":"Events","item":[{"name":"List events","id":"72b2ac66-442c-447c-9d5e-ceb4c56fb151","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/events?from&ip&limit&page&signal&status&to","description":"<p>List events in a workspace.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","events"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Represents the start of a date-time range and is the older of the two dates, expressed in RFC 3339 format.</p>\n","type":"text/plain"},"key":"from"},{"description":{"content":"<p>Filter based on IP.</p>\n","type":"text/plain"},"key":"ip"},{"description":{"content":"<p>Limit how many results are returned.</p>\n","type":"text/plain"},"key":"limit"},{"description":{"content":"<p>Page number of the collection to request.</p>\n","type":"text/plain"},"key":"page"},{"description":{"content":"<p>Filter based on signal.</p>\n","type":"text/plain"},"key":"signal"},{"description":{"content":"<p>Filter based on status.</p>\n","type":"text/plain"},"key":"status"},{"description":{"content":"<p>Represents the end of a date-time range and is the newer of the two dates, expressed in RFC 3339 format.</p>\n","type":"text/plain"},"key":"to"}],"variable":[]}},"response":[{"id":"fdccf6e5-4c61-4763-a6ae-55e69127f58c","name":"200 List of events.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/events?from=2023-01-01T02%3A30%3A00Z&limit=100&page=1&to=2023-01-01T02%3A30%3A00Z?from&ip&limit&page&signal&status&to","protocol":"https","host":["api","fastly","com"],"path":["ngwaf","v1","workspaces","SU1Z0isxPaozGVKXdv0eY","events"],"query":[{"key":"from","description":"Represents the start of a date-time range and is the older of the two dates, expressed in RFC 3339 format."},{"key":"ip","description":"Filter based on IP."},{"key":"limit","description":"Limit how many results are returned."},{"key":"page","description":"Page number of the collection to request."},{"key":"signal","description":"Filter based on signal."},{"key":"status","description":"Filter based on status."},{"key":"to","description":"Represents the end of a date-time range and is the newer of the two dates, expressed in RFC 3339 format."}]},"description":"List events in a workspace.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 List of events.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"meta\":{\"limit\":1,\"total\":100},\"data\":[{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"created_at\":\"2025-05-12T20:55:07Z\",\"detected_at\":\"2025-05-12T20:55:07Z\",\"source\":\"192.0.2.1\",\"country\":\"US\",\"remote_hostname\":\"example.com\",\"user_agents\":[\"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML\",\"like Gecko) Chrome/124.0.0.0 Safari/537.36\"],\"reasons\":[{\"signal_id\":\"XSS\",\"count\":0}],\"block_signals\":[\"SQLI\"],\"action\":\"flagged\",\"type\":\"attack\",\"request_count\":0,\"window\":0,\"expires_at\":\"2025-05-12T20:55:07Z\",\"blocked_request_count\":0,\"flagged_request_count\":0,\"sample_request\":{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"timestamp\":\"2025-05-12T20:55:07Z\",\"server_hostname\":\"example.com\",\"server_name\":\"string\",\"uri\":\"/requestpath?q=example\",\"scheme\":\"http\",\"path\":\"/requestpath\",\"user_agent\":\"Mozilla/5.00 (Nikto/2.1.5) (Evasions:None) (Test:000691)\",\"remote_ip\":\"198.51.100.1\",\"remote_hostname\":\"example.com\",\"country\":\"US\",\"method\":\"PUT\",\"protocol\":\"HTTP/1.1\",\"tls_protocol\":\"TLS13\",\"tls_cipher\":\"TLS_AES_128_GCM_SHA256\",\"response_code\":503,\"response_size\":88336,\"response_time\":50,\"agent_response_code\":200,\"request_headers\":[{\"name\":\"User-Agent\",\"value\":\"Firefox/1.0\"}],\"response_headers\":[{\"name\":\"Content-Encoding\",\"value\":\"gzip\"}],\"signals\":[{\"id\":\"SQLI\",\"location\":\"QUERYSTRING\",\"value\":\"foo=1 OR 1\",\"detector\":\"LIBINJECTIONV5\",\"detector_scope\":\"system\"}]},\"is_expired\":true}]}"}],"_postman_id":"72b2ac66-442c-447c-9d5e-ceb4c56fb151"},{"name":"Retrieve event","id":"0039a4d1-cc9a-4bb0-a9db-985a8fea4239","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/events/{{event_id}}","description":"<p>Get an event in a workspace.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","events","{{event_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"e2510235-6c9b-4972-9b98-c1470cb30627","name":"200 Requested event.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/events/ORkjWUVWFgNJIyKvcSnzmLCsizuPnqhjHvTbwtOxVmTxEgxetXX","description":"Get an event in a workspace.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Requested event.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"created_at\":\"2025-05-12T20:55:07Z\",\"detected_at\":\"2025-05-12T20:55:07Z\",\"source\":\"192.0.2.1\",\"country\":\"US\",\"remote_hostname\":\"example.com\",\"user_agents\":[\"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML\",\"like Gecko) Chrome/124.0.0.0 Safari/537.36\"],\"reasons\":[{\"signal_id\":\"XSS\",\"count\":0}],\"block_signals\":[\"SQLI\"],\"action\":\"flagged\",\"type\":\"attack\",\"request_count\":0,\"window\":0,\"expires_at\":\"2025-05-12T20:55:07Z\",\"is_expired\":true,\"blocked_request_count\":0,\"flagged_request_count\":0,\"sample_request\":{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"timestamp\":\"2025-05-12T20:55:07Z\",\"server_hostname\":\"example.com\",\"server_name\":\"string\",\"uri\":\"/requestpath?q=example\",\"scheme\":\"http\",\"path\":\"/requestpath\",\"user_agent\":\"Mozilla/5.00 (Nikto/2.1.5) (Evasions:None) (Test:000691)\",\"remote_ip\":\"198.51.100.1\",\"remote_hostname\":\"example.com\",\"country\":\"US\",\"method\":\"PUT\",\"protocol\":\"HTTP/1.1\",\"tls_protocol\":\"TLS13\",\"tls_cipher\":\"TLS_AES_128_GCM_SHA256\",\"response_code\":503,\"response_size\":88336,\"response_time\":50,\"agent_response_code\":200,\"request_headers\":[{\"name\":\"User-Agent\",\"value\":\"ZmEu\"}],\"response_headers\":[{\"name\":\"Content-Encoding\",\"value\":\"gzip\"}],\"signals\":[{\"id\":\"SQLI\",\"location\":\"QUERYSTRING\",\"value\":\"foo=1 OR 1\",\"detector\":\"LIBINJECTIONV5\",\"detector_scope\":\"system\"}]}}"}],"_postman_id":"0039a4d1-cc9a-4bb0-a9db-985a8fea4239"},{"name":"Expire event","id":"9af37e11-6ce1-47b3-af05-143bf87bf0a7","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"is_expired\":true}"},"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/events/{{event_id}}","description":"<p>Expire an event in a workspace.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","events","{{event_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"3500a576-73ba-4740-8f33-7f7b5408d7b0","name":"200 Requested event.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"is_expired\":true}"},"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/events/ORkjWUVWFgNJIyKvcSnzmLCsizuPnqhjHvTbwtOxVmTxEgxetXX","description":"Expire an event in a workspace.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Requested event.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"created_at\":\"2025-05-12T20:55:07Z\",\"detected_at\":\"2025-05-12T20:55:07Z\",\"source\":\"192.0.2.1\",\"country\":\"US\",\"remote_hostname\":\"example.com\",\"user_agents\":[\"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML\",\"like Gecko) Chrome/124.0.0.0 Safari/537.36\"],\"reasons\":[{\"signal_id\":\"XSS\",\"count\":0}],\"block_signals\":[\"SQLI\"],\"action\":\"flagged\",\"type\":\"attack\",\"request_count\":0,\"window\":0,\"expires_at\":\"2025-05-12T20:55:07Z\",\"is_expired\":true,\"blocked_request_count\":0,\"flagged_request_count\":0,\"sample_request\":{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"timestamp\":\"2025-05-12T20:55:07Z\",\"server_hostname\":\"example.com\",\"server_name\":\"string\",\"uri\":\"/requestpath?q=example\",\"scheme\":\"http\",\"path\":\"/requestpath\",\"user_agent\":\"Mozilla/5.00 (Nikto/2.1.5) (Evasions:None) (Test:000691)\",\"remote_ip\":\"198.51.100.1\",\"remote_hostname\":\"example.com\",\"country\":\"US\",\"method\":\"PUT\",\"protocol\":\"HTTP/1.1\",\"tls_protocol\":\"TLS13\",\"tls_cipher\":\"TLS_AES_128_GCM_SHA256\",\"response_code\":503,\"response_size\":88336,\"response_time\":50,\"agent_response_code\":200,\"request_headers\":[{\"name\":\"User-Agent\",\"value\":\"ZmEu\"}],\"response_headers\":[{\"name\":\"Content-Encoding\",\"value\":\"gzip\"}],\"signals\":[{\"id\":\"SQLI\",\"location\":\"QUERYSTRING\",\"value\":\"foo=1 OR 1\",\"detector\":\"LIBINJECTIONV5\",\"detector_scope\":\"system\"}]}}"}],"_postman_id":"9af37e11-6ce1-47b3-af05-143bf87bf0a7"},{"name":"Remove flag from IP","id":"a8edfac7-c35c-4bf1-8cde-fa29a3be8c92","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/events/{{event_id}}/expire","description":"<p>Remove flag from IP for a specific event in a workspace.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","events","{{event_id}}","expire"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"194808f9-18d8-477f-9ad9-8ad45813b52d","name":"200 Event with flag removed.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/events/ORkjWUVWFgNJIyKvcSnzmLCsizuPnqhjHvTbwtOxVmTxEgxetXX/expire","description":"Remove flag from IP for a specific event in a workspace.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Event with flag removed.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"created_at\":\"2025-05-12T20:55:07Z\",\"detected_at\":\"2025-05-12T20:55:07Z\",\"source\":\"192.0.2.1\",\"country\":\"US\",\"remote_hostname\":\"example.com\",\"user_agents\":[\"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML\",\"like Gecko) Chrome/124.0.0.0 Safari/537.36\"],\"reasons\":[{\"signal_id\":\"XSS\",\"count\":0}],\"block_signals\":[\"SQLI\"],\"action\":\"flagged\",\"type\":\"attack\",\"request_count\":0,\"window\":0,\"expires_at\":\"2025-05-12T20:55:07Z\",\"is_expired\":true,\"blocked_request_count\":0,\"flagged_request_count\":0,\"sample_request\":{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"timestamp\":\"2025-05-12T20:55:07Z\",\"server_hostname\":\"example.com\",\"server_name\":\"string\",\"uri\":\"/requestpath?q=example\",\"scheme\":\"http\",\"path\":\"/requestpath\",\"user_agent\":\"Mozilla/5.00 (Nikto/2.1.5) (Evasions:None) (Test:000691)\",\"remote_ip\":\"198.51.100.1\",\"remote_hostname\":\"example.com\",\"country\":\"US\",\"method\":\"PUT\",\"protocol\":\"HTTP/1.1\",\"tls_protocol\":\"TLS13\",\"tls_cipher\":\"TLS_AES_128_GCM_SHA256\",\"response_code\":503,\"response_size\":88336,\"response_time\":50,\"agent_response_code\":200,\"request_headers\":[{\"name\":\"User-Agent\",\"value\":\"ZmEu\"}],\"response_headers\":[{\"name\":\"Content-Encoding\",\"value\":\"gzip\"}],\"signals\":[{\"id\":\"SQLI\",\"location\":\"QUERYSTRING\",\"value\":\"foo=1 OR 1\",\"detector\":\"LIBINJECTIONV5\",\"detector_scope\":\"system\"}]}}"}],"_postman_id":"a8edfac7-c35c-4bf1-8cde-fa29a3be8c92"}],"id":"70a084ce-7f79-45ba-a818-cbcd9d16c302","description":"<p>Events are actions that the Next-Gen WAF takes as the result of regular threshold-based blocking, templated rules, and site alerts.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>action</td>\n<td>string</td>\n<td>Value can be 'flagged' (requests will be blocked), 'info' (requests will be logged), or 'template'.</td>\n</tr>\n<tr>\n<td>block_signals</td>\n<td>array</td>\n<td>List of block signals.</td>\n</tr>\n<tr>\n<td>country</td>\n<td>string</td>\n<td>Country code.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Created timestamp.</td>\n</tr>\n<tr>\n<td>detected_at</td>\n<td>string</td>\n<td>Detected timestamp.</td>\n</tr>\n<tr>\n<td>expires_at</td>\n<td>string</td>\n<td>Time at which the event expires.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>Unique ID of the event.</td>\n</tr>\n<tr>\n<td>is_expired</td>\n<td>boolean</td>\n<td>If it is true, the event should be set to expired.</td>\n</tr>\n<tr>\n<td>reasons</td>\n<td>array</td>\n<td>List of signals and their counts.</td>\n</tr>\n<tr>\n<td>remote_hostname</td>\n<td>string</td>\n<td>Remote hostname.</td>\n</tr>\n<tr>\n<td>request_count</td>\n<td>integer</td>\n<td>Total number of requests.</td>\n</tr>\n<tr>\n<td>source</td>\n<td>string</td>\n<td>Source information.</td>\n</tr>\n<tr>\n<td>user_agents</td>\n<td>array</td>\n<td>User agents.</td>\n</tr>\n<tr>\n<td>window</td>\n<td>integer</td>\n<td>Time window in seconds where the items were detected.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"70a084ce-7f79-45ba-a818-cbcd9d16c302"},{"name":"Header links","item":[{"name":"List header links","id":"c0ebc521-d791-4808-865a-b172f5c9b934","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/header-links","description":"<p>Returns all header links in a workspace.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","header-links"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"5df87468-6d8c-4fb5-b2ce-a6087f365af8","name":"200 List of header links","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/header-links","description":"Returns all header links in a workspace.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 List of header links","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"meta\":{\"total\":1},\"data\":[{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"header_name\":\"X-Request-ID\",\"link_url_template\":\"https://kibana.example.com/search?query={{value}}\",\"link_label\":\"Kibana\",\"header_context\":\"request\",\"created_at\":\"2024-01-15T10:30:00Z\",\"updated_at\":\"2024-01-16T14:25:30Z\"}]}"}],"_postman_id":"c0ebc521-d791-4808-865a-b172f5c9b934"},{"name":"Create header link","id":"1db638cc-129d-4d89-a662-faac8e189449","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"header_name\":\"X-Request-ID\",\"link_url_template\":\"https://kibana.example.com/search?query={{value}}\",\"link_label\":\"Kibana\",\"header_context\":\"request\"}"},"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/header-links","description":"<p>Creates a header link in a workspace.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","header-links"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"9557aa17-cd42-455b-8692-3142d732ee55","name":"201 Header link created successfully","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"header_name\":\"X-Request-ID\",\"link_url_template\":\"https://kibana.example.com/search?query={{value}}\",\"link_label\":\"Kibana\",\"header_context\":\"request\"}"},"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/header-links","description":"Creates a header link in a workspace.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"201 Header link created successfully","code":201,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"header_name\":\"X-Request-ID\",\"link_url_template\":\"https://kibana.example.com/search?query={{value}}\",\"link_label\":\"Kibana\",\"header_context\":\"request\",\"created_at\":\"2024-01-15T10:30:00Z\",\"updated_at\":\"2024-01-15T10:30:00Z\"}"}],"_postman_id":"1db638cc-129d-4d89-a662-faac8e189449"},{"name":"Get header link","id":"9c36bdd8-8032-4fe4-83b2-b03fefadbc73","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/header-links/{{header_link_id}}","description":"<p>Retrieves a header link by ID.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","header-links","{{header_link_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"61581d94-76fc-4b9a-adbe-abe80dd3484d","name":"200 Header link retrieved successfully","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/header-links/SU1Z0isxPaozGVKXdv0eY","description":"Retrieves a header link by ID.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Header link retrieved successfully","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"header_name\":\"X-Request-ID\",\"link_url_template\":\"https://kibana.example.com/search?query={{value}}\",\"link_label\":\"Kibana\",\"header_context\":\"request\",\"created_at\":\"2024-01-15T10:30:00Z\",\"updated_at\":\"2024-01-16T14:25:30Z\"}"}],"_postman_id":"9c36bdd8-8032-4fe4-83b2-b03fefadbc73"},{"name":"Update header link","id":"ef8e6afd-6718-41bf-a404-5ca984cb8335","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"header_name\":\"X-Request-ID\",\"link_url_template\":\"https://kibana.example.com/search?query={{value}}\",\"link_label\":\"Kibana\",\"header_context\":\"response\"}"},"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/header-links/{{header_link_id}}","description":"<p>Updates a header link.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","header-links","{{header_link_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"256b71b9-cca4-439b-8435-a7c2a594870e","name":"200 Header link updated successfully","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"header_name\":\"X-Request-ID\",\"link_url_template\":\"https://kibana.example.com/search?query={{value}}\",\"link_label\":\"Kibana\",\"header_context\":\"response\"}"},"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/header-links/SU1Z0isxPaozGVKXdv0eY","description":"Updates a header link.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Header link updated successfully","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"header_name\":\"X-Request-ID\",\"link_url_template\":\"https://kibana.example.com/search?query={{value}}\",\"link_label\":\"Kibana\",\"header_context\":\"request\",\"created_at\":\"2024-01-15T10:30:00Z\",\"updated_at\":\"2024-01-16T14:25:30Z\"}"}],"_postman_id":"ef8e6afd-6718-41bf-a404-5ca984cb8335"},{"name":"Delete header link","id":"ec68dece-5693-420a-b667-82c2a4c9e973","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/header-links/{{header_link_id}}","description":"<p>Removes a header link by ID.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","header-links","{{header_link_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"57616622-1746-4e08-a384-cbb6a7151bd6","name":"204 Header link deleted successfully","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/header-links/SU1Z0isxPaozGVKXdv0eY","description":"Removes a header link by ID.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 Header link deleted successfully","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"ec68dece-5693-420a-b667-82c2a4c9e973"}],"id":"b2ffdc0a-158e-4c7e-9421-938fc9bd4c55","description":"<p>Header links allow you to create clickable links in the Next-Gen WAF interface based on request or response header values.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Timestamp when the header link was created.</td>\n</tr>\n<tr>\n<td>header_context</td>\n<td>string</td>\n<td>Whether this is a request header or response header.</td>\n</tr>\n<tr>\n<td>header_name</td>\n<td>string</td>\n<td>HTTP header name (e.g., X-Request-ID, X-User-ID).</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>Header link identifier.</td>\n</tr>\n<tr>\n<td>link_label</td>\n<td>string</td>\n<td>Display label for the link shown in UI (e.g., \"Kibana\").</td>\n</tr>\n<tr>\n<td>link_url_template</td>\n<td>string</td>\n<td>Link template URL with {{value}} placeholder for the header value.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Timestamp when the header link was last updated.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"b2ffdc0a-158e-4c7e-9421-938fc9bd4c55"},{"name":"Lists","item":[{"name":"List all account-level lists","id":"a1cfe3c1-8a36-4857-8bb5-a7164ee8afe7","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/lists","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/ngwaf/lists/#ngwafListLists\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","lists"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"5b5fd4a7-3f06-459c-b455-9e0549fb0935","name":"200 List of lists.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/lists","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/ngwaf/lists/#ngwafListLists)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 List of lists.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"meta\":{\"total\":1},\"data\":[{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"type\":\"ip\",\"reference_id\":\"example-account.example-list123\",\"name\":\"example-list123\",\"description\":\"This is an example list description\",\"entries\":[\"10.0.0.0\"],\"created_at\":\"2025-05-12T20:55:07Z\",\"updated_at\":\"2025-05-12T20:55:08Z\",\"scope\":{\"type\":\"account\"}}]}"}],"_postman_id":"a1cfe3c1-8a36-4857-8bb5-a7164ee8afe7"},{"name":"Create a new account-level list","id":"ce9b9d47-ea17-44e5-843d-b76c146b0318","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"type\":\"ip\",\"name\":\"example-list\",\"description\":\"Example description\",\"entries\":[\"10.0.0.0\"]}"},"url":"https://api.fastly.com/ngwaf/v1/lists","description":"<p>Add a new list.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","lists"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"3cd96bc6-ea4b-4b46-b2de-e1ff8da076f4","name":"201 Successful list creation.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"type\":\"ip\",\"name\":\"example-list\",\"description\":\"Example description\",\"entries\":[\"10.0.0.0\"]}"},"url":"https://api.fastly.com/ngwaf/v1/lists","description":"Add a new list.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"201 Successful list creation.","code":201,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"type\":\"ip\",\"reference_id\":\"example-account.example-list\",\"name\":\"example-list\",\"description\":\"Example description\",\"entries\":[\"10.0.0.0\"],\"created_at\":\"2025-05-12T20:55:07Z\",\"updated_at\":\"2025-05-12T20:55:08Z\",\"scope\":{\"type\":\"account\"}}"}],"_postman_id":"ce9b9d47-ea17-44e5-843d-b76c146b0318"},{"name":"Get account-level list by ID","id":"44551598-7479-45ab-9f18-6c6b33ddf963","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/lists/{{listId}}","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/ngwaf/lists/#ngwafGetListByID\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","lists","{{listId}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"eb631165-2e82-40c7-bec2-5c72309ae731","name":"200 Requested list.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/lists/SU1Z0isxPaozGVKXdv0eY","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/ngwaf/lists/#ngwafGetListByID)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Requested list.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"type\":\"ip\",\"reference_id\":\"example-account.example-list\",\"name\":\"example-list\",\"description\":\"Example description\",\"entries\":[\"10.0.0.0\"],\"created_at\":\"2025-05-12T20:55:07Z\",\"updated_at\":\"2025-05-12T20:55:08Z\",\"scope\":{\"type\":\"account\"}}"}],"_postman_id":"44551598-7479-45ab-9f18-6c6b33ddf963"},{"name":"Remove an account-level list","id":"92465b00-068b-40da-8072-dafb0face01a","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/lists/{{listId}}","description":"<p>Delete an account-level list.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","lists","{{listId}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"83fbc5ed-746d-4c86-9bb1-814ba37ec419","name":"204 Deletion was successful.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/lists/SU1Z0isxPaozGVKXdv0eY","description":"Delete an account-level list.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 Deletion was successful.","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{}"}],"_postman_id":"92465b00-068b-40da-8072-dafb0face01a"},{"name":"Update account-level list","id":"863be504-7fb4-42a7-9751-bbaea9fa6907","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"description\":\"Updated description\"}"},"url":"https://api.fastly.com/ngwaf/v1/lists/{{listId}}","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/ngwaf/lists/#ngwafUpdateList\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","lists","{{listId}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"ea14c9a2-f786-4082-925a-513d0d90af80","name":"200 Edit was successful.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"description\":\"Updated description\"}"},"url":"https://api.fastly.com/ngwaf/v1/lists/SU1Z0isxPaozGVKXdv0eY","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/ngwaf/lists/#ngwafUpdateList)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Edit was successful.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"type\":\"ip\",\"reference_id\":\"example-account.example-list\",\"name\":\"example-list\",\"description\":\"Updated description\",\"entries\":[\"10.0.0.0\",\"192.168.1.0\"],\"created_at\":\"2025-05-12T20:55:07Z\",\"updated_at\":\"2025-05-12T21:00:00Z\",\"scope\":{\"type\":\"account\"}}"}],"_postman_id":"863be504-7fb4-42a7-9751-bbaea9fa6907"},{"name":"List all workspace-level lists","id":"ded236b3-235f-4ccd-a10a-38e74793af90","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspaceId}}/lists","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/ngwaf/lists/#ngwafListWorkspaceLists\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspaceId}}","lists"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"5caaabed-79c9-4c7d-946d-2b16092156ca","name":"200 List of workspace lists.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/4bac27393bdd9777ce02453256c5577cd8b08198/lists","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/ngwaf/lists/#ngwafListWorkspaceLists)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 List of workspace lists.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"meta\":{\"total\":1},\"data\":[{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"type\":\"ip\",\"reference_id\":\"example-workspace.example-list123\",\"name\":\"example-list123\",\"description\":\"This is an example list description\",\"entries\":[\"10.0.0.0\"],\"created_at\":\"2025-05-12T20:55:07Z\",\"updated_at\":\"2025-05-12T20:55:08Z\",\"scope\":{\"type\":\"workspace\"}}]}"}],"_postman_id":"ded236b3-235f-4ccd-a10a-38e74793af90"},{"name":"Create a new workspace-level list","id":"408bb050-6b0c-4380-aaa6-c6b8f3d58683","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"type\":\"ip\",\"name\":\"example-list\",\"description\":\"Example description\",\"entries\":[\"10.0.0.0\"]}"},"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspaceId}}/lists","description":"<p>Add a new list for the given workspace.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspaceId}}","lists"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"ad055db6-6c26-4e26-8731-e884df42596e","name":"201 Successful workspace list creation.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"type\":\"ip\",\"name\":\"example-list\",\"description\":\"Example description\",\"entries\":[\"10.0.0.0\"]}"},"url":"https://api.fastly.com/ngwaf/v1/workspaces/4bac27393bdd9777ce02453256c5577cd8b08198/lists","description":"Add a new list for the given workspace.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"201 Successful workspace list creation.","code":201,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"type\":\"ip\",\"reference_id\":\"example-workspace.example-list\",\"name\":\"example-list\",\"description\":\"Example description\",\"entries\":[\"10.0.0.0\"],\"created_at\":\"2025-05-12T20:55:07Z\",\"updated_at\":\"2025-05-12T20:55:08Z\",\"scope\":{\"type\":\"workspace\"}}"}],"_postman_id":"408bb050-6b0c-4380-aaa6-c6b8f3d58683"},{"name":"Get workspace-level list by ID","id":"177ce354-dbdb-40c6-87bd-28cf7a5fe823","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspaceId}}/lists/{{listId}}","description":"<p>Get workspace-level list by ID for the given workspace.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspaceId}}","lists","{{listId}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"76a20b43-c9d0-4d3f-a4aa-0c3cd94ed19d","name":"200 Requested workspace list.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/4bac27393bdd9777ce02453256c5577cd8b08198/lists/SU1Z0isxPaozGVKXdv0eY","description":"Get workspace-level list by ID for the given workspace.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Requested workspace list.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"type\":\"ip\",\"reference_id\":\"example-workspace.example-list\",\"name\":\"example-list\",\"description\":\"Example description\",\"entries\":[\"10.0.0.0\"],\"created_at\":\"2025-05-12T20:55:07Z\",\"updated_at\":\"2025-05-12T20:55:08Z\",\"scope\":{\"type\":\"workspace\"}}"}],"_postman_id":"177ce354-dbdb-40c6-87bd-28cf7a5fe823"},{"name":"Remove a workspace-level list","id":"a61227c9-264e-469f-a6c2-41837104f624","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspaceId}}/lists/{{listId}}","description":"<p>Delete a workspace-level list for the given workspace.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspaceId}}","lists","{{listId}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"a61227c9-264e-469f-a6c2-41837104f624"},{"name":"Update workspace-level list","id":"50971e92-28d0-420c-aa46-2e6994699b39","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"description\":\"Updated description\"}"},"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspaceId}}/lists/{{listId}}","description":"<p>Update workspace-level list for the given workspace.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspaceId}}","lists","{{listId}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"f484e929-217b-4409-8c62-038aa9425270","name":"200 Workspace list edit was successful.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"description\":\"Updated description\"}"},"url":"https://api.fastly.com/ngwaf/v1/workspaces/4bac27393bdd9777ce02453256c5577cd8b08198/lists/SU1Z0isxPaozGVKXdv0eY","description":"Update workspace-level list for the given workspace.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Workspace list edit was successful.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"type\":\"ip\",\"reference_id\":\"example-workspace.example-list\",\"name\":\"example-list\",\"description\":\"Updated description\",\"entries\":[\"10.0.0.0\",\"192.168.1.0\"],\"created_at\":\"2025-05-12T20:55:07Z\",\"updated_at\":\"2025-05-12T21:00:00Z\",\"scope\":{\"type\":\"workspace\"}}"}],"_postman_id":"50971e92-28d0-420c-aa46-2e6994699b39"}],"id":"89441a96-39fc-4aa4-9d0e-2e0664a10bfb","description":"<p>Lists allow you to manage lists at the account level and workspace level for use with Next-Gen WAF rules.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date the list was created.</td>\n</tr>\n<tr>\n<td>description</td>\n<td>string</td>\n<td>The description of the list.</td>\n</tr>\n<tr>\n<td>entries</td>\n<td>array</td>\n<td>Array of strings.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>The ID of the list.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The name of the list.</td>\n</tr>\n<tr>\n<td>reference_id</td>\n<td>string</td>\n<td>The reference ID (slug) of the list.</td>\n</tr>\n<tr>\n<td>scope</td>\n<td>object</td>\n<td>The scope of the list.</td>\n</tr>\n<tr>\n<td>type</td>\n<td>string</td>\n<td>The type of list. - string - wildcard - ip - country - signal.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date the list was last updated.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"89441a96-39fc-4aa4-9d0e-2e0664a10bfb"},{"name":"Rate limited sources","item":[{"name":"Get rate limited sources","id":"2783ca1e-5e83-430a-95e7-ae830038fd17","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/rate-limited-sources?limit&page&signal&source","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/ngwaf/rate-limited-sources/#ngwafListRateLimitedSources\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","rate-limited-sources"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>The maximum number of items to return.</p>\n","type":"text/plain"},"key":"limit"},{"description":{"content":"<p>The page number to retrieve.</p>\n","type":"text/plain"},"key":"page"},{"description":{"content":"<p>Filter by signal.</p>\n","type":"text/plain"},"key":"signal"},{"description":{"content":"<p>Filter by source.</p>\n","type":"text/plain"},"key":"source"}],"variable":[]}},"response":[{"id":"fdaa6ca0-5f59-4e9a-89c1-ff2e3a9f937f","name":"200 Requested rate limited sources.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/rate-limited-sources?limit=100&page=1?limit&page&signal&source","protocol":"https","host":["api","fastly","com"],"path":["ngwaf","v1","workspaces","SU1Z0isxPaozGVKXdv0eY","rate-limited-sources"],"query":[{"key":"limit","description":"The maximum number of items to return."},{"key":"page","description":"The page number to retrieve."},{"key":"signal","description":"Filter by signal."},{"key":"source","description":"Filter by source."}]},"description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/ngwaf/rate-limited-sources/#ngwafListRateLimitedSources)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Requested rate limited sources.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"meta\":{\"limit\":1,\"total\":100},\"data\":[{\"id\":\"665f1719e3d162737d986653\",\"created_at\":\"2019-08-24T14:15:22Z\",\"workspace_id\":\"6EbvL2deHPgDm7ap5mS6D9\",\"signal\":\"RATE_LIMIT\",\"source\":\"192.0.2.1\",\"expires_at\":\"2021-04-19T03:29:30Z\",\"client_identifiers\":[{\"type\":\"ip\",\"name\":\"remote_ip\",\"key\":\"192.0.2.1\"}]}]}"}],"_postman_id":"2783ca1e-5e83-430a-95e7-ae830038fd17"},{"name":"Bulk delete rate limited sources","id":"2d586ebf-4a1d-4160-8027-c1021ffb0b17","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/rate-limited-sources?signal","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/ngwaf/rate-limited-sources/#ngwafBulkDeleteRateLimitedSources\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","rate-limited-sources"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Filter by signal.</p>\n","type":"text/plain"},"key":"signal"}],"variable":[]}},"response":[{"id":"88dc8b29-6389-4262-b8dd-be8bdba2a0df","name":"204 Deletion was successful.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":{"raw":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/rate-limited-sources?signal","protocol":"https","host":["api","fastly","com"],"path":["ngwaf","v1","workspaces","SU1Z0isxPaozGVKXdv0eY","rate-limited-sources"],"query":[{"key":"signal","description":"Filter by signal."}]},"description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/ngwaf/rate-limited-sources/#ngwafBulkDeleteRateLimitedSources)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 Deletion was successful.","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"2d586ebf-4a1d-4160-8027-c1021ffb0b17"},{"name":"Get rate limited source","id":"5fac578d-80e4-41d0-9283-62288790bb29","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/rate-limited-sources/{{source_id}}","description":"<p>Retrieves a rate limited source by ID.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","rate-limited-sources","{{source_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"27b94192-c4ae-4e8d-b43e-2f9813f157ab","name":"200 Rate limited source retrieved successfully.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/rate-limited-sources/665f1719e3d162737d986653","description":"Retrieves a rate limited source by ID.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Rate limited source retrieved successfully.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"665f1719e3d162737d986653\",\"created_at\":\"2019-08-24T14:15:22Z\",\"workspace_id\":\"6EbvL2deHPgDm7ap5mS6D9\",\"signal\":\"RATE_LIMIT\",\"source\":\"192.0.2.1\",\"expires_at\":\"2021-04-19T03:29:30Z\",\"client_identifiers\":[{\"type\":\"ip\",\"name\":\"remote_ip\",\"key\":\"192.0.2.1\"}]}"}],"_postman_id":"5fac578d-80e4-41d0-9283-62288790bb29"},{"name":"Remove a rate limited source","id":"bbb8d404-6c5d-4a86-b889-b2fddc55af8a","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/rate-limited-sources/{{source_id}}","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/ngwaf/rate-limited-sources/#ngwafDeleteRateLimitedSource\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","rate-limited-sources","{{source_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"5b7035e9-df66-4e19-83e2-8691ae834b77","name":"204 Deletion was successful.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/rate-limited-sources/665f1719e3d162737d986653","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/ngwaf/rate-limited-sources/#ngwafDeleteRateLimitedSource)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 Deletion was successful.","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"bbb8d404-6c5d-4a86-b889-b2fddc55af8a"}],"id":"eedd514e-56dd-4c8e-9535-5bfac20c53b4","description":"<p>Rate limited sources allow you to view and manage IP addresses and other sources that have been temporarily rate limited by the Next-Gen WAF.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"eedd514e-56dd-4c8e-9535-5bfac20c53b4"},{"name":"Redactions","item":[{"name":"List redactions","id":"1da31408-47e4-425b-808a-7efd04371366","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/redactions?limit","description":"<p>List redactions in a workspace.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","redactions"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Limit how many results are returned.</p>\n","type":"text/plain"},"key":"limit"}],"variable":[]}},"response":[{"id":"c1b02d84-5da1-4c4f-9e2a-ac847c0e68d0","name":"200 List of redactions in a workspace.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/redactions?limit=100?limit","protocol":"https","host":["api","fastly","com"],"path":["ngwaf","v1","workspaces","SU1Z0isxPaozGVKXdv0eY","redactions"],"query":[{"key":"limit","description":"Limit how many results are returned."}]},"description":"List redactions in a workspace.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 List of redactions in a workspace.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"meta\":{\"limit\":2,\"total\":5},\"data\":[{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"field\":\"credit_card_number\",\"type\":\"request_parameter\",\"created_at\":\"2025-05-12T20:55:07Z\"},{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"field\":\"authorization_header\",\"type\":\"request_header\",\"created_at\":\"2025-05-12T20:55:07Z\"}]}"}],"_postman_id":"1da31408-47e4-425b-808a-7efd04371366"},{"name":"Create redaction","id":"8511a974-3c14-4a1d-b11d-633d1dfd3b6d","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"field\":\"secret_key\",\"type\":\"request_header\"}"},"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/redactions","description":"<p>Create a redaction in a workspace.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","redactions"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"69171ce4-04a1-419c-974c-789668dbf813","name":"201 Successful redaction creation.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"field\":\"secret_key\",\"type\":\"request_header\"}"},"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/redactions","description":"Create a redaction in a workspace.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"201 Successful redaction creation.","code":201,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"field\":\"secret_key\",\"type\":\"request_header\",\"created_at\":\"2025-05-12T20:55:07Z\"}"}],"_postman_id":"8511a974-3c14-4a1d-b11d-633d1dfd3b6d"},{"name":"Retrieve redaction","id":"34be4f04-24e4-4e1e-80c2-f489419ad704","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/redactions/{{redaction_id}}","description":"<p>Get a redaction in a workspace.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","redactions","{{redaction_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"d8cd6f85-df96-43ca-a3b5-b2141b95796a","name":"200 Requested redaction.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/redactions/HXhKL17TU7qYODkpEErsNHvOzQ6wGNEHxTfKVpZzsW9hoG4K8kc","description":"Get a redaction in a workspace.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Requested redaction.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"field\":\"credit_card_number\",\"type\":\"request_parameter\",\"created_at\":\"2025-05-12T20:55:07Z\"}"}],"_postman_id":"34be4f04-24e4-4e1e-80c2-f489419ad704"},{"name":"Remove redaction","id":"51de0e2e-f17e-4cb1-9084-52bbfc90890e","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/redactions/{{redaction_id}}","description":"<p>Remove a redaction from a workspace.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","redactions","{{redaction_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"e68d53af-10f0-42bb-8a84-2c17567ff7e8","name":"204 Deletion was successful.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/redactions/HXhKL17TU7qYODkpEErsNHvOzQ6wGNEHxTfKVpZzsW9hoG4K8kc","description":"Remove a redaction from a workspace.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 Deletion was successful.","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"51de0e2e-f17e-4cb1-9084-52bbfc90890e"},{"name":"Edit redaction","id":"59987228-ccc1-45a1-9fe0-19c3bdd06657","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"field\":\"secret_key\",\"type\":\"request_header\"}"},"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/redactions/{{redaction_id}}","description":"<p>Change attributes of a redaction in a workspace.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","redactions","{{redaction_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"0af907c3-0bfe-48ca-bf7c-0488a2dfa5b1","name":"200 Successful redaction update.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"field\":\"secret_key\",\"type\":\"request_header\"}"},"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/redactions/HXhKL17TU7qYODkpEErsNHvOzQ6wGNEHxTfKVpZzsW9hoG4K8kc","description":"Change attributes of a redaction in a workspace.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Successful redaction update.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"field\":\"payment_info\",\"type\":\"request_parameter\",\"created_at\":\"2025-05-12T20:55:07Z\"}"}],"_postman_id":"59987228-ccc1-45a1-9fe0-19c3bdd06657"}],"id":"cc07753c-bc19-48ef-aa75-207b50040994","description":"<p>Next-Gen WAF automatically redacts known patterns of sensitive information. In addition to automatic redactions, the redactions API allows you to specify additional fields to redact from requests.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>field</td>\n<td>string</td>\n<td>The name of the field that should be redacted.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>A base62-encoded representation of a UUID used to uniquely identify a redaction.</td>\n</tr>\n<tr>\n<td>type</td>\n<td>string</td>\n<td>The type of field that is being redacted.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"cc07753c-bc19-48ef-aa75-207b50040994"},{"name":"Reports","item":[{"name":"Get signals report","id":"d186c408-0f1a-4f4b-90fb-340ab57e04c6","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/reports/signals?from&signal_type&to","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/ngwaf/reports/#getSignalsReport\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","reports","signals"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>The start of a time range in RFC 3339 format.</p>\n","type":"text/plain"},"key":"from"},{"description":{"content":"<p>The type of signal.</p>\n","type":"text/plain"},"key":"signal_type"},{"description":{"content":"<p>The end of a time range in RFC 3339 format. Defaults to the current time.</p>\n","type":"text/plain"},"key":"to"}],"variable":[]}},"response":[{"id":"f8adb5ff-d49c-41b7-926b-2ae09ed52927","name":"200 Successful response with signals report.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/ngwaf/v1/reports/signals?from=2019-08-20T18%3A07%3A33Z&signal_type=all&to=2019-08-21T18%3A07%3A33Z?from&signal_type&to","protocol":"https","host":["api","fastly","com"],"path":["ngwaf","v1","reports","signals"],"query":[{"key":"from","description":"The start of a time range in RFC 3339 format."},{"key":"signal_type","description":"The type of signal."},{"key":"to","description":"The end of a time range in RFC 3339 format. Defaults to the current time."}]},"description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/ngwaf/reports/#getSignalsReport)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Successful response with signals report.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"name\":\"TRAVERSAL\",\"display_name\":\"Traversal\",\"count\":200,\"top_workspaces\":[{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"name\":\"Workspace\",\"count\":200}]}]}"}],"_postman_id":"d186c408-0f1a-4f4b-90fb-340ab57e04c6"},{"name":"Get attacks report","id":"4536dc35-e585-43a6-8dad-ac2182353b8b","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/reports/attacks?from&to","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/ngwaf/reports/#getAttacksReport\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","reports","attacks"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>The start of a time range in RFC 3339 format.</p>\n","type":"text/plain"},"key":"from"},{"description":{"content":"<p>The end of a time range in RFC 3339 format. Defaults to the current time.</p>\n","type":"text/plain"},"key":"to"}],"variable":[]}},"response":[{"id":"c83d5944-2c56-44bd-aea0-d4f33db8db85","name":"200 Successful response with attack reports.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/ngwaf/v1/reports/attacks?from=2019-08-20T18%3A07%3A33Z&to=2019-08-21T18%3A07%3A33Z?from&to","protocol":"https","host":["api","fastly","com"],"path":["ngwaf","v1","reports","attacks"],"query":[{"key":"from","description":"The start of a time range in RFC 3339 format."},{"key":"to","description":"The end of a time range in RFC 3339 format. Defaults to the current time."}]},"description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/ngwaf/reports/#getAttacksReport)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Successful response with attack reports.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"name\":\"dashboard.myapp.net\",\"total_count\":9000,\"blocked_count\":123,\"flagged_count\":0,\"attack_count\":0,\"all_flagged_ip_count\":279,\"flagged_ip_count\":193,\"top_attack_signals\":[{\"tag_name\":\"Traversal\",\"tag_count\":21198,\"total_count\":45826}],\"top_attack_sources\":[{\"country_code\":\"US\",\"country_name\":\"United States\",\"request_count\":25977,\"total_count\":42762}]}],\"meta\":{\"total\":100}}"}],"_postman_id":"4536dc35-e585-43a6-8dad-ac2182353b8b"}],"id":"87a41ad0-d703-476a-8c56-c1357967bec4","description":"<p>Reports endpoints provide functionality to access account reports on attacks and signals.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>all_flagged_ip_count</td>\n<td>integer</td>\n<td>Count of IPs that have been flagged.</td>\n</tr>\n<tr>\n<td>attack_count</td>\n<td>integer</td>\n<td>Attack request count.</td>\n</tr>\n<tr>\n<td>blocked_count</td>\n<td>integer</td>\n<td>Blocked request count.</td>\n</tr>\n<tr>\n<td>flagged_count</td>\n<td>integer</td>\n<td>Flagged request count.</td>\n</tr>\n<tr>\n<td>flagged_ip_count</td>\n<td>integer</td>\n<td>Count of currently flagged IPs.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>ID of the workspace.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>Name of the workspace.</td>\n</tr>\n<tr>\n<td>total_count</td>\n<td>integer</td>\n<td>Total request count.</td>\n</tr>\n<tr>\n<td>tag_count</td>\n<td>integer</td>\n<td>Count of requests with this attack signal.</td>\n</tr>\n<tr>\n<td>tag_name</td>\n<td>string</td>\n<td>Name of the attack signal tag.</td>\n</tr>\n<tr>\n<td>country_code</td>\n<td>string</td>\n<td>Country code of the attack source.</td>\n</tr>\n<tr>\n<td>country_name</td>\n<td>string</td>\n<td>Name of the country.</td>\n</tr>\n<tr>\n<td>request_count</td>\n<td>integer</td>\n<td>Number of requests from this country.</td>\n</tr>\n<tr>\n<td>meta</td>\n<td>object</td>\n<td>Metadata about the request.</td>\n</tr>\n<tr>\n<td>count</td>\n<td>integer</td>\n<td>Total count of attacks of this type.</td>\n</tr>\n<tr>\n<td>display_name</td>\n<td>string</td>\n<td>Display name of the attack type.</td>\n</tr>\n<tr>\n<td>top_workspaces</td>\n<td>array</td>\n<td>Top workspaces affected by this attack type.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-1\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>count</td>\n<td>integer</td>\n<td>Count of attacks on this workspace for the specific attack type.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>ID of the workspace.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>Name of the workspace.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"87a41ad0-d703-476a-8c56-c1357967bec4"},{"name":"Requests","item":[{"name":"Search requests","id":"4e0f322f-e8e4-425f-a2d0-61d14de1ebe8","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/requests?export&limit&page&q","description":"<p>Find requests in a workspace.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","requests"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Request to download the content as a file. Uses the Accept header to determine which format to download.</p>\n","type":"text/plain"},"key":"export"},{"description":{"content":"<p>Limit how many results are returned.</p>\n","type":"text/plain"},"key":"limit"},{"description":{"content":"<p>Page number of the collection to request.</p>\n","type":"text/plain"},"key":"page"},{"description":{"content":"<p>Search query. See Search Syntax: <a href=\"https://www.fastly.com/documentation/guides/next-gen-waf/reference/searching-for-requests/\">https://www.fastly.com/documentation/guides/next-gen-waf/reference/searching-for-requests/</a>.</p>\n","type":"text/plain"},"key":"q"}],"variable":[]}},"response":[{"id":"f3fe9552-88fd-4189-b8ca-ed39784ade38","name":"200 List of requests.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/requests?limit=100&page=1&q=%2Fa%2Fpath%2Fhere+sqli+from%3A-7h?export&limit&page&q","protocol":"https","host":["api","fastly","com"],"path":["ngwaf","v1","workspaces","SU1Z0isxPaozGVKXdv0eY","requests"],"query":[{"key":"export","description":"Request to download the content as a file. Uses the Accept header to determine which format to download."},{"key":"limit","description":"Limit how many results are returned."},{"key":"page","description":"Page number of the collection to request."},{"key":"q","description":"Search query. See Search Syntax: https://www.fastly.com/documentation/guides/next-gen-waf/reference/searching-for-requests/."}]},"description":"Find requests in a workspace.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 List of requests.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"meta\":{\"limit\":1,\"total\":100},\"data\":[{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"timestamp\":\"2025-05-12T20:55:07Z\",\"server_hostname\":\"example.com\",\"server_name\":\"string\",\"uri\":\"/requestpath?q=example\",\"scheme\":\"http\",\"path\":\"/requestpath\",\"user_agent\":\"Mozilla/5.00 (Nikto/2.1.5) (Evasions:None) (Test:000691)\",\"remote_ip\":\"127.0.0.1\",\"remote_hostname\":\"example.com\",\"country\":\"US\",\"method\":\"PUT\",\"protocol\":\"HTTP/1.1\",\"tls_protocol\":\"TLS13\",\"tls_cipher\":\"TLS_AES_128_GCM_SHA256\",\"response_code\":503,\"response_size\":88336,\"response_time\":50,\"agent_response_code\":200,\"request_headers\":[{\"name\":\"User-Agent\",\"value\":\"ZmEu\"}],\"response_headers\":[{\"name\":\"Content-Encoding\",\"value\":\"gzip\"}],\"signals\":[{\"id\":\"SQLI\",\"location\":\"QUERYSTRING\",\"value\":\"foo=1 OR 1\",\"detector\":\"LIBINJECTIONV5\",\"detector_scope\":\"system\"}]}]}"}],"_postman_id":"4e0f322f-e8e4-425f-a2d0-61d14de1ebe8"},{"name":"Retrieve request","id":"0cc1b8c4-c2df-476f-8a21-023cdbee8749","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/requests/{{request_id}}","description":"<p>Get a request in a workspace.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","requests","{{request_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"13a2dbe2-c41c-4d6e-9568-66c644a60317","name":"200 Requested request.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/requests/ORkjWUVWFgNJIyKvcSnzmLCsizuPnqhjHvTbwtOxVmTxEgxetXX","description":"Get a request in a workspace.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Requested request.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"timestamp\":\"2025-05-12T20:55:07Z\",\"server_hostname\":\"example.com\",\"server_name\":\"string\",\"uri\":\"/requestpath?q=example\",\"scheme\":\"http\",\"path\":\"/requestpath\",\"user_agent\":\"Mozilla/5.00 (Nikto/2.1.5) (Evasions:None) (Test:000691)\",\"remote_ip\":\"127.0.0.1\",\"remote_hostname\":\"example.com\",\"country\":\"US\",\"method\":\"PUT\",\"protocol\":\"HTTP/1.1\",\"tls_protocol\":\"TLS13\",\"tls_cipher\":\"TLS_AES_128_GCM_SHA256\",\"response_code\":503,\"response_size\":88336,\"response_time\":50,\"agent_response_code\":200,\"request_headers\":[{\"name\":\"User-Agent\",\"value\":\"ZmEu\"}],\"response_headers\":[{\"name\":\"Content-Encoding\",\"value\":\"gzip\"}],\"signals\":[{\"id\":\"SQLI\",\"location\":\"QUERYSTRING\",\"value\":\"foo=1 OR 1\",\"detector\":\"LIBINJECTIONV5\",\"detector_scope\":\"system\"}]}"}],"_postman_id":"0cc1b8c4-c2df-476f-8a21-023cdbee8749"},{"name":"Report false positive for request","id":"0f715518-800a-4560-a685-e5b410e07949","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"description\":\"A legitimate database query triggered an SQL injection detection.\",\"signals\":[\"SQLI\"]}"},"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/requests/{{request_id}}/report","description":"<p>Report a false positive for a specific request when the Next-Gen WAF incorrectly flags legitimate traffic as malicious.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","requests","{{request_id}}","report"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"3e59992c-b60b-4cb5-9c76-45212827d1f6","name":"201 False positive reported successfully.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"description\":\"A legitimate database query triggered an SQL injection detection.\",\"signals\":[\"SQLI\"]}"},"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/requests/ORkjWUVWFgNJIyKvcSnzmLCsizuPnqhjHvTbwtOxVmTxEgxetXX/report","description":"Report a false positive for a specific request when the Next-Gen WAF incorrectly flags legitimate traffic as malicious.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"201 False positive reported successfully.","code":201,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"description\":\"A legitimate database query triggered an SQL injection detection.\",\"signals\":[\"SQLI\"]}"}],"_postman_id":"0f715518-800a-4560-a685-e5b410e07949"}],"id":"00993d59-400d-4fee-a4c3-5b3236019f1f","description":"<p>Requests lists individual requests that have been tagged with signals.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>agent_response_code</td>\n<td>integer</td>\n<td>Agent response code.</td>\n</tr>\n<tr>\n<td>country</td>\n<td>string</td>\n<td>Country code.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>A base62-encoded representation of a UUID used to uniquely identify a request.</td>\n</tr>\n<tr>\n<td>method</td>\n<td>string</td>\n<td>HTTP method.</td>\n</tr>\n<tr>\n<td>path</td>\n<td>string</td>\n<td>Request path.</td>\n</tr>\n<tr>\n<td>protocol</td>\n<td>string</td>\n<td>HTTP protocol.</td>\n</tr>\n<tr>\n<td>remote_hostname</td>\n<td>string</td>\n<td>Remote hostname.</td>\n</tr>\n<tr>\n<td>remote_ip</td>\n<td>string</td>\n<td>Remote IP address.</td>\n</tr>\n<tr>\n<td>request_headers</td>\n<td>array</td>\n<td>Request headers.</td>\n</tr>\n<tr>\n<td>response_code</td>\n<td>integer</td>\n<td>HTTP response code.</td>\n</tr>\n<tr>\n<td>response_headers</td>\n<td>array</td>\n<td>Response headers.</td>\n</tr>\n<tr>\n<td>response_size</td>\n<td>integer</td>\n<td>HTTP response size.</td>\n</tr>\n<tr>\n<td>response_time</td>\n<td>integer</td>\n<td>Response time in milliseconds.</td>\n</tr>\n<tr>\n<td>scheme</td>\n<td>string</td>\n<td>Request scheme.</td>\n</tr>\n<tr>\n<td>server_hostname</td>\n<td>string</td>\n<td>Server hostname.</td>\n</tr>\n<tr>\n<td>server_name</td>\n<td>string</td>\n<td>Server name.</td>\n</tr>\n<tr>\n<td>signals</td>\n<td>array</td>\n<td>List of signals.</td>\n</tr>\n<tr>\n<td>timestamp</td>\n<td>string</td>\n<td>Time when the request was made.</td>\n</tr>\n<tr>\n<td>tls_cipher</td>\n<td>string</td>\n<td>TLS cipher.</td>\n</tr>\n<tr>\n<td>tls_protocol</td>\n<td>string</td>\n<td>TLS protocol.</td>\n</tr>\n<tr>\n<td>uri</td>\n<td>string</td>\n<td>Request URI.</td>\n</tr>\n<tr>\n<td>user_agent</td>\n<td>string</td>\n<td>User agent.</td>\n</tr>\n<tr>\n<td>description</td>\n<td>string</td>\n<td>A detailed description of why this detection is a false positive. Special characters will be sanitized to ensure data remains safe and reliable.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>Header name.</td>\n</tr>\n<tr>\n<td>value</td>\n<td>string</td>\n<td>Header value.</td>\n</tr>\n<tr>\n<td>detector</td>\n<td>string</td>\n<td>Detector that detected the signal.</td>\n</tr>\n<tr>\n<td>detector_scope</td>\n<td>string</td>\n<td>The scope of the detector that generated this signal.</td>\n</tr>\n<tr>\n<td>location</td>\n<td>string</td>\n<td>Where the signal was detected.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"00993d59-400d-4fee-a4c3-5b3236019f1f"},{"name":"Rules","item":[{"name":"List account rules","id":"0e0a98b5-9327-476a-9399-b52935c53406","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/rules?action&enabled&limit&page&scope&types","description":"<p>List rules at the account level.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","rules"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Return only the rules with the given action.</p>\n","type":"text/plain"},"key":"action"},{"description":{"content":"<p>Return either all enabled rules or all disabled rules.</p>\n","type":"text/plain"},"key":"enabled"},{"description":{"content":"<p>Limit how many results are returned.</p>\n","type":"text/plain"},"key":"limit"},{"description":{"content":"<p>Page number of the collection to request.</p>\n","type":"text/plain"},"key":"page"},{"description":{"content":"<p>Return only the rules with the given scope.</p>\n","type":"text/plain"},"key":"scope"},{"description":{"content":"<p>Return rules with any of the given rule types. More than one value can be supplied.</p>\n","type":"text/plain"},"key":"types"}],"variable":[]}},"response":[{"id":"e77ea61d-d523-491d-85a0-fbe4a6f18194","name":"200 Successful response of listing rules at the account level.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/ngwaf/v1/rules?limit=100&page=1?action&enabled&limit&page&scope&types","protocol":"https","host":["api","fastly","com"],"path":["ngwaf","v1","rules"],"query":[{"key":"action","description":"Return only the rules with the given action."},{"key":"enabled","description":"Return either all enabled rules or all disabled rules."},{"key":"limit","description":"Limit how many results are returned."},{"key":"page","description":"Page number of the collection to request."},{"key":"scope","description":"Return only the rules with the given scope."},{"key":"types","description":"Return rules with any of the given rule types. More than one value can be supplied."}]},"description":"List rules at the account level.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Successful response of listing rules at the account level.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"meta\":{\"limit\":1,\"total\":100},\"data\":[{\"id\":\"68a36634154cfc0df49018c1\",\"type\":\"request\",\"scope\":{\"type\":\"account\",\"applies_to\":[\"*\"]},\"enabled\":true,\"description\":\"Block IP 192.0.2.1\",\"group_operator\":\"all\",\"request_logging\":\"sampled\",\"conditions\":[{\"type\":\"single\",\"field\":\"ip\",\"operator\":\"equals\",\"value\":\"192.0.2.0/24\"}],\"actions\":[{\"type\":\"block\"}],\"created_at\":\"2025-08-18T17:43:16Z\",\"updated_at\":\"2025-08-18T17:43:16Z\"}]}"}],"_postman_id":"0e0a98b5-9327-476a-9399-b52935c53406"},{"name":"Create account rule","id":"cbb37ecd-cf13-4e9a-a232-083639925437","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/rules","description":"<p>Create a rule at the account level.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","rules"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"6c3ddf92-902c-4e67-8310-22a283ee294d","name":"201 Successful account rule creation.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/rules","description":"Create a rule at the account level.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"201 Successful account rule creation.","code":201,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"68a36634154cfc0df49018c1\",\"type\":\"request\",\"scope\":{\"type\":\"account\",\"applies_to\":[\"*\"]},\"enabled\":true,\"description\":\"Block IP 192.0.2.1\",\"group_operator\":\"all\",\"request_logging\":\"sampled\",\"conditions\":[{\"type\":\"single\",\"field\":\"ip\",\"operator\":\"equals\",\"value\":\"192.0.2.0/24\"}],\"actions\":[{\"type\":\"block\"}],\"created_at\":\"2025-08-18T17:43:16Z\",\"updated_at\":\"2025-08-18T17:43:16Z\"}"}],"_postman_id":"cbb37ecd-cf13-4e9a-a232-083639925437"},{"name":"Retrieve account rule","id":"0f010ad4-eef3-4fcc-b6e9-047413910479","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/rules/{{rule_id}}","description":"<p>Get a rule at the account level.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","rules","{{rule_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"0d0df2a2-ff7d-45ac-85e4-e97ff640ef24","name":"200 Successful account rule request.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/rules/665f1719e3d162737d986653","description":"Get a rule at the account level.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Successful account rule request.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"68a36634154cfc0df49018c1\",\"type\":\"request\",\"scope\":{\"type\":\"account\",\"applies_to\":[\"*\"]},\"enabled\":true,\"description\":\"Block IP 192.0.2.1\",\"group_operator\":\"all\",\"request_logging\":\"sampled\",\"conditions\":[{\"type\":\"single\",\"field\":\"ip\",\"operator\":\"equals\",\"value\":\"192.0.2.0/24\"}],\"actions\":[{\"type\":\"block\"}],\"created_at\":\"2025-08-18T17:43:16Z\",\"updated_at\":\"2025-08-18T17:43:16Z\"}"}],"_postman_id":"0f010ad4-eef3-4fcc-b6e9-047413910479"},{"name":"Remove an account rule","id":"b02cb1a7-7b47-4cf1-b64c-a532be2075ec","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/ngwaf/v1/rules/{{rule_id}}","description":"<p>Delete a rule at the account level.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","rules","{{rule_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"53c35fdf-4e25-4e1d-9b8f-0a8008c28d5c","name":"204 Deletion was successful.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/ngwaf/v1/rules/665f1719e3d162737d986653","description":"Delete a rule at the account level.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 Deletion was successful.","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"b02cb1a7-7b47-4cf1-b64c-a532be2075ec"},{"name":"Edit account rule","id":"708538cd-43ab-4e77-b5da-3cc39b9afd02","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/rules/{{rule_id}}","description":"<p>Change attributes of a rule at the account level.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","rules","{{rule_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"d9409f95-6bb3-44a4-90d4-abf7b609ee81","name":"200 Successful account rule update.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/rules/665f1719e3d162737d986653","description":"Change attributes of a rule at the account level.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Successful account rule update.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"68a371d8490d9d1f77bab645\",\"type\":\"request\",\"scope\":{\"type\":\"account\",\"applies_to\":[\"*\"]},\"enabled\":true,\"description\":\"Block requests from ip 192.0.2.1 on internal route\",\"group_operator\":\"all\",\"request_logging\":\"sampled\",\"conditions\":[{\"type\":\"single\",\"field\":\"ip\",\"operator\":\"equals\",\"value\":\"192.0.2.0/24\"},{\"type\":\"single\",\"field\":\"path\",\"operator\":\"equals\",\"value\":\"/internal\"}],\"actions\":[{\"type\":\"block\"}],\"created_at\":\"2025-08-18T18:32:56Z\",\"updated_at\":\"2025-08-18T18:32:56Z\"}"}],"_postman_id":"708538cd-43ab-4e77-b5da-3cc39b9afd02"},{"name":"List rules","id":"97737edb-4e18-46c2-9666-994f63d467c8","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/rules?action&enabled&limit&page&types","description":"<p>List rules in a workspace.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","rules"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Return only the rules with the given action.</p>\n","type":"text/plain"},"key":"action"},{"description":{"content":"<p>Return either all enabled rules or all disabled rules.</p>\n","type":"text/plain"},"key":"enabled"},{"description":{"content":"<p>Limit how many results are returned.</p>\n","type":"text/plain"},"key":"limit"},{"description":{"content":"<p>Page number of the collection to request.</p>\n","type":"text/plain"},"key":"page"},{"description":{"content":"<p>Return rules with any of the given rule types. More than one value can be supplied.</p>\n","type":"text/plain"},"key":"types"}],"variable":[]}},"response":[{"id":"b3e6c698-c862-4dfc-86eb-2b455cbb328b","name":"200 Successful response of searching rules of a workspace.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/rules?limit=100&page=1?action&enabled&limit&page&types","protocol":"https","host":["api","fastly","com"],"path":["ngwaf","v1","workspaces","SU1Z0isxPaozGVKXdv0eY","rules"],"query":[{"key":"action","description":"Return only the rules with the given action."},{"key":"enabled","description":"Return either all enabled rules or all disabled rules."},{"key":"limit","description":"Limit how many results are returned."},{"key":"page","description":"Page number of the collection to request."},{"key":"types","description":"Return rules with any of the given rule types. More than one value can be supplied."}]},"description":"List rules in a workspace.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Successful response of searching rules of a workspace.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"meta\":{\"limit\":1,\"total\":100},\"data\":[{\"id\":\"68a36634154cfc0df49018c1\",\"type\":\"request\",\"scope\":{\"type\":\"workspace\",\"applies_to\":[\"SU1Z0isxPaozGVKXdv0eY\"]},\"enabled\":true,\"description\":\"Block IP 192.0.2.1\",\"group_operator\":\"all\",\"request_logging\":\"sampled\",\"conditions\":[{\"type\":\"single\",\"field\":\"ip\",\"operator\":\"equals\",\"value\":\"192.0.2.0/24\"}],\"actions\":[{\"type\":\"block\"}],\"created_at\":\"2025-08-18T17:43:16Z\",\"updated_at\":\"2025-08-18T17:43:16Z\"}]}"}],"_postman_id":"97737edb-4e18-46c2-9666-994f63d467c8"},{"name":"Create rule","id":"61a9d06b-c88b-41f9-aac0-d16b56d20aa4","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/rules","description":"<p>Create a rule in a workspace.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","rules"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"90fe38d2-eb7f-4b5a-a006-c883881e58eb","name":"201 Successful rule creation.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/rules","description":"Create a rule in a workspace.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"201 Successful rule creation.","code":201,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"68a36634154cfc0df49018c1\",\"type\":\"request\",\"scope\":{\"type\":\"workspace\",\"applies_to\":[\"SU1Z0isxPaozGVKXdv0eY\"]},\"enabled\":true,\"description\":\"Block IP 192.0.2.1\",\"group_operator\":\"all\",\"request_logging\":\"sampled\",\"conditions\":[{\"type\":\"single\",\"field\":\"ip\",\"operator\":\"equals\",\"value\":\"192.0.2.0/24\"}],\"actions\":[{\"type\":\"block\"}],\"created_at\":\"2025-08-18T17:43:16.000Z\",\"updated_at\":\"2025-08-18T17:43:16.000Z\"}"}],"_postman_id":"61a9d06b-c88b-41f9-aac0-d16b56d20aa4"},{"name":"Retrieve rule","id":"281e65c5-7cdf-47f5-90ea-3a586072aef6","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/rules/{{rule_id}}","description":"<p>Get a rule in a workspace.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","rules","{{rule_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"abcf995a-8f91-4208-8f0f-c1ed3c55b71f","name":"200 Successful rule request.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/rules/665f1719e3d162737d986653","description":"Get a rule in a workspace.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Successful rule request.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"68a36634154cfc0df49018c1\",\"type\":\"request\",\"scope\":{\"type\":\"workspace\",\"applies_to\":[\"SU1Z0isxPaozGVKXdv0eY\"]},\"enabled\":true,\"description\":\"Block IP 192.0.2.1\",\"group_operator\":\"all\",\"request_logging\":\"sampled\",\"conditions\":[{\"type\":\"single\",\"field\":\"ip\",\"operator\":\"equals\",\"value\":\"192.0.2.0/24\"}],\"actions\":[{\"type\":\"block\"}],\"created_at\":\"2025-08-18T17:43:16.000Z\",\"updated_at\":\"2025-08-18T17:43:16.000Z\"}"}],"_postman_id":"281e65c5-7cdf-47f5-90ea-3a586072aef6"},{"name":"Remove a rule","id":"35101c9a-fe9e-4d35-8cef-4d71dd7acfc1","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/rules/{{rule_id}}","description":"<p>Delete a rule from a workspace.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","rules","{{rule_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"fb17b22d-c557-43dd-9b2b-ce39f9b7fc03","name":"204 Deletion was successful.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/rules/665f1719e3d162737d986653","description":"Delete a rule from a workspace.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 Deletion was successful.","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"35101c9a-fe9e-4d35-8cef-4d71dd7acfc1"},{"name":"Edit rule","id":"c59ce992-c4b5-4976-8b5e-f317e990894b","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/rules/{{rule_id}}","description":"<p>Change attributes of a rule in a workspace.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","rules","{{rule_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"435c0589-975a-4214-bc0f-8e8254a30a2c","name":"200 Successful rule update.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/rules/665f1719e3d162737d986653","description":"Change attributes of a rule in a workspace.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Successful rule update.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"68a371d8490d9d1f77bab645\",\"type\":\"request\",\"scope\":{\"type\":\"workspace\",\"applies_to\":[\"SU1Z0isxPaozGVKXdv0eY\"]},\"enabled\":true,\"description\":\"Block requests from ip 192.0.2.1 on internal route\",\"group_operator\":\"all\",\"request_logging\":\"sampled\",\"conditions\":[{\"type\":\"single\",\"field\":\"ip\",\"operator\":\"equals\",\"value\":\"192.0.2.0/24\"},{\"type\":\"single\",\"field\":\"path\",\"operator\":\"equals\",\"value\":\"/internal\"}],\"actions\":[{\"type\":\"block\"}],\"created_at\":\"2025-08-18T18:32:56Z\",\"updated_at\":\"2025-08-18T18:32:56Z\"}"}],"_postman_id":"c59ce992-c4b5-4976-8b5e-f317e990894b"}],"id":"54a1188f-d8e6-4dc1-9385-de32d34f3ab1","description":"<p>Rules allow you to allow, block, rate limit, or tag requests for an arbitrary set of conditions.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date the rule was created.</td>\n</tr>\n<tr>\n<td>description</td>\n<td>string</td>\n<td>Description for rule.</td>\n</tr>\n<tr>\n<td>enabled</td>\n<td>boolean</td>\n<td>Turns a rule on and off. Defaults to false (off).</td>\n</tr>\n<tr>\n<td>expires_at</td>\n<td>string</td>\n<td>Date the rule will automatically be disabled. Field is nullable and set to null if the rule should always be enabled. If the rule is always enabled, will return undefined.</td>\n</tr>\n<tr>\n<td>group_operator</td>\n<td>string</td>\n<td>Conditions that must be matched when evaluating the request.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>The ID of the rule.</td>\n</tr>\n<tr>\n<td>request_logging</td>\n<td>string</td>\n<td>Indicates whether to store the logs for requests that match the rule's conditions (sampled) or not store them (none).</td>\n</tr>\n<tr>\n<td>scope</td>\n<td>object</td>\n<td>Scope configuration for account rules. Defines whether the rule applies to all workspaces or specific workspaces.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date the rule was last updated.</td>\n</tr>\n<tr>\n<td>rate_limit</td>\n<td>object</td>\n<td>Rate limiting configuration including thresholds, intervals, and client identification methods.</td>\n</tr>\n<tr>\n<td>applies_to</td>\n<td>array</td>\n<td>Defines the workspaces to which the rule applies. Use \"*\" to apply the rule to all workspaces, or provide specific workspace IDs.</td>\n</tr>\n<tr>\n<td>type</td>\n<td>string</td>\n<td>Indicates the rule applies at the account level.</td>\n</tr>\n<tr>\n<td>field</td>\n<td>string</td>\n<td>Enums for multival condition field. Refer to: <a href=\"https://www.fastly.com/documentation/guides/next-gen-waf/using-ngwaf/rules/defining-rule-conditions/#fields\">https://www.fastly.com/documentation/guides/next-gen-waf/using-ngwaf/rules/defining-rule-conditions/#fields</a>.</td>\n</tr>\n<tr>\n<td>operator</td>\n<td>string</td>\n<td>Indicates whether the supplied conditions will check for existence or non-existence of matching field values.</td>\n</tr>\n<tr>\n<td>Refer to: <a href=\"https://www.fastly.com/documentation/guides/next-gen-waf/using-ngwaf/rules/defining-rule-conditions/#operators\">https://www.fastly.com/documentation/guides/next-gen-waf/using-ngwaf/rules/defining-rule-conditions/#operators</a>.</td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td>value</td>\n<td>string</td>\n<td>The value to compare against the field. Refer to: <a href=\"https://www.fastly.com/documentation/guides/next-gen-waf/using-ngwaf/rules/defining-rule-conditions/#field-value-case-sensitivity\">https://www.fastly.com/documentation/guides/next-gen-waf/using-ngwaf/rules/defining-rule-conditions/#field-value-case-sensitivity</a>.</td>\n</tr>\n<tr>\n<td>client_identifiers</td>\n<td>array</td>\n<td>Array of client identifier objects that define how to identify unique clients for rate limiting.</td>\n</tr>\n<tr>\n<td>duration</td>\n<td>integer</td>\n<td>The time in seconds that the rate limit action will be applied after the threshold is exceeded.</td>\n</tr>\n<tr>\n<td>interval</td>\n<td>integer</td>\n<td>The time window in seconds over which the threshold is applied.</td>\n</tr>\n<tr>\n<td>signal</td>\n<td>string</td>\n<td>Signal name for rate limit rules.</td>\n</tr>\n<tr>\n<td>threshold</td>\n<td>integer</td>\n<td>The number of requests that must be exceeded before the rate limit is triggered.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"54a1188f-d8e6-4dc1-9385-de32d34f3ab1"},{"name":"Custom Signals","item":[{"name":"Get account level custom signals","id":"da59c0ce-e8e6-453c-805a-1cb30bbeb1c8","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/signals?limit","description":"<p>List account level signals.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","signals"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Limit how many results are returned.</p>\n","type":"text/plain"},"key":"limit"}],"variable":[]}},"response":[{"id":"6ebc8b2e-d7f3-447e-ace4-3ff743b0cf37","name":"200 List of custom signals.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/ngwaf/v1/signals?limit=100?limit","protocol":"https","host":["api","fastly","com"],"path":["ngwaf","v1","signals"],"query":[{"key":"limit","description":"Limit how many results are returned."}]},"description":"List account level signals.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 List of custom signals.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"meta\":{\"limit\":1,\"total\":100},\"data\":[{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"reference_id\":\"site.foo-signal\",\"name\":\"foo signal\",\"description\":\"Custom signal description.\",\"scope\":{\"type\":\"account\",\"applies_to\":[\"*\"]},\"created_at\":\"2025-05-12T20:55:07Z\",\"updated_at\":\"2025-05-12T20:55:07Z\"}]}"}],"_postman_id":"da59c0ce-e8e6-453c-805a-1cb30bbeb1c8"},{"name":"Create a new account-level custom signal","id":"0cd81688-4b81-46ed-befa-cc0d4ac8394e","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"foo signal\",\"description\":\"Custom signal description.\"}"},"url":"https://api.fastly.com/ngwaf/v1/signals","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/ngwaf/signals/#ngwafCreateAccountCustomSignal\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","signals"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"88507736-149d-4bce-b258-caa669f11bf9","name":"201 Successful custom signal creation.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"foo signal\",\"description\":\"Custom signal description.\"}"},"url":"https://api.fastly.com/ngwaf/v1/signals","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/ngwaf/signals/#ngwafCreateAccountCustomSignal)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"201 Successful custom signal creation.","code":201,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"reference_id\":\"site.foo-signal\",\"name\":\"foo signal\",\"description\":\"Custom signal description.\",\"scope\":{\"type\":\"account\",\"applies_to\":[\"*\"]},\"created_at\":\"2025-05-12T20:55:07Z\",\"updated_at\":\"2025-05-12T20:55:07Z\"}"}],"_postman_id":"0cd81688-4b81-46ed-befa-cc0d4ac8394e"},{"name":"Get an account-level custom signal","id":"75fff1d6-082f-4067-a76a-3a8ceb3a926a","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/signals/{{signal_id}}","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/ngwaf/signals/#ngwafAccountCustomSignalByID\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","signals","{{signal_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"cb0f35a0-75f9-454b-9aef-0734269fa88d","name":"200 Requested custom signal.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/signals/SU1Z0isxPaozGVKXdv0eY","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/ngwaf/signals/#ngwafAccountCustomSignalByID)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Requested custom signal.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"reference_id\":\"site.foo-signal\",\"name\":\"foo signal\",\"description\":\"Custom signal description.\",\"scope\":{\"type\":\"account\",\"applies_to\":[\"*\"]},\"created_at\":\"2025-05-12T20:55:07Z\",\"updated_at\":\"2025-05-12T20:55:07Z\"}"}],"_postman_id":"75fff1d6-082f-4067-a76a-3a8ceb3a926a"},{"name":"Remove an account-level custom signal","id":"76b99c8f-4f5c-4ccd-b6a9-51735b5875d7","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/ngwaf/v1/signals/{{signal_id}}","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/ngwaf/signals/#ngwafDeleteCustomSignal\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","signals","{{signal_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"c38afa9c-e665-4578-aee0-a67b4fb9324a","name":"204 Deletion was successful.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/ngwaf/v1/signals/SU1Z0isxPaozGVKXdv0eY","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/ngwaf/signals/#ngwafDeleteCustomSignal)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 Deletion was successful.","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"76b99c8f-4f5c-4ccd-b6a9-51735b5875d7"},{"name":"Edit an account-level custom signal","id":"7b060ca8-ec35-4f3c-96de-8031eeb52aec","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"description\":\"Updated custom signal description.\"}"},"url":"https://api.fastly.com/ngwaf/v1/signals/{{signal_id}}","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/ngwaf/signals/#ngwafPatchAccountCustomSignal\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","signals","{{signal_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"03bb907d-4e02-42f7-aa51-ab49f2dcf0bf","name":"200 Edit was successful.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"description\":\"Updated custom signal description.\"}"},"url":"https://api.fastly.com/ngwaf/v1/signals/SU1Z0isxPaozGVKXdv0eY","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/ngwaf/signals/#ngwafPatchAccountCustomSignal)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Edit was successful.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"reference_id\":\"site.foo-signal\",\"name\":\"foo signal\",\"description\":\"Updated custom signal description.\",\"scope\":{\"type\":\"account\",\"applies_to\":[\"*\"]},\"created_at\":\"2025-05-12T20:55:07Z\",\"updated_at\":\"2025-05-12T20:55:07Z\"}"}],"_postman_id":"7b060ca8-ec35-4f3c-96de-8031eeb52aec"},{"name":"List workspace custom signals","id":"8b16c96d-e5ce-4c7c-95c9-d163913c7d2f","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/signals?limit","description":"<p>List custom signals for a workspace.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","signals"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Limit how many results are returned.</p>\n","type":"text/plain"},"key":"limit"}],"variable":[]}},"response":[{"id":"b943d3b6-6e07-4658-9825-a02ed808432f","name":"200 List of workspace custom signals.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/signals?limit=100?limit","protocol":"https","host":["api","fastly","com"],"path":["ngwaf","v1","workspaces","SU1Z0isxPaozGVKXdv0eY","signals"],"query":[{"key":"limit","description":"Limit how many results are returned."}]},"description":"List custom signals for a workspace.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 List of workspace custom signals.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"meta\":{\"limit\":1,\"total\":100},\"data\":[{\"id\":\"6EbvL2deHPgDm7ap5mS6D9\",\"reference_id\":\"site.my-workspace-signal\",\"name\":\"my workspace signal\",\"description\":\"A workspace-scoped custom signal.\",\"scope\":{\"type\":\"workspace\",\"applies_to\":[\"SU1Z0isxPaozGVKXdv0eY\"]},\"created_at\":\"2025-05-12T20:55:07Z\",\"updated_at\":\"2025-05-12T20:55:07Z\"}]}"}],"_postman_id":"8b16c96d-e5ce-4c7c-95c9-d163913c7d2f"},{"name":"Create a workspace custom signal","id":"deed44b7-623c-409e-ad6d-8facb3488738","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"foo signal\",\"description\":\"Custom signal description.\"}"},"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/signals","description":"<p>Create a new custom signal for a workspace.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","signals"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"30b1a00c-24e3-4069-8b63-46039eee3aa3","name":"201 Successful workspace custom signal creation.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"foo signal\",\"description\":\"Custom signal description.\"}"},"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/signals","description":"Create a new custom signal for a workspace.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"201 Successful workspace custom signal creation.","code":201,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"6EbvL2deHPgDm7ap5mS6D9\",\"reference_id\":\"site.my-workspace-signal\",\"name\":\"my workspace signal\",\"description\":\"A workspace-scoped custom signal.\",\"scope\":{\"type\":\"workspace\",\"applies_to\":[\"SU1Z0isxPaozGVKXdv0eY\"]},\"created_at\":\"2025-05-12T20:55:07Z\",\"updated_at\":\"2025-05-12T20:55:07Z\"}"}],"_postman_id":"deed44b7-623c-409e-ad6d-8facb3488738"},{"name":"Get a workspace custom signal","id":"7fc35471-aa26-4032-9fde-3eb50897c51e","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/signals/{{signal_id}}","description":"<p>Get a workspace custom signal by ID.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","signals","{{signal_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"8cc5f961-4243-4542-a769-fbe28cba003e","name":"200 Requested workspace custom signal.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/signals/SU1Z0isxPaozGVKXdv0eY","description":"Get a workspace custom signal by ID.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Requested workspace custom signal.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"6EbvL2deHPgDm7ap5mS6D9\",\"reference_id\":\"site.my-workspace-signal\",\"name\":\"my workspace signal\",\"description\":\"A workspace-scoped custom signal.\",\"scope\":{\"type\":\"workspace\",\"applies_to\":[\"SU1Z0isxPaozGVKXdv0eY\"]},\"created_at\":\"2025-05-12T20:55:07Z\",\"updated_at\":\"2025-05-12T20:55:07Z\"}"}],"_postman_id":"7fc35471-aa26-4032-9fde-3eb50897c51e"},{"name":"Remove a workspace custom signal","id":"fee0dc24-440b-4fac-a5f9-5933cff24617","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/signals/{{signal_id}}","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/ngwaf/signals/#ngwafDeleteWorkspaceCustomSignal\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","signals","{{signal_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"57910961-698c-4668-a5ff-9c208324ff63","name":"204 Deletion was successful.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/signals/SU1Z0isxPaozGVKXdv0eY","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/ngwaf/signals/#ngwafDeleteWorkspaceCustomSignal)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 Deletion was successful.","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"fee0dc24-440b-4fac-a5f9-5933cff24617"},{"name":"Edit a workspace custom signal","id":"2f88cc05-61f0-4764-943e-5304a5484063","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"description\":\"Updated custom signal description.\"}"},"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/signals/{{signal_id}}","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/ngwaf/signals/#ngwafPatchWorkspaceCustomSignal\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","signals","{{signal_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"077ec65e-f363-427b-bb1b-a08ebbf18009","name":"200 Edit was successful.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"description\":\"Updated custom signal description.\"}"},"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/signals/SU1Z0isxPaozGVKXdv0eY","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/ngwaf/signals/#ngwafPatchWorkspaceCustomSignal)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Edit was successful.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"6EbvL2deHPgDm7ap5mS6D9\",\"reference_id\":\"site.my-workspace-signal\",\"name\":\"my workspace signal\",\"description\":\"Updated workspace custom signal description.\",\"scope\":{\"type\":\"workspace\",\"applies_to\":[\"SU1Z0isxPaozGVKXdv0eY\"]},\"created_at\":\"2025-05-12T20:55:07Z\",\"updated_at\":\"2025-05-12T20:55:07Z\"}"}],"_postman_id":"2f88cc05-61f0-4764-943e-5304a5484063"}],"id":"2f99275e-c4e0-4f69-a853-b445d809227a","description":"<p>Custom signals endpoints provide functionality for adding, editing, and deleting custom signals.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>description</td>\n<td>string</td>\n<td>The custom signal description.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The custom signal name. Can only contain lower and upper case letters, digits, spaces, and dashes (-).</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>The custom signal ID.</td>\n</tr>\n<tr>\n<td>reference_id</td>\n<td>string</td>\n<td>The reference ID of the signal. The ID is generated from the signal's name. The name appears lowercased, has spaces converted to dashes, and is prefixed with site. For example, a name foo signal will generate the reference ID site.foo-signal.</td>\n</tr>\n<tr>\n<td>applies_to</td>\n<td>array</td>\n<td>Defines the workspaces to which the signal applies.</td>\n</tr>\n</tbody>\n</table>\n</div><p>For workspace signals, this array contains a single workspace ID.\nFor account signals, this array can contain multiple workspace IDs or * to apply to all workspaces. |\n| type | string | Indicates whether the signal applies to a single workspace or multiple workspaces.\nA workspace signal is specific to a workspace, whereas an account signal can apply to multiple workspaces. |</p>\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"2f99275e-c4e0-4f69-a853-b445d809227a"},{"name":"Simulate","item":[{"name":"Simulate a WAF request","id":"c27b494f-24e8-4bb5-b348-ac21c4affa5a","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/simulate","description":"<p>Simulates a request through the workspace's WAF configuration and returns\nthe WAF response code and any signals that would be detected. The operation\nis stateless — no simulation data is persisted.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","simulate"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"2cb1f9df-9523-4070-a475-3ccc201cf0ed","name":"200 Simulation result.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/simulate","description":"Simulates a request through the workspace's WAF configuration and returns\nthe WAF response code and any signals that would be detected. The operation\nis stateless — no simulation data is persisted.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Simulation result.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"waf_response\":406,\"signals\":[{\"type\":\"XSS\",\"location\":\"QUERYSTRING\",\"name\":\"q\",\"value\":\"q=<script>123</script>\",\"detector\":\"LIBINJECTIONV5\",\"redaction\":\"none\"},{\"type\":\"BLOCKED\",\"value\":\"406\",\"detector\":\"650dee5a558b8c01d4dcd0ed\",\"redaction\":\"none\"}]}"}],"_postman_id":"c27b494f-24e8-4bb5-b348-ac21c4affa5a"}],"id":"e6db7431-3bd5-4617-916a-f7934e2bf452","description":"<p>Simulate HTTP requests through a workspace's WAF configuration without sending actual traffic. This allows testing and validating WAF rule behavior in a safe, non-production context.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>request</td>\n<td>string</td>\n<td>The raw HTTP request in wire format to simulate through the WAF. Must include the request line, headers, and optionally a body, separated by CRLF sequences.</td>\n</tr>\n<tr>\n<td>response</td>\n<td>string</td>\n<td>The raw HTTP response in wire format. The WAF engine inspects response headers during its PostRequest phase and may generate signals from them. When omitted, a default response of HTTP/1.1 200 OK\\r\\n\\r\\n is used.</td>\n</tr>\n<tr>\n<td>signals</td>\n<td>array</td>\n<td>List of signals detected by the WAF during simulation. Empty array when no signals are detected.</td>\n</tr>\n<tr>\n<td>waf_response</td>\n<td>integer</td>\n<td>The HTTP status code the WAF would return for the simulated request (e.g., 200 for allowed, 406 for blocked).</td>\n</tr>\n<tr>\n<td>detector</td>\n<td>string</td>\n<td>The detector engine that identified the signal (e.g., SQLI, LIBINJECTIONV5, LIBINJECTIONJS, or a rule ID).</td>\n</tr>\n<tr>\n<td>location</td>\n<td>string</td>\n<td>Where in the request the signal was detected (e.g., QUERYSTRING, POSTBODY, HEADER, HEADEROUT, POSTARG). Present for detection signals; absent for custom and action signals.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The parameter or header name that triggered detection. Present when the WAF engine identifies a specific parameter or header.</td>\n</tr>\n<tr>\n<td>redaction</td>\n<td>string</td>\n<td>The redaction level applied to the detected value. Clients should handle unexpected string values gracefully, as new redaction types may be added.</td>\n</tr>\n<tr>\n<td>type</td>\n<td>string</td>\n<td>The type of signal detected (e.g., SQLI, XSS, CMDEXE, TRAVERSAL, BACKDOOR, LOG4J-JNDI, BLOCKED).</td>\n</tr>\n<tr>\n<td>value</td>\n<td>string</td>\n<td>The matched payload value that triggered signal detection. For detection signals, contains the matched content. For BLOCKED signals, carries the WAF response code as a string. Absent for custom signals.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"e6db7431-3bd5-4617-916a-f7934e2bf452"},{"name":"Thresholds","item":[{"name":"List thresholds","id":"3ab2f9ec-9f98-482d-8954-c6eac4194c05","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/thresholds?limit","description":"<p>List configured thresholds for this workspace.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","thresholds"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Limit how many results are returned.</p>\n","type":"text/plain"},"key":"limit"}],"variable":[]}},"response":[{"id":"3b89574e-5ca6-475d-a0bb-9980418d1786","name":"200 Successful response of listing thresholds in a workspace.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/thresholds?limit=100?limit","protocol":"https","host":["api","fastly","com"],"path":["ngwaf","v1","workspaces","SU1Z0isxPaozGVKXdv0eY","thresholds"],"query":[{"key":"limit","description":"Limit how many results are returned."}]},"description":"List configured thresholds for this workspace.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Successful response of listing thresholds in a workspace.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"meta\":{\"total\":1,\"limit\":100},\"data\":[{\"id\":\"cB72dvEcGGP85ZTiQkICvg\",\"name\":\"block XSS\",\"enabled\":true,\"signal\":\"XSS\",\"action\":\"block\",\"interval\":60,\"limit\":5,\"duration\":60,\"dont_notify\":false,\"created_at\":\"2025-08-07T16:26:14-04:00\"}]}"}],"_postman_id":"3ab2f9ec-9f98-482d-8954-c6eac4194c05"},{"name":"Create a new workspace threshold","id":"05e097a9-7899-4af9-9f0e-e35869fc794b","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"block XSS\",\"enabled\":true,\"signal\":\"XSS\",\"action\":\"block\",\"interval\":60,\"limit\":5}"},"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/thresholds","description":"<p>Add a new threshold.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","thresholds"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"098abd95-e419-4242-aff6-fda249474d34","name":"201 Successful creation of workspace threshold.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"block XSS\",\"enabled\":true,\"signal\":\"XSS\",\"action\":\"block\",\"interval\":60,\"limit\":5}"},"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/thresholds","description":"Add a new threshold.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"201 Successful creation of workspace threshold.","code":201,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"cB72dvEcGGP85ZTiQkICvg\",\"name\":\"block XSS\",\"enabled\":true,\"signal\":\"XSS\",\"action\":\"block\",\"interval\":60,\"limit\":5,\"duration\":60,\"dont_notify\":false,\"created_at\":\"2025-08-07T16:26:14-04:00\"}"}],"_postman_id":"05e097a9-7899-4af9-9f0e-e35869fc794b"},{"name":"Retrieve threshold","id":"1a70087c-a7b5-47d5-844c-b8572a020598","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/thresholds/{{threshold_id}}","description":"<p>Get a threshold for a workspace.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","thresholds","{{threshold_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"2ec01ad2-36c0-4aa9-bc03-868372b3d1f6","name":"200 Successful threshold request.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/thresholds/cB72dvEcGGP85ZTiQkICvg","description":"Get a threshold for a workspace.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Successful threshold request.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"cB72dvEcGGP85ZTiQkICvg\",\"name\":\"block XSS\",\"enabled\":true,\"signal\":\"XSS\",\"action\":\"block\",\"interval\":60,\"limit\":5,\"duration\":60,\"dont_notify\":false,\"created_at\":\"2025-08-07T16:26:14-04:00\"}"}],"_postman_id":"1a70087c-a7b5-47d5-844c-b8572a020598"},{"name":"Remove a threshold","id":"e6609b02-0295-4406-abef-0c373266a517","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/thresholds/{{threshold_id}}","description":"<p>Delete a threshold.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","thresholds","{{threshold_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"0337c253-c048-435d-97c9-dced26960476","name":"204 Deletion was successful.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/thresholds/cB72dvEcGGP85ZTiQkICvg","description":"Delete a threshold.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 Deletion was successful.","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"e6609b02-0295-4406-abef-0c373266a517"},{"name":"Edit threshold","id":"0506c42f-240b-4cfc-a42e-2252c78e43b8","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"log CMDEXE\",\"signal\":\"CMDEXE\",\"action\":\"log\"}"},"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/thresholds/{{threshold_id}}","description":"<p>Change attributes of a threshold in a workspace.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","thresholds","{{threshold_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"0d452439-e99a-48c1-99b6-4fc7afb1ed77","name":"200 Successful threshold update.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"log CMDEXE\",\"signal\":\"CMDEXE\",\"action\":\"log\"}"},"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/thresholds/cB72dvEcGGP85ZTiQkICvg","description":"Change attributes of a threshold in a workspace.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Successful threshold update.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"cB72dvEcGGP85ZTiQkICvg\",\"name\":\"log CMDEXE\",\"enabled\":true,\"signal\":\"CMDEXE\",\"action\":\"log\",\"interval\":60,\"limit\":5,\"duration\":60,\"dont_notify\":false,\"created_at\":\"2025-08-07T16:26:14-04:00\"}"}],"_postman_id":"0506c42f-240b-4cfc-a42e-2252c78e43b8"}],"id":"9515d77d-9770-457b-acb9-16f823a77b77","description":"<p>Manage workspace thresholds.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>action</td>\n<td>string</td>\n<td>Action to take when threshold is exceeded.</td>\n</tr>\n<tr>\n<td>dont_notify</td>\n<td>boolean</td>\n<td>Whether to silence notifications when action is taken.</td>\n</tr>\n<tr>\n<td>duration</td>\n<td>integer</td>\n<td>Duration the action is in place. Default duration is 86,400 seconds (1 day).</td>\n</tr>\n<tr>\n<td>enabled</td>\n<td>boolean</td>\n<td>Whether this threshold is active.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>Threshold ID.</td>\n</tr>\n<tr>\n<td>interval</td>\n<td>integer</td>\n<td>Threshold interval in seconds. Default interval is 3600 seconds (1 hour).</td>\n</tr>\n<tr>\n<td>limit</td>\n<td>integer</td>\n<td>Threshold limit. Default limit is 10.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>Threshold name.</td>\n</tr>\n<tr>\n<td>signal</td>\n<td>string</td>\n<td>The name of the signal this threshold is acting on.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"9515d77d-9770-457b-acb9-16f823a77b77"},{"name":"Time series","item":[{"name":"Retrieve timeseries metrics","id":"378005dd-8960-4f1a-9b61-bdfe5f624429","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/timeseries?end&granularity&metrics&start","description":"<p>Get timeseries metrics in a workspace.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","timeseries"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>The end of a date-time range, expressed in RFC 3339 format.</p>\n","type":"text/plain"},"key":"end"},{"description":{"content":"<p>Level of detail of the sample size in seconds.</p>\n","type":"text/plain"},"key":"granularity"},{"description":{"content":"<p>Comma-separated list of metrics to be included in the timeseries. Metrics can be XSS, SQLI, HTTP404, requests_total, requests_attack, requests_total_blocked, or any custom metric.</p>\n","type":"text/plain"},"key":"metrics"},{"description":{"content":"<p>The start of a date-time range, expressed in RFC 3339 format.</p>\n","type":"text/plain"},"key":"start"}],"variable":[]}},"response":[{"id":"86a1db63-9e27-4655-ab24-f27519ccb383","name":"200 Successful timeseries request.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/timeseries?end=2019-08-21T18%3A07%3A33Z&granularity=86400&metrics=requests_total%2Crequests_attack&start=2019-08-20T18%3A07%3A33Z?end&granularity&metrics&start","protocol":"https","host":["api","fastly","com"],"path":["ngwaf","v1","workspaces","SU1Z0isxPaozGVKXdv0eY","timeseries"],"query":[{"key":"end","description":"The end of a date-time range, expressed in RFC 3339 format."},{"key":"granularity","description":"Level of detail of the sample size in seconds."},{"key":"metrics","description":"Comma-separated list of metrics to be included in the timeseries. Metrics can be XSS, SQLI, HTTP404, requests_total, requests_attack, requests_total_blocked, or any custom metric."},{"key":"start","description":"The start of a date-time range, expressed in RFC 3339 format."}]},"description":"Get timeseries metrics in a workspace.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Successful timeseries request.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"meta\":{\"total\":100},\"data\":[{\"timestamp\":\"2025-05-12T20:55:07Z\",\"XSS\":5,\"SQLI\":0,\"HTTP404\":0}]}"}],"_postman_id":"378005dd-8960-4f1a-9b61-bdfe5f624429"},{"name":"List timeseries metrics","id":"626967f9-50c0-4524-bfd4-2df67c7b4aca","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/timeseries?dimensions&from&granularity&metrics&to","description":"<p>List timeseries metrics for Next-Gen WAF.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","timeseries"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Comma separated list of grouping dimensions to be included in the timeseries. Allowed values are workspaces and time.</p>\n","type":"text/plain"},"key":"dimensions"},{"description":{"content":"<p>The start of a date-time range, expressed in RFC 3339 format. This is an alias for start.</p>\n","type":"text/plain"},"key":"from"},{"description":{"content":"<p>Level of detail of the sample size in seconds.</p>\n","type":"text/plain"},"key":"granularity"},{"description":{"content":"<p>Comma-separated list of metrics to be included in the timeseries. Metrics can be XSS, SQLI, HTTP404, requests_total, requests_attack, requests_total_blocked, or any custom metric.</p>\n","type":"text/plain"},"key":"metrics"},{"description":{"content":"<p>The end of a date-time range, expressed in RFC 3339 format. This is an alias for end.</p>\n","type":"text/plain"},"key":"to"}],"variable":[]}},"response":[{"id":"8121b92d-a265-490c-b149-fc99fa2088b6","name":"200 Successful timeseries request.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/ngwaf/v1/timeseries?dimensions=workspaces&from=2019-08-20T18%3A07%3A33Z&granularity=86400&metrics=requests_total%2Crequests_attack&to=2019-08-21T18%3A07%3A33Z?dimensions&from&granularity&metrics&to","protocol":"https","host":["api","fastly","com"],"path":["ngwaf","v1","timeseries"],"query":[{"key":"dimensions","description":"Comma separated list of grouping dimensions to be included in the timeseries. Allowed values are workspaces and time."},{"key":"from","description":"The start of a date-time range, expressed in RFC 3339 format. This is an alias for start."},{"key":"granularity","description":"Level of detail of the sample size in seconds."},{"key":"metrics","description":"Comma-separated list of metrics to be included in the timeseries. Metrics can be XSS, SQLI, HTTP404, requests_total, requests_attack, requests_total_blocked, or any custom metric."},{"key":"to","description":"The end of a date-time range, expressed in RFC 3339 format. This is an alias for end."}]},"description":"List timeseries metrics for Next-Gen WAF.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Successful timeseries request.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"dimensions\":{\"time\":\"2025-05-06T17:00:00-07:00\",\"workspace\":\"Workspace 1\"},\"values\":[{\"HTTP404\":0},{\"requests_total\":21241}]},{\"dimensions\":{\"time\":\"2025-05-07T17:00:00-07:00\",\"workspace\":\"Workspace 2\"},\"values\":[{\"HTTP404\":0},{\"requests_total\":21006}]},{\"dimensions\":{\"time\":\"2025-05-08T17:00:00-07:00\",\"workspace\":\"Workspace 3\"},\"values\":[{\"HTTP404\":0},{\"requests_total\":21342}]}],\"meta\":{\"total\":3}}"}],"_postman_id":"626967f9-50c0-4524-bfd4-2df67c7b4aca"},{"name":"Retrieve agent timeseries metrics","id":"5b69877f-412a-43d3-bc3c-768e7026a31b","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/timeseries/agents/{{agent_id}}?end&granularity&metrics&start","description":"<p>Get timeseries metrics for an agent in a workspace. Agent metrics include request counts, decision latency percentiles, and host resource usage.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","timeseries","agents","{{agent_id}}"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>The end of a date-time range, expressed in RFC 3339 format.</p>\n","type":"text/plain"},"key":"end"},{"description":{"content":"<p>Level of detail of the sample size in seconds.</p>\n","type":"text/plain"},"key":"granularity"},{"description":{"content":"<p>Comma-separated list of agent metrics to include in the timeseries. Metrics can be requests_total, agent_decision_time_50th, agent_decision_time_95th, agent_decision_time_99th, host_cpu, or host_agent_cpu.</p>\n","type":"text/plain"},"key":"metrics"},{"description":{"content":"<p>The start of a date-time range, expressed in RFC 3339 format.</p>\n","type":"text/plain"},"key":"start"}],"variable":[]}},"response":[{"id":"00293d6b-f4b7-40c1-a03b-28b429ee34cb","name":"200 Successful agent timeseries request.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/timeseries/agents/6EbvL2deHPgDm7ap5mS6D9?end=2019-08-21T18%3A07%3A33Z&granularity=60&metrics=requests_total%2Chost_cpu&start=2019-08-20T18%3A07%3A33Z?end&granularity&metrics&start","protocol":"https","host":["api","fastly","com"],"path":["ngwaf","v1","workspaces","SU1Z0isxPaozGVKXdv0eY","timeseries","agents","6EbvL2deHPgDm7ap5mS6D9"],"query":[{"key":"end","description":"The end of a date-time range, expressed in RFC 3339 format."},{"key":"granularity","description":"Level of detail of the sample size in seconds."},{"key":"metrics","description":"Comma-separated list of agent metrics to include in the timeseries. Metrics can be requests_total, agent_decision_time_50th, agent_decision_time_95th, agent_decision_time_99th, host_cpu, or host_agent_cpu."},{"key":"start","description":"The start of a date-time range, expressed in RFC 3339 format."}]},"description":"Get timeseries metrics for an agent in a workspace. Agent metrics include request counts, decision latency percentiles, and host resource usage.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Successful agent timeseries request.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"meta\":{\"total\":3},\"data\":[{\"timestamp\":\"2025-05-12T20:55:07Z\",\"requests_total\":1500,\"host_cpu\":45.2,\"host_agent_cpu\":12.1},{\"timestamp\":\"2025-05-12T20:56:07Z\",\"requests_total\":1480,\"host_cpu\":43.8,\"host_agent_cpu\":11.9},{\"timestamp\":\"2025-05-12T20:57:07Z\",\"requests_total\":1520,\"host_cpu\":46.1,\"host_agent_cpu\":12.5}]}"}],"_postman_id":"5b69877f-412a-43d3-bc3c-768e7026a31b"}],"id":"1ca671b5-7c8c-4f89-ac2d-ca657dfbc435","description":"<p>Time series returns data for the number of signals (e.g., XSS, SQLi, 404s) observed per minute.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>timestamp</td>\n<td>string</td>\n<td>Timestamp for the data point in RFC 3339 format.</td>\n</tr>\n<tr>\n<td>dimensions</td>\n<td>object</td>\n<td>Dimension values for this data point.</td>\n</tr>\n<tr>\n<td>values</td>\n<td>array</td>\n<td>Metric values for this data point.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"1ca671b5-7c8c-4f89-ac2d-ca657dfbc435"},{"name":"Virtual patches","item":[{"name":"List virtual patches","id":"26348c8e-e17e-447c-84bc-b1652e3161b6","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/virtual-patches?limit&page","description":"<p>List virtual patches for a workspace.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","virtual-patches"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Limit how many results are returned.</p>\n","type":"text/plain"},"key":"limit"},{"description":{"content":"<p>Page number of the collection to request.</p>\n","type":"text/plain"},"key":"page"}],"variable":[]}},"response":[{"id":"f4befad4-2493-4e2d-8222-b500ad969cf3","name":"200 Successful response of searching for virtual patches in a workspace.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/virtual-patches?limit=100&page=1?limit&page","protocol":"https","host":["api","fastly","com"],"path":["ngwaf","v1","workspaces","SU1Z0isxPaozGVKXdv0eY","virtual-patches"],"query":[{"key":"limit","description":"Limit how many results are returned."},{"key":"page","description":"Page number of the collection to request."}]},"description":"List virtual patches for a workspace.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Successful response of searching for virtual patches in a workspace.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"meta\":{\"limit\":1,\"total\":100},\"data\":[{\"id\":\"CVE-2017-5638\",\"description\":\"Apache Struts 2.3.5 - 2.3.31 and 2.5 - 2.5.10\",\"enabled\":true,\"mode\":\"block\"}]}"}],"_postman_id":"26348c8e-e17e-447c-84bc-b1652e3161b6"},{"name":"Retrieve virtual patch","id":"f98716cc-2b33-4707-ab46-0a121043c699","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/virtual-patches/{{virtual_patch_id}}","description":"<p>Get a virtual patch from a workspace.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","virtual-patches","{{virtual_patch_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"411b3190-3584-4eb5-9447-586f50935cc8","name":"200 Successful virtual patch request.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/virtual-patches/CVE-2017-5638","description":"Get a virtual patch from a workspace.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Successful virtual patch request.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"CVE-2017-5638\",\"description\":\"Apache Struts 2.3.5 - 2.3.31 and 2.5 - 2.5.10\",\"enabled\":true,\"mode\":\"block\"}"}],"_postman_id":"f98716cc-2b33-4707-ab46-0a121043c699"},{"name":"Edit virtual patch","id":"51e6f8d1-e15b-4769-b405-ddbe831a572a","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"enabled\":true,\"mode\":\"block\"}"},"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/virtual-patches/{{virtual_patch_id}}","description":"<p>Change attributes of a virtual patch in a workspace.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","virtual-patches","{{virtual_patch_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"1017f2aa-491a-4853-a7fa-24f6fae8666f","name":"200 Successful virtual patch update.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"enabled\":true,\"mode\":\"block\"}"},"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/virtual-patches/CVE-2017-5638","description":"Change attributes of a virtual patch in a workspace.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Successful virtual patch update.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"CVE-2017-5638\",\"description\":\"Apache Struts 2.3.5 - 2.3.31 and 2.5 - 2.5.10\",\"enabled\":true,\"mode\":\"block\"}"}],"_postman_id":"51e6f8d1-e15b-4769-b405-ddbe831a572a"}],"id":"032a9cc5-2ee4-4f19-9201-607ab64eaa6b","description":"<p>Virtual patching rules block or log requests matching specific vulnerabilities.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>description</td>\n<td>string</td>\n<td>Description of the virtual patch.</td>\n</tr>\n<tr>\n<td>enabled</td>\n<td>boolean</td>\n<td>Control for enabling and disabling a virtual patch.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>The ID of the virtual patch.</td>\n</tr>\n<tr>\n<td>mode</td>\n<td>string</td>\n<td>Action to take when a signal for virtual patch is detected.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"032a9cc5-2ee4-4f19-9201-607ab64eaa6b"},{"name":"Workspace alerts","item":[{"name":"List workspace alerts","id":"aec3de37-085e-4386-9d73-960b25c33e4f","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/alerts?limit","description":"<p>List all alerts of a given workspace.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","alerts"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Limit how many results are returned.</p>\n","type":"text/plain"},"key":"limit"}],"variable":[]}},"response":[{"id":"83a153ef-13b1-4b95-a52c-27338bb6d738","name":"200 List of workspace alerts.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/alerts?limit=100?limit","protocol":"https","host":["api","fastly","com"],"path":["ngwaf","v1","workspaces","SU1Z0isxPaozGVKXdv0eY","alerts"],"query":[{"key":"limit","description":"Limit how many results are returned."}]},"description":"List all alerts of a given workspace.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 List of workspace alerts.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"meta\":{\"limit\":1,\"total\":100},\"data\":[{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"type\":\"pagerduty\",\"config\":{\"key\":\"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\"},\"events\":[\"flag\"],\"description\":\"Test workspace alert's description\",\"created_by\":\"engineer@example.com\",\"created_at\":\"2025-05-12T20:55:07Z\",\"last_status_code\":200}]}"}],"_postman_id":"aec3de37-085e-4386-9d73-960b25c33e4f"},{"name":"Create a workspace alert","id":"9879d16c-6775-435c-9698-9b81f3292a18","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"type\":\"pagerduty\",\"config\":{\"key\":\"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\"},\"events\":[\"flag\"],\"description\":\"Test workspace alert's description\"}"},"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/alerts","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/ngwaf/workspace-alerts/#ngwafCreateWorkspaceAlert\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","alerts"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"49dbffae-3f64-445e-800a-0b81958fa966","name":"201 Successful workspace alert creation.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"type\":\"pagerduty\",\"config\":{\"key\":\"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\"},\"events\":[\"flag\"],\"description\":\"Test workspace alert's description\"}"},"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/alerts","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/ngwaf/workspace-alerts/#ngwafCreateWorkspaceAlert)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"201 Successful workspace alert creation.","code":201,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"type\":\"pagerduty\",\"config\":{\"key\":\"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\"},\"events\":[\"flag\"],\"description\":\"Test workspace alert's description\",\"created_by\":\"engineer@example.com\",\"created_at\":\"2025-05-12T20:55:07Z\",\"last_status_code\":200}"}],"_postman_id":"9879d16c-6775-435c-9698-9b81f3292a18"},{"name":"Get a workspace alert","id":"415c5813-c2f7-4038-b97f-7b1638de3bfb","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/alerts/{{alert_id}}","description":"<p>Retrieve a workspace alert.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","alerts","{{alert_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"3c104691-e7d1-48b6-b90e-016880482fe8","name":"200 Requested workspace alert.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/alerts/SU1Z0isxPaozGVKXdv0eY","description":"Retrieve a workspace alert.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Requested workspace alert.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"type\":\"pagerduty\",\"config\":{\"key\":\"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\"},\"events\":[\"flag\"],\"description\":\"Test workspace alert's description\",\"created_by\":\"engineer@example.com\",\"created_at\":\"2025-05-12T20:55:07Z\",\"last_status_code\":200}"}],"_postman_id":"415c5813-c2f7-4038-b97f-7b1638de3bfb"},{"name":"Remove a workspace alert","id":"2d6759bd-cd70-4dc5-afb4-c98dfe0c0b7a","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/alerts/{{alert_id}}","description":"<p>Delete a workspace alert.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","alerts","{{alert_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"77fb9043-1b57-44ed-8665-05ef4b9b1554","name":"204 Deletion was successful.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/alerts/SU1Z0isxPaozGVKXdv0eY","description":"Delete a workspace alert.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 Deletion was successful.","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"2d6759bd-cd70-4dc5-afb4-c98dfe0c0b7a"},{"name":"Edit a workspace alert","id":"a3fb3c79-187e-465e-a14c-23cd501385da","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"type\":\"pagerduty\",\"config\":{\"key\":\"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\"}}"},"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/alerts/{{alert_id}}","description":"<p>Make changes to a workspace alert.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","alerts","{{alert_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"96db6e48-caa5-482e-8dba-e96cdc3ff966","name":"200 Edit was successful.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"type\":\"pagerduty\",\"config\":{\"key\":\"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\"}}"},"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/alerts/SU1Z0isxPaozGVKXdv0eY","description":"Make changes to a workspace alert.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Edit was successful.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"type\":\"pagerduty\",\"config\":{\"key\":\"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\"},\"events\":[\"flag\"],\"description\":\"Test workspace alert's description\",\"created_by\":\"engineer@example.com\",\"created_at\":\"2025-05-12T20:55:07Z\",\"last_status_code\":200}"}],"_postman_id":"a3fb3c79-187e-465e-a14c-23cd501385da"},{"name":"Get workspace alert signing key","id":"573ac5c7-d554-4a27-8676-84eb8a9cdb14","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/alerts/{{alert_id}}/signing-key","description":"<p>Retrieves details of a workspace alert signing key. Only allowed on webhook alert.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","alerts","{{alert_id}}","signing-key"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"507815a8-42dd-4504-a357-3b71b10eada3","name":"200 Successful retrieval of workspace alert signing key.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/alerts/SU1Z0isxPaozGVKXdv0eY/signing-key","description":"Retrieves details of a workspace alert signing key. Only allowed on webhook alert.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Successful retrieval of workspace alert signing key.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"signing-key\":\"8a9f54e9-17a2-45df-9541-6828a13a3fdd\"}"}],"_postman_id":"573ac5c7-d554-4a27-8676-84eb8a9cdb14"},{"name":"Rotate workspace alert signing key","id":"7f73bac4-99fc-4eaa-8567-4102daa831aa","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/alerts/{{alert_id}}/signing-key","description":"<p>Rotate workspace alert signing key. Only allowed on webhook alert.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","alerts","{{alert_id}}","signing-key"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"097b9b08-3b63-4da0-8df7-5ed39249f050","name":"200 Successful rotation of workspace alert signing key.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/alerts/SU1Z0isxPaozGVKXdv0eY/signing-key","description":"Rotate workspace alert signing key. Only allowed on webhook alert.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Successful rotation of workspace alert signing key.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"signing-key\":\"8a9f54e9-17a2-45df-9541-6828a13a3fdd\"}"}],"_postman_id":"7f73bac4-99fc-4eaa-8567-4102daa831aa"},{"name":"Test workspace alert","id":"bf07530d-0f72-42e3-b973-1ac39e0e5d56","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/alerts/{{alert_id}}/test","description":"<p>Tests a workspace alert by sending a test notification to verify the alert is configured correctly and reachable.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","alerts","{{alert_id}}","test"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"faa6c58d-e8a3-4e73-8e18-36af05e02720","name":"202 Alert test request accepted.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/alerts/SU1Z0isxPaozGVKXdv0eY/test","description":"Tests a workspace alert by sending a test notification to verify the alert is configured correctly and reachable.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"202 Alert test request accepted.","code":202,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"bf07530d-0f72-42e3-b973-1ac39e0e5d56"}],"id":"c7796702-ce1a-4ce1-b677-6c2f8b242bb3","description":"<p>Workspace alerts endpoints provide functionality for adding, editing, and deleting alerts.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>config</td>\n<td>object</td>\n<td>Configuration specific to the workspace integration type.</td>\n</tr>\n<tr>\n<td>description</td>\n<td>string</td>\n<td>An optional description for the alert.</td>\n</tr>\n<tr>\n<td>events</td>\n<td>array</td>\n<td>List of event types that trigger this webhook.</td>\n</tr>\n<tr>\n<td>type</td>\n<td>string</td>\n<td>Type of the workspace integration.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-1\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>key</td>\n<td>string</td>\n<td>Datadog integration key.</td>\n</tr>\n<tr>\n<td>site</td>\n<td>string</td>\n<td>Datadog site.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-2\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>host</td>\n<td>string</td>\n<td>Host name of the Jira instance.</td>\n</tr>\n<tr>\n<td>issue_type</td>\n<td>string</td>\n<td>The Jira issue type associated with the ticket.</td>\n</tr>\n<tr>\n<td>key</td>\n<td>string</td>\n<td>Jira API key (secret field).</td>\n</tr>\n<tr>\n<td>project</td>\n<td>string</td>\n<td>Specifies the Jira project where the issue will be created.</td>\n</tr>\n<tr>\n<td>username</td>\n<td>string</td>\n<td>Jira username of the user who created the ticket.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-3\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>address</td>\n<td>string</td>\n<td>An email address.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-4\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>webhook</td>\n<td>string</td>\n<td>Microsoft Teams webhook.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-5\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>key</td>\n<td>string</td>\n<td>Opsgenie integration key.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-6\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>key</td>\n<td>string</td>\n<td>PagerDuty integration key.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-7\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>webhook</td>\n<td>string</td>\n<td>Slack webhook.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-8\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>webhook</td>\n<td>string</td>\n<td>Webhook URL.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-9\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>flag</td>\n<td>string</td>\n<td>Event that occurs when an IP address is detected as a potential threat.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"c7796702-ce1a-4ce1-b677-6c2f8b242bb3"},{"name":"Workspaces","item":[{"name":"List workspaces","id":"f3c9256a-9cd8-4fce-a1cb-6c89c0a349ac","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces?limit&mode&page&workspace_id","description":"<p>List all workspaces.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Limit how many results are returned.</p>\n","type":"text/plain"},"key":"limit"},{"description":{"content":"<p>Filter results based on mode.</p>\n","type":"text/plain"},"key":"mode"},{"description":{"content":"<p>Page number of the collection to request.</p>\n","type":"text/plain"},"key":"page"},{"description":{"content":"<p>Filter results based on workspace ID.</p>\n","type":"text/plain"},"key":"workspace_id"}],"variable":[]}},"response":[{"id":"54290971-9950-4441-ae7c-658e7a43c78a","name":"200 List of workspaces.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/ngwaf/v1/workspaces?limit=100&page=1&workspace_id=SU1Z0isxPaozGVKXdv0eY?limit&mode&page&workspace_id","protocol":"https","host":["api","fastly","com"],"path":["ngwaf","v1","workspaces"],"query":[{"key":"limit","description":"Limit how many results are returned."},{"key":"mode","description":"Filter results based on mode."},{"key":"page","description":"Page number of the collection to request."},{"key":"workspace_id","description":"Filter results based on workspace ID."}]},"description":"List all workspaces.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 List of workspaces.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"meta\":{\"limit\":1,\"total\":100},\"data\":[{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"name\":\"Test workspace display name\",\"description\":\"Test workspaces's description\",\"mode\":\"off\",\"ip_anonymization\":\"hashed\",\"attack_signal_thresholds\":{\"one_minute\":1,\"ten_minutes\":1,\"one_hour\":1,\"immediate\":true},\"default_blocking_response_code\":301,\"default_redirect_url\":\"https://example.com/redirect\",\"client_ip_headers\":[\"X-Forwared-For\"],\"created_at\":\"2025-05-12T20:55:07Z\",\"updated_at\":\"2025-05-12T20:55:07Z\"}]}"}],"_postman_id":"f3c9256a-9cd8-4fce-a1cb-6c89c0a349ac"},{"name":"Create a workspace","id":"7f621116-7e51-4ebd-bf30-c2a3e69b3162","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"Workspace test name\",\"description\":\"Workspace test description\",\"mode\":\"off\",\"ip_anonymization\":\"hashed\",\"attack_signal_thresholds\":{\"one_minute\":1,\"ten_minutes\":1,\"one_hour\":1,\"immediate\":true},\"default_blocking_response_code\":301,\"default_redirect_url\":\"https://example.com/redirect\",\"client_ip_headers\":[\"X-Forwarded-For\"]}"},"url":"https://api.fastly.com/ngwaf/v1/workspaces","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/ngwaf/workspaces/#ngwafCreateWorkspace\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"9b90344c-8f3d-48ae-998f-f6dfc9cc3fe7","name":"201 Successful workspace creation.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"Workspace test name\",\"description\":\"Workspace test description\",\"mode\":\"off\",\"ip_anonymization\":\"hashed\",\"attack_signal_thresholds\":{\"one_minute\":1,\"ten_minutes\":1,\"one_hour\":1,\"immediate\":true},\"default_blocking_response_code\":301,\"default_redirect_url\":\"https://example.com/redirect\",\"client_ip_headers\":[\"X-Forwarded-For\"]}"},"url":"https://api.fastly.com/ngwaf/v1/workspaces","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/ngwaf/workspaces/#ngwafCreateWorkspace)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"201 Successful workspace creation.","code":201,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"name\":\"Workspace test name\",\"description\":\"Workspace test description\",\"mode\":\"off\",\"ip_anonymization\":\"hashed\",\"attack_signal_thresholds\":{\"one_minute\":1,\"ten_minutes\":1,\"one_hour\":1,\"immediate\":true},\"default_blocking_response_code\":301,\"default_redirect_url\":\"https://example.com/redirect\",\"client_ip_headers\":[\"X-Forwarded-For\"],\"created_at\":\"2025-05-12T20:55:07Z\",\"updated_at\":\"2025-05-12T20:55:07Z\"}"}],"_postman_id":"7f621116-7e51-4ebd-bf30-c2a3e69b3162"},{"name":"Get a workspace","id":"5f9dc740-d106-4a2a-b21d-f1879194760a","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}","description":"<p>Retrieve a workspace.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"75872c4b-719f-42e0-b9fd-b4e0709c42b2","name":"200 Requested workspace.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY","description":"Retrieve a workspace.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Requested workspace.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"name\":\"Test workspace display name\",\"description\":\"Test workspaces's description\",\"mode\":\"off\",\"ip_anonymization\":\"hashed\",\"attack_signal_thresholds\":{\"one_minute\":1,\"ten_minutes\":1,\"one_hour\":1,\"immediate\":true},\"default_blocking_response_code\":301,\"default_redirect_url\":\"https://example.com/redirect\",\"client_ip_headers\":[\"X-Forwared-For\"],\"created_at\":\"2025-05-12T20:55:07Z\",\"updated_at\":\"2025-05-12T20:55:07Z\"}"}],"_postman_id":"5f9dc740-d106-4a2a-b21d-f1879194760a"},{"name":"Remove a workspace","id":"e6abd26c-a505-4a14-957e-a98fc08e3075","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}","description":"<p>Delete a workspace.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"64fb57f0-a4ab-4ef9-81f8-baa1069a359b","name":"204 Deletion was successful.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY","description":"Delete a workspace.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 Deletion was successful.","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"e6abd26c-a505-4a14-957e-a98fc08e3075"},{"name":"Edit a workspace","id":"ef0297a3-e833-422a-a7a3-e6a17b731bd6","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"Workspace test name\",\"description\":\"Workspace test description\",\"mode\":\"off\",\"ip_anonymization\":\"hashed\",\"attack_signal_thresholds\":{\"one_minute\":1,\"ten_minutes\":1,\"one_hour\":1,\"immediate\":true},\"default_blocking_response_code\":301,\"default_redirect_url\":\"https://example.com/redirect\",\"client_ip_headers\":[\"X-Forwarded-For\"]}"},"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}","description":"<p>Make changes to a workspace.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"9528e7ff-93a0-4d55-b6f5-b339713e9877","name":"200 Edit was successful.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"Workspace test name\",\"description\":\"Workspace test description\",\"mode\":\"off\",\"ip_anonymization\":\"hashed\",\"attack_signal_thresholds\":{\"one_minute\":1,\"ten_minutes\":1,\"one_hour\":1,\"immediate\":true},\"default_blocking_response_code\":301,\"default_redirect_url\":\"https://example.com/redirect\",\"client_ip_headers\":[\"X-Forwarded-For\"]}"},"url":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY","description":"Make changes to a workspace.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Edit was successful.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"name\":\"Workspace test name\",\"description\":\"Workspace test description\",\"mode\":\"off\",\"ip_anonymization\":\"hashed\",\"attack_signal_thresholds\":{\"one_minute\":1,\"ten_minutes\":1,\"one_hour\":1,\"immediate\":true},\"default_blocking_response_code\":301,\"default_redirect_url\":\"https://example.com/redirect\",\"client_ip_headers\":[\"X-Forwarded-For\"],\"created_at\":\"2025-05-12T20:55:07Z\",\"updated_at\":\"2025-05-12T20:55:07Z\"}"}],"_postman_id":"ef0297a3-e833-422a-a7a3-e6a17b731bd6"},{"name":"Get top attacks for a workspace","id":"973f37e1-6af2-4300-becb-f385f3530721","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ngwaf/v1/workspaces/{{workspace_id}}/top-attacks?field&from&limit&to","description":"<p>Retrieve data on top attacks for a workspace within a specified time range. This endpoint returns an aggregation of URLs that have been attacked, sorted by request count. This data can be used in custom dashboards with the top-attacks widget.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ngwaf","v1","workspaces","{{workspace_id}}","top-attacks"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>The field to aggregate top attacks by (e.g., server_name_and_path for URLs, remote_ip for IPs).</p>\n","type":"text/plain"},"key":"field"},{"description":{"content":"<p>Represents the start of a time range and is the older of the two dates in RFC 3339 format.</p>\n","type":"text/plain"},"key":"from"},{"description":{"content":"<p>Maximum number of top attacks to return.</p>\n","type":"text/plain"},"key":"limit"},{"description":{"content":"<p>Represents the end of a time range and is the newer of the two dates in RFC 3339 format.</p>\n","type":"text/plain"},"key":"to"}],"variable":[]}},"response":[{"id":"a20496d0-1fdf-4212-a1c2-0e12f4683bc0","name":"200 Top attacks retrieved successfully.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/ngwaf/v1/workspaces/SU1Z0isxPaozGVKXdv0eY/top-attacks?field=server_name_and_path&from=2023-01-01T00%3A00%3A00Z&limit=100&to=2023-01-31T23%3A59%3A59Z?field&from&limit&to","protocol":"https","host":["api","fastly","com"],"path":["ngwaf","v1","workspaces","SU1Z0isxPaozGVKXdv0eY","top-attacks"],"query":[{"key":"field","description":"The field to aggregate top attacks by (e.g., server_name_and_path for URLs, remote_ip for IPs)."},{"key":"from","description":"Represents the start of a time range and is the older of the two dates in RFC 3339 format."},{"key":"limit","description":"Maximum number of top attacks to return."},{"key":"to","description":"Represents the end of a time range and is the newer of the two dates in RFC 3339 format."}]},"description":"Retrieve data on top attacks for a workspace within a specified time range. This endpoint returns an aggregation of URLs that have been attacked, sorted by request count. This data can be used in custom dashboards with the top-attacks widget.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Top attacks retrieved successfully.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"value\":\"US\",\"display_name\":\"United States\",\"count\":4},{\"value\":\"CN\",\"display_name\":\"China\",\"count\":2}],\"meta\":{\"limit\":100}}"}],"_postman_id":"973f37e1-6af2-4300-becb-f385f3530721"}],"id":"25c1082b-481d-4d2e-bfaf-4bc069de4c5b","description":"<p>Workspaces allows you to add, edit, and delete workspaces in your account.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>attack_signal_thresholds</td>\n<td>object</td>\n<td>Attack threshold parameters for system site alerts. Each threshold value is the number of attack signals per IP address that must be detected during the interval before the related IP address is flagged.</td>\n</tr>\n<tr>\n<td>client_ip_headers</td>\n<td>array</td>\n<td>Specifies the request headers containing the client IP address.</td>\n</tr>\n<tr>\n<td>default_blocking_response_code</td>\n<td>integer</td>\n<td>The status code returned when a request is blocked. This configuration is applied at the workspace but can be overwritten in rules. Accepted values are [301, 302, 400..599].</td>\n</tr>\n<tr>\n<td>default_redirect_url</td>\n<td>string</td>\n<td>The redirect URL used if default_blocking_response_code is 301 or 302.</td>\n</tr>\n<tr>\n<td>description</td>\n<td>string</td>\n<td>User-submitted description of a workspace.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>A base62-encoded representation of a UUID used to uniquely identify a workspace.</td>\n</tr>\n<tr>\n<td>ip_anonymization</td>\n<td>string</td>\n<td>Agents will anonymize IP addresses according to the option selected.</td>\n</tr>\n<tr>\n<td>mode</td>\n<td>string</td>\n<td>User-configured mode of a workspace.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>User-submitted display name of a workspace.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"25c1082b-481d-4d2e-bfaf-4bc069de4c5b"}],"id":"2207a2b3-bbbb-4128-a017-6a8c63921ab5","_postman_id":"2207a2b3-bbbb-4128-a017-6a8c63921ab5","description":""},{"name":"Alerts","item":[{"name":"Definitions","item":[{"name":"List definitions","id":"3ad025b2-fb9e-409c-abc5-a138f858a51d","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/alerts/definitions?cursor&integration_id&limit&name&service_id&sort","description":"<p>List all definitions for a particular customer. Definitions can be filtered by name, service_id, and integration_id.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["alerts","definitions"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Cursor value from the next_cursor field of a previous response, used to retrieve the next page. To request the first page, this should be empty.</p>\n","type":"text/plain"},"key":"cursor"},{"description":{"content":"<p>Filter definitions by integration.</p>\n","type":"text/plain"},"key":"integration_id"},{"description":{"content":"<p>Limit how many results are returned.</p>\n","type":"text/plain"},"key":"limit"},{"description":{"content":"<p>Filter definitions by name.</p>\n","type":"text/plain"},"key":"name"},{"description":{"content":"<p>Filter results based on a service_id.</p>\n","type":"text/plain"},"key":"service_id"},{"description":{"content":"<p>Sort the items by field provided ascending or descending.</p>\n","type":"text/plain"},"key":"sort"}],"variable":[]}},"response":[{"id":"23b08e03-2682-4321-97f2-088a9d742d4e","name":"200 Listing all definitions","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/alerts/definitions?cursor&integration_id&limit&name&service_id&sort","protocol":"https","host":["api","fastly","com"],"path":["alerts","definitions"],"query":[{"key":"cursor","description":"Cursor value from the next_cursor field of a previous response, used to retrieve the next page. To request the first page, this should be empty."},{"key":"integration_id","description":"Filter definitions by integration."},{"key":"limit","description":"Limit how many results are returned."},{"key":"name","description":"Filter definitions by name."},{"key":"service_id","description":"Filter results based on a service_id."},{"key":"sort","description":"Sort the items by field provided ascending or descending."}]},"description":"List all definitions for a particular customer. Definitions can be filtered by name, service_id, and integration_id.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 Listing all definitions","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"id\":\"x4xCwxxJxGCx123Rx5xTx\",\"object\":\"definition\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"name\":\"New alert on origin\",\"description\":\"A description of your alert\",\"dimensions\":{\"origins\":[\"example-origin.com\"]},\"metric\":\"all_status_5xx\",\"source\":\"origins\",\"evaluation_strategy\":{\"type\":\"above_threshold\",\"period\":\"5m\",\"threshold\":10},\"integration_ids\":[\"12pkXDutPjb9DI8JNYNm5q\"],\"created_at\":\"2022-09-14T19:06:27Z\",\"updated_at\":\"2022-09-14T19:06:27Z\"},{\"id\":\"x4xCwxxJxGCx123Rx5xTx\",\"object\":\"definition\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"name\":\"New alert on domain\",\"description\":\"A description of your alert\",\"dimensions\":{\"domains\":[\"example-domain.com\"]},\"metric\":\"status_5xx\",\"source\":\"domains\",\"evaluation_strategy\":{\"type\":\"above_threshold\",\"period\":\"5m\",\"threshold\":10},\"integration_ids\":[\"12pkXDutPjb9DI8JNYNm5q\"],\"created_at\":\"2022-09-14T19:06:27Z\",\"updated_at\":\"2022-09-14T19:06:27Z\"},{\"id\":\"x4xCwxxJxGCx123Rx5xTx\",\"object\":\"definition\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"name\":\"New alert on stats\",\"description\":\"A description of your alert\",\"dimensions\":{},\"metric\":\"status_5xx\",\"source\":\"stats\",\"evaluation_strategy\":{\"type\":\"above_threshold\",\"period\":\"5m\",\"threshold\":10},\"integration_ids\":[\"12pkXDutPjb9DI8JNYNm5q\"],\"created_at\":\"2022-09-14T19:06:27Z\",\"updated_at\":\"2022-09-14T19:06:27Z\"}],\"meta\":{\"next_cursor\":\"\",\"limit\":100,\"sort\":\"-created_at\",\"total\":3}}"}],"_postman_id":"3ad025b2-fb9e-409c-abc5-a138f858a51d"},{"name":"Create definition","id":"98cbb8ff-0556-41c7-ac01-57b946da97dc","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"name\":\"New alert on origin\",\"description\":\"A description of your alert\",\"dimensions\":{\"origins\":[\"example-origin.com\"]},\"metric\":\"all_status_5xx\",\"source\":\"origins\",\"evaluation_strategy\":{\"type\":\"above_threshold\",\"period\":\"5m\",\"threshold\":10},\"integration_ids\":[\"12pkXDutPjb9DI8JNYNm5q\"]}"},"url":"https://api.fastly.com/alerts/definitions","description":"<p>Create a definition for a particular customer based on metrics.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["alerts","definitions"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"5ea3cbdf-1cd8-41d2-885b-ffbfabdedb94","name":"201 Requested definition","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"name\":\"New alert on origin\",\"description\":\"A description of your alert\",\"dimensions\":{\"origins\":[\"example-origin.com\"]},\"metric\":\"all_status_5xx\",\"source\":\"origins\",\"evaluation_strategy\":{\"type\":\"above_threshold\",\"period\":\"5m\",\"threshold\":10},\"integration_ids\":[\"12pkXDutPjb9DI8JNYNm5q\"]}"},"url":"https://api.fastly.com/alerts/definitions","description":"Create a definition for a particular customer based on metrics.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"201 Requested definition","code":201,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"x4xCwxxJxGCx123Rx5xTx\",\"object\":\"definition\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"name\":\"New alert on origin\",\"description\":\"A description of your alert\",\"dimensions\":{\"origins\":[\"example-origin.com\"]},\"metric\":\"all_status_5xx\",\"source\":\"origins\",\"evaluation_strategy\":{\"type\":\"above_threshold\",\"period\":\"5m\",\"threshold\":10},\"integration_ids\":[\"12pkXDutPjb9DI8JNYNm5q\"],\"created_at\":\"2022-09-14T19:06:27Z\",\"updated_at\":\"2022-09-14T19:06:27Z\"}"}],"_postman_id":"98cbb8ff-0556-41c7-ac01-57b946da97dc"},{"name":"Read definition","id":"f43b73d1-e567-45dd-8ca5-45a7a1e581b2","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/alerts/definitions/{{definition_id}}","description":"<p>Retrieve an existing definition by using its ID.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["alerts","definitions","{{definition_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"771077fc-580d-4e4e-8397-cd4c29b9d6d0","name":"200 Requested definition","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/alerts/definitions/{{definition_id}}","description":"Retrieve an existing definition by using its ID.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 Requested definition","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"x4xCwxxJxGCx123Rx5xTx\",\"object\":\"definition\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"name\":\"New alert on origin\",\"description\":\"A description of your alert\",\"dimensions\":{\"origins\":[\"example-origin.com\"]},\"metric\":\"all_status_5xx\",\"source\":\"origins\",\"evaluation_strategy\":{\"type\":\"above_threshold\",\"period\":\"5m\",\"threshold\":10},\"integration_ids\":[\"12pkXDutPjb9DI8JNYNm5q\"],\"created_at\":\"2022-09-14T19:06:27Z\",\"updated_at\":\"2022-09-14T19:06:27Z\"}"}],"_postman_id":"f43b73d1-e567-45dd-8ca5-45a7a1e581b2"},{"name":"Update definition","id":"e3a86924-db2b-4c10-9c85-44b23a64dfbf","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"New alert on origin\",\"description\":\"A description of your alert\",\"dimensions\":{\"origins\":[\"example-origin.com\"]},\"metric\":\"all_status_5xx\",\"source\":\"origins\",\"evaluation_strategy\":{\"type\":\"above_threshold\",\"period\":\"5m\",\"threshold\":10},\"integration_ids\":[\"12pkXDutPjb9DI8JNYNm5q\"]}"},"url":"https://api.fastly.com/alerts/definitions/{{definition_id}}","description":"<p>Update a definition with a new configuration.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["alerts","definitions","{{definition_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"b0b75a10-699a-40e2-8ab2-bba87c36d9db","name":"204 Update was successful","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"New alert on origin\",\"description\":\"A description of your alert\",\"dimensions\":{\"origins\":[\"example-origin.com\"]},\"metric\":\"all_status_5xx\",\"source\":\"origins\",\"evaluation_strategy\":{\"type\":\"above_threshold\",\"period\":\"5m\",\"threshold\":10},\"integration_ids\":[\"12pkXDutPjb9DI8JNYNm5q\"]}"},"url":"https://api.fastly.com/alerts/definitions/{{definition_id}}","description":"Update a definition with a new configuration.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"204 Update was successful","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"e3a86924-db2b-4c10-9c85-44b23a64dfbf"},{"name":"Delete definition","id":"f2eefda8-05ca-4ea8-ab51-0efda9ce4852","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/alerts/definitions/{{definition_id}}","description":"<p>Delete a definition using its ID.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["alerts","definitions","{{definition_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"78791693-fb1d-482d-8aed-3c51469188d1","name":"204 Delete was successful","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/alerts/definitions/{{definition_id}}","description":"Delete a definition using its ID.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"204 Delete was successful","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"f2eefda8-05ca-4ea8-ab51-0efda9ce4852"}],"id":"66a426c8-2e55-4327-aa0d-2a592518283c","description":"<p>Definitions are used to configure alerts on how to observe a metric.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Time when the definition was created (RFC3339).</td>\n</tr>\n<tr>\n<td>description</td>\n<td>string</td>\n<td>Additional text that is included in the alert notification.</td>\n</tr>\n<tr>\n<td>dimensions</td>\n<td>object</td>\n<td>More filters depending on the source type.</td>\n</tr>\n<tr>\n<td>evaluation_strategy</td>\n<td>object</td>\n<td>Criteria on how to alert.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>A unique identifier for a definition.</td>\n</tr>\n<tr>\n<td>integration_ids</td>\n<td>array</td>\n<td>List of integrations used to notify when alert fires. Refer to Notification Service.</td>\n</tr>\n<tr>\n<td>metric</td>\n<td>string</td>\n<td>The metric name to alert on for a specific source:</td>\n</tr>\n<tr>\n<td>domains,</td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td>origins or</td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td>stats.</td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The name of the alert definition.</td>\n</tr>\n<tr>\n<td>object</td>\n<td>string</td>\n<td>The resource type.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>The service on which the definition will alert on.</td>\n</tr>\n<tr>\n<td>source</td>\n<td>string</td>\n<td>The source where the metric comes from.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Time when the definition was last updated (RFC3339).</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-1\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>compute_resp_status_404_rate</td>\n<td>number</td>\n<td>Fraction of Compute responses with 404 codes delivered. If there are no responses, this value will be 0.</td>\n</tr>\n<tr>\n<td>compute_resp_status_4xx_excl_404_rate</td>\n<td>number</td>\n<td>Fraction of Compute responses with non-404 4xx codes delivered. If there are no responses, this value will be 0.</td>\n</tr>\n<tr>\n<td>compute_resp_status_4xx_rate</td>\n<td>number</td>\n<td>Fraction of Compute responses with 4xx codes delivered from domain. If there are no responses, this value will be 0.</td>\n</tr>\n<tr>\n<td>compute_resp_status_5xx_rate</td>\n<td>number</td>\n<td>Fraction of Compute responses with 5xx codes delivered from domain. If there are no responses, this value will be 0.</td>\n</tr>\n<tr>\n<td>compute_resp_status_gte_400_rate</td>\n<td>number</td>\n<td>Fraction of Compute responses with 4xx or 5xx codes delivered from domain. If there are no responses, this value will be 0.</td>\n</tr>\n<tr>\n<td>compute_resp_status_lt_500_rate</td>\n<td>number</td>\n<td>Fraction of Compute responses with non-5xx codes delivered from domain. If there are no responses, this value will be 0.</td>\n</tr>\n<tr>\n<td>origin_offload_bytes</td>\n<td>number</td>\n<td>The number of bytes offloaded to the edge.</td>\n</tr>\n<tr>\n<td>status_404_rate</td>\n<td>number</td>\n<td>Fraction of VCL responses with 404 codes delivered. If there are no responses, this value will be 0.</td>\n</tr>\n<tr>\n<td>status_4xx_excl_404_rate</td>\n<td>number</td>\n<td>Fraction of VCL responses with non-404 4xx codes delivered. If there are no responses, this value will be 0.</td>\n</tr>\n<tr>\n<td>status_4xx_rate</td>\n<td>number</td>\n<td>Fraction of VCL responses with 4xx codes delivered from domain. If there are no responses, this value will be 0.</td>\n</tr>\n<tr>\n<td>status_5xx_rate</td>\n<td>number</td>\n<td>Fraction of VCL responses with 5xx codes delivered from domain. If there are no responses, this value will be 0.</td>\n</tr>\n<tr>\n<td>status_gte_400_rate</td>\n<td>number</td>\n<td>Fraction of VCL responses with 4xx or 5xx codes delivered from domain. If there are no responses, this value will be 0.</td>\n</tr>\n<tr>\n<td>status_lt_500_rate</td>\n<td>number</td>\n<td>Fraction of VCL responses with non-5xx codes delivered from domain. If there are no responses, this value will be 0.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-2\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>all_bandwidth</td>\n<td>integer</td>\n<td>The amount of bandwidth from your origin.</td>\n</tr>\n<tr>\n<td>all_status_404_rate</td>\n<td>number</td>\n<td>Fraction of all responses with 404 codes delivered (Compute, WAF, and VCL). If there are no responses, this value will be 0.</td>\n</tr>\n<tr>\n<td>all_status_4xx_excl_404_rate</td>\n<td>number</td>\n<td>Fraction of all responses with non-404 4xx codes delivered (Compute, WAF, and VCL). If there are no responses, this value will be 0.</td>\n</tr>\n<tr>\n<td>all_status_4xx_rate</td>\n<td>number</td>\n<td>Fraction of all responses with 4xx codes delivered (Compute, WAF, and VCL). If there are no responses, this value will be 0.</td>\n</tr>\n<tr>\n<td>all_status_5xx_rate</td>\n<td>number</td>\n<td>Fraction of all responses with 5xx codes delivered (Compute, WAF, and VCL). If there are no responses, this value will be 0.</td>\n</tr>\n<tr>\n<td>all_status_gte_400_rate</td>\n<td>number</td>\n<td>Fraction of all responses with 4xx or 5xx codes delivered (Compute, WAF, and VCL). If there are no responses, this value will be 0.</td>\n</tr>\n<tr>\n<td>all_status_lt_500_rate</td>\n<td>number</td>\n<td>Fraction of all responses with non-5xx codes delivered (Compute, WAF, and VCL). If there are no responses, this value will be 0.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-3\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>ignore_below</td>\n<td>number</td>\n<td>Threshold for the denominator value used in evaluations that calculate a rate or ratio. Usually used to filter out noise.</td>\n</tr>\n<tr>\n<td>period</td>\n<td>string</td>\n<td>The length of time to evaluate whether the conditions have been met. The data is polled every minute.</td>\n</tr>\n<tr>\n<td>threshold</td>\n<td>number</td>\n<td>Threshold used to alert.</td>\n</tr>\n<tr>\n<td>type</td>\n<td>string</td>\n<td>Type of strategy to use to evaluate.</td>\n</tr>\n<tr>\n<td></td>\n<td>above_threshold</td>\n<td>This alert will fire when the observed metric goes above the specified threshold during an evaluation period at any one minute polling interval. The alert will resolve when there are zero one minute intervals in the evaluation period that exceed the threshold.</td>\n</tr>\n<tr>\n<td></td>\n<td>all_above_threshold</td>\n<td>This alert will fire when the observed metric is above the specified threshold during an evaluation period for every one minute polling interval. The alert will resolve when there is one minute interval in the evaluation period that does not exceed the threshold.</td>\n</tr>\n<tr>\n<td></td>\n<td>below_threshold</td>\n<td>This alert will fire when the observed metric remains below the specified threshold for two consecutive minutes in an evaluation period. The alert will resolve when there aren't two consecutive minutes in an evaluation period that are below the threshold.</td>\n</tr>\n<tr>\n<td></td>\n<td>percent_absolute</td>\n<td>This alert will fire when the observed metric increases or decreases by more than a threshold percentage from the first to the last minute of the evaluation period. The alert will resolve when the percentage change is below the threshold.</td>\n</tr>\n<tr>\n<td></td>\n<td>percent_decrease</td>\n<td>This alert will fire when the observed metric decreases by more than a threshold percentage from the first to the last minute of the evaluation period. The alert will resolve when the percentage decrease is below the threshold.</td>\n</tr>\n<tr>\n<td></td>\n<td>percent_increase</td>\n<td>This alert will fire when the observed metric increases by more than a threshold percentage from the first to the last minute of the evaluation period. The alert will resolve when the percentage increase is below the threshold.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-4\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>all_status_4xx_rate</td>\n<td>number</td>\n<td>Fraction of all responses with 4xx codes delivered (Compute and VCL). If there are no responses, this value will be 0.</td>\n</tr>\n<tr>\n<td>all_status_5xx_rate</td>\n<td>number</td>\n<td>Fraction of all responses with 5xx codes delivered (Compute and VCL). If there are no responses, this value will be 0.</td>\n</tr>\n<tr>\n<td>all_status_gte_400_rate</td>\n<td>number</td>\n<td>Fraction of all responses with 4xx or 5xx codes delivered (Compute and VCL). If there are no responses, this value will be 0.</td>\n</tr>\n<tr>\n<td>all_status_lt_500_rate</td>\n<td>number</td>\n<td>Fraction of all responses with non-5xx codes delivered (Compute and VCL). If there are no responses, this value will be 0.</td>\n</tr>\n<tr>\n<td>status_404_rate</td>\n<td>number</td>\n<td>Fraction of VCL responses with 404 codes delivered. If there are no responses, this value will be 0.</td>\n</tr>\n<tr>\n<td>status_4xx_excl_404_rate</td>\n<td>number</td>\n<td>Fraction of VCL responses with non-404 4xx codes delivered. If there are no responses, this value will be 0.</td>\n</tr>\n<tr>\n<td>status_4xx_rate</td>\n<td>number</td>\n<td>Fraction of VCL responses with 4xx codes delivered. If there are no responses, this value will be 0.</td>\n</tr>\n<tr>\n<td>status_5xx_rate</td>\n<td>number</td>\n<td>Fraction of VCL responses with 5xx codes delivered. If there are no responses, this value will be 0.</td>\n</tr>\n<tr>\n<td>status_gte_400_rate</td>\n<td>number</td>\n<td>Fraction of VCL responses with 4xx or 5xx codes delivered. If there are no responses, this value will be 0.</td>\n</tr>\n<tr>\n<td>status_lt_500_rate</td>\n<td>number</td>\n<td>Fraction of VCL responses with non-5xx codes delivered. If there are no responses, this value will be 0.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"66a426c8-2e55-4327-aa0d-2a592518283c"},{"name":"History","item":[{"name":"List history","id":"a2fd8cc2-0628-46bd-95f3-0ed384ef65ed","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/alerts/history?after&before&cursor&definition_id&limit&service_id&sort&status","description":"<p>List all history records.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["alerts","history"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Filter results based on records that were created after a specific time.</p>\n","type":"text/plain"},"key":"after"},{"description":{"content":"<p>Filter results based on records that were created before a specific time.</p>\n","type":"text/plain"},"key":"before"},{"description":{"content":"<p>Cursor value from the next_cursor field of a previous response, used to retrieve the next page. To request the first page, this should be empty.</p>\n","type":"text/plain"},"key":"cursor"},{"description":{"content":"<p>The ID of the definition that is requested.</p>\n","type":"text/plain"},"key":"definition_id"},{"description":{"content":"<p>Limit how many results are returned.</p>\n","type":"text/plain"},"key":"limit"},{"description":{"content":"<p>Filter results based on a service_id.</p>\n","type":"text/plain"},"key":"service_id"},{"description":{"content":"<p>Sort the items by the field provided, either ascending or descending.</p>\n","type":"text/plain"},"key":"sort"},{"description":{"content":"<p>Filter results based on a status.</p>\n","type":"text/plain"},"key":"status"}],"variable":[]}},"response":[{"id":"fa45b182-3878-4685-aadd-c55cba247b4d","name":"200 Requested history","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/alerts/history?after&before&cursor&definition_id&limit&service_id&sort&status","protocol":"https","host":["api","fastly","com"],"path":["alerts","history"],"query":[{"key":"after","description":"Filter results based on records that were created after a specific time."},{"key":"before","description":"Filter results based on records that were created before a specific time."},{"key":"cursor","description":"Cursor value from the next_cursor field of a previous response, used to retrieve the next page. To request the first page, this should be empty."},{"key":"definition_id","description":"The ID of the definition that is requested."},{"key":"limit","description":"Limit how many results are returned."},{"key":"service_id","description":"Filter results based on a service_id."},{"key":"sort","description":"Sort the items by the field provided, either ascending or descending."},{"key":"status","description":"Filter results based on a status."}]},"description":"List all history records.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 Requested history","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"id\":\"6HW4welznAHVnMCJhY9QdX\",\"object\":\"history\",\"definition\":{\"id\":\"x4xCwxxJxGCx123Rx5xTx\",\"object\":\"definition\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"name\":\"New alert on origin\",\"description\":\"A description of your alert\",\"dimensions\":{\"origins\":[\"example-origin.com\"]},\"metric\":\"all_status_5xx\",\"source\":\"origins\",\"evaluation_strategy\":{\"type\":\"above_threshold\",\"period\":\"5m\",\"threshold\":10},\"integration_ids\":[\"12pkXDutPjb9DI8JNYNm5q\"],\"created_at\":\"2022-09-14T19:06:27Z\",\"updated_at\":\"2022-09-14T19:06:27Z\"},\"definition_id\\\"\":\"x4xCwxxJxGCx123Rx5xTx\",\"start\":\"2022-09-14T20:06:27Z\",\"end\":\"2022-09-14T21:06:27Z\",\"status\":\"active\"}],\"meta\":{\"next_cursor\":\"\",\"limit\":100,\"sort\":\"-start\",\"total\":1}}"}],"_postman_id":"a2fd8cc2-0628-46bd-95f3-0ed384ef65ed"}],"id":"bb8da3fa-a0ab-4de5-bc93-575ad5715e64","description":"<p>Alerts history presents the past event notifications sent when observed metrics thresholds were triggered.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>definition</td>\n<td>object</td>\n<td>A snapshot of the definition.</td>\n</tr>\n<tr>\n<td>definition_id</td>\n<td>string</td>\n<td>Definition ID of which the event relates to.</td>\n</tr>\n<tr>\n<td>end</td>\n<td>string</td>\n<td>Time when the event ended (RFC3339).</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>History ID for a given event.</td>\n</tr>\n<tr>\n<td>object</td>\n<td>string</td>\n<td>Type of resource this object is.</td>\n</tr>\n<tr>\n<td>start</td>\n<td>string</td>\n<td>Time when the event started (RFC3339).</td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>Status of the event.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"bb8da3fa-a0ab-4de5-bc93-575ad5715e64"}],"id":"88e04bc7-95f3-4a57-be82-4a4797a36f31","_postman_id":"88e04bc7-95f3-4a57-be82-4a4797a36f31","description":""},{"name":"Observability","item":[{"name":"Custom dashboards","item":[{"name":"List all custom dashboards","id":"8b85dec2-9044-4ad5-b825-916f47cda492","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/observability/dashboards","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/observability/custom-dashboards/#list-dashboards\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["observability","dashboards"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"192f39eb-7656-456f-b482-ae101fdee7e4","name":"200 List all custom dashboards","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/observability/dashboards","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/observability/custom-dashboards/#list-dashboards)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 List all custom dashboards","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"id\":\"6zCMWp5NxFyHX1VdKiptmH\",\"name\":\"My Empty Dashboard\",\"description\":\"\",\"items\":[]},{\"id\":\"2eGFXF4F4kTxd4gU39Bg3e\",\"name\":\"My Cool Dashboard\",\"description\":\"This dashboard has one chart\",\"items\":[{\"id\":\"1qWQVbYqKAYJAsjFqr9EE6\",\"span\":4,\"title\":\"My Chart\",\"subtitle\":\"This chart displays my cool metrics\",\"data_source\":{\"type\":\"stats.edge\",\"config\":{\"metrics\":[\"requests\"]}},\"visualization\":{\"type\":\"chart\",\"config\":{\"plot_type\":\"line\",\"format\":\"number\"}}}],\"created_by\":\"x9KzsrACXZv8tPwlEDsKb6\",\"updated_by\":\"2Pgj3VqoQ8Zp57TWqt4VUb\",\"created_at\":\"2024-04-29T03:00:00.000Z\",\"updated_at\":\"2024-04-29T03:00:00.000Z\"}],\"meta\":{\"next_cursor\":\"\",\"limit\":20,\"sort\":\"-updated_at\",\"total\":2}}"}],"_postman_id":"8b85dec2-9044-4ad5-b825-916f47cda492"},{"name":"Create a new dashboard","id":"f66dd560-acd5-440a-9816-d12a14c3fbd0","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"My Empty Dashboard\"}"},"url":"https://api.fastly.com/observability/dashboards","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/observability/custom-dashboards/#create-dashboard\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["observability","dashboards"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"ffa07ada-8bee-4268-84f9-321ba80ca45a","name":"200 Requested dashboard","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"My Empty Dashboard\"}"},"url":"https://api.fastly.com/observability/dashboards","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/observability/custom-dashboards/#create-dashboard)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Requested dashboard","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"6zCMWp5NxFyHX1VdKiptmH\",\"name\":\"My Empty Dashboard\",\"description\":\"\",\"items\":[]}"}],"_postman_id":"f66dd560-acd5-440a-9816-d12a14c3fbd0"},{"name":"Retrieve a dashboard by ID","id":"2f60d0ae-cf08-49b3-bace-a64adde174b3","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/observability/dashboards/{{dashboard_id}}","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/observability/custom-dashboards/#get-dashboard\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["observability","dashboards","{{dashboard_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"ba50703c-2103-4b4b-8cfd-7aba1c6615fe","name":"200 Requested dashboard","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/observability/dashboards/2eGFXF4F4kTxd4gU39Bg3e","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/observability/custom-dashboards/#get-dashboard)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Requested dashboard","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"2eGFXF4F4kTxd4gU39Bg3e\",\"name\":\"My Cool Dashboard\",\"description\":\"This dashboard has one chart\",\"items\":[{\"id\":\"1qWQVbYqKAYJAsjFqr9EE6\",\"span\":4,\"title\":\"My Chart\",\"subtitle\":\"This chart displays my cool metrics\",\"data_source\":{\"type\":\"stats.edge\",\"config\":{\"metrics\":[\"requests\"]}},\"visualization\":{\"type\":\"chart\",\"config\":{\"plot_type\":\"line\",\"format\":\"number\"}}}],\"created_by\":\"x9KzsrACXZv8tPwlEDsKb6\",\"updated_by\":\"2Pgj3VqoQ8Zp57TWqt4VUb\",\"created_at\":\"2024-04-29T03:00:00.000Z\",\"updated_at\":\"2024-04-29T03:00:00.000Z\"}"}],"_postman_id":"2f60d0ae-cf08-49b3-bace-a64adde174b3"},{"name":"Delete an existing dashboard","id":"1908aaf4-1aa9-4380-b3c2-88572ef85eca","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/observability/dashboards/{{dashboard_id}}","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/observability/custom-dashboards/#delete-dashboard\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["observability","dashboards","{{dashboard_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"512a9f8b-cf5b-4075-b77e-a0e33ea02b31","name":"204 No Content","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/observability/dashboards/2eGFXF4F4kTxd4gU39Bg3e","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/observability/custom-dashboards/#delete-dashboard)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 No Content","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"1908aaf4-1aa9-4380-b3c2-88572ef85eca"},{"name":"Update an existing dashboard","id":"6750c7b7-293f-4711-8358-6fbc42a5e365","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"My Updated Dashboard\",\"description\":\"I'm altering the dashboard.\"}"},"url":"https://api.fastly.com/observability/dashboards/{{dashboard_id}}","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/observability/custom-dashboards/#update-dashboard\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["observability","dashboards","{{dashboard_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"edca6c10-004e-4beb-b168-a8815feddc25","name":"200 Update was successful","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"My Updated Dashboard\",\"description\":\"I'm altering the dashboard.\"}"},"url":"https://api.fastly.com/observability/dashboards/2eGFXF4F4kTxd4gU39Bg3e","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/observability/custom-dashboards/#update-dashboard)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Update was successful","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"2eGFXF4F4kTxd4gU39Bg3e\",\"name\":\"My Updated Dashboard\",\"description\":\"I'm altering the dashboard.\",\"items\":[{\"id\":\"1qWQVbYqKAYJAsjFqr9EE6\",\"span\":4,\"title\":\"My Chart\",\"subtitle\":\"This chart displays my cool metrics\",\"data_source\":{\"type\":\"stats.edge\",\"config\":{\"metrics\":[\"requests\"]}},\"visualization\":{\"type\":\"chart\",\"config\":{\"plot_type\":\"line\",\"format\":\"number\"}}}],\"created_by\":\"x9KzsrACXZv8tPwlEDsKb6\",\"updated_by\":\"2Pgj3VqoQ8Zp57TWqt4VUb\",\"created_at\":\"2024-04-29T03:00:00.000Z\",\"updated_at\":\"2024-09-30T03:31:00.000Z\"}"}],"_postman_id":"6750c7b7-293f-4711-8358-6fbc42a5e365"}],"id":"616dd4f3-4513-4397-baa7-17aff2230f1e","description":"<p>The Observability API allows you to programmatically define custom dashboards to view in the Observability web interface.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>description</td>\n<td>string</td>\n<td>A short description of the dashboard.</td>\n</tr>\n<tr>\n<td>items</td>\n<td>array</td>\n<td>A list of dashboard items.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>A human-readable name.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>created_by</td>\n<td>string</td>\n<td>The ID of the user who created the dashboard.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>Dashboard identifier (UUID).</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>updated_by</td>\n<td>string</td>\n<td>The ID of the user who last modified the dashboard.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-1\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>data_source</td>\n<td>object</td>\n<td>An object which describes the data to display.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>Dashboard item identifier (UUID).</td>\n</tr>\n<tr>\n<td>span</td>\n<td>integer</td>\n<td>The number of columns for the dashboard item to span. Dashboards are rendered on a 12-column grid on \"desktop\" screen sizes.</td>\n</tr>\n<tr>\n<td>subtitle</td>\n<td>string</td>\n<td>A human-readable subtitle for the dashboard item. Often a description of the visualization.</td>\n</tr>\n<tr>\n<td>title</td>\n<td>string</td>\n<td>A human-readable title for the dashboard item.</td>\n</tr>\n<tr>\n<td>visualization</td>\n<td>object</td>\n<td>An object which describes the data visualization to display.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-2\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>config</td>\n<td>object</td>\n<td>Configuration options for the selected data source.</td>\n</tr>\n<tr>\n<td>type</td>\n<td>string</td>\n<td>The source of the data to display.</td>\n</tr>\n<tr>\n<td></td>\n<td>stats.edge</td>\n<td>Edge metrics.</td>\n</tr>\n<tr>\n<td></td>\n<td>stats.domain</td>\n<td>Domain metrics.</td>\n</tr>\n<tr>\n<td></td>\n<td>stats.origin</td>\n<td>Origin metrics.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-3\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>metrics</td>\n<td>array</td>\n<td>The metrics to visualize. Valid options are defined by the selected data source.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-4\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>config</td>\n<td>object</td>\n<td>Configuration options for the given visualization.</td>\n</tr>\n<tr>\n<td>type</td>\n<td>string</td>\n<td>The type of visualization to display.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-5\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>calculation_method</td>\n<td>string</td>\n<td>(Optional) The aggregation function to apply to the dataset.</td>\n</tr>\n<tr>\n<td>format</td>\n<td>string</td>\n<td>(Optional) The units to use to format the data.</td>\n</tr>\n<tr>\n<td>plot_type</td>\n<td>string</td>\n<td>The type of chart to display.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"616dd4f3-4513-4397-baa7-17aff2230f1e"},{"name":"Insights","item":[{"name":"Retrieve log insights","id":"051fe67d-9373-4193-8bc4-6a87d77ed23c","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/observability/log-insights?domain_exact_match&domain&end&limit&pops&service_id&start&visualization","description":"<p>Retrieves statistics from sampled log records.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["observability","log-insights"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Determines whether the value in the domain parameter should be treated as a suffix or exact match. When false for suffix match, any request domain ending in the specified value will be considered a match (e.g., foo.com will match a.foo.com and b.foo.com in addition to foo.com). Defaults to true for exact match.</p>\n","type":"text/plain"},"key":"domain_exact_match"},{"description":{"content":"<p>Limits data to the specified request domain. Defaults to all request domains.</p>\n","type":"text/plain"},"key":"domain"},{"description":{"content":"<p>Specifies the exclusive end time of the logs to be queried. Must be in valid RFC 3339 format.</p>\n","type":"text/plain"},"key":"end"},{"description":{"content":"<p>Maximum number of rows to return. Defaults to 10, limited to 100.</p>\n","type":"text/plain"},"key":"limit"},{"description":{"content":"<p>Comma-separated list of Fastly POP codes. Omission defaults to all POPs.</p>\n","type":"text/plain"},"key":"pops"},{"description":{"content":"<p>Specifies the ID of the service for which data should be returned.</p>\n","type":"text/plain"},"key":"service_id"},{"description":{"content":"<p>Specifies the inclusive start time of the logs to be queried. Must be in valid RFC 3339 format.</p>\n","type":"text/plain"},"key":"start"},{"description":{"content":"<p>Specifies the Log Insights visualization for which data should be returned.</p>\n","type":"text/plain"},"key":"visualization"}],"variable":[]}},"response":[{"id":"68521240-adbd-40c3-adb3-87c96668dd4a","name":"200 Retrieves log insights for the specified service and visualization.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/observability/log-insights?end=2024-01-05T14%3A30%3A23Z&service_id=1jlmtMz1ncwA0KC3TBGD0X&start=2024-01-01T14%3A30%3A23Z&visualization=top-url-by-requests?domain_exact_match&domain&end&limit&pops&service_id&start&visualization","protocol":"https","host":["api","fastly","com"],"path":["observability","log-insights"],"query":[{"key":"domain_exact_match","description":"Determines whether the value in the domain parameter should be treated as a suffix or exact match. When false for suffix match, any request domain ending in the specified value will be considered a match (e.g., foo.com will match a.foo.com and b.foo.com in addition to foo.com). Defaults to true for exact match."},{"key":"domain","description":"Limits data to the specified request domain. Defaults to all request domains."},{"key":"end","description":"Specifies the exclusive end time of the logs to be queried. Must be in valid RFC 3339 format."},{"key":"limit","description":"Maximum number of rows to return. Defaults to 10, limited to 100."},{"key":"pops","description":"Comma-separated list of Fastly POP codes. Omission defaults to all POPs."},{"key":"service_id","description":"Specifies the ID of the service for which data should be returned."},{"key":"start","description":"Specifies the inclusive start time of the logs to be queried. Must be in valid RFC 3339 format."},{"key":"visualization","description":"Specifies the Log Insights visualization for which data should be returned."}]},"description":"Retrieves statistics from sampled log records.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Retrieves log insights for the specified service and visualization.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"dimensions\":{\"url\":\"GET /health\"},\"values\":[{\"request_percentage\":0.5161290322580645}]},{\"dimensions\":{\"url\":\"HEAD /internal/dns/configurations/pdnsdatad\"},\"values\":[{\"request_percentage\":0.25806451612903225}]},{\"dimensions\":{\"url\":\"/\"},\"values\":[{\"request_percentage\":0.12903225806451613}]}],\"meta\":{\"filters\":{\"service_id\":\"1jlmtMz1ncwA0KC3TBGD0X\",\"start\":\"2024-01-01T14:30:23.51559064-06:00\",\"end\":\"2024-01-05T14:30:23.51559064-06:00\",\"domain_exact_match\":true,\"limit\":10}}}"}],"_postman_id":"051fe67d-9373-4193-8bc4-6a87d77ed23c"}],"id":"04c5b26b-3d97-453f-9099-068f602715bc","description":"<p>The Insights API allows users to analyze insights from sampled logs that are collected for the Log Explorer &amp; Insights product.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>country_chr</td>\n<td>number</td>\n<td>The cache hit ratio for the country.</td>\n</tr>\n<tr>\n<td>country_error_rate</td>\n<td>number</td>\n<td>The error rate for the country.</td>\n</tr>\n<tr>\n<td>country_request_rate</td>\n<td>number</td>\n<td>This country's percentage of the total requests.</td>\n</tr>\n<tr>\n<td>rate</td>\n<td>number</td>\n<td>The rate at which the value in the current dimension occurs.</td>\n</tr>\n<tr>\n<td>browser</td>\n<td>string</td>\n<td>The client's browser for this dimension.</td>\n</tr>\n<tr>\n<td>content_type</td>\n<td>string</td>\n<td>The content type of the response for this dimension.</td>\n</tr>\n<tr>\n<td>country</td>\n<td>string</td>\n<td>The client's country for this dimension.</td>\n</tr>\n<tr>\n<td>device</td>\n<td>string</td>\n<td>The client's device type for this dimension.</td>\n</tr>\n<tr>\n<td>os</td>\n<td>string</td>\n<td>The client's operating system for this dimension.</td>\n</tr>\n<tr>\n<td>response</td>\n<td>string</td>\n<td>The HTTP reason phrase for this dimension.</td>\n</tr>\n<tr>\n<td>status-code</td>\n<td>string</td>\n<td>The HTTP response code for this dimension.</td>\n</tr>\n<tr>\n<td>url</td>\n<td>string</td>\n<td>The URL path for this dimension.</td>\n</tr>\n<tr>\n<td>meta</td>\n<td>object</td>\n<td>Echoes the filters that were supplied in the request.</td>\n</tr>\n<tr>\n<td>filters</td>\n<td>object</td>\n<td>The filters that were supplied in the request.</td>\n</tr>\n<tr>\n<td>domain_exact_match</td>\n<td>boolean</td>\n<td>Value of the domain_exact_match filter as supplied in the request.</td>\n</tr>\n<tr>\n<td>end</td>\n<td>string</td>\n<td>End time for the query as supplied in the request.</td>\n</tr>\n<tr>\n<td>limit</td>\n<td>integer</td>\n<td>Number of records per page.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Specifies the ID of the service for which data should be returned.</td>\n</tr>\n<tr>\n<td>start</td>\n<td>string</td>\n<td>Start time for the query as supplied in the request.</td>\n</tr>\n<tr>\n<td>503_rate_per_url</td>\n<td>number</td>\n<td>The rate at which 503 status codes are returned for this URL.</td>\n</tr>\n<tr>\n<td>rate_per_url</td>\n<td>number</td>\n<td>The rate at which the reason in this dimension occurs among responses to this URL with a 503 status code.</td>\n</tr>\n<tr>\n<td>average_bandwidth_bytes</td>\n<td>number</td>\n<td>The average bandwidth in bytes for responses to requests to the URL in the current dimension.</td>\n</tr>\n<tr>\n<td>bandwidth_percentage</td>\n<td>number</td>\n<td>The total bandwidth percentage for all responses to requests to the URL in the current dimension.</td>\n</tr>\n<tr>\n<td>browser_version</td>\n<td>string</td>\n<td>The version of the client's browser.</td>\n</tr>\n<tr>\n<td>cache_hit_ratio</td>\n<td>number</td>\n<td>The cache hit ratio for the URL specified in the dimension.</td>\n</tr>\n<tr>\n<td>region</td>\n<td>string</td>\n<td>The client's country subdivision code as defined by ISO 3166-2.</td>\n</tr>\n<tr>\n<td>region_chr</td>\n<td>number</td>\n<td>The cache hit ratio for the region.</td>\n</tr>\n<tr>\n<td>region_error_rate</td>\n<td>number</td>\n<td>The error rate for the region.</td>\n</tr>\n<tr>\n<td>average_response_time</td>\n<td>number</td>\n<td>The average time in seconds to respond to requests to the URL in the current dimension.</td>\n</tr>\n<tr>\n<td>p95_response_time</td>\n<td>number</td>\n<td>The P95 time in seconds to respond to requests to the URL in the current dimension.</td>\n</tr>\n<tr>\n<td>response_time_percentage</td>\n<td>number</td>\n<td>The total percentage of time to respond to all requests to the URL in the current dimension.</td>\n</tr>\n<tr>\n<td>miss_rate</td>\n<td>number</td>\n<td>The miss rate for requests to the URL in the current dimension.</td>\n</tr>\n<tr>\n<td>request_percentage</td>\n<td>number</td>\n<td>The percentage of all requests made to the URL in the current dimension.</td>\n</tr>\n<tr>\n<td>rate_per_status</td>\n<td>number</td>\n<td>The URL accounts for this percentage of the status code in this dimension.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"04c5b26b-3d97-453f-9099-068f602715bc"},{"name":"Log Aggregations","item":[{"name":"Retrieve aggregated log results","id":"e2cea8a8-dade-4501-816c-2a431d0a6f3c","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/observability/aggregations?dimensions&end&filter&limit&series&service_id&sort&source&start","description":"<p>Retrieves aggregated log results.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["observability","aggregations"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Comma-separated list of fields for grouping dimensions.</p>\n","type":"text/plain"},"key":"dimensions"},{"description":{"content":"<p>Specifies the exclusive end time of the logs to be queried. Must be in valid RFC3339 format.</p>\n","type":"text/plain"},"key":"end"},{"description":{"content":"<p>Filter parameters take the form filter[ ][ ]= .\nFor example, filter[response_time][gte]=0.5 would filter for logs where the\nresponse time was greater than or equal to 0.5 seconds. Multiple filter\nexpressions can be combined. The filters will be combined with a logical AND\noperator so that the logs returned match all supplied filters.\nSupported filter fields include domain, request_path, fastly_pop,\nresponse_time, response_status, is_shield, is_edge,\nclient_os_name, client_device_type, client_browser_name, and\nis_cache_hit.\nSupported filter operators include = (applicable to string, numeric, and\nboolean values), ends-with (applicable to string values), in (applicable\nto lists of string and numeric values), not_in (applicable to lists of\nstring and numeric values), and gt, gte, lt, lte (applicable to\nnumeric values).</p>\n","type":"text/plain"},"key":"filter"},{"description":{"content":"<p>Maximum number of rows to return. Defaults to 10, limited to 100.</p>\n","type":"text/plain"},"key":"limit"},{"description":{"content":"<p>A data series to be computed for each grouping dimension. Series\ndefinitions take the form [ ]. For example, series=avg[response_time]\nwill compute the average response time for each dimension value. At least one\nseries is required.</p>\n","type":"text/plain"},"key":"series"},{"description":{"content":"<p>Specifies the ID of the service for which data should be returned.</p>\n","type":"text/plain"},"key":"service_id"},{"description":{"content":"<p>Comma-separated list of the series names whose values should be used\nto sort the results. Prepend - to a series name to sort according to the\ndescending order of its values.</p>\n","type":"text/plain"},"key":"sort"},{"description":{"content":"<p>Specifies the source of the data for the aggregations.  Must be logs to retrieve log data.</p>\n","type":"text/plain"},"key":"source"},{"description":{"content":"<p>Specifies the inclusive start time of the logs to be queried. Must be in valid RFC3339 format.</p>\n","type":"text/plain"},"key":"start"}],"variable":[]}},"response":[{"id":"9830c65e-59b4-4db5-9a5b-2b3f009f6106","name":"200 Retrieves aggregated log records.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/observability/aggregations?dimensions&end&filter&limit&series&service_id&sort&source&start","protocol":"https","host":["api","fastly","com"],"path":["observability","aggregations"],"query":[{"key":"dimensions","description":"Comma-separated list of fields for grouping dimensions."},{"key":"end","description":"Specifies the exclusive end time of the logs to be queried. Must be in valid RFC3339 format."},{"key":"filter","description":"Filter parameters take the form filter[ ][ ]= .\nFor example, filter[response_time][gte]=0.5 would filter for logs where the\nresponse time was greater than or equal to 0.5 seconds. Multiple filter\nexpressions can be combined. The filters will be combined with a logical AND\noperator so that the logs returned match all supplied filters.\nSupported filter fields include domain, request_path, fastly_pop,\nresponse_time, response_status, is_shield, is_edge,\nclient_os_name, client_device_type, client_browser_name, and\nis_cache_hit.\nSupported filter operators include = (applicable to string, numeric, and\nboolean values), ends-with (applicable to string values), in (applicable\nto lists of string and numeric values), not_in (applicable to lists of\nstring and numeric values), and gt, gte, lt, lte (applicable to\nnumeric values)."},{"key":"limit","description":"Maximum number of rows to return. Defaults to 10, limited to 100."},{"key":"series","description":"A data series to be computed for each grouping dimension. Series\ndefinitions take the form [ ]. For example, series=avg[response_time]\nwill compute the average response time for each dimension value. At least one\nseries is required."},{"key":"service_id","description":"Specifies the ID of the service for which data should be returned."},{"key":"sort","description":"Comma-separated list of the series names whose values should be used\nto sort the results. Prepend - to a series name to sort according to the\ndescending order of its values."},{"key":"source","description":"Specifies the source of the data for the aggregations.  Must be logs to retrieve log data."},{"key":"start","description":"Specifies the inclusive start time of the logs to be queried. Must be in valid RFC3339 format."}]},"description":"Retrieves aggregated log results.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Retrieves aggregated log records.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"oneOf\":[{\"data\":[],\"meta\":{\"service_id\":\"1jlmtMz1ncwA0KC3TBGD0X\",\"start\":\"2024-01-01T14:30:23.51559064-06:00\",\"end\":\"2024-01-05T14:30:23.51559064-06:00\",\"sort\":\"-avg[response_time]\",\"limit\":5}},{\"data\":[{\"dimensions\":{\"fastly_pop\":\"IAD\"},\"values\":{\"avg[response_time]\":0.09929545630108226,\"p99[response_time]\":0.16500000655651093}},{\"dimensions\":{\"fastly_pop\":\"BOS\"},\"values\":{\"avg[response_time]\":0.09807500019669532,\"p99[response_time]\":0.17800000309944153}},{\"dimensions\":{\"fastly_pop\":\"CMH\"},\"values\":{\"avg[response_time]\":0.09406060567407896,\"p99[response_time]\":0.125}},{\"dimensions\":{\"fastly_pop\":\"DFW\"},\"values\":{\"avg[response_time]\":0.07580769205322632,\"p99[response_time]\":0.09300000220537186}}],\"meta\":{\"service_id\":\"1jlmtMz1ncwA0KC3TBGD0X\",\"start\":\"2024-01-01T14:30:23.51559064-06:00\",\"end\":\"2024-01-05T14:30:23.51559064-06:00\",\"sort\":\"-avg[response_time]\",\"limit\":4}}]}"}],"_postman_id":"e2cea8a8-dade-4501-816c-2a431d0a6f3c"}],"id":"496fcf7d-f45f-48d5-90e2-bd805ece343d","description":"<p>The Observability Aggregations API for Logs allows users to query the sampled logs that are collected for the Log Explorer &amp; Insights product with user-defined aggregations and filters.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>field</td>\n<td>string</td>\n<td>The log field to which this filter should be applied.</td>\n</tr>\n<tr>\n<td>operator</td>\n<td>string</td>\n<td>The comparison operator used for this filter.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"496fcf7d-f45f-48d5-90e2-bd805ece343d"},{"name":"Log Explorer","item":[{"name":"Retrieve log records","id":"bdc7d1a8-8742-470c-845c-d5b0a3805c70","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/observability/log-explorer?end&filter&limit&next_cursor&service_id&start","description":"<p>Retrieves log records.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["observability","log-explorer"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Specifies the exclusive end time of the logs to be queried. Must be in valid RFC3339 format.</p>\n","type":"text/plain"},"key":"end"},{"description":{"content":"<p>Filter parameters take the form filter[ ][ ]= .\nFor example, filter[response_time][gte]=0.5 would filter for logs where the\nresponse time was greater than or equal to 0.5 seconds. Multiple filter\nexpressions can be combined. The filters will be combined with a logical AND\noperator so that the logs returned match all supplied filters.\nSupported filter fields include domain, request_path, fastly_pop,\nresponse_time, response_status, fastly_is_shield, fastly_is_edge,\nclient_os_name, client_device_type, client_browser_name, and\nfastly_is_cache_hit.\nSupported filter operators include = (applicable to string, numeric, and\nboolean values), ends-with (applicable to string values), in (applicable\nto lists of string and numeric values), not_in (applicable to lists of\nstring and numeric values), and gt, gte, lt, lte (applicable to\nnumeric values).</p>\n","type":"text/plain"},"key":"filter"},{"description":{"content":"<p>Maximum number of rows to return. Defaults to 10, limited to 100.</p>\n","type":"text/plain"},"key":"limit"},{"description":{"content":"<p>A cursor to specify the next page of results in a paginated query. Must be specified with the same parameters as the original query or results may be inconsistent.</p>\n","type":"text/plain"},"key":"next_cursor"},{"description":{"content":"<p>Specifies the ID of the service for which data should be returned.</p>\n","type":"text/plain"},"key":"service_id"},{"description":{"content":"<p>Specifies the inclusive start time of the logs to be queried. Must be in valid RFC3339 format.</p>\n","type":"text/plain"},"key":"start"}],"variable":[]}},"response":[{"id":"6c20483d-8f49-46ce-b396-56c6267e86ed","name":"200 Retrieves log records.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/observability/log-explorer?service_id=1jlmtMz1ncwA0KC3TBGD0X?end&filter&limit&next_cursor&service_id&start","protocol":"https","host":["api","fastly","com"],"path":["observability","log-explorer"],"query":[{"key":"end","description":"Specifies the exclusive end time of the logs to be queried. Must be in valid RFC3339 format."},{"key":"filter","description":"Filter parameters take the form filter[ ][ ]= .\nFor example, filter[response_time][gte]=0.5 would filter for logs where the\nresponse time was greater than or equal to 0.5 seconds. Multiple filter\nexpressions can be combined. The filters will be combined with a logical AND\noperator so that the logs returned match all supplied filters.\nSupported filter fields include domain, request_path, fastly_pop,\nresponse_time, response_status, fastly_is_shield, fastly_is_edge,\nclient_os_name, client_device_type, client_browser_name, and\nfastly_is_cache_hit.\nSupported filter operators include = (applicable to string, numeric, and\nboolean values), ends-with (applicable to string values), in (applicable\nto lists of string and numeric values), not_in (applicable to lists of\nstring and numeric values), and gt, gte, lt, lte (applicable to\nnumeric values)."},{"key":"limit","description":"Maximum number of rows to return. Defaults to 10, limited to 100."},{"key":"next_cursor","description":"A cursor to specify the next page of results in a paginated query. Must be specified with the same parameters as the original query or results may be inconsistent."},{"key":"service_id","description":"Specifies the ID of the service for which data should be returned."},{"key":"start","description":"Specifies the inclusive start time of the logs to be queried. Must be in valid RFC3339 format."}]},"description":"Retrieves log records.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Retrieves log records.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"oneOf\":[{\"data\":[],\"meta\":{\"service_id\":\"1jlmtMz1ncwA0KC3TBGD0X\",\"start\":\"2024-01-01T14:30:23.51559064-06:00\",\"end\":\"2024-01-05T14:30:23.51559064-06:00\",\"limit\":5}},{\"data\":[{\"customer_id\":\"M4HCwJxJPGCIBSlRd5ETh\",\"service_id\":\"1jlmtMz1ncwA0KC3TBGD0X\",\"timestamp\":\"2024-01-03T16:14:22.317Z\",\"client_as_number\":0,\"client_region\":\"OH\",\"client_country_code\":\"US\",\"client_os_name\":\"\",\"client_os_version\":\"\",\"client_device_type\":\"\",\"client_browser_name\":\"\",\"client_browser_version\":\"\",\"fastly_pop\":\"NYC\",\"origin_host\":\"a1.com\",\"request_protocol\":\"HTTP/2\",\"request_host\":\"api.fastly.com\",\"request_path\":\"/health\",\"request_method\":\"GET\",\"response_bytes_body\":0,\"response_bytes_header\":0,\"response_content_length\":0,\"response_content_type\":\"text/html;charset=utf-8\",\"response_reason\":\"OK\",\"response_state\":\"\",\"response_status\":200,\"response_time\":0.093,\"response_x_cache\":\"MISS, MISS\",\"is_cache_hit\":false,\"is_edge\":false,\"is_shield\":false},{\"customer_id\":\"M4HCwJxJPGCIBSlRd5ETh\",\"service_id\":\"1jlmtMz1ncwA0KC3TBGD0X\",\"timestamp\":\"2024-01-03T16:14:23.317Z\",\"client_as_number\":0,\"client_region\":\"TX\",\"client_country_code\":\"US\",\"client_os_name\":\"Windows 10\",\"client_os_version\":\"\",\"client_device_type\":\"\",\"client_browser_name\":\"\",\"client_browser_version\":\"\",\"fastly_pop\":\"DFW\",\"origin_host\":\"a2.com\",\"request_protocol\":\"HTTP/2\",\"request_host\":\"api.fastly.com\",\"request_path\":\"/bar\",\"request_method\":\"GET\",\"response_bytes_body\":0,\"response_bytes_header\":0,\"response_content_length\":0,\"response_content_type\":\"text/html;charset=utf-8\",\"response_reason\":\"OK\",\"response_state\":\"\",\"response_status\":200,\"response_time\":0.091,\"response_x_cache\":\"MISS, MISS\",\"is_cache_hit\":false,\"is_edge\":false,\"is_shield\":false}],\"meta\":{\"service_id\":\"1jlmtMz1ncwA0KC3TBGD0X\",\"start\":\"2024-01-01T14:30:23.51559064-06:00\",\"end\":\"2024-01-05T14:30:23.51559064-06:00\",\"limit\":5}}]}"}],"_postman_id":"bdc7d1a8-8742-470c-845c-d5b0a3805c70"}],"id":"627b026b-73be-4b95-b75a-8a25a185907f","description":"<p>The Log Explorer API allows users to query the sampled logs that are collected for the Log Explorer &amp; Insights product.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>field</td>\n<td>string</td>\n<td>The log field to which this filter should be applied.</td>\n</tr>\n<tr>\n<td>operator</td>\n<td>string</td>\n<td>The comparison operator used for this filter.</td>\n</tr>\n<tr>\n<td>client_as_number</td>\n<td>integer</td>\n<td>The autonomous system (AS) number of the client.</td>\n</tr>\n<tr>\n<td>client_browser_name</td>\n<td>string</td>\n<td>The name of the browser in use on the client device.</td>\n</tr>\n<tr>\n<td>client_browser_version</td>\n<td>string</td>\n<td>The version of the browser in use on client device.</td>\n</tr>\n<tr>\n<td>client_country_code</td>\n<td>string</td>\n<td>The two-letter ISO 3166-1 country code for the client.</td>\n</tr>\n<tr>\n<td>client_device_type</td>\n<td>string</td>\n<td>The type of the client's device.</td>\n</tr>\n<tr>\n<td>client_os_name</td>\n<td>string</td>\n<td>The name of the operating system installed on the client device.</td>\n</tr>\n<tr>\n<td>client_region</td>\n<td>string</td>\n<td>The client's country subdivision code as found in ISO 3166-2.</td>\n</tr>\n<tr>\n<td>customer_id</td>\n<td>string</td>\n<td>The ID of the Fastly customer that owns the service.</td>\n</tr>\n<tr>\n<td>fastly_pop</td>\n<td>string</td>\n<td>The name of the Fastly POP that served this request.</td>\n</tr>\n<tr>\n<td>is_cache_hit</td>\n<td>boolean</td>\n<td>Indicates whether this request was fulfilled from cache.</td>\n</tr>\n<tr>\n<td>is_edge</td>\n<td>boolean</td>\n<td>Indicates whether the request was handled by a Fastly edge POP.</td>\n</tr>\n<tr>\n<td>is_shield</td>\n<td>boolean</td>\n<td>Indicates whether the request was handled by a Fastly shield POP.</td>\n</tr>\n<tr>\n<td>origin_host</td>\n<td>string</td>\n<td>The name of the origin host that served this request.</td>\n</tr>\n<tr>\n<td>request_host</td>\n<td>string</td>\n<td>The name of the request host used for this request.</td>\n</tr>\n<tr>\n<td>request_method</td>\n<td>string</td>\n<td>HTTP method sent by the client such as \"GET\" or \"POST\".</td>\n</tr>\n<tr>\n<td>request_path</td>\n<td>string</td>\n<td>The URL path supplied for this request.</td>\n</tr>\n<tr>\n<td>request_protocol</td>\n<td>string</td>\n<td>HTTP protocol version in use for this request. For example, HTTP/1.1.</td>\n</tr>\n<tr>\n<td>response_bytes_body</td>\n<td>integer</td>\n<td>Body bytes sent to the client in the response.</td>\n</tr>\n<tr>\n<td>response_bytes_header</td>\n<td>integer</td>\n<td>Header bytes sent to the client in the response.</td>\n</tr>\n<tr>\n<td>response_content_length</td>\n<td>integer</td>\n<td>Total bytes sent to the client in the response.</td>\n</tr>\n<tr>\n<td>response_content_type</td>\n<td>string</td>\n<td>The content type of the response sent to the client.</td>\n</tr>\n<tr>\n<td>response_reason</td>\n<td>string</td>\n<td>The HTTP reason phrase returned for this request, if any.</td>\n</tr>\n<tr>\n<td>response_state</td>\n<td>string</td>\n<td>The state of the request with optional suffixes describing special cases.</td>\n</tr>\n<tr>\n<td>response_status</td>\n<td>integer</td>\n<td>The HTTP response code returned for this request.</td>\n</tr>\n<tr>\n<td>response_time</td>\n<td>number</td>\n<td>The time since the request started in seconds.</td>\n</tr>\n<tr>\n<td>response_x_cache</td>\n<td>string</td>\n<td>Indicates whether the request was a HIT or a MISS.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>The ID of the service that received the request.</td>\n</tr>\n<tr>\n<td>timestamp</td>\n<td>string</td>\n<td>Timestamp of the request in ISO 8601 format.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"627b026b-73be-4b95-b75a-8a25a185907f"},{"name":"Notification Service","item":[{"name":"Get all integration types","id":"29019a59-345f-454e-8bb3-b265eccb47d0","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/notifications/integration-types","description":"<p>Describe all handled integration types with additional metadata on how to create an integration of each type.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["notifications","integration-types"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"7ee23bb2-dda7-48d3-ab82-14cbe5c8cf05","name":"200 List of integration types","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/notifications/integration-types","description":"Describe all handled integration types with additional metadata on how to create an integration of each type.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 List of integration types","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"type\":\"mailinglist\",\"display_name\":\"Mailing List\",\"custom_fields\":[{\"name\":\"address\",\"display_name\":\"Address\",\"format\":\"email\"}]},{\"type\":\"microsoftteams\",\"display_name\":\"Microsoft Teams\",\"custom_fields\":[{\"name\":\"webhook\",\"display_name\":\"Webhook URL\",\"format\":\"url\"}]},{\"type\":\"newrelic\",\"display_name\":\"New Relic\",\"custom_fields\":[{\"name\":\"account\",\"display_name\":\"Account\",\"format\":\"\"},{\"name\":\"key\",\"display_name\":\"Key\",\"format\":\"\"}]},{\"type\":\"pagerduty\",\"display_name\":\"PagerDuty\",\"custom_fields\":[{\"name\":\"key\",\"display_name\":\"Key\",\"format\":\"\"}]},{\"type\":\"slack\",\"display_name\":\"Slack Webhook\",\"custom_fields\":[{\"name\":\"webhook\",\"display_name\":\"Webhook URL\",\"format\":\"url\"}]},{\"type\":\"webhook\",\"display_name\":\"Generic Webhook\",\"custom_fields\":[{\"name\":\"webhook\",\"display_name\":\"Webhook URL\",\"format\":\"url\"}]}]"}],"_postman_id":"29019a59-345f-454e-8bb3-b265eccb47d0"},{"name":"Search for integrations","id":"8aceda36-8270-4093-9112-b1f42c411534","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/notifications/integrations?cursor&limit&sort&type","description":"<p>Lists integrations matching the given query parameters.\nIf no query parameter is given, the query returns the first 10 integrations sorted by name in ascending order.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["notifications","integrations"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Cursor value from the next_cursor field of a previous response, used to retrieve the next page. To request the first page, this should be empty.</p>\n","type":"text/plain"},"key":"cursor"},{"description":{"content":"<p>Limit how many results are returned.</p>\n","type":"text/plain"},"key":"limit"},{"description":{"content":"<p>Sort the items by the given field.\nAllowed fields names are \"name\", \"created_at\" and \"updated_at\". Order is ascending by default, preprend the field with the minus sign - to use descending order.</p>\n","type":"text/plain"},"key":"sort"},{"description":{"content":"<p>Filter results based on their type.</p>\n","type":"text/plain"},"key":"type"}],"variable":[]}},"response":[{"id":"decffc29-3a0b-4262-8716-4ff3ece44c62","name":"200 Requested integrations","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/notifications/integrations?sort=-updated_at?cursor&limit&sort&type","protocol":"https","host":["api","fastly","com"],"path":["notifications","integrations"],"query":[{"key":"cursor","description":"Cursor value from the next_cursor field of a previous response, used to retrieve the next page. To request the first page, this should be empty."},{"key":"limit","description":"Limit how many results are returned."},{"key":"sort","description":"Sort the items by the given field.\nAllowed fields names are \"name\", \"created_at\" and \"updated_at\". Order is ascending by default, preprend the field with the minus sign - to use descending order."},{"key":"type","description":"Filter results based on their type."}]},"description":"Lists integrations matching the given query parameters.\nIf no query parameter is given, the query returns the first 10 integrations sorted by name in ascending order.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 Requested integrations","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"name\":\"team alerts mailinglist\",\"description\":\"A description of your integration\",\"type\":\"mailinglist\",\"config\":{\"address\":\"redteam@example-domain.com\"},\"id\":\"6es1LOoxtL1yybTnlRpmC7\",\"status\":\"confirmation_pending\",\"created_at\":\"2022-09-14T19:06:27Z\",\"updated_at\":\"2022-09-14T19:06:27Z\"},{\"id\":\"5zWgM0qxIvGg3dspNSoCr\",\"name\":\"Slack Prod\",\"description\":\"Slack for Fastly notifications\",\"type\":\"slack\",\"created_at\":\"2022-09-14T19:06:27Z\",\"updated_at\":\"2022-09-14T19:06:27Z\"}],\"meta\":{\"total\":10,\"next_cursor\":\"U2UGtPn7FQfkMCEPwHs\",\"limit\":2,\"sort\":\"-updated_at\"}}"}],"_postman_id":"8aceda36-8270-4093-9112-b1f42c411534"},{"name":"Create an integration","id":"c1f75dab-18bb-4785-9974-10c07864035d","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"team alerts mailinglist\",\"description\":\"A description of your integration\",\"type\":\"mailinglist\",\"config\":{\"address\":\"redteam@example-domain.com\"}}"},"url":"https://api.fastly.com/notifications/integrations","description":"<p>Create a new integration of the given type.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["notifications","integrations"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"6a76b61f-149d-4cbd-864b-daae0eaab129","name":"200 Creation was successful","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"team alerts mailinglist\",\"description\":\"A description of your integration\",\"type\":\"mailinglist\",\"config\":{\"address\":\"redteam@example-domain.com\"}}"},"url":"https://api.fastly.com/notifications/integrations","description":"Create a new integration of the given type.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 Creation was successful","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"integration_id\":\"12pkXDutPjb9DI8JNYNm5q\"}"}],"_postman_id":"c1f75dab-18bb-4785-9974-10c07864035d"},{"name":"Get integration","id":"6df490fa-4653-449a-96a7-062364cbdecc","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/notifications/integrations/{{integration_id}}","description":"<p>Retrieve an existing integration by using its id, if it exists.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["notifications","integrations","{{integration_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"b8d8d389-37f4-4632-97fb-d1c5506d4185","name":"200 Requested integrations","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/notifications/integrations/5zWgM0qxIvGg3dspNSoCr","description":"Retrieve an existing integration by using its id, if it exists.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 Requested integrations","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"name\":\"team alerts mailinglist\",\"description\":\"A description of your integration\",\"type\":\"mailinglist\",\"config\":{\"address\":\"redteam@example-domain.com\"},\"id\":\"6es1LOoxtL1yybTnlRpmC7\",\"status\":\"confirmation_pending\",\"created_at\":\"2022-09-14T19:06:27Z\",\"updated_at\":\"2022-09-14T19:06:27Z\"}"}],"_postman_id":"6df490fa-4653-449a-96a7-062364cbdecc"},{"name":"Delete an integration","id":"c2a5c0a1-9990-4052-9c37-7358cd3afdc1","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/notifications/integrations/{{integration_id}}","description":"<p>Delete an integration. The effect is immediate and does not require confirmation.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["notifications","integrations","{{integration_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"10eb8d18-bdfc-4282-912d-273593086f77","name":"204 Deletion was successful","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/notifications/integrations/5zWgM0qxIvGg3dspNSoCr","description":"Delete an integration. The effect is immediate and does not require confirmation.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"204 Deletion was successful","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"c2a5c0a1-9990-4052-9c37-7358cd3afdc1"},{"name":"Update an integration","id":"caecc9a4-8ed9-40e0-bf6d-63df1456d756","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\"config\":{\"address\":\"newaddress@example-domain.com\"}}"},"url":"https://api.fastly.com/notifications/integrations/{{integration_id}}","description":"<p>Update an existing integration, only updating the fields that are given and leaving the others untouched.\nIf the type is changed, then you must also fill out the specific fields required by the integration.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["notifications","integrations","{{integration_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"4792b0e3-009b-4eec-9511-78104b216c54","name":"204 Update was successful","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\"config\":{\"address\":\"newaddress@example-domain.com\"}}"},"url":"https://api.fastly.com/notifications/integrations/5zWgM0qxIvGg3dspNSoCr","description":"Update an existing integration, only updating the fields that are given and leaving the others untouched.\nIf the type is changed, then you must also fill out the specific fields required by the integration.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"204 Update was successful","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"caecc9a4-8ed9-40e0-bf6d-63df1456d756"},{"name":"Get webhook payload signing key","id":"e4c18999-0d19-449c-8dc6-0cdffc6ff7e8","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/notifications/integrations/{{integration_id}}/signingKey","description":"<p>Get the signing key used to sign payloads for a webhook integration.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["notifications","integrations","{{integration_id}}","signingKey"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"7aef95ee-cadc-430e-8769-73266cd8a2a1","name":"200 Requested webhook signing key","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/notifications/integrations/5zWgM0qxIvGg3dspNSoCr/signingKey","description":"Get the signing key used to sign payloads for a webhook integration.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 Requested webhook signing key","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"signingKey\":\"8a9f54e9-17a2-45df-9541-6828a13a3fdd\"}"}],"_postman_id":"e4c18999-0d19-449c-8dc6-0cdffc6ff7e8"},{"name":"Rotate webhook payload signing key","id":"883ebb8e-6321-4627-9e8a-3d7f2a61eaa4","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/notifications/integrations/{{integration_id}}/rotateSigningKey","description":"<p>Rotate the webhook signing key. This immediately updates the signing key for any new notification.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["notifications","integrations","{{integration_id}}","rotateSigningKey"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"b283a0a3-eb53-4645-99ef-db2fb49a8e3c","name":"200 Rotated webhook signing key","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/notifications/integrations/5zWgM0qxIvGg3dspNSoCr/rotateSigningKey","description":"Rotate the webhook signing key. This immediately updates the signing key for any new notification.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 Rotated webhook signing key","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"signingKey\":\"8a9f54e9-17a2-45df-9541-6828a13a3fdd\"}"}],"_postman_id":"883ebb8e-6321-4627-9e8a-3d7f2a61eaa4"},{"name":"Send mailing list confirmation email","id":"2251eee5-6ae5-4b37-b556-9eee69391af6","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\"email\":\"redteam@example-domain.com\"}"},"url":"https://api.fastly.com/notifications/mailinglist-confirmations","description":"<p>Send a confirmation email to collect required opt-in for mailing list notifications.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["notifications","mailinglist-confirmations"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"8b4a8d5b-8406-4f05-8768-efd52c21dc7b","name":"204 Creation was successful","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\"email\":\"redteam@example-domain.com\"}"},"url":"https://api.fastly.com/notifications/mailinglist-confirmations","description":"Send a confirmation email to collect required opt-in for mailing list notifications.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"204 Creation was successful","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"2251eee5-6ae5-4b37-b556-9eee69391af6"}],"id":"e377dbf5-b01a-45f0-8e21-05f608bda789","description":"<p>The Notification Service API allows you to programmatically create and manage notification integrations. Fastly will use these integrations to send you notifications and alerts related to the Fastly product. Mailing list, Microsoft Teams, New Relic, Slack, PagerDuty, and webhook are supported as integrations.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>config</td>\n<td>object</td>\n<td>Configuration specific to the integration type.</td>\n</tr>\n<tr>\n<td>description</td>\n<td>string</td>\n<td>User submitted description of the integration.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>User submitted name of the integration.</td>\n</tr>\n<tr>\n<td>type</td>\n<td>string</td>\n<td>Type of the integration.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>An unique identifier for the integration.</td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>The status for a mailing list integration.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-1\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>address</td>\n<td>string</td>\n<td>An email address.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-2\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>webhook</td>\n<td>string</td>\n<td>Microsoft teams webhook.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-3\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>account</td>\n<td>string</td>\n<td>New Relic Account.</td>\n</tr>\n<tr>\n<td>key</td>\n<td>string</td>\n<td>New Relic Key.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-4\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>key</td>\n<td>string</td>\n<td>PagerDuty integration key.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-5\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>webhook</td>\n<td>string</td>\n<td>Slack webhook.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-6\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>webhook</td>\n<td>string</td>\n<td>Webhook URL.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"e377dbf5-b01a-45f0-8e21-05f608bda789"},{"name":"Timeseries","item":[{"name":"Retrieve observability data as a time series","id":"40e7d11c-fbdd-4296-9dac-7e891d4eddd8","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/observability/timeseries?dimensions&filter&from&granularity&series&source&to","description":"<p>Retrieves observability data as a time series.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["observability","timeseries"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Comma-separated list of grouping dimensions. Supported values are source specific.\nNo grouping dimensions implies aggregation by time only.</p>\n","type":"text/plain"},"key":"dimensions"},{"description":{"content":"<p>Filter parameters are query string components that let you narrow down API responses by\nincluding only records that match specific criteria. Filter parameters take the form\nfilter[ ][ ]= or filter[ ]= .\nFor example, filter[response_time][gte]=0.5 would filter for\nresponse time values greater than or equal to 0.5 seconds. Multiple filter\nexpressions can be combined. The filters will be combined with a logical AND\noperator so that the logs returned match all supplied filters.\nSupported filter fields are source specific.\nSupported filter operators include ends-with (applicable to string values),\nin and not_in (applicable to lists of string and numeric values); as well as\ngt, gte, lt, and lte (applicable to numeric values).</p>\n","type":"text/plain"},"key":"filter"},{"description":{"content":"<p>Specifies the inclusive start time of the data to be queried. Must be in valid RFC 3339 format.</p>\n","type":"text/plain"},"key":"from"},{"description":{"content":"<p>The duration of each interval in the time series. Supported values are source specific.</p>\n","type":"text/plain"},"key":"granularity"},{"description":{"content":"<p>Comma-separated list of the data series to be computed for each time bucket and combination\nof dimensions. Series definitions take the form [ ]. Supported fields\nare source specific. For example, series=avg[response_time] will compute the\naverage response time. At least one series is required.</p>\n","type":"text/plain"},"key":"series"},{"description":{"content":"<p>The source of the data for the time series.</p>\n","type":"text/plain"},"key":"source"},{"description":{"content":"<p>Specifies the exclusive end time of the data to be queried. Must be in valid RFC 3339 format.</p>\n","type":"text/plain"},"key":"to"}],"variable":[]}},"response":[{"id":"973d848c-6e2c-4d09-b566-0334d6a5fb35","name":"200 Retrieves the time series results based on observability data.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/observability/timeseries?filter=filter%5Bresponse_status%5D%3D200&from=2024-01-03T16%3A00%3A00Z&granularity=hour&series=avg%5Bresponse_time%5D%2Cp99%5Bresponse_time%5D&source=logs&to=2024-01-03T18%3A00%3A00Z?dimensions&filter&from&granularity&series&source&to","protocol":"https","host":["api","fastly","com"],"path":["observability","timeseries"],"query":[{"key":"dimensions","description":"Comma-separated list of grouping dimensions. Supported values are source specific.\nNo grouping dimensions implies aggregation by time only."},{"key":"filter","description":"Filter parameters are query string components that let you narrow down API responses by\nincluding only records that match specific criteria. Filter parameters take the form\nfilter[ ][ ]= or filter[ ]= .\nFor example, filter[response_time][gte]=0.5 would filter for\nresponse time values greater than or equal to 0.5 seconds. Multiple filter\nexpressions can be combined. The filters will be combined with a logical AND\noperator so that the logs returned match all supplied filters.\nSupported filter fields are source specific.\nSupported filter operators include ends-with (applicable to string values),\nin and not_in (applicable to lists of string and numeric values); as well as\ngt, gte, lt, and lte (applicable to numeric values)."},{"key":"from","description":"Specifies the inclusive start time of the data to be queried. Must be in valid RFC 3339 format."},{"key":"granularity","description":"The duration of each interval in the time series. Supported values are source specific."},{"key":"series","description":"Comma-separated list of the data series to be computed for each time bucket and combination\nof dimensions. Series definitions take the form [ ]. Supported fields\nare source specific. For example, series=avg[response_time] will compute the\naverage response time. At least one series is required."},{"key":"source","description":"The source of the data for the time series."},{"key":"to","description":"Specifies the exclusive end time of the data to be queried. Must be in valid RFC 3339 format."}]},"description":"Retrieves observability data as a time series.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Retrieves the time series results based on observability data.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"dimensions\":{\"time\":\"2024-01-03T16:00:00Z\"},\"values\":{\"avg[response_time]\":0.08858333315168108,\"p99[response_time]\":0.17800000309944153}},{\"dimensions\":{\"time\":\"2024-01-03T17:00:00Z\"},\"values\":{\"avg[response_time]\":0.09044898073283994,\"p99[response_time]\":0.0949999988079071}},{\"dimensions\":{\"time\":\"2024-01-03T18:00:00Z\"},\"values\":{\"avg[response_time]\":0.09019999993698938,\"p99[response_time]\":0.0949999988079071}}],\"meta\":{\"from\":\"2024-01-03T16:00:00Z\",\"to\":\"2024-01-03T19:00:00Z\",\"granularity\":\"hour\",\"limit\":10}}"}],"_postman_id":"40e7d11c-fbdd-4296-9dac-7e891d4eddd8"}],"id":"b7514aa8-cb81-4752-89b2-64104f53c0e1","description":"<p>The Observability Timeseries API allows users to retrieve observability data collected by Fastly for the Log Explorer &amp; Insights product and for the Sustainability dashboard as time series.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>dimensions</td>\n<td>object</td>\n<td>An object containing each requested dimension and time as properties.</td>\n</tr>\n<tr>\n<td>values</td>\n<td>object</td>\n<td>An object containing each requested series as a property.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-1\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>from</td>\n<td>string</td>\n<td>Start time for the query as supplied in the request.</td>\n</tr>\n<tr>\n<td>granularity</td>\n<td>string</td>\n<td>The granularity of the time buckets in the response.</td>\n</tr>\n<tr>\n<td>limit</td>\n<td>string</td>\n<td>Maximum number of results returned in the request.</td>\n</tr>\n<tr>\n<td>to</td>\n<td>string</td>\n<td>End time for the query as supplied in the request.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"b7514aa8-cb81-4752-89b2-64104f53c0e1"}],"id":"d804c97a-115f-41f9-92d1-3a08fc5982a6","_postman_id":"d804c97a-115f-41f9-92d1-3a08fc5982a6","description":""},{"name":"Timeseries","item":[{"name":"Log Timeseries","item":[{"name":"Retrieve log data as time series","id":"0d661c8e-fd85-4eaf-b35f-d142de7476a0","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/observability/timeseries?filter&from&granularity&limit&series&service_id&source&to","description":"<p>Retrieves log data as time series.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["observability","timeseries"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Filter parameters take the form filter[ ][ ]= .\nFor example, filter[response_time][gte]=0.5 would filter for logs where the\nresponse time was greater than or equal to 0.5 seconds. Multiple filter\nexpressions can be combined. The filters will be combined with a logical AND\noperator so that the logs returned match all supplied filters.\nSupported filter fields include domain, request_path, fastly_pop,\nresponse_time, response_status, fastly_is_shield, fastly_is_edge,\nclient_os_name, client_device_type, client_browser_name, and\nfastly_is_cache_hit.\nSupported filter operators include = (applicable to string, numeric, and\nboolean values), ends-with (applicable to string values), in (applicable\nto lists of string and numeric values), not_in (applicable to lists of\nstring and numeric values), and gt, gte, lt, lte (applicable to\nnumeric values).</p>\n","type":"text/plain"},"key":"filter"},{"description":{"content":"<p>Specifies the inclusive start time of the data to be queried. Must be in valid RFC 3339 format.</p>\n","type":"text/plain"},"key":"from"},{"description":{"content":"<p>The duration of each interval in the time series.</p>\n","type":"text/plain"},"key":"granularity"},{"description":{"content":"<p>Maximum number of results to return.</p>\n","type":"text/plain"},"key":"limit"},{"description":{"content":"<p>Comma-separated list of the data series to be computed for each time bucket. Series\ndefinitions take the form [ ]. For example, series=avg[response_time]\nwill compute the average response time for each time bucket. At least one\nseries is required.</p>\n","type":"text/plain"},"key":"series"},{"description":{"content":"<p>Specifies the ID of the service for which data should be returned.</p>\n","type":"text/plain"},"key":"service_id"},{"description":{"content":"<p>Specifies the source of the data for the time series. Must be logs to retrieve log data.</p>\n","type":"text/plain"},"key":"source"},{"description":{"content":"<p>Specifies the exclusive end time of the data to be queried. Must be in valid RFC 3339 format.</p>\n","type":"text/plain"},"key":"to"}],"variable":[]}},"response":[{"id":"098e4b17-5bea-4739-8929-bf1502483b3d","name":"200 Retrieves time series results based on log data.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/observability/timeseries?from=2024-01-03T16%3A00%3A00Z&granularity=hour&series=avg%5Bresponse_time%5D%2Cp99%5Bresponse_time%5D&service_id=1jlmtMz1ncwA0KC3TBGD0X&source=logs&to=2024-01-03T18%3A00%3A00Z?filter&from&granularity&limit&series&service_id&source&to","protocol":"https","host":["api","fastly","com"],"path":["observability","timeseries"],"query":[{"key":"filter","description":"Filter parameters take the form filter[ ][ ]= .\nFor example, filter[response_time][gte]=0.5 would filter for logs where the\nresponse time was greater than or equal to 0.5 seconds. Multiple filter\nexpressions can be combined. The filters will be combined with a logical AND\noperator so that the logs returned match all supplied filters.\nSupported filter fields include domain, request_path, fastly_pop,\nresponse_time, response_status, fastly_is_shield, fastly_is_edge,\nclient_os_name, client_device_type, client_browser_name, and\nfastly_is_cache_hit.\nSupported filter operators include = (applicable to string, numeric, and\nboolean values), ends-with (applicable to string values), in (applicable\nto lists of string and numeric values), not_in (applicable to lists of\nstring and numeric values), and gt, gte, lt, lte (applicable to\nnumeric values)."},{"key":"from","description":"Specifies the inclusive start time of the data to be queried. Must be in valid RFC 3339 format."},{"key":"granularity","description":"The duration of each interval in the time series."},{"key":"limit","description":"Maximum number of results to return."},{"key":"series","description":"Comma-separated list of the data series to be computed for each time bucket. Series\ndefinitions take the form [ ]. For example, series=avg[response_time]\nwill compute the average response time for each time bucket. At least one\nseries is required."},{"key":"service_id","description":"Specifies the ID of the service for which data should be returned."},{"key":"source","description":"Specifies the source of the data for the time series. Must be logs to retrieve log data."},{"key":"to","description":"Specifies the exclusive end time of the data to be queried. Must be in valid RFC 3339 format."}]},"description":"Retrieves log data as time series.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Retrieves time series results based on log data.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"dimensions\":{\"time\":\"2024-01-03T16:00:00Z\"},\"values\":{\"avg[response_time]\":0.08858333315168108,\"p99[response_time]\":0.17800000309944153}},{\"dimensions\":{\"time\":\"2024-01-03T17:00:00Z\"},\"values\":{\"avg[response_time]\":0.09044898073283994,\"p99[response_time]\":0.0949999988079071}},{\"dimensions\":{\"time\":\"2024-01-03T18:00:00Z\"},\"values\":{\"avg[response_time]\":0.09019999993698938,\"p99[response_time]\":0.0949999988079071}}],\"meta\":{\"service_id\":\"1jlmtMz1ncwA0KC3TBGD0X\",\"from\":\"2024-01-03T16:00:00Z\",\"to\":\"2024-01-03T19:00:00Z\",\"granularity\":\"hour\"}}"}],"_postman_id":"0d661c8e-fd85-4eaf-b35f-d142de7476a0"}],"id":"b505cabb-406a-4865-b386-b56d96ded23d","description":"<p>The Observability Timeseries API for Logs allows users to query the sampled logs that are collected for the Log Explorer &amp; Insights product as time series data with user-defined aggregations and filters.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>client_as_number</td>\n<td>integer</td>\n<td>The autonomous system (AS) number of the client.</td>\n</tr>\n<tr>\n<td>client_browser_name</td>\n<td>string</td>\n<td>The name of the browser in use on the client device.</td>\n</tr>\n<tr>\n<td>client_browser_version</td>\n<td>string</td>\n<td>The version of the browser in use on client device.</td>\n</tr>\n<tr>\n<td>client_country_code</td>\n<td>string</td>\n<td>The two-letter ISO 3166-1 country code for the client.</td>\n</tr>\n<tr>\n<td>client_device_type</td>\n<td>string</td>\n<td>The type of the client's device.</td>\n</tr>\n<tr>\n<td>client_os_name</td>\n<td>string</td>\n<td>The name of the operating system installed on the client device.</td>\n</tr>\n<tr>\n<td>client_region</td>\n<td>string</td>\n<td>The client's country subdivision code as found in ISO 3166-2.</td>\n</tr>\n<tr>\n<td>fastly_pop</td>\n<td>string</td>\n<td>The name of the Fastly POP that served this request.</td>\n</tr>\n<tr>\n<td>is_cache_hit</td>\n<td>boolean</td>\n<td>Indicates whether this request was fulfilled from cache.</td>\n</tr>\n<tr>\n<td>is_edge</td>\n<td>boolean</td>\n<td>Indicates whether the request was handled by a Fastly edge POP.</td>\n</tr>\n<tr>\n<td>is_shield</td>\n<td>boolean</td>\n<td>Indicates whether the request was handled by a Fastly shield POP.</td>\n</tr>\n<tr>\n<td>origin_host</td>\n<td>string</td>\n<td>The name of the origin host that served this request.</td>\n</tr>\n<tr>\n<td>request_host</td>\n<td>string</td>\n<td>The name of the request host used for this request.</td>\n</tr>\n<tr>\n<td>request_method</td>\n<td>string</td>\n<td>HTTP method sent by the client such as \"GET\" or \"POST\".</td>\n</tr>\n<tr>\n<td>request_path</td>\n<td>string</td>\n<td>The URL path supplied for this request.</td>\n</tr>\n<tr>\n<td>request_protocol</td>\n<td>string</td>\n<td>HTTP protocol version in use for this request. For example, HTTP/1.1.</td>\n</tr>\n<tr>\n<td>response_bytes_body</td>\n<td>integer</td>\n<td>Body bytes sent to the client in the response.</td>\n</tr>\n<tr>\n<td>response_bytes_header</td>\n<td>integer</td>\n<td>Header bytes sent to the client in the response.</td>\n</tr>\n<tr>\n<td>response_content_length</td>\n<td>integer</td>\n<td>Total bytes sent to the client in the response.</td>\n</tr>\n<tr>\n<td>response_content_type</td>\n<td>string</td>\n<td>The content type of the response sent to the client.</td>\n</tr>\n<tr>\n<td>response_reason</td>\n<td>string</td>\n<td>The HTTP reason phrase returned for this request, if any.</td>\n</tr>\n<tr>\n<td>response_state</td>\n<td>string</td>\n<td>The state of the request with optional suffixes describing special cases.</td>\n</tr>\n<tr>\n<td>response_status</td>\n<td>integer</td>\n<td>The HTTP response code returned for this request.</td>\n</tr>\n<tr>\n<td>response_time</td>\n<td>number</td>\n<td>The time since the request started in seconds.</td>\n</tr>\n<tr>\n<td>response_x_cache</td>\n<td>string</td>\n<td>Indicates whether the request was a HIT or a MISS.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-1\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>field</td>\n<td>string</td>\n<td>The field this filter applies to.</td>\n</tr>\n<tr>\n<td>operator</td>\n<td>string</td>\n<td>The comparison operator used for this filter.</td>\n</tr>\n<tr>\n<td>value</td>\n<td>object</td>\n<td>The comparison value used for this filter. Can be string, number, boolean, string array, or number array.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-2\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>field_filters</td>\n<td>array</td>\n<td>Array of filter objects describing filters supplied in the request.</td>\n</tr>\n<tr>\n<td>from</td>\n<td>string</td>\n<td>Start time for the query as supplied in the request.</td>\n</tr>\n<tr>\n<td>granularity</td>\n<td>string</td>\n<td>The granularity of the time buckets in the response.</td>\n</tr>\n<tr>\n<td>limit</td>\n<td>string</td>\n<td>Maximum number of results returned in the request.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>ID of the service for which data was returned.</td>\n</tr>\n<tr>\n<td>to</td>\n<td>string</td>\n<td>End time for the query as supplied in the request.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"b505cabb-406a-4865-b386-b56d96ded23d"},{"name":"Sustainability Timeseries","item":[{"name":"Retrieve sustainability data as a time series","id":"9a03fd9c-7bf6-478e-bb00-673592ab1078","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/observability/timeseries?cursor&dimensions&filter&from&granularity&limit&series&source&to","description":"<p>Retrieves sustainability data as a time series.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["observability","timeseries"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Cursor value from the next_cursor field of a previous response, used to retrieve the next page. To request the first page, this should be empty.</p>\n","type":"text/plain"},"key":"cursor"},{"description":{"content":"<p>Comma separated list of grouping dimensions. No grouping dimensions implies aggregation by time only.</p>\n","type":"text/plain"},"key":"dimensions"},{"description":{"content":"<p>Filter parameters are query string components that let you narrow down API responses by\nincluding only records that match specific criteria.  Filter parameters take the form\nfilter[ ][ ]= or filter[ ]= .\nFor example, filter[country][in]=US,CA would filter for sustainability data\nfrom usage of Fastly PoPs located in the United States or Canada. Multiple filter\nexpressions can be combined. The filters will be combined with a logical AND\noperator so that the data returned match all supplied filters.\nSupported filter operator in applies to lists of string values.</p>\n","type":"text/plain"},"key":"filter"},{"description":{"content":"<p>Specifies the inclusive start time of the data to be queried. Must be in valid RFC 3339 format.</p>\n","type":"text/plain"},"key":"from"},{"description":{"content":"<p>The duration of each interval in the time series.</p>\n","type":"text/plain"},"key":"granularity"},{"description":{"content":"<p>Maximum number of results to return.</p>\n","type":"text/plain"},"key":"limit"},{"description":{"content":"<p>Comma-separated list of the data series to be computed for each time bucket and combination\nof dimensions. Series definitions take the form [ ]. For sustainability,\nthe only function supported is sum. For example, series=sum[bandwidth_gb] will return\nthe sum of bandwidth for each dimensioned time bucket. At least one series is required.</p>\n","type":"text/plain"},"key":"series"},{"description":{"content":"<p>Specifies the source of the data for the time series. Must be sustainability to retrieve sustainability data.</p>\n","type":"text/plain"},"key":"source"},{"description":{"content":"<p>Specifies the exclusive end time of the data to be queried. Must be in valid RFC 3339 format.</p>\n","type":"text/plain"},"key":"to"}],"variable":[]}},"response":[{"id":"8514c6be-bff3-4c83-ad53-91ef0c1d1558","name":"200 Retrieves time series results based on sustainability data.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/observability/timeseries?dimensions=product&filter=filter%5Bcountry%5D%3DUS%26filter%5Bproduct%5D%5Bin%5D%3Ddelivery%2Ccompute&from=2024-01-03T16%3A00%3A00Z&granularity=day&series=sum%5Bscope2_market_mtco2e%5D%2Csum%5Bscope3_market_mtco2e%5D&source=sustainability&to=2024-01-03T18%3A00%3A00Z?cursor&dimensions&filter&from&granularity&limit&series&source&to","protocol":"https","host":["api","fastly","com"],"path":["observability","timeseries"],"query":[{"key":"cursor","description":"Cursor value from the next_cursor field of a previous response, used to retrieve the next page. To request the first page, this should be empty."},{"key":"dimensions","description":"Comma separated list of grouping dimensions. No grouping dimensions implies aggregation by time only."},{"key":"filter","description":"Filter parameters are query string components that let you narrow down API responses by\nincluding only records that match specific criteria.  Filter parameters take the form\nfilter[ ][ ]= or filter[ ]= .\nFor example, filter[country][in]=US,CA would filter for sustainability data\nfrom usage of Fastly PoPs located in the United States or Canada. Multiple filter\nexpressions can be combined. The filters will be combined with a logical AND\noperator so that the data returned match all supplied filters.\nSupported filter operator in applies to lists of string values."},{"key":"from","description":"Specifies the inclusive start time of the data to be queried. Must be in valid RFC 3339 format."},{"key":"granularity","description":"The duration of each interval in the time series."},{"key":"limit","description":"Maximum number of results to return."},{"key":"series","description":"Comma-separated list of the data series to be computed for each time bucket and combination\nof dimensions. Series definitions take the form [ ]. For sustainability,\nthe only function supported is sum. For example, series=sum[bandwidth_gb] will return\nthe sum of bandwidth for each dimensioned time bucket. At least one series is required."},{"key":"source","description":"Specifies the source of the data for the time series. Must be sustainability to retrieve sustainability data."},{"key":"to","description":"Specifies the exclusive end time of the data to be queried. Must be in valid RFC 3339 format."}]},"description":"Retrieves sustainability data as a time series.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Retrieves time series results based on sustainability data.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"dimensions\":{\"product\":\"delivery\",\"time\":\"2025-01-01T00:00:00Z\"},\"values\":{\"sum[scope2_market_mtco2e]\":0.08858333315168108,\"sum[scope3_market_mtco2e]\":0.00178000003099441}},{\"dimensions\":{\"product\":\"compute\",\"time\":\"2025-01-01T00:00:00Z\"},\"values\":{\"sum[scope2_market_mtco2e]\":0.09044898073283994,\"sum[scope3_market_mtco2e]\":0.00949999988079071}},{\"dimensions\":{\"product\":\"delivery\",\"time\":\"2025-01-02T00:00:00Z\"},\"values\":{\"sum[scope2_market_mtco2e]\":0.09019999993698938,\"sum[scope3_market_mtco2e]\":0.00949999988079071}},{\"dimensions\":{\"product\":\"compute\",\"time\":\"2025-01-02T00:00:00Z\"},\"values\":{\"sum[scope2_market_mtco2e]\":0.09019999993698938,\"sum[scope3_market_mtco2e]\":0.00949999988079071}}],\"meta\":{\"from\":\"2025-01-01T00:00:00Z\",\"to\":\"2025-01-02T00:00:00Z\",\"granularity\":\"day\",\"limit\":10000}}"}],"_postman_id":"9a03fd9c-7bf6-478e-bb00-673592ab1078"}],"id":"b0375fd6-8c1a-49ef-8d91-7e15d678fdc3","description":"<p>The Observability Timeseries API for Sustainability allows users to query the platform usage, electricity consumption and greenhouse gas (GHG) emission metrics across the Fastly PoP network that are visualized in the Sustainability dashboard.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>bandwidth_gb</td>\n<td>number</td>\n<td>Total bandwidth consumed across all services in gigabytes (GB).</td>\n</tr>\n<tr>\n<td>cputime_sec</td>\n<td>number</td>\n<td>Total CPU use by compute services in seconds (CPU seconds).</td>\n</tr>\n<tr>\n<td>grid_it_mwh</td>\n<td>number</td>\n<td>Residual grid electricity consumption in megawatt-hours (MWh) by Fastly-operated IT equipment after deducting renewable energy consumption. Applied to residual emission factor per country for GHGP Scope 2 market-based emissions accounting.</td>\n</tr>\n<tr>\n<td>grid_non_it_mwh</td>\n<td>number</td>\n<td>Residual grid electricity consumption in MWh by facility-operated non-IT equipment after deducting renewable energy consumption. Applied to residual emission factor per country for GHGP Scope 3 Category 8 market-based emissions accounting.</td>\n</tr>\n<tr>\n<td>renewable_it_mwh</td>\n<td>number</td>\n<td>Electricity consumption in MWh by Fastly-operated IT equipment covered by renewable energy procurement or on-site generation. Calculated from per-facility data gathered by Fastly from facility operators and backed by documentary evidence or attestations.</td>\n</tr>\n<tr>\n<td>renewable_non_it_mwh</td>\n<td>number</td>\n<td>Electricity consumption in MWh by facility-operated non-IT equipment (e.g. to regulate data center temperature and humidity) covered by renewable energy procurement or on-site generation. Calculated from per-facility data gathered by Fastly from facility operators and backed by documentary evidence or attestations.</td>\n</tr>\n<tr>\n<td>scope2_location_mtco2e</td>\n<td>number</td>\n<td>GHG Scope 2 location-based carbon emissions in metric tons of carbon dioxide equivalent (MTCO2e).</td>\n</tr>\n<tr>\n<td>scope2_market_mtco2e</td>\n<td>number</td>\n<td>GHG Scope 2 market-based carbon emissions in MTCO2e.</td>\n</tr>\n<tr>\n<td>scope3_location_mtco2e</td>\n<td>number</td>\n<td>GHG Scope 3 location-based carbon emissions in MTCO2e.</td>\n</tr>\n<tr>\n<td>scope3_market_mtco2e</td>\n<td>number</td>\n<td>GHG Scope 3 market-based carbon emissions in MTCO2e.</td>\n</tr>\n<tr>\n<td>total_it_mwh</td>\n<td>number</td>\n<td>Total electricity consumption in MWh by Fastly-operated IT equipment based on power distribution unit (PDU) and server power metrics. Applied to electricity generation emission factors per country for Greenhouse Gas Protocol (GHGP) Scope 2 location-based emissions accounting. Also used to calculate GHGP Scope 3 Category 3 emissions of transmission and distribution (T&amp;D) losses, well-to-tank (WTT) emissions, and WTT of T&amp;D.</td>\n</tr>\n<tr>\n<td>total_non_it_mwh</td>\n<td>number</td>\n<td>Total electricity consumption in MWh by facility-operated non-IT equipment based on total_it_mwh and facility power usage effectiveness (PUE) factor. Applied to electricity generation emission factor per country for GHGP Scope 3 Category 8 location-based emissions accounting.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-1\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>from</td>\n<td>string</td>\n<td>Start time for the query as supplied in the request.</td>\n</tr>\n<tr>\n<td>granularity</td>\n<td>string</td>\n<td>The granularity of the time buckets in the response.</td>\n</tr>\n<tr>\n<td>limit</td>\n<td>string</td>\n<td>Maximum number of results returned in the request.</td>\n</tr>\n<tr>\n<td>next_cursor</td>\n<td>string</td>\n<td>The value to use as the cursor parameter of the next request to retrieve the following result page. To paginate, use the exact same query parameters with the cursor updated.</td>\n</tr>\n<tr>\n<td>If this value is empty, you got the last page.</td>\n<td></td>\n<td></td>\n</tr>\n<tr>\n<td>to</td>\n<td>string</td>\n<td>End time for the query as supplied in the request.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"b0375fd6-8c1a-49ef-8d91-7e15d678fdc3"}],"id":"617e5496-ba21-46e7-9f2a-85179a30dbf8","_postman_id":"617e5496-ba21-46e7-9f2a-85179a30dbf8","description":""},{"name":"Products","item":[{"name":"AI Accelerator","item":[{"name":"Get product enablement status","id":"ea3645cf-88c3-45c6-b7c6-83391ec2ce19","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/ai_accelerator","description":"<p>Get the enablement status of the AI Accelerator product.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","ai_accelerator"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"ed46df98-6c56-4387-9ac5-6c1ff3517ea9","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/ai_accelerator","description":"Get the enablement status of the AI Accelerator product.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"ai_accelerator\",\"object\":\"product\"},\"customer\":{\"id\":\"WioEuN2Pp8TCBwEyfFMuG7\",\"object\":\"customer\"},\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/ai_accelerator\"}}"}],"_postman_id":"ea3645cf-88c3-45c6-b7c6-83391ec2ce19"},{"name":"Enable product","id":"623fee8c-2537-4a16-9b00-00e6bf9985a1","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/ai_accelerator","description":"<p>Enable the AI Accelerator product.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","ai_accelerator"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"b6a4f5e1-1897-4c92-b903-49641ff65539","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/ai_accelerator","description":"Enable the AI Accelerator product.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"ai_accelerator\",\"object\":\"product\"},\"customer\":{\"id\":\"WioEuN2Pp8TCBwEyfFMuG7\",\"object\":\"customer\"},\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/ai_accelerator\"}}"}],"_postman_id":"623fee8c-2537-4a16-9b00-00e6bf9985a1"},{"name":"Disable product","id":"1b73f2ae-d3c7-4a05-bf14-d7f3af4ba67c","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/enabled-products/v1/ai_accelerator","description":"<p>Disable the AI Accelerator product.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","ai_accelerator"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"2569047a-90be-4fda-92b2-5f2503c42485","name":"204 No Content","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/enabled-products/v1/ai_accelerator","description":"Disable the AI Accelerator product.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 No Content","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"1b73f2ae-d3c7-4a05-bf14-d7f3af4ba67c"}],"id":"ed28150d-e9a0-4762-9193-9c11e2b469e5","description":"<p>These endpoints allow you to enable, disable, and check the enablement status of the AI Accelerator product on your customer account.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"ed28150d-e9a0-4762-9193-9c11e2b469e5"},{"name":"API Discovery","item":[{"name":"Get product enablement status","id":"1499fd36-b270-49fc-a566-34643bd83dfc","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/api_discovery/services/{{service_id}}","description":"<p>Get the enablement status of the API Discovery product on a service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","api_discovery","services","{{service_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"65b17ff6-e41e-47fa-b38e-75293493ed27","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/api_discovery/services/SU1Z0isxPaozGVKXdv0eY","description":"Get the enablement status of the API Discovery product on a service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"api_discovery\",\"object\":\"product\"},\"service\":{\"id\":\"4nWURjwmQjbMB5OefSM75i\",\"object\":\"service\"},\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/api_discovery/services/4nWURjwmQjbMB5OefSM75i\"}}"}],"_postman_id":"1499fd36-b270-49fc-a566-34643bd83dfc"},{"name":"Enable product","id":"f3e27f0f-215b-4f16-a3ea-e577c2496b71","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/api_discovery/services/{{service_id}}","description":"<p>Enable the API Discovery product on a service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","api_discovery","services","{{service_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"72bcccea-c116-46bc-a0c8-4df30fc1f0c9","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/api_discovery/services/SU1Z0isxPaozGVKXdv0eY","description":"Enable the API Discovery product on a service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"api_discovery\",\"object\":\"product\"},\"service\":{\"id\":\"4nWURjwmQjbMB5OefSM75i\",\"object\":\"service\"},\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/api_discovery/services/4nWURjwmQjbMB5OefSM75i\"}}"}],"_postman_id":"f3e27f0f-215b-4f16-a3ea-e577c2496b71"},{"name":"Disable product","id":"8f41c83e-cd2b-4d4a-9c5d-a4ec46098c0a","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/enabled-products/v1/api_discovery/services/{{service_id}}","description":"<p>Disable the API Discovery product on a service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","api_discovery","services","{{service_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"4493cb88-9f7f-43c4-a29c-c5be59344c56","name":"204 No Content","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/enabled-products/v1/api_discovery/services/SU1Z0isxPaozGVKXdv0eY","description":"Disable the API Discovery product on a service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 No Content","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"8f41c83e-cd2b-4d4a-9c5d-a4ec46098c0a"},{"name":"Get services with product enabled","id":"31c1c084-557d-4d0e-9194-76bfe2f910f3","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/api_discovery/services","description":"<p>Get all the services for a customer that has the API Discovery product enabled.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","api_discovery","services"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"f2b4318b-a311-4f00-8248-7aa7f961a54b","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/api_discovery/services","description":"Get all the services for a customer that has the API Discovery product enabled.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"api_discovery\",\"object\":\"product\"},\"customer\":{\"id\":\"customer_id\",\"object\":\"customer\"},\"services\":[\"4nWURjwmQjbMB5OefSM75i\",\"3krg2uUGZzb2W9Euo4moOY\"],\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/api_discovery/services\"}}"}],"_postman_id":"31c1c084-557d-4d0e-9194-76bfe2f910f3"}],"id":"12e56503-bb9d-400a-9ab8-12000a6d401b","description":"<p>These endpoints allow you to enable, disable, and check the enablement status of the API Discovery product on your services.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>services</td>\n<td>array</td>\n<td>A list of services for a customer with API Discovery enabled.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"12e56503-bb9d-400a-9ab8-12000a6d401b"},{"name":"Bot Management","item":[{"name":"Get product enablement status","id":"d2b92625-9c14-4322-ac5b-08043fe8b570","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/bot_management/services/{{service_id}}","description":"<p>Get the enablement status of the Bot Management product on a service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","bot_management","services","{{service_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"e21ffad3-f87f-4291-ad03-6e48195acc9c","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/bot_management/services/SU1Z0isxPaozGVKXdv0eY","description":"Get the enablement status of the Bot Management product on a service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"bot_management\",\"object\":\"product\"},\"service\":{\"id\":\"4nWURjwmQjbMB5OefSM75i\",\"object\":\"service\"},\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/bot_management/services/4nWURjwmQjbMB5OefSM75i\",\"service\":\"https://api.fastly.com/service/4nWURjwmQjbMB5OefSM75i\"}}"}],"_postman_id":"d2b92625-9c14-4322-ac5b-08043fe8b570"},{"name":"Enable product","id":"68058b77-03f5-43e5-a213-eca1d05ce461","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/bot_management/services/{{service_id}}","description":"<p>Enable the Bot Management product on a service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","bot_management","services","{{service_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"e13bf8f0-2de9-48fa-a6ec-650f193049b7","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/bot_management/services/SU1Z0isxPaozGVKXdv0eY","description":"Enable the Bot Management product on a service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"bot_management\",\"object\":\"product\"},\"service\":{\"id\":\"4nWURjwmQjbMB5OefSM75i\",\"object\":\"service\"},\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/bot_management/services/4nWURjwmQjbMB5OefSM75i\",\"service\":\"https://api.fastly.com/service/4nWURjwmQjbMB5OefSM75i\"}}"}],"_postman_id":"68058b77-03f5-43e5-a213-eca1d05ce461"},{"name":"Disable product","id":"613df0b9-8509-4647-b3fc-c63c1015575a","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/enabled-products/v1/bot_management/services/{{service_id}}","description":"<p>Disable the Bot Management product on a service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","bot_management","services","{{service_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"312e4ddb-974c-4241-ba7c-64ed72b2cdee","name":"204 No Content","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/enabled-products/v1/bot_management/services/SU1Z0isxPaozGVKXdv0eY","description":"Disable the Bot Management product on a service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 No Content","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"613df0b9-8509-4647-b3fc-c63c1015575a"},{"name":"Get configuration","id":"6219546f-5219-4b69-805b-b66531cda04d","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/bot_management/services/{{service_id}}/configuration","description":"<p>Get the configuration of the Bot Management product on a service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","bot_management","services","{{service_id}}","configuration"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"2573610c-7c4f-4405-836b-a590e8187878","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/bot_management/services/SU1Z0isxPaozGVKXdv0eY/configuration","description":"Get the configuration of the Bot Management product on a service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"bot_management\",\"object\":\"product\"},\"service\":{\"id\":\"4nWURjwmQjbMB5OefSM75i\",\"object\":\"service\"},\"configuration\":{\"contentguard\":\"on\"},\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/bot_management/services/4nWURjwmQjbMB5OefSM75i\",\"service\":\"https://api.fastly.com/service/4nWURjwmQjbMB5OefSM75i\"}}"}],"_postman_id":"6219546f-5219-4b69-805b-b66531cda04d"},{"name":"Update configuration","id":"b2598e83-705e-4d79-8030-0d6bd3f6ee74","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"contentguard\":\"on\"}"},"url":"https://api.fastly.com/enabled-products/v1/bot_management/services/{{service_id}}/configuration","description":"<p>Update the configuration of the Bot Management product on a service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","bot_management","services","{{service_id}}","configuration"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"f2e1c1d0-4e16-488c-aaa2-5f9233247219","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"contentguard\":\"on\"}"},"url":"https://api.fastly.com/enabled-products/v1/bot_management/services/SU1Z0isxPaozGVKXdv0eY/configuration","description":"Update the configuration of the Bot Management product on a service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"bot_management\",\"object\":\"product\"},\"service\":{\"id\":\"4nWURjwmQjbMB5OefSM75i\",\"object\":\"service\"},\"configuration\":{\"contentguard\":\"on\"},\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/bot_management/services/4nWURjwmQjbMB5OefSM75i\",\"service\":\"https://api.fastly.com/service/4nWURjwmQjbMB5OefSM75i\"}}"}],"_postman_id":"b2598e83-705e-4d79-8030-0d6bd3f6ee74"},{"name":"Get services with product enabled","id":"43b70c07-db0e-4d99-af7d-31a0a1d98f30","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/bot_management/services","description":"<p>Get all the services which have the Bot Management product enabled.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","bot_management","services"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"a9181e8f-01a1-459b-bdab-1bfe867c2fcd","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/bot_management/services","description":"Get all the services which have the Bot Management product enabled.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"bot_management\",\"object\":\"product\"},\"customer\":{\"id\":\"customer_id\",\"object\":\"customer\"},\"services\":[\"4nWURjwmQjbMB5OefSM75i\",\"3krg2uUGZzb2W9Euo4moOY\"],\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/bot_management/services\"}}"}],"_postman_id":"43b70c07-db0e-4d99-af7d-31a0a1d98f30"}],"id":"9bf81680-033e-427d-95d0-50aceb053926","description":"<p>These endpoints allow you to enable, disable, and check the enablement status of the Bot Management product on your services.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>services</td>\n<td>array</td>\n<td>A list of services with Bot Management enabled.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-1\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>contentguard</td>\n<td>string</td>\n<td>ContentGuard status.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"9bf81680-033e-427d-95d0-50aceb053926"},{"name":"Brotli Compression","item":[{"name":"Get product enablement status","id":"a864f6e9-6566-4d17-960d-cc6e8052d22f","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/brotli_compression/services/{{service_id}}","description":"<p>Get the enablement status of the Brotli Compression product on a service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","brotli_compression","services","{{service_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"86ea96a2-4502-484c-b309-275561174211","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/brotli_compression/services/SU1Z0isxPaozGVKXdv0eY","description":"Get the enablement status of the Brotli Compression product on a service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"brotli_compression\",\"object\":\"product\"},\"service\":{\"id\":\"4nWURjwmQjbMB5OefSM75i\",\"object\":\"service\"},\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/brotli_compression/services/4nWURjwmQjbMB5OefSM75i\",\"service\":\"https://api.fastly.com/service/4nWURjwmQjbMB5OefSM75i\"}}"}],"_postman_id":"a864f6e9-6566-4d17-960d-cc6e8052d22f"},{"name":"Enable product","id":"3980bdef-1d3b-4e98-9708-6277bf4ddb94","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/brotli_compression/services/{{service_id}}","description":"<p>Enable the Brotli Compression product on a service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","brotli_compression","services","{{service_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"1953dd8a-e7ec-448f-a025-e45ee67a6544","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/brotli_compression/services/SU1Z0isxPaozGVKXdv0eY","description":"Enable the Brotli Compression product on a service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"brotli_compression\",\"object\":\"product\"},\"service\":{\"id\":\"4nWURjwmQjbMB5OefSM75i\",\"object\":\"service\"},\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/brotli_compression/services/4nWURjwmQjbMB5OefSM75i\",\"service\":\"https://api.fastly.com/service/4nWURjwmQjbMB5OefSM75i\"}}"}],"_postman_id":"3980bdef-1d3b-4e98-9708-6277bf4ddb94"},{"name":"Disable product","id":"579ee893-a928-4570-a43a-270c7d02d6bd","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/enabled-products/v1/brotli_compression/services/{{service_id}}","description":"<p>Disable the Brotli Compression product on a service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","brotli_compression","services","{{service_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"78996ddb-5de0-49d6-a296-da06d104ad27","name":"204 No Content","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/enabled-products/v1/brotli_compression/services/SU1Z0isxPaozGVKXdv0eY","description":"Disable the Brotli Compression product on a service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 No Content","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"579ee893-a928-4570-a43a-270c7d02d6bd"},{"name":"Get services with product enabled","id":"3cf14d00-3cbe-4b2d-901e-4a31912b78d1","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/brotli_compression/services","description":"<p>Get all the services which have the Brotli Compression product enabled.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","brotli_compression","services"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"79493ebb-40bc-4a09-a076-18d4c86bdca9","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/brotli_compression/services","description":"Get all the services which have the Brotli Compression product enabled.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"brotli_compression\",\"object\":\"product\"},\"customer\":{\"id\":\"customer_id\",\"object\":\"customer\"},\"services\":[\"4nWURjwmQjbMB5OefSM75i\",\"3krg2uUGZzb2W9Euo4moOY\"],\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/brotli_compression/services\"}}"}],"_postman_id":"3cf14d00-3cbe-4b2d-901e-4a31912b78d1"}],"id":"b49b0670-7c2c-4fff-a5bc-7ba036b037a5","description":"<p>These endpoints allow you to enable, disable, and check the enablement status of the Brotli Compression product on your services.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>services</td>\n<td>array</td>\n<td>A list of services with Brotli Compression enabled.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"b49b0670-7c2c-4fff-a5bc-7ba036b037a5"},{"name":"DDoS Protection","item":[{"name":"Get product enablement status","id":"f0c5547e-2d4c-493a-acbc-fd8f29565ca6","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/ddos_protection/services/{{service_id}}","description":"<p>Get the enablement status of the DDoS Protection product on a service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","ddos_protection","services","{{service_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"dd200375-d451-4c83-ac9e-10351c8d13f3","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/ddos_protection/services/SU1Z0isxPaozGVKXdv0eY","description":"Get the enablement status of the DDoS Protection product on a service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"ddos_protection\",\"object\":\"product\"},\"service\":{\"id\":\"4nWURjwmQjbMB5OefSM75i\",\"object\":\"service\"},\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/ddos_protection/services/4nWURjwmQjbMB5OefSM75i\",\"service\":\"https://api.fastly.com/service/4nWURjwmQjbMB5OefSM75i\"}}"}],"_postman_id":"f0c5547e-2d4c-493a-acbc-fd8f29565ca6"},{"name":"Enable product","id":"28dbdcf8-b0c8-4342-bb00-1be925eb81ed","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"mode\":\"block\"}"},"url":"https://api.fastly.com/enabled-products/v1/ddos_protection/services/{{service_id}}","description":"<p>Enable the DDoS Protection product on a service in default 'log' mode unless otherwise specified in the request body.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","ddos_protection","services","{{service_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"e25a3e2b-273c-4fe8-8648-66d0544bf13e","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"mode\":\"block\"}"},"url":"https://api.fastly.com/enabled-products/v1/ddos_protection/services/SU1Z0isxPaozGVKXdv0eY","description":"Enable the DDoS Protection product on a service in default 'log' mode unless otherwise specified in the request body.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"ddos_protection\",\"object\":\"product\"},\"service\":{\"id\":\"4nWURjwmQjbMB5OefSM75i\",\"object\":\"service\"},\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/ddos_protection/services/4nWURjwmQjbMB5OefSM75i\",\"service\":\"https://api.fastly.com/service/4nWURjwmQjbMB5OefSM75i\"}}"}],"_postman_id":"28dbdcf8-b0c8-4342-bb00-1be925eb81ed"},{"name":"Disable product","id":"33a2c770-c678-426f-bb0e-8d92c9912194","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/enabled-products/v1/ddos_protection/services/{{service_id}}","description":"<p>Disable the DDoS Protection product on a service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","ddos_protection","services","{{service_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"ce888f5a-8b86-473d-b5f0-6c7eaa91e3df","name":"204 No Content","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/enabled-products/v1/ddos_protection/services/SU1Z0isxPaozGVKXdv0eY","description":"Disable the DDoS Protection product on a service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 No Content","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"33a2c770-c678-426f-bb0e-8d92c9912194"},{"name":"Get configuration","id":"f18aa799-653a-4030-b099-b46741c01ce5","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/ddos_protection/services/{{service_id}}/configuration","description":"<p>Get configuration of the DDoS Protection product on a service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","ddos_protection","services","{{service_id}}","configuration"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"d6cc3de4-54a5-4656-9bb1-2848e9145214","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/ddos_protection/services/SU1Z0isxPaozGVKXdv0eY/configuration","description":"Get configuration of the DDoS Protection product on a service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"ddos_protection\",\"object\":\"product\"},\"service\":{\"id\":\"4nWURjwmQjbMB5OefSM75i\",\"object\":\"service\"},\"configuration\":{\"mode\":\"log\"},\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/ddos_protection/services/4nWURjwmQjbMB5OefSM75i\",\"service\":\"https://api.fastly.com/service/4nWURjwmQjbMB5OefSM75i\"}}"}],"_postman_id":"f18aa799-653a-4030-b099-b46741c01ce5"},{"name":"Update configuration","id":"a3747396-783b-417a-843d-179675df067f","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"mode\":\"log\"}"},"url":"https://api.fastly.com/enabled-products/v1/ddos_protection/services/{{service_id}}/configuration","description":"<p>Update configuration of the DDoS Protection product on a service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","ddos_protection","services","{{service_id}}","configuration"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"d14f02a8-eb9a-49ce-a6cc-9113e7287bb6","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"mode\":\"log\"}"},"url":"https://api.fastly.com/enabled-products/v1/ddos_protection/services/SU1Z0isxPaozGVKXdv0eY/configuration","description":"Update configuration of the DDoS Protection product on a service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"ddos_protection\",\"object\":\"product\"},\"service\":{\"id\":\"4nWURjwmQjbMB5OefSM75i\",\"object\":\"service\"},\"configuration\":{\"mode\":\"log\"},\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/ddos_protection/services/4nWURjwmQjbMB5OefSM75i\",\"service\":\"https://api.fastly.com/service/4nWURjwmQjbMB5OefSM75i\"}}"}],"_postman_id":"a3747396-783b-417a-843d-179675df067f"},{"name":"Get services with product enabled","id":"b0af1813-1ca3-44bb-8362-87992a333d54","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/ddos_protection/services","description":"<p>Get all the services which have the DDoS Protection product enabled.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","ddos_protection","services"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"24d4759b-dcf6-4ba2-9fd4-fb56a480ead4","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/ddos_protection/services","description":"Get all the services which have the DDoS Protection product enabled.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"ddos_protection\",\"object\":\"product\"},\"customer\":{\"id\":\"customer_id\",\"object\":\"customer\"},\"services\":[\"4nWURjwmQjbMB5OefSM75i\",\"3krg2uUGZzb2W9Euo4moOY\"],\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/ddos_protection/services\"}}"}],"_postman_id":"b0af1813-1ca3-44bb-8362-87992a333d54"}],"id":"2e3c95ad-f042-4a95-9ff0-580045283ea4","description":"<p>These endpoints allow you to enable, disable, configure, and check the enablement and configuration status of the DDoS Protection product on your services.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>services</td>\n<td>array</td>\n<td>A list of services with DDoS Protection enabled.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-1\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>mode</td>\n<td>string</td>\n<td>Operation mode.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-2\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>mode</td>\n<td>string</td>\n<td>Operation mode.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"2e3c95ad-f042-4a95-9ff0-580045283ea4"},{"name":"Domain Inspector","item":[{"name":"Get product enablement status","id":"38c0a344-9fb2-4755-bc0c-7b9b6d385698","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/domain_inspector/services/{{service_id}}","description":"<p>Get the enablement status of the Domain Inspector product on a service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","domain_inspector","services","{{service_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"3ad53eb5-e0b8-47e3-b9d3-26a609f13929","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/domain_inspector/services/SU1Z0isxPaozGVKXdv0eY","description":"Get the enablement status of the Domain Inspector product on a service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"domain_inspector\",\"object\":\"product\"},\"service\":{\"id\":\"4nWURjwmQjbMB5OefSM75i\",\"object\":\"service\"},\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/domain_inspector/services/4nWURjwmQjbMB5OefSM75i\",\"service\":\"https://api.fastly.com/service/4nWURjwmQjbMB5OefSM75i\"}}"}],"_postman_id":"38c0a344-9fb2-4755-bc0c-7b9b6d385698"},{"name":"Enable product","id":"eea0b547-950b-4480-b382-bd1935c16e5e","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/domain_inspector/services/{{service_id}}","description":"<p>Enable the Domain Inspector product on a service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","domain_inspector","services","{{service_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"cdf81d48-9377-4071-8b12-ccdebe0f7bcf","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/domain_inspector/services/SU1Z0isxPaozGVKXdv0eY","description":"Enable the Domain Inspector product on a service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"domain_inspector\",\"object\":\"product\"},\"service\":{\"id\":\"4nWURjwmQjbMB5OefSM75i\",\"object\":\"service\"},\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/domain_inspector/services/4nWURjwmQjbMB5OefSM75i\",\"service\":\"https://api.fastly.com/service/4nWURjwmQjbMB5OefSM75i\"}}"}],"_postman_id":"eea0b547-950b-4480-b382-bd1935c16e5e"},{"name":"Disable product","id":"f049abf1-929e-4628-adab-030c5f45dd10","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/enabled-products/v1/domain_inspector/services/{{service_id}}","description":"<p>Disable the Domain Inspector product on a service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","domain_inspector","services","{{service_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"c02fd713-0aa9-407f-b616-3228adc76eeb","name":"204 No Content","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/enabled-products/v1/domain_inspector/services/SU1Z0isxPaozGVKXdv0eY","description":"Disable the Domain Inspector product on a service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 No Content","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"f049abf1-929e-4628-adab-030c5f45dd10"},{"name":"Get services with product enabled","id":"7e51315d-c28f-4244-b781-e5137f6f7fc6","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/domain_inspector/services","description":"<p>Get all the services which have the Domain Inspector product enabled.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","domain_inspector","services"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"b657603f-c3e5-4902-b645-82673cef7d1c","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/domain_inspector/services","description":"Get all the services which have the Domain Inspector product enabled.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"domain_inspector\",\"object\":\"product\"},\"customer\":{\"id\":\"customer_id\",\"object\":\"customer\"},\"services\":[\"4nWURjwmQjbMB5OefSM75i\",\"3krg2uUGZzb2W9Euo4moOY\"],\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/domain_inspector/services\"}}"}],"_postman_id":"7e51315d-c28f-4244-b781-e5137f6f7fc6"}],"id":"f4b745ba-6010-49d2-ac2f-b24d391da9fc","description":"<p>These endpoints allow you to enable, disable, and check the enablement status of the Domain Inspector product on your services.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>services</td>\n<td>array</td>\n<td>A list of services with Domain Inspector enabled.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"f4b745ba-6010-49d2-ac2f-b24d391da9fc"},{"name":"Domain Research","item":[{"name":"Get product enablement status","id":"79978ee4-0c8a-4c57-bd35-5a8ced5985d6","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/domain_research","description":"<p>Get the enablement status of the Domain Research product.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","domain_research"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"4f16f0d5-b5ba-4c69-aead-93c3e63ffe8e","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/domain_research","description":"Get the enablement status of the Domain Research product.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"domain_research\",\"object\":\"product\"},\"customer\":{\"id\":\"WioEuN2Pp8TCBwEyfFMuG7\",\"object\":\"customer\"},\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/domain_research\"}}"}],"_postman_id":"79978ee4-0c8a-4c57-bd35-5a8ced5985d6"},{"name":"Enable product","id":"0f1d7063-9a54-47a2-a3ab-451589da5b15","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/domain_research","description":"<p>Enable the Domain Research product.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","domain_research"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"ada23164-fc6a-4114-a90e-4641fbef532f","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/domain_research","description":"Enable the Domain Research product.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"domain_research\",\"object\":\"product\"},\"customer\":{\"id\":\"WioEuN2Pp8TCBwEyfFMuG7\",\"object\":\"customer\"},\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/domain_research\"}}"}],"_postman_id":"0f1d7063-9a54-47a2-a3ab-451589da5b15"},{"name":"Disable product","id":"777432f6-b99a-4ece-8bde-b57b3dfeedd9","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/enabled-products/v1/domain_research","description":"<p>Disable the Domain Research product.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","domain_research"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"e7a81026-026a-4a77-853f-f8bb4dde39ff","name":"204 No Content","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/enabled-products/v1/domain_research","description":"Disable the Domain Research product.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 No Content","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"777432f6-b99a-4ece-8bde-b57b3dfeedd9"}],"id":"f9126a9e-e67c-456d-8bbb-0b20d0156603","description":"<p>These endpoints allow you to enable, disable, and check the enablement status of the Domain Research API product on your customer account.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"f9126a9e-e67c-456d-8bbb-0b20d0156603"},{"name":"Fanout","item":[{"name":"Get product enablement status","id":"e330c40c-980f-4f0f-a2fb-4b12fc421103","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/fanout/services/{{service_id}}","description":"<p>Get the enablement status of the Fanout product on a service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","fanout","services","{{service_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"2d462de1-7719-406e-9358-7c393a8803e4","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/fanout/services/SU1Z0isxPaozGVKXdv0eY","description":"Get the enablement status of the Fanout product on a service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"fanout\",\"object\":\"product\"},\"service\":{\"id\":\"4nWURjwmQjbMB5OefSM75i\",\"object\":\"service\"},\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/fanout/services/4nWURjwmQjbMB5OefSM75i\",\"service\":\"https://api.fastly.com/service/4nWURjwmQjbMB5OefSM75i\"}}"}],"_postman_id":"e330c40c-980f-4f0f-a2fb-4b12fc421103"},{"name":"Enable product","id":"d36ac8ca-788a-4eb1-a9cb-bb0961d6986f","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/fanout/services/{{service_id}}","description":"<p>Enable the Fanout product on a service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","fanout","services","{{service_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"4f0a3444-3bc3-49bf-b484-470325b662bc","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/fanout/services/SU1Z0isxPaozGVKXdv0eY","description":"Enable the Fanout product on a service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"fanout\",\"object\":\"product\"},\"service\":{\"id\":\"4nWURjwmQjbMB5OefSM75i\",\"object\":\"service\"},\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/fanout/services/4nWURjwmQjbMB5OefSM75i\",\"service\":\"https://api.fastly.com/service/4nWURjwmQjbMB5OefSM75i\"}}"}],"_postman_id":"d36ac8ca-788a-4eb1-a9cb-bb0961d6986f"},{"name":"Disable product","id":"ce3944cb-b415-4bfe-88e6-9b69c5f10fff","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/enabled-products/v1/fanout/services/{{service_id}}","description":"<p>Disable the Fanout product on a service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","fanout","services","{{service_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"780fc1d6-f259-47f9-83e0-1ead9aa42b38","name":"204 No Content","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/enabled-products/v1/fanout/services/SU1Z0isxPaozGVKXdv0eY","description":"Disable the Fanout product on a service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 No Content","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"ce3944cb-b415-4bfe-88e6-9b69c5f10fff"},{"name":"Get services with product enabled","id":"0847baa9-d257-42a8-ac7e-75ca3b9547b9","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/fanout/services","description":"<p>Get all the services which have the Fanout product enabled.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","fanout","services"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"2e524584-7515-440c-b154-5774d827a53e","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/fanout/services","description":"Get all the services which have the Fanout product enabled.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"fanout\",\"object\":\"product\"},\"customer\":{\"id\":\"customer_id\",\"object\":\"customer\"},\"services\":[\"4nWURjwmQjbMB5OefSM75i\",\"3krg2uUGZzb2W9Euo4moOY\"],\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/fanout/services\"}}"}],"_postman_id":"0847baa9-d257-42a8-ac7e-75ca3b9547b9"}],"id":"12398569-255f-4346-98f8-c77dc3ae1ff1","description":"<p>These endpoints allow you to enable, disable, and check the enablement status of the Fanout product on your services.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>services</td>\n<td>array</td>\n<td>A list of services with Fanout enabled.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"12398569-255f-4346-98f8-c77dc3ae1ff1"},{"name":"Image Optimizer","item":[{"name":"Get product enablement status","id":"ffb9465f-5c6e-4905-ae2b-1f684dadbc5e","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/image_optimizer/services/{{service_id}}","description":"<p>Get the enablement status of the Image Optimizer product on a service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","image_optimizer","services","{{service_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"519ac13c-7468-4f78-a52e-2a056a3de3ce","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/image_optimizer/services/SU1Z0isxPaozGVKXdv0eY","description":"Get the enablement status of the Image Optimizer product on a service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"image_optimizer\",\"object\":\"product\"},\"service\":{\"id\":\"4nWURjwmQjbMB5OefSM75i\",\"object\":\"service\"},\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/image_optimizer/services/4nWURjwmQjbMB5OefSM75i\",\"service\":\"https://api.fastly.com/service/4nWURjwmQjbMB5OefSM75i\"}}"}],"_postman_id":"ffb9465f-5c6e-4905-ae2b-1f684dadbc5e"},{"name":"Enable product","id":"ee69a029-cb79-432a-a6b9-90d600eab413","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/image_optimizer/services/{{service_id}}","description":"<p>Enable the Image Optimizer product on a service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","image_optimizer","services","{{service_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"83df2931-27d5-4739-be63-430a2aea1d67","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/image_optimizer/services/SU1Z0isxPaozGVKXdv0eY","description":"Enable the Image Optimizer product on a service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"image_optimizer\",\"object\":\"product\"},\"service\":{\"id\":\"4nWURjwmQjbMB5OefSM75i\",\"object\":\"service\"},\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/image_optimizer/services/4nWURjwmQjbMB5OefSM75i\",\"service\":\"https://api.fastly.com/service/4nWURjwmQjbMB5OefSM75i\"}}"}],"_postman_id":"ee69a029-cb79-432a-a6b9-90d600eab413"},{"name":"Disable product","id":"c222d5b4-abfb-497b-bf52-488d1d00d2c9","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/enabled-products/v1/image_optimizer/services/{{service_id}}","description":"<p>Disable the Image Optimizer product on a service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","image_optimizer","services","{{service_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"77f28932-69f3-4481-af10-961c1e20f6d8","name":"204 No Content","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/enabled-products/v1/image_optimizer/services/SU1Z0isxPaozGVKXdv0eY","description":"Disable the Image Optimizer product on a service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 No Content","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"c222d5b4-abfb-497b-bf52-488d1d00d2c9"},{"name":"Get services with product enabled","id":"255872cf-6d63-40cf-b080-975b21230e54","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/image_optimizer/services","description":"<p>Get all the services which have the Image Optimizer product enabled.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","image_optimizer","services"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"d169185a-9547-4cf4-8cd9-4c8d248fbac9","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/image_optimizer/services","description":"Get all the services which have the Image Optimizer product enabled.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"image_optimizer\",\"object\":\"product\"},\"customer\":{\"id\":\"customer_id\",\"object\":\"customer\"},\"services\":[\"4nWURjwmQjbMB5OefSM75i\",\"3krg2uUGZzb2W9Euo4moOY\"],\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/image_optimizer/services\"}}"}],"_postman_id":"255872cf-6d63-40cf-b080-975b21230e54"}],"id":"d0dc6636-cc77-4b34-b508-a9d3d226320c","description":"<p>These endpoints allow you to enable, disable, and check the enablement status of the Image Optimizer product on your services.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>services</td>\n<td>array</td>\n<td>A list of services with Image Optimizer enabled.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"d0dc6636-cc77-4b34-b508-a9d3d226320c"},{"name":"KV Store","item":[{"name":"Get product enablement status","id":"8140a7b7-7118-4f21-af5f-c6ee66961c4d","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/kv_store","description":"<p>Get the enablement status of the KV Store product.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","kv_store"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"23e14019-eef4-4caf-8c8c-a980a774b01e","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/kv_store","description":"Get the enablement status of the KV Store product.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"kv_store\",\"object\":\"product\"},\"customer\":{\"id\":\"WioEuN2Pp8TCBwEyfFMuG7\",\"object\":\"customer\"},\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/kv_store\"}}"}],"_postman_id":"8140a7b7-7118-4f21-af5f-c6ee66961c4d"},{"name":"Enable product","id":"8139e125-caf3-4048-ab1d-a54465208da1","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/kv_store","description":"<p>Enable the KV Store product.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","kv_store"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"c2af653f-cc4b-48e6-8537-05fe3f570955","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/kv_store","description":"Enable the KV Store product.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"kv_store\",\"object\":\"product\"},\"customer\":{\"id\":\"WioEuN2Pp8TCBwEyfFMuG7\",\"object\":\"customer\"},\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/kv_store\"}}"}],"_postman_id":"8139e125-caf3-4048-ab1d-a54465208da1"},{"name":"Disable product","id":"b2c6877f-dfba-4448-84f8-0c670c068281","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/enabled-products/v1/kv_store","description":"<p>Disable the KV Store product.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","kv_store"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"0b1482c0-3a81-4338-bc51-72394930c390","name":"204 No Content","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/enabled-products/v1/kv_store","description":"Disable the KV Store product.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 No Content","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"b2c6877f-dfba-4448-84f8-0c670c068281"}],"id":"8c609295-88e0-44b0-8020-98b43d01b8f8","description":"<p>These endpoints allow you to enable, disable, and check the enablement status of the KV Store product on your customer account.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"8c609295-88e0-44b0-8020-98b43d01b8f8"},{"name":"Log Explorer & Insights","item":[{"name":"Get product enablement status","id":"79ba1f24-a95e-4411-be2a-6ab0dffbfa6f","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/log_explorer_insights/services/{{service_id}}","description":"<p>Get the enablement status of the Log Explorer &amp; Insights product on a service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","log_explorer_insights","services","{{service_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"fe8ae3f7-d91c-4344-af2a-b041fd5e67ba","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/log_explorer_insights/services/SU1Z0isxPaozGVKXdv0eY","description":"Get the enablement status of the Log Explorer & Insights product on a service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"log_explorer_insights\",\"object\":\"product\"},\"service\":{\"id\":\"4nWURjwmQjbMB5OefSM75i\",\"object\":\"service\"},\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/log_explorer_insights/services/4nWURjwmQjbMB5OefSM75i\",\"service\":\"https://api.fastly.com/service/4nWURjwmQjbMB5OefSM75i\"}}"}],"_postman_id":"79ba1f24-a95e-4411-be2a-6ab0dffbfa6f"},{"name":"Enable product","id":"7eabbb50-d6b0-477a-bf62-072cb2c72b5a","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/log_explorer_insights/services/{{service_id}}","description":"<p>Enable the Log Explorer &amp; Insights product on a service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","log_explorer_insights","services","{{service_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"0a35accb-3a9a-4c65-b69b-bb38acfae2b5","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/log_explorer_insights/services/SU1Z0isxPaozGVKXdv0eY","description":"Enable the Log Explorer & Insights product on a service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"log_explorer_insights\",\"object\":\"product\"},\"service\":{\"id\":\"4nWURjwmQjbMB5OefSM75i\",\"object\":\"service\"},\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/log_explorer_insights/services/4nWURjwmQjbMB5OefSM75i\",\"service\":\"https://api.fastly.com/service/4nWURjwmQjbMB5OefSM75i\"}}"}],"_postman_id":"7eabbb50-d6b0-477a-bf62-072cb2c72b5a"},{"name":"Disable product","id":"d0a1e981-f24f-4117-89a8-134613962e36","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/enabled-products/v1/log_explorer_insights/services/{{service_id}}","description":"<p>Disable the Log Explorer &amp; Insights product on a service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","log_explorer_insights","services","{{service_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"a97771df-0c78-47cc-9167-b45d6e940ded","name":"204 No Content","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/enabled-products/v1/log_explorer_insights/services/SU1Z0isxPaozGVKXdv0eY","description":"Disable the Log Explorer & Insights product on a service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 No Content","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"d0a1e981-f24f-4117-89a8-134613962e36"},{"name":"Get services with product enabled","id":"ee77620a-3fae-47d1-a7b2-d6656b715939","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/log_explorer_insights/services","description":"<p>Get all the services which have the Log Explorer &amp; Insights product enabled.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","log_explorer_insights","services"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"f8d2082a-5a43-4850-a0b9-b1c978d2b683","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/log_explorer_insights/services","description":"Get all the services which have the Log Explorer & Insights product enabled.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"log_explorer_insights\",\"object\":\"product\"},\"customer\":{\"id\":\"customer_id\",\"object\":\"customer\"},\"services\":[\"4nWURjwmQjbMB5OefSM75i\",\"3krg2uUGZzb2W9Euo4moOY\"],\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/log_explorer_insights/services\"}}"}],"_postman_id":"ee77620a-3fae-47d1-a7b2-d6656b715939"}],"id":"021a0577-858c-45fa-af49-a7f87d652409","description":"<p>These endpoints allow you to enable, disable, and check the enablement status of the Log Explorer &amp; Insights product on your services.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>services</td>\n<td>array</td>\n<td>A ist of services with Log Explorer &amp; Insights enabled.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"021a0577-858c-45fa-af49-a7f87d652409"},{"name":"Next-Gen WAF","item":[{"name":"Get product enablement status","id":"e9940fe4-2a5e-43e3-88bd-0d35cbcb3c61","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/ngwaf/services/{{service_id}}","description":"<p>Get the enablement status of the Next-Gen WAF product on a service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","ngwaf","services","{{service_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"8b9197b9-fb7a-4e88-b375-038a3e43ce04","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/ngwaf/services/SU1Z0isxPaozGVKXdv0eY","description":"Get the enablement status of the Next-Gen WAF product on a service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"ngwaf\",\"object\":\"product\"},\"service\":{\"id\":\"4nWURjwmQjbMB5OefSM75i\",\"object\":\"service\"},\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/ngwaf/services/4nWURjwmQjbMB5OefSM75i\",\"service\":\"https://api.fastly.com/service/4nWURjwmQjbMB5OefSM75i\"}}"}],"_postman_id":"e9940fe4-2a5e-43e3-88bd-0d35cbcb3c61"},{"name":"Enable product","id":"46938468-0957-412a-bd65-1aa34fc2abd6","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"workspace_id\":\"7JFbo4RNA0OKdFWC04r6B3\"}"},"url":"https://api.fastly.com/enabled-products/v1/ngwaf/services/{{service_id}}","description":"<p>Enable the Next-Gen WAF product on a service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","ngwaf","services","{{service_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"b333f3cb-a040-4f70-b1b9-68c311ae00ca","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"workspace_id\":\"7JFbo4RNA0OKdFWC04r6B3\"}"},"url":"https://api.fastly.com/enabled-products/v1/ngwaf/services/SU1Z0isxPaozGVKXdv0eY","description":"Enable the Next-Gen WAF product on a service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"ngwaf\",\"object\":\"product\"},\"service\":{\"id\":\"4nWURjwmQjbMB5OefSM75i\",\"object\":\"service\"},\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/ngwaf/services/4nWURjwmQjbMB5OefSM75i\",\"service\":\"https://api.fastly.com/service/4nWURjwmQjbMB5OefSM75i\"}}"}],"_postman_id":"46938468-0957-412a-bd65-1aa34fc2abd6"},{"name":"Disable product","id":"5fe0916d-7130-41bf-8cd1-7ca40cb1b182","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/enabled-products/v1/ngwaf/services/{{service_id}}","description":"<p>Disable the Next-Gen WAF product on a service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","ngwaf","services","{{service_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"494cb2dd-ef2a-4a0d-8c60-f56e29bc227d","name":"204 No Content","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/enabled-products/v1/ngwaf/services/SU1Z0isxPaozGVKXdv0eY","description":"Disable the Next-Gen WAF product on a service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 No Content","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"5fe0916d-7130-41bf-8cd1-7ca40cb1b182"},{"name":"Get configuration","id":"3d0fad1e-08b1-444c-9390-532b2ff097e2","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/ngwaf/services/{{service_id}}/configuration","description":"<p>Get configuration of the Next-Gen WAF product on a service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","ngwaf","services","{{service_id}}","configuration"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"f9feb9bd-885c-4bba-94fc-caa0e859dfaa","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/ngwaf/services/SU1Z0isxPaozGVKXdv0eY/configuration","description":"Get configuration of the Next-Gen WAF product on a service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"ngwaf\",\"object\":\"product\"},\"service\":{\"id\":\"4nWURjwmQjbMB5OefSM75i\",\"object\":\"service\"},\"configuration\":{\"workspace_id\":\"7JFbo4RNA0OKdFWC04r6B3\",\"traffic_ramp\":\"20\"},\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/ngwaf/services/4nWURjwmQjbMB5OefSM75i\",\"service\":\"https://api.fastly.com/service/4nWURjwmQjbMB5OefSM75i\"}}"}],"_postman_id":"3d0fad1e-08b1-444c-9390-532b2ff097e2"},{"name":"Update configuration","id":"604937b7-133b-45f1-8876-e5b52533cbf0","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"workspace_id\":\"7JFbo4RNA0OKdFWC04r6B3\",\"traffic_ramp\":\"20\"}"},"url":"https://api.fastly.com/enabled-products/v1/ngwaf/services/{{service_id}}/configuration","description":"<p>Update configuration of the Next-Gen WAF product on a service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","ngwaf","services","{{service_id}}","configuration"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"666f670c-18d7-4bf4-aa86-cabebcad4760","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"workspace_id\":\"7JFbo4RNA0OKdFWC04r6B3\",\"traffic_ramp\":\"20\"}"},"url":"https://api.fastly.com/enabled-products/v1/ngwaf/services/SU1Z0isxPaozGVKXdv0eY/configuration","description":"Update configuration of the Next-Gen WAF product on a service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"ngwaf\",\"object\":\"product\"},\"service\":{\"id\":\"4nWURjwmQjbMB5OefSM75i\",\"object\":\"service\"},\"configuration\":{\"workspace_id\":\"7JFbo4RNA0OKdFWC04r6B3\",\"traffic_ramp\":\"20\"},\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/ngwaf/services/4nWURjwmQjbMB5OefSM75i\",\"service\":\"https://api.fastly.com/service/4nWURjwmQjbMB5OefSM75i\"}}"}],"_postman_id":"604937b7-133b-45f1-8876-e5b52533cbf0"},{"name":"Get services with product enabled","id":"c74bcd6f-8941-4d76-98b3-0ca4427e2591","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/ngwaf/services","description":"<p>Get all the services which have the Next-Gen WAF product enabled.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","ngwaf","services"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"89ce95ef-fd1d-4acc-8372-f3d04f418faf","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/ngwaf/services","description":"Get all the services which have the Next-Gen WAF product enabled.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"ngwaf\",\"object\":\"product\"},\"customer\":{\"id\":\"customer_id\",\"object\":\"customer\"},\"services\":[\"4nWURjwmQjbMB5OefSM75i\",\"3krg2uUGZzb2W9Euo4moOY\"],\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/ngwaf/services\"}}"}],"_postman_id":"c74bcd6f-8941-4d76-98b3-0ca4427e2591"}],"id":"8870bd3f-f348-4098-a2f7-ef809c5c5208","description":"<p>These endpoints allow you to enable, disable, configure, and check the enablement and configuration status of the Next-Gen WAF product on your services.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>services</td>\n<td>array</td>\n<td>A list of services with the Next-Gen WAF enabled.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-1\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>traffic_ramp</td>\n<td>string</td>\n<td>The percentage of traffic to inspect.</td>\n</tr>\n<tr>\n<td>workspace_id</td>\n<td>string</td>\n<td>The workspace to link.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-2\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>traffic_ramp</td>\n<td>string</td>\n<td>The percentage of traffic to inspect.</td>\n</tr>\n<tr>\n<td>workspace_id</td>\n<td>string</td>\n<td>The workspace to link.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"8870bd3f-f348-4098-a2f7-ef809c5c5208"},{"name":"Object Storage","item":[{"name":"Get product enablement status","id":"7752d172-fef1-4db3-b823-d2c86e078a6e","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/object_storage","description":"<p>Get the enablement status of the Object Storage product.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","object_storage"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"e813fe38-b4e8-4a38-85d0-4d84768457f6","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/object_storage","description":"Get the enablement status of the Object Storage product.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"object_storage\",\"object\":\"product\"},\"customer\":{\"id\":\"WioEuN2Pp8TCBwEyfFMuG7\",\"object\":\"customer\"},\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/object_storage\"}}"}],"_postman_id":"7752d172-fef1-4db3-b823-d2c86e078a6e"},{"name":"Enable product","id":"9a634c32-19b7-4f82-a35f-67e3cccd9bf0","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/object_storage","description":"<p>Enable the Object Storage product.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","object_storage"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"2e72a2db-b627-43ef-9472-d06264c90689","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/object_storage","description":"Enable the Object Storage product.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"object_storage\",\"object\":\"product\"},\"customer\":{\"id\":\"WioEuN2Pp8TCBwEyfFMuG7\",\"object\":\"customer\"},\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/object_storage\"}}"}],"_postman_id":"9a634c32-19b7-4f82-a35f-67e3cccd9bf0"},{"name":"Disable product","id":"ae1aac3a-0d75-4f25-b10e-65934d7f6151","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/enabled-products/v1/object_storage","description":"<p>Disable the Object Storage product.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","object_storage"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"45a82e33-2b7e-4e45-9166-1969ee35226a","name":"204 No Content","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/enabled-products/v1/object_storage","description":"Disable the Object Storage product.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 No Content","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"ae1aac3a-0d75-4f25-b10e-65934d7f6151"}],"id":"343480f3-8782-4711-ad33-6af31b2f8bfe","description":"<p>These endpoints allow you to enable, disable, and check the enablement status of the Object Storage product on your customer account.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"343480f3-8782-4711-ad33-6af31b2f8bfe"},{"name":"Origin Inspector","item":[{"name":"Get product enablement status","id":"9112e485-3b64-4899-9b5c-3e3a29a0736a","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/origin_inspector/services/{{service_id}}","description":"<p>Get the enablement status of the Origin Inspector product on a service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","origin_inspector","services","{{service_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"aa77acb2-1800-4761-86ac-a7ec656872b7","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/origin_inspector/services/SU1Z0isxPaozGVKXdv0eY","description":"Get the enablement status of the Origin Inspector product on a service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"origin_inspector\",\"object\":\"product\"},\"service\":{\"id\":\"4nWURjwmQjbMB5OefSM75i\",\"object\":\"service\"},\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/origin_inspector/services/4nWURjwmQjbMB5OefSM75i\",\"service\":\"https://api.fastly.com/service/4nWURjwmQjbMB5OefSM75i\"}}"}],"_postman_id":"9112e485-3b64-4899-9b5c-3e3a29a0736a"},{"name":"Enable product","id":"7ebf850b-c941-4d32-93d9-5eb790faff1a","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/origin_inspector/services/{{service_id}}","description":"<p>Enable the Origin Inspector product on a service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","origin_inspector","services","{{service_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"f6d5d77a-d12a-432f-a79a-a8c9b2627c37","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/origin_inspector/services/SU1Z0isxPaozGVKXdv0eY","description":"Enable the Origin Inspector product on a service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"origin_inspector\",\"object\":\"product\"},\"service\":{\"id\":\"4nWURjwmQjbMB5OefSM75i\",\"object\":\"service\"},\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/origin_inspector/services/4nWURjwmQjbMB5OefSM75i\",\"service\":\"https://api.fastly.com/service/4nWURjwmQjbMB5OefSM75i\"}}"}],"_postman_id":"7ebf850b-c941-4d32-93d9-5eb790faff1a"},{"name":"Disable product","id":"6449a3f1-5edb-4c89-94a4-e8400a9f6a7a","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/enabled-products/v1/origin_inspector/services/{{service_id}}","description":"<p>Disable the Origin Inspector product on a service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","origin_inspector","services","{{service_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"9cf5076d-32f1-4d64-ba1b-0748c1915f77","name":"204 No Content","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/enabled-products/v1/origin_inspector/services/SU1Z0isxPaozGVKXdv0eY","description":"Disable the Origin Inspector product on a service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 No Content","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"6449a3f1-5edb-4c89-94a4-e8400a9f6a7a"},{"name":"Get services with product enabled","id":"461d2ec2-1e36-419f-99ef-30265b774061","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/origin_inspector/services","description":"<p>Get all the services which have the Origin Inspector product enabled.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","origin_inspector","services"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"089e106b-0b1f-444d-ae23-7f1333e7e63a","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/origin_inspector/services","description":"Get all the services which have the Origin Inspector product enabled.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"origin_inspector\",\"object\":\"product\"},\"customer\":{\"id\":\"customer_id\",\"object\":\"customer\"},\"services\":[\"4nWURjwmQjbMB5OefSM75i\",\"3krg2uUGZzb2W9Euo4moOY\"],\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/origin_inspector/services\"}}"}],"_postman_id":"461d2ec2-1e36-419f-99ef-30265b774061"}],"id":"41a1b4f8-a3c4-4d1b-a795-55f234ae23c7","description":"<p>These endpoints allow you to enable, disable, and check the enablement status of the Origin Inspector product on your services.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>services</td>\n<td>array</td>\n<td>A list of services with Origin Inspector enabled.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"41a1b4f8-a3c4-4d1b-a795-55f234ae23c7"},{"name":"WebSockets","item":[{"name":"Get product enablement status","id":"4be989c2-833c-4112-9cab-6972059795eb","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/websockets/services/{{service_id}}","description":"<p>Get the enablement status of the WebSockets product on a service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","websockets","services","{{service_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"587d8547-d10b-45d3-82dc-55964fbe7fc9","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/websockets/services/SU1Z0isxPaozGVKXdv0eY","description":"Get the enablement status of the WebSockets product on a service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"websockets\",\"object\":\"product\"},\"service\":{\"id\":\"4nWURjwmQjbMB5OefSM75i\",\"object\":\"service\"},\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/websockets/services/4nWURjwmQjbMB5OefSM75i\",\"service\":\"https://api.fastly.com/service/4nWURjwmQjbMB5OefSM75i\"}}"}],"_postman_id":"4be989c2-833c-4112-9cab-6972059795eb"},{"name":"Enable product","id":"1a08ae91-a5fd-478b-9b36-720fbf30ec2b","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/websockets/services/{{service_id}}","description":"<p>Enable the WebSockets product on a service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","websockets","services","{{service_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"5f21f0c9-60bd-431f-8fe6-8b2c937a1649","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/websockets/services/SU1Z0isxPaozGVKXdv0eY","description":"Enable the WebSockets product on a service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"websockets\",\"object\":\"product\"},\"service\":{\"id\":\"4nWURjwmQjbMB5OefSM75i\",\"object\":\"service\"},\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/websockets/services/4nWURjwmQjbMB5OefSM75i\",\"service\":\"https://api.fastly.com/service/4nWURjwmQjbMB5OefSM75i\"}}"}],"_postman_id":"1a08ae91-a5fd-478b-9b36-720fbf30ec2b"},{"name":"Disable product","id":"0b5fe1e1-d27e-429c-a73b-73cf37f4b941","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/enabled-products/v1/websockets/services/{{service_id}}","description":"<p>Disable the Websockets product on a service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","websockets","services","{{service_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"7c124565-d08e-4dfc-82ee-7c741720bb39","name":"204 No Content","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/enabled-products/v1/websockets/services/SU1Z0isxPaozGVKXdv0eY","description":"Disable the Websockets product on a service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 No Content","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"0b5fe1e1-d27e-429c-a73b-73cf37f4b941"},{"name":"Get services with product enabled","id":"b49228bd-8b02-4abc-a9f0-6bac9c9f5063","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/websockets/services","description":"<p>Get all the services which have the Websockets product enabled.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["enabled-products","v1","websockets","services"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"ab0c6e58-b8ce-40a3-aa63-1d5d890aa41e","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/enabled-products/v1/websockets/services","description":"Get all the services which have the Websockets product enabled.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"product\":{\"id\":\"websockets\",\"object\":\"product\"},\"customer\":{\"id\":\"customer_id\",\"object\":\"customer\"},\"services\":[\"4nWURjwmQjbMB5OefSM75i\",\"3krg2uUGZzb2W9Euo4moOY\"],\"_links\":{\"self\":\"https://api.fastly.com/enabled-products/v1/websockets/services\"}}"}],"_postman_id":"b49228bd-8b02-4abc-a9f0-6bac9c9f5063"}],"id":"4036aaca-12af-4693-96ad-2490bb050992","description":"<p>These endpoints allow you to enable, disable, and check the enablement status of the WebSockets product on your services.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>services</td>\n<td>array</td>\n<td>A list of services with Websockets enabled.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"4036aaca-12af-4693-96ad-2490bb050992"}],"id":"0742cea1-8d93-47d9-9c63-8842bc68fdb6","_postman_id":"0742cea1-8d93-47d9-9c63-8842bc68fdb6","description":""},{"name":"Services","item":[{"name":"Backend","item":[{"name":"List backends","id":"0a8af151-363c-4a10-9fa1-1565feefbfed","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/backend","description":"<p>List all backends for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","backend"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"6b590ffb-18fc-4842-a557-e4707bce1ade","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/backend","description":"List all backends for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"address\":\"127.0.0.1\",\"auto_loadbalance\":false,\"between_bytes_timeout\":10000,\"client_cert\":null,\"comment\":\"\",\"connect_timeout\":1000,\"first_byte_timeout\":15000,\"fetch_timeout\":120000,\"healthcheck\":null,\"hostname\":null,\"ipv4\":\"127.0.0.1\",\"ipv6\":null,\"keepalive_time\":null,\"locked\":true,\"max_conn\":200,\"max_tls_version\":null,\"min_tls_version\":null,\"name\":\"test-backend\",\"port\":80,\"request_condition\":\"\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"share_key\":null,\"shield\":null,\"override_host\":null,\"ssl_ca_cert\":null,\"ssl_cert_hostname\":null,\"ssl_check_cert\":true,\"ssl_ciphers\":null,\"ssl_client_cert\":null,\"ssl_client_key\":null,\"ssl_hostname\":null,\"ssl_sni_hostname\":null,\"tcp_keepalive_enable\":false,\"tcp_keepalive_interval\":null,\"tcp_keepalive_probes\":null,\"tcp_keepalive_time\":null,\"use_ssl\":false,\"version\":1,\"weight\":100}]"}],"_postman_id":"0a8af151-363c-4a10-9fa1-1565feefbfed"},{"name":"Create a backend","id":"d0f8d002-46e9-4d69-8b79-ac358e726928","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/backend","description":"<p>Create a backend for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","backend"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"8915511b-2e36-44bc-9ebd-c831d04328ee","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/backend","description":"Create a backend for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"address\":\"127.0.0.1\",\"auto_loadbalance\":false,\"between_bytes_timeout\":10000,\"client_cert\":null,\"comment\":\"\",\"connect_timeout\":1000,\"first_byte_timeout\":15000,\"fetch_timeout\":120000,\"healthcheck\":null,\"hostname\":null,\"ipv4\":\"127.0.0.1\",\"ipv6\":null,\"keepalive_time\":null,\"locked\":true,\"max_conn\":200,\"max_tls_version\":null,\"min_tls_version\":null,\"name\":\"test-backend\",\"port\":80,\"request_condition\":\"\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"share_key\":null,\"shield\":null,\"override_host\":null,\"ssl_ca_cert\":null,\"ssl_cert_hostname\":null,\"ssl_check_cert\":true,\"ssl_ciphers\":null,\"ssl_client_cert\":null,\"ssl_client_key\":null,\"ssl_hostname\":null,\"ssl_sni_hostname\":null,\"tcp_keepalive_enable\":false,\"tcp_keepalive_interval\":null,\"tcp_keepalive_probes\":null,\"tcp_keepalive_time\":null,\"use_ssl\":false,\"version\":1,\"weight\":100}"}],"_postman_id":"d0f8d002-46e9-4d69-8b79-ac358e726928"},{"name":"Describe a backend","id":"ea03571d-cf81-4c43-95df-70b3cbd3dbe5","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/backend/{{backend_name}}","description":"<p>Get the backend for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","backend","{{backend_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"141dee04-f686-45e2-92df-587129c2e323","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/backend/test-backend","description":"Get the backend for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"address\":\"127.0.0.1\",\"auto_loadbalance\":false,\"between_bytes_timeout\":10000,\"client_cert\":null,\"comment\":\"\",\"connect_timeout\":1000,\"first_byte_timeout\":15000,\"fetch_timeout\":120000,\"healthcheck\":null,\"hostname\":null,\"ipv4\":\"127.0.0.1\",\"ipv6\":null,\"keepalive_time\":null,\"locked\":true,\"max_conn\":200,\"max_tls_version\":null,\"min_tls_version\":null,\"name\":\"test-backend\",\"port\":80,\"request_condition\":\"\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"share_key\":null,\"shield\":null,\"override_host\":null,\"ssl_ca_cert\":null,\"ssl_cert_hostname\":null,\"ssl_check_cert\":true,\"ssl_ciphers\":null,\"ssl_client_cert\":null,\"ssl_client_key\":null,\"ssl_hostname\":null,\"ssl_sni_hostname\":null,\"tcp_keepalive_enable\":false,\"tcp_keepalive_interval\":null,\"tcp_keepalive_probes\":null,\"tcp_keepalive_time\":null,\"use_ssl\":false,\"version\":1,\"weight\":100}"}],"_postman_id":"ea03571d-cf81-4c43-95df-70b3cbd3dbe5"},{"name":"Update a backend","id":"05ede6ea-2df9-48c4-a334-af6592e44617","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/backend/{{backend_name}}","description":"<p>Update the backend for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","backend","{{backend_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"34e4c873-573e-48a8-9b7a-9a22c172772e","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/backend/test-backend","description":"Update the backend for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"address\":\"127.0.0.1\",\"auto_loadbalance\":false,\"between_bytes_timeout\":10000,\"client_cert\":null,\"comment\":\"\",\"connect_timeout\":1000,\"first_byte_timeout\":15000,\"fetch_timeout\":120000,\"healthcheck\":null,\"hostname\":null,\"ipv4\":\"127.0.0.1\",\"ipv6\":null,\"keepalive_time\":null,\"locked\":true,\"max_conn\":200,\"max_tls_version\":null,\"min_tls_version\":null,\"name\":\"updated-test-backend\",\"port\":80,\"request_condition\":\"\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"share_key\":null,\"shield\":null,\"override_host\":null,\"ssl_ca_cert\":null,\"ssl_cert_hostname\":null,\"ssl_check_cert\":true,\"ssl_ciphers\":null,\"ssl_client_cert\":null,\"ssl_client_key\":null,\"ssl_hostname\":null,\"ssl_sni_hostname\":null,\"tcp_keepalive_enable\":false,\"tcp_keepalive_interval\":null,\"tcp_keepalive_probes\":null,\"tcp_keepalive_time\":null,\"use_ssl\":false,\"version\":1,\"weight\":100}"}],"_postman_id":"05ede6ea-2df9-48c4-a334-af6592e44617"},{"name":"Delete a backend","id":"268c0423-5550-4b21-99ff-80e3078f9be9","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/backend/{{backend_name}}","description":"<p>Delete the backend for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","backend","{{backend_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"22d5184f-f1cf-45e8-b236-f5c56804782e","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/backend/test-backend","description":"Delete the backend for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"268c0423-5550-4b21-99ff-80e3078f9be9"}],"id":"1711bb21-a4d2-4488-957d-89e357c3d476","description":"<p>A backend (also sometimes called an origin server) is a server identified by IP address or hostname, from which Fastly will fetch your content. There can be multiple backends attached to a service, but each backend is specific to one service. By default, if only one backend is defined in a service configuration, it will be used for all requests provided it meets the conditions attached to it, if any. If multiple backends are defined, the backend that is used for a request is the one with the highest-priority condition attached to it, out of all conditions that this request satisfies. If multiple conditions match the request with the same (highest) priority, one is chosen arbitrarily. If there are no backends with conditions that match the request, then the backend without any conditions is chosen. If there are multiple such backends, one is chosen arbitrarily. The behavior described above can be modified by using the auto_loadbalance field described below. These endpoints can be used with static backends only, not dynamic backends.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>address</td>\n<td>string</td>\n<td>A hostname, IPv4, or IPv6 address for the backend. This is the preferred way to specify the location of your backend.</td>\n</tr>\n<tr>\n<td>auto_loadbalance</td>\n<td>boolean</td>\n<td>Whether or not this backend should be automatically load balanced. If true, all backends with this setting that don't have a request_condition will be selected based on their weight.</td>\n</tr>\n<tr>\n<td>between_bytes_timeout</td>\n<td>integer</td>\n<td>Maximum duration in milliseconds that Fastly will wait while receiving no data on a download from a backend. If exceeded, for Delivery services, the response received so far will be considered complete and the fetch will end. For Compute services, timeout expiration is treated as a failure of the backend connection, and an error is generated. May be set at runtime using bereq.between_bytes_timeout.</td>\n</tr>\n<tr>\n<td>client_cert</td>\n<td>string</td>\n<td>Unused.</td>\n</tr>\n<tr>\n<td>comment</td>\n<td>string</td>\n<td>A freeform descriptive note.</td>\n</tr>\n<tr>\n<td>connect_timeout</td>\n<td>integer</td>\n<td>Maximum duration in milliseconds to wait for a connection to this backend to be established. If exceeded, the connection is aborted and a synthetic 503 response will be presented instead. May be set at runtime using bereq.connect_timeout.</td>\n</tr>\n<tr>\n<td>fetch_timeout</td>\n<td>integer</td>\n<td>Maximum duration in milliseconds to wait for the entire response to be received after a TCP connection is established and the request has been sent. If exceeded, the connection is aborted and a synthetic 503 response will be presented instead. May be set at runtime using bereq.fetch_timeout.</td>\n</tr>\n<tr>\n<td>first_byte_timeout</td>\n<td>integer</td>\n<td>Maximum duration in milliseconds to wait for the server response to begin after a TCP connection is established and the request has been sent. If exceeded, the connection is aborted and a synthetic 503 response will be presented instead. May be set at runtime using bereq.first_byte_timeout.</td>\n</tr>\n<tr>\n<td>healthcheck</td>\n<td>string</td>\n<td>The name of the healthcheck to use with this backend.</td>\n</tr>\n<tr>\n<td>hostname</td>\n<td>string</td>\n<td>The hostname of the backend. May be used as an alternative to address to set the backend location.</td>\n</tr>\n<tr>\n<td>ipv4</td>\n<td>string</td>\n<td>IPv4 address of the backend. May be used as an alternative to address to set the backend location.</td>\n</tr>\n<tr>\n<td>ipv6</td>\n<td>string</td>\n<td>IPv6 address of the backend. May be used as an alternative to address to set the backend location.</td>\n</tr>\n<tr>\n<td>keepalive_time</td>\n<td>integer</td>\n<td>How long (in seconds) to keep a persistent connection to the backend between requests. By default, Fastly keeps connections open as long as it can.</td>\n</tr>\n<tr>\n<td>max_conn</td>\n<td>integer</td>\n<td>Maximum number of concurrent connections this backend will accept.</td>\n</tr>\n<tr>\n<td>max_lifetime</td>\n<td>integer</td>\n<td>Maximum time from creation (in milliseconds) that a pooled HTTP keepalive connection will be eligible for reuse; 0 is treated as unlimited.</td>\n</tr>\n<tr>\n<td>max_tls_version</td>\n<td>string</td>\n<td>Maximum allowed TLS version on SSL connections to this backend. If your backend server is not able to negotiate a connection meeting this constraint, a synthetic 503 error response will be generated.</td>\n</tr>\n<tr>\n<td>max_use</td>\n<td>integer</td>\n<td>Maximum number of requests allowed over a single, pooled HTTP keepalive connection to this backend; 0 is treated as unlimited.</td>\n</tr>\n<tr>\n<td>min_tls_version</td>\n<td>string</td>\n<td>Minimum allowed TLS version on SSL connections to this backend. If your backend server is not able to negotiate a connection meeting this constraint, a synthetic 503 error response will be generated.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The name of the backend.</td>\n</tr>\n<tr>\n<td>override_host</td>\n<td>string</td>\n<td>If set, will replace the client-supplied HTTP Host header on connections to this backend. Applied after VCL has been processed, so this setting will take precedence over changing bereq.http.Host in VCL.</td>\n</tr>\n<tr>\n<td>port</td>\n<td>integer</td>\n<td>Port on which the backend server is listening for connections from Fastly. Setting port to 80 or 443 will also set use_ssl automatically (to false and true respectively), unless explicitly overridden by setting use_ssl in the same request.</td>\n</tr>\n<tr>\n<td>prefer_ipv6</td>\n<td>boolean</td>\n<td>Prefer IPv6 connections to origins for hostname backends. Default is 'false' for Delivery services and 'true' for Compute services.</td>\n</tr>\n<tr>\n<td>request_condition</td>\n<td>string</td>\n<td>Name of a Condition, which if satisfied, will select this backend during a request. If set, will override any auto_loadbalance setting. By default, the first backend added to a service is selected for all requests.</td>\n</tr>\n<tr>\n<td>share_key</td>\n<td>string</td>\n<td>Value that when shared across backends will enable those backends to share the same health check.</td>\n</tr>\n<tr>\n<td>shield</td>\n<td>string</td>\n<td>Identifier of the POP to use as a shield.</td>\n</tr>\n<tr>\n<td>ssl_ca_cert</td>\n<td>string</td>\n<td>CA certificate attached to origin.</td>\n</tr>\n<tr>\n<td>ssl_cert_hostname</td>\n<td>string</td>\n<td>Overrides ssl_hostname, but only for cert verification. Does not affect SNI at all.</td>\n</tr>\n<tr>\n<td>ssl_check_cert</td>\n<td>boolean</td>\n<td>Be strict on checking SSL certs.</td>\n</tr>\n<tr>\n<td>ssl_ciphers</td>\n<td>string</td>\n<td>List of OpenSSL ciphers to support for connections to this origin. If your backend server is not able to negotiate a connection meeting this constraint, a synthetic 503 error response will be generated.</td>\n</tr>\n<tr>\n<td>ssl_client_cert</td>\n<td>string</td>\n<td>Client certificate attached to origin.</td>\n</tr>\n<tr>\n<td>ssl_client_key</td>\n<td>string</td>\n<td>Client key attached to origin.</td>\n</tr>\n<tr>\n<td>ssl_hostname</td>\n<td>string</td>\n<td>Use ssl_cert_hostname and ssl_sni_hostname to configure certificate validation.</td>\n</tr>\n<tr>\n<td>ssl_sni_hostname</td>\n<td>string</td>\n<td>Overrides ssl_hostname, but only for SNI in the handshake. Does not affect cert validation at all.</td>\n</tr>\n<tr>\n<td>tcp_keepalive_enable</td>\n<td>boolean</td>\n<td>Whether to enable TCP keepalives for backend connections. Varnish defaults to using keepalives if this is unspecified.</td>\n</tr>\n<tr>\n<td>tcp_keepalive_interval</td>\n<td>integer</td>\n<td>Interval in seconds between subsequent keepalive probes.</td>\n</tr>\n<tr>\n<td>tcp_keepalive_probes</td>\n<td>integer</td>\n<td>Number of unacknowledged probes to send before considering the connection dead.</td>\n</tr>\n<tr>\n<td>tcp_keepalive_time</td>\n<td>integer</td>\n<td>Interval in seconds between the last data packet sent and the first keepalive probe.</td>\n</tr>\n<tr>\n<td>use_ssl</td>\n<td>boolean</td>\n<td>Whether or not to require TLS for connections to this backend.</td>\n</tr>\n<tr>\n<td>weight</td>\n<td>integer</td>\n<td>Weight used to load balance this backend against others. May be any positive integer. If auto_loadbalance is true, the chance of this backend being selected is equal to its own weight over the sum of all weights for backends that have auto_loadbalance set to true.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>locked</td>\n<td>boolean</td>\n<td>Indicates whether the version of the service this backend is attached to accepts edits.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>integer</td>\n<td>Integer identifying a service version.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"1711bb21-a4d2-4488-957d-89e357c3d476"},{"name":"Domain","item":[{"name":"Validate DNS configuration for all domains on a service","id":"1019bd9a-8f99-4a72-9318-a9d98db581f0","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/domain/check_all","description":"<p>Checks the status of all domains' DNS records for a Service Version. Returns an array of 3 items for each domain; the first is the details for the domain, the second is the current CNAME of the domain, and the third is a boolean indicating whether or not it has been properly setup to use Fastly.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","domain","check_all"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"8e62e352-56dc-443f-b47f-8ce7e8b1e777","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/domain/check_all","description":"Checks the status of all domains' DNS records for a Service Version. Returns an array of 3 items for each domain; the first is the details for the domain, the second is the current CNAME of the domain, and the third is a boolean indicating whether or not it has been properly setup to use Fastly.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[[{\"comment\":\"\",\"name\":\"www.example.com\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":1,\"created_at\":\"2020-03-15T20:10:09.000Z\",\"updated_at\":\"2020-03-15T20:10:09.000Z\",\"deleted_at\":null},\"global.prod.fastly.net.\",true]]"}],"_postman_id":"1019bd9a-8f99-4a72-9318-a9d98db581f0"},{"name":"Validate DNS configuration for a single domain on a service","id":"998cf75b-315b-4d06-a354-035d59790ed8","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/domain/{{domain_name}}/check","description":"<p>Checks the status of a specific domain's DNS record for a Service Version. Returns an array in the same format as domain/check_all.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","domain","{{domain_name}}","check"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"84c92f28-3c38-457f-b5d9-80f4f7287768","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/domain/www.example.com/check","description":"Checks the status of a specific domain's DNS record for a Service Version. Returns an array in the same format as domain/check_all.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"comment\":\"\",\"name\":\"www.example.com\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":1,\"created_at\":\"2020-03-15T20:10:09.000Z\",\"updated_at\":\"2020-03-15T20:10:09.000Z\",\"deleted_at\":null},\"global.prod.fastly.net.\",true]"}],"_postman_id":"998cf75b-315b-4d06-a354-035d59790ed8"},{"name":"List domains","id":"3beeb936-ef86-410f-a3ab-1de32f798e7c","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/domain","description":"<p>List all the domains for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","domain"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"f0932a5d-c4eb-47a1-b6a1-8a029ede0c44","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/domain","description":"List all the domains for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"comment\":\"\",\"name\":\"www.example.com\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":1,\"created_at\":\"2020-03-15T20:10:09.000Z\",\"updated_at\":\"2020-03-15T20:10:09.000Z\",\"deleted_at\":null}]"}],"_postman_id":"3beeb936-ef86-410f-a3ab-1de32f798e7c"},{"name":"Add a domain name to a service","id":"0dc070aa-c636-4984-b31f-ffb86a9d24d5","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/domain","description":"<p>Create a domain for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","domain"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"30602102-faed-41eb-9c01-2414d8a02e29","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/domain","description":"Create a domain for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"comment\":\"\",\"name\":\"www.example.com\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":1,\"created_at\":\"2020-03-15T20:10:09.000Z\",\"updated_at\":\"2020-03-15T20:10:09.000Z\",\"deleted_at\":null}"}],"_postman_id":"0dc070aa-c636-4984-b31f-ffb86a9d24d5"},{"name":"Describe a domain","id":"1f0d3bb1-0639-49d1-9e73-339ddb18e5d0","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/domain/{{domain_name}}","description":"<p>Get the domain for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","domain","{{domain_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"a2c36ac4-7af0-476c-8db8-519a1d8f6e7e","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/domain/www.example.com","description":"Get the domain for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"comment\":\"\",\"name\":\"www.example.com\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":1,\"created_at\":\"2020-03-15T20:10:09.000Z\",\"updated_at\":\"2020-03-15T20:10:09.000Z\",\"deleted_at\":null}"}],"_postman_id":"1f0d3bb1-0639-49d1-9e73-339ddb18e5d0"},{"name":"Update a domain","id":"6a3ee6b9-e07a-4376-b8a7-07eddcd553aa","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/domain/{{domain_name}}","description":"<p>Update the domain for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","domain","{{domain_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"f5ff6583-46b5-4d59-b9b8-0eb4e7f4056a","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/domain/www.example.com","description":"Update the domain for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"comment\":\"\",\"name\":\"www.updated-example.com\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":1,\"created_at\":\"2020-03-15T20:10:09.000Z\",\"updated_at\":\"2020-03-15T20:10:09.000Z\",\"deleted_at\":null}"}],"_postman_id":"6a3ee6b9-e07a-4376-b8a7-07eddcd553aa"},{"name":"Remove a domain from a service","id":"99f9f90a-8a35-4b9e-b114-92bc8d0187a1","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/domain/{{domain_name}}","description":"<p>Delete the domain for a particular service and versions.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","domain","{{domain_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"44482c62-e8d1-4c57-a2e0-572fc56fd863","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/domain/www.example.com","description":"Delete the domain for a particular service and versions.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"99f9f90a-8a35-4b9e-b114-92bc8d0187a1"}],"id":"2c7a894f-a2e9-4719-8b85-0d9daadd7822","description":"<p>A domain represents the domain name through which visitors will retrieve content. There can be multiple domains for a service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>comment</td>\n<td>string</td>\n<td>A freeform descriptive note.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The name of the domain or domains associated with this service.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>integer</td>\n<td>Integer identifying a service version.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"2c7a894f-a2e9-4719-8b85-0d9daadd7822"},{"name":"Health check","item":[{"name":"List health checks","id":"199710a9-e1cb-4146-a0aa-114be250c771","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/healthcheck","description":"<p>List all of the health checks for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","healthcheck"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"f073d88b-89fb-4a1e-a773-dc7b246e9274","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/healthcheck","description":"List all of the health checks for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"check_interval\":5000,\"comment\":\"\",\"expected_response\":200,\"headers\":[\"Authorization: bearer 1234567890\"],\"host\":\"example.com\",\"http_version\":\"1.1\",\"initial\":2,\"method\":\"HEAD\",\"name\":\"test-healthcheck\",\"path\":\"/test.txt\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"threshold\":3,\"timeout\":500,\"version\":1,\"window\":5}]"}],"_postman_id":"199710a9-e1cb-4146-a0aa-114be250c771"},{"name":"Create a health check","id":"2da82425-4336-4160-9536-cd2b1959697e","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/healthcheck","description":"<p>Create a health check for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","healthcheck"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"1d244b9a-1575-44d4-af2f-a52188c4e530","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/healthcheck","description":"Create a health check for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"check_interval\":5000,\"comment\":\"\",\"expected_response\":200,\"headers\":[\"Authorization: bearer 1234567890\"],\"host\":\"example.com\",\"http_version\":\"1.1\",\"initial\":2,\"method\":\"HEAD\",\"name\":\"test-healthcheck\",\"path\":\"/test.txt\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"threshold\":3,\"timeout\":500,\"version\":1,\"window\":5}"}],"_postman_id":"2da82425-4336-4160-9536-cd2b1959697e"},{"name":"Get a health check","id":"d210f729-f1bd-4198-a0c6-c7097ad41ff0","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/healthcheck/{{healthcheck_name}}","description":"<p>Get the health check for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","healthcheck","{{healthcheck_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"49ff73b7-8841-48d1-b18d-520594939c3a","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/healthcheck/test-healthcheck","description":"Get the health check for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"check_interval\":5000,\"comment\":\"\",\"expected_response\":200,\"headers\":[\"Authorization: bearer 1234567890\"],\"host\":\"example.com\",\"http_version\":\"1.1\",\"initial\":2,\"method\":\"HEAD\",\"name\":\"test-healthcheck\",\"path\":\"/test.txt\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"threshold\":3,\"timeout\":500,\"version\":1,\"window\":5}"}],"_postman_id":"d210f729-f1bd-4198-a0c6-c7097ad41ff0"},{"name":"Update a health check","id":"ae614d88-d7d4-4d3d-a4e2-ccf21148a20b","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/healthcheck/{{healthcheck_name}}","description":"<p>Update the health check for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","healthcheck","{{healthcheck_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"fd4337c4-89a9-49b6-9a58-2c45911d9c55","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/healthcheck/test-healthcheck","description":"Update the health check for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"check_interval\":5000,\"comment\":\"\",\"expected_response\":200,\"headers\":[\"Authorization: bearer 1234567890\"],\"host\":\"example.com\",\"http_version\":\"1.1\",\"initial\":2,\"method\":\"HEAD\",\"name\":\"test-healthcheck\",\"path\":\"/test.txt\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"threshold\":3,\"timeout\":500,\"version\":1,\"window\":5}"}],"_postman_id":"ae614d88-d7d4-4d3d-a4e2-ccf21148a20b"},{"name":"Delete a health check","id":"951bc3dc-bd20-4c25-b157-f55a80215375","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/healthcheck/{{healthcheck_name}}","description":"<p>Delete the health check for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","healthcheck","{{healthcheck_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"fa99409c-fe41-40bc-b079-3ccd0bd0d041","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/healthcheck/test-healthcheck","description":"Delete the health check for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"951bc3dc-bd20-4c25-b157-f55a80215375"}],"id":"212225d5-bc37-4d8d-b90c-095f9345a202","description":"<p>Health checks are used to customize the way Fastly checks on your Backends. If an origin server is marked unhealthy due to health checks, Fastly will stop attempting to send requests to it. If all origin servers are marked unhealthy, Fastly will attempt to serve stale. If no stale object is available, a 503 will be returned to the client.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>check_interval</td>\n<td>integer</td>\n<td>How often to run the health check in milliseconds. Minimum 1 second, maximum 1 hour.</td>\n</tr>\n<tr>\n<td>comment</td>\n<td>string</td>\n<td>A freeform descriptive note.</td>\n</tr>\n<tr>\n<td>expected_response</td>\n<td>integer</td>\n<td>The status code expected from the host.</td>\n</tr>\n<tr>\n<td>headers</td>\n<td>array</td>\n<td>Array of custom headers that will be added to the health check probes.</td>\n</tr>\n<tr>\n<td>host</td>\n<td>string</td>\n<td>Which host to check.</td>\n</tr>\n<tr>\n<td>http_version</td>\n<td>string</td>\n<td>Whether to use version 1.0 or 1.1 HTTP.</td>\n</tr>\n<tr>\n<td>initial</td>\n<td>integer</td>\n<td>When loading a config, the initial number of probes to be seen as OK.</td>\n</tr>\n<tr>\n<td>method</td>\n<td>string</td>\n<td>Which HTTP method to use.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The name of the health check.</td>\n</tr>\n<tr>\n<td>path</td>\n<td>string</td>\n<td>The path to check.</td>\n</tr>\n<tr>\n<td>threshold</td>\n<td>integer</td>\n<td>How many health checks must succeed to be considered healthy.</td>\n</tr>\n<tr>\n<td>timeout</td>\n<td>integer</td>\n<td>Timeout in milliseconds.</td>\n</tr>\n<tr>\n<td>window</td>\n<td>integer</td>\n<td>The number of most recent health check queries to keep for this health check.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>integer</td>\n<td>Integer identifying a service version.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"212225d5-bc37-4d8d-b90c-095f9345a202"},{"name":"Image Optimizer Default Settings","item":[{"name":"Get current Image Optimizer Default Settings","id":"897f1ae4-91c8-4abd-84e4-01bd046efa74","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/image_optimizer_default_settings","description":"<p>Retrieve the current Image Optimizer default settings. All properties in the response will be populated.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","image_optimizer_default_settings"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"373eb1ed-17d1-41bd-aee4-a6559ce40bc1","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/image_optimizer_default_settings","description":"Retrieve the current Image Optimizer default settings. All properties in the response will be populated.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"resize_filter\":\"lanczos3\",\"webp\":false,\"webp_quality\":85,\"jpeg_type\":\"auto\",\"jpeg_quality\":90,\"upscale\":false,\"allow_video\":false}"}],"_postman_id":"897f1ae4-91c8-4abd-84e4-01bd046efa74"},{"name":"Update Image Optimizer Default Settings","id":"0f4b6bda-5b84-4b40-b9fa-f5bac9e8988c","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"jpeg_quality\":70,\"allow_video\":true}"},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/image_optimizer_default_settings","description":"<p>Update one or more default settings. A minimum of one property is required. The endpoint will respond with the new Image Optimizer default settings,\nwith all properties populated.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","image_optimizer_default_settings"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"d564cc78-acd3-4332-afce-a229e770e31b","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"jpeg_quality\":70,\"allow_video\":true}"},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/image_optimizer_default_settings","description":"Update one or more default settings. A minimum of one property is required. The endpoint will respond with the new Image Optimizer default settings,\nwith all properties populated.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"resize_filter\":\"lanczos3\",\"webp\":false,\"webp_quality\":85,\"jpeg_type\":\"auto\",\"jpeg_quality\":90,\"upscale\":false,\"allow_video\":false}"}],"_postman_id":"0f4b6bda-5b84-4b40-b9fa-f5bac9e8988c"}],"id":"edd580bf-1326-45e9-99bc-2382b9bc9cb2","description":"<p>Configures default settings for Fastly Image Optimizer requests, configuring the way images are optimized when not overridden by URL parameters on specific requests.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>allow_video</td>\n<td>boolean</td>\n<td>Enables GIF to MP4 transformations on this service.</td>\n</tr>\n<tr>\n<td>jpeg_quality</td>\n<td>integer</td>\n<td>The default quality to use with JPEG output. This can be overridden with the \"quality\" parameter on specific image optimizer requests.</td>\n</tr>\n<tr>\n<td>jpeg_type</td>\n<td>string</td>\n<td>The default type of JPEG output to use. This can be overridden with \"format=bjpeg\" and \"format=pjpeg\" on specific image optimizer requests.</td>\n</tr>\n<tr>\n<td></td>\n<td>auto</td>\n<td>Match the input JPEG type, or baseline if transforming from a non-JPEG input.</td>\n</tr>\n<tr>\n<td></td>\n<td>baseline</td>\n<td>Output baseline JPEG images.</td>\n</tr>\n<tr>\n<td></td>\n<td>progressive</td>\n<td>Output progressive JPEG images.</td>\n</tr>\n<tr>\n<td>resize_filter</td>\n<td>string</td>\n<td>The type of filter to use while resizing an image.</td>\n</tr>\n<tr>\n<td></td>\n<td>lanczos3</td>\n<td>A Lanczos filter with a kernel size of 3. Lanczos filters can detect edges and linear features within an image, providing the best possible reconstruction.</td>\n</tr>\n<tr>\n<td></td>\n<td>lanczos2</td>\n<td>A Lanczos filter with a kernel size of 2.</td>\n</tr>\n<tr>\n<td></td>\n<td>bicubic</td>\n<td>A filter using an average of a 4x4 environment of pixels, weighing the innermost pixels higher.</td>\n</tr>\n<tr>\n<td></td>\n<td>bilinear</td>\n<td>A filter using an average of a 2x2 environment of pixels.</td>\n</tr>\n<tr>\n<td></td>\n<td>nearest</td>\n<td>A filter using the value of nearby translated pixel values. Preserves hard edges.</td>\n</tr>\n<tr>\n<td>upscale</td>\n<td>boolean</td>\n<td>Whether or not we should allow output images to render at sizes larger than input.</td>\n</tr>\n<tr>\n<td>webp</td>\n<td>boolean</td>\n<td>Controls whether or not to default to WebP output when the client supports it. This is equivalent to adding \"auto=webp\" to all image optimizer requests.</td>\n</tr>\n<tr>\n<td>webp_quality</td>\n<td>integer</td>\n<td>The default quality to use with WebP output. This can be overridden with the second option in the \"quality\" URL parameter on specific image optimizer requests.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"edd580bf-1326-45e9-99bc-2382b9bc9cb2"},{"name":"Package","item":[{"name":"Get details of the service's Compute package","id":"4652c2ba-eeaa-4ddf-8a23-e1b3d2aea626","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/package","description":"<p>List detailed information about the Compute package for the specified service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","package"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"e42f5616-07be-46ed-b0a1-5f0802786990","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/package","description":"List detailed information about the Compute package for the specified service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"2jejPzXC4GYh189GU3CCA6\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":1,\"metadata\":{\"name\":\"some-package-name\",\"description\":\"Some description\",\"authors\":[\"<support@fastly.com>\"],\"language\":\"rust\",\"size\":1234567,\"created_at\":\"2020-06-24T22:54:28.000Z\",\"updated_at\":\"2020-06-24T22:54:28.000Z\",\"deleted_at\":null}}"}],"_postman_id":"4652c2ba-eeaa-4ddf-8a23-e1b3d2aea626"},{"name":"Upload a Compute package","id":"cd9bd2d9-6e1b-488c-8130-50bc052cda20","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"multipart/form-data; boundary=\"boundary\""},{"key":"Accept","value":"application/json"},{"key":"expect","value":"100-continue"}],"body":{"mode":"raw","raw":"{\"package\":\"(binary data ...)\"}"},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/package","description":"<p>Upload a Compute package associated with the specified service version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","package"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"1e951269-d10e-43e1-9904-ca5fc518423b","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"multipart/form-data; boundary=\"boundary\""},{"key":"Accept","value":"application/json"},{"key":"expect","value":"100-continue"}],"body":{"mode":"raw","raw":"{\"package\":\"(binary data ...)\"}"},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/package","description":"Upload a Compute package associated with the specified service version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"2jejPzXC4GYh189GU3CCA6\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":1,\"metadata\":{\"name\":\"some-package-name\",\"description\":\"Some description\",\"authors\":[\"<support@fastly.com>\"],\"language\":\"rust\",\"size\":1234567,\"created_at\":\"2020-06-24T22:54:28.000Z\",\"updated_at\":\"2020-06-24T22:54:28.000Z\",\"deleted_at\":null}}"}],"_postman_id":"cd9bd2d9-6e1b-488c-8130-50bc052cda20"}],"id":"90385875-417f-4435-b7f5-806d6b6720c6","description":"<p>Fastly Compute is a computation platform capable of running custom binary packages that you compile on your own systems and upload to Fastly. These packages are associated with a service version and are deployed to Fastly's edge network.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>metadata</td>\n<td>object</td>\n<td>Package metadata that has been extracted from the uploaded package.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the package.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>integer</td>\n<td>Integer identifying a service version.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-1\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>authors</td>\n<td>array</td>\n<td>A list of package authors' email addresses.</td>\n</tr>\n<tr>\n<td>description</td>\n<td>string</td>\n<td>Description of the Compute package.</td>\n</tr>\n<tr>\n<td>files_hash</td>\n<td>string</td>\n<td>Hash of the files within the Compute package.</td>\n</tr>\n<tr>\n<td>hashsum</td>\n<td>string</td>\n<td>Hash of the Compute package. This is deprecated in favor of files_hash.</td>\n</tr>\n<tr>\n<td>language</td>\n<td>string</td>\n<td>The language of the Compute package.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>Name of the Compute package.</td>\n</tr>\n<tr>\n<td>size</td>\n<td>integer</td>\n<td>Size of the Compute package in bytes. This is deprecated along with hashsum.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-2\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>package</td>\n<td>string</td>\n<td>The content of the Wasm binary package.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"90385875-417f-4435-b7f5-806d6b6720c6"},{"name":"Resource links","item":[{"name":"List resource links","id":"ede6232e-5448-4182-812b-eddb36afded9","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/resource","description":"<p>List links between resources and services.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","resource"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"4d0e5ed7-51a7-472d-ad85-4a8715f9ef84","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/resource","description":"List links between resources and services.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"id\":\"7Lsb7Y76rChV9hSrv3KgFl\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"href\":\"/resources/stores/kv/3vjTN8v1O7nOAY7aNDGOL\",\"name\":\"test-resource\",\"version\":33,\"resource_id\":\"iqctMyezMmoSAryhwUr6ZF\",\"resource_type\":\"kv-store\",\"updated_at\":\"2020-04-29T22:16:23.000Z\",\"created_at\":\"2020-04-29T22:16:23.000Z\",\"deleted_at\":null}]"}],"_postman_id":"ede6232e-5448-4182-812b-eddb36afded9"},{"name":"Create a resource link","id":"bded3d5f-c47e-4522-9424-7331a84f0c65","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/resource","description":"<p>Create a link between a resource and a service version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","resource"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"9381c004-6519-4f7d-bc3e-dc8f36f8b454","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/resource","description":"Create a link between a resource and a service version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"7Lsb7Y76rChV9hSrv3KgFl\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"resource_id\":\"3vjTN8v1O7nOAY7aNDGOL\",\"href\":\"/resources/stores/kv/3vjTN8v1O7nOAY7aNDGOL\",\"name\":\"test-resource\",\"version\":33,\"resource_type\":\"kv-store\",\"updated_at\":\"2020-04-29T22:16:23.000Z\",\"created_at\":\"2020-04-29T22:16:23.000Z\",\"deleted_at\":null}"}],"_postman_id":"bded3d5f-c47e-4522-9424-7331a84f0c65"},{"name":"Display a resource link","id":"4e1dc056-729a-47ef-9678-68fb837f7ff2","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/resource/{{id}}","description":"<p>Display a resource link by its identifier.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","resource","{{id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"c14325a0-4c81-47de-a42a-52d7ef973e15","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/resource/7Lsb7Y76rChV9hSrv3KgFl","description":"Display a resource link by its identifier.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"7Lsb7Y76rChV9hSrv3KgFl\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"resource_id\":\"3vjTN8v1O7nOAY7aNDGOL\",\"href\":\"/resources/stores/kv/3vjTN8v1O7nOAY7aNDGOL\",\"name\":\"test-resource\",\"version\":33,\"resource_type\":\"kv-store\",\"updated_at\":\"2020-04-29T22:16:23.000Z\",\"created_at\":\"2020-04-29T22:16:23.000Z\",\"deleted_at\":null}"}],"_postman_id":"4e1dc056-729a-47ef-9678-68fb837f7ff2"},{"name":"Update a resource link","id":"bc9eb2da-b45b-4ac3-8e4b-4272b99e6d24","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/resource/{{id}}","description":"<p>Update a link between a resource and a service version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","resource","{{id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"f2e9741b-87c8-4054-b39a-9fd899b41913","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/resource/7Lsb7Y76rChV9hSrv3KgFl","description":"Update a link between a resource and a service version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"7Lsb7Y76rChV9hSrv3KgFl\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"resource_id\":\"3vjTN8v1O7nOAY7aNDGOL\",\"href\":\"/resources/stores/kv/3vjTN8v1O7nOAY7aNDGOL\",\"name\":\"test-resource\",\"version\":33,\"resource_type\":\"kv-store\",\"updated_at\":\"2020-04-29T22:16:23.000Z\",\"created_at\":\"2020-04-29T22:16:23.000Z\",\"deleted_at\":null}"}],"_postman_id":"bc9eb2da-b45b-4ac3-8e4b-4272b99e6d24"},{"name":"Delete a resource link","id":"8614f5d8-a4e6-4a9a-84d8-c67c93a1612e","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/resource/{{id}}","description":"<p>Delete a link between a resource and a service version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","resource","{{id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"5ae9dabc-41cb-4bfc-b643-749e33a632ee","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/resource/7Lsb7Y76rChV9hSrv3KgFl","description":"Delete a link between a resource and a service version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"8614f5d8-a4e6-4a9a-84d8-c67c93a1612e"}],"id":"9eddee14-247a-45ac-b238-86e2d13e0441","description":"<p>A resource link represents a link between a shared resource (such as an kv store or config store) and a service version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The name of the resource link. Note this is separate from the resource store name and might not match the store name.</td>\n</tr>\n<tr>\n<td>resource_id</td>\n<td>string</td>\n<td>The ID of the underlying linked resource.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>href</td>\n<td>string</td>\n<td>The path to the resource.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>An alphanumeric string identifying the resource link.</td>\n</tr>\n<tr>\n<td>resource_type</td>\n<td>string</td>\n<td>Resource type.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>integer</td>\n<td>Integer identifying a service version.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"9eddee14-247a-45ac-b238-86e2d13e0441"},{"name":"Service","item":[{"name":"List services","id":"2e9ec20a-f081-4a6f-90c3-64429e6eea6b","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service?direction&page&per_page&sort","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/services/service/#list-services\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Direction in which to sort results.</p>\n","type":"text/plain"},"key":"direction"},{"description":{"content":"<p>Current page.</p>\n","type":"text/plain"},"key":"page"},{"description":{"content":"<p>Number of records per page.</p>\n","type":"text/plain"},"key":"per_page"},{"description":{"content":"<p>Field on which to sort.</p>\n","type":"text/plain"},"key":"sort"}],"variable":[]}},"response":[{"id":"b997f050-6d83-498c-9ff9-15b1ac64bab5","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/service?direction=ascend&page=1&per_page=20&sort=created?direction&page&per_page&sort","protocol":"https","host":["api","fastly","com"],"path":["service"],"query":[{"key":"direction","description":"Direction in which to sort results."},{"key":"page","description":"Current page."},{"key":"per_page","description":"Number of records per page."},{"key":"sort","description":"Field on which to sort."}]},"description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/services/service/#list-services)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"comment\":\"\",\"created_at\":\"2020-04-27T19:40:49.000Z\",\"customer_id\":\"x4xCwxxJxGCx123Rx5xTx\",\"deleted_at\":null,\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"name\":\"test-service\",\"version\":1,\"paused\":false,\"type\":\"vcl\",\"updated_at\":\"2020-04-27T19:40:49.000Z\",\"versions\":[{\"created_at\":\"2020-04-09T18:14:30.000Z\",\"updated_at\":\"2020-04-09T18:14:30.000Z\",\"deleted_at\":null,\"active\":true,\"comment\":\"\",\"deployed\":true,\"locked\":false,\"number\":1,\"staging\":false,\"testing\":false,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\"}],\"environments\":[{\"active_version\":1,\"name\":\"production\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\"}]}]"}],"_postman_id":"2e9ec20a-f081-4a6f-90c3-64429e6eea6b"},{"name":"Create a service","id":"f3b232d6-0012-4fbb-8a7a-d340c4a8153f","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/services/service/#create-service\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"da25d932-e1a1-4a05-8b8e-09f72859ebf6","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/services/service/#create-service)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"comment\":\"\",\"created_at\":\"2020-04-27T19:40:49.000Z\",\"customer_id\":\"x4xCwxxJxGCx123Rx5xTx\",\"deleted_at\":null,\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"name\":\"test-service\",\"publish_key\":\"\",\"paused\":false,\"type\":\"vcl\",\"updated_at\":\"2020-04-27T19:40:49.000Z\",\"versions\":[{\"created_at\":\"2020-04-09T18:14:30.000Z\",\"updated_at\":\"2020-04-09T18:14:30.000Z\",\"deleted_at\":null,\"active\":true,\"comment\":\"\",\"deployed\":true,\"locked\":false,\"number\":1,\"staging\":false,\"testing\":false,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\"}],\"environments\":[{\"active_version\":1,\"name\":\"production\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\"}]}"}],"_postman_id":"f3b232d6-0012-4fbb-8a7a-d340c4a8153f"},{"name":"Get service details","id":"a524e869-a89f-4f88-9b06-8a2f539660dc","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/details?filter[versions.active]&version","description":"<p>List detailed information on a specified service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","details"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Limits the versions array to the active versions. Accepts true or false (defaults to false).</p>\n","type":"text/plain"},"key":"filter[versions.active]"},{"description":{"content":"<p>Number identifying a version of the service.</p>\n","type":"text/plain"},"key":"version"}],"variable":[]}},"response":[{"id":"a2000773-77af-4e13-abec-7da209e7d8b6","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/details?version=1?filter[versions.active]&version","protocol":"https","host":["api","fastly","com"],"path":["service","SU1Z0isxPaozGVKXdv0eY","details"],"query":[{"key":"filter[versions.active]","description":"Limits the versions array to the active versions. Accepts true or false (defaults to false)."},{"key":"version","description":"Number identifying a version of the service."}]},"description":"List detailed information on a specified service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"comment\":\"\",\"created_at\":\"2020-04-27T19:40:49.000Z\",\"customer_id\":\"x4xCwxxJxGCx123Rx5xTx\",\"deleted_at\":null,\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"name\":\"test-service\",\"publish_key\":\"\",\"paused\":false,\"type\":\"vcl\",\"updated_at\":\"2020-04-27T19:40:49.000Z\",\"versions\":[{\"created_at\":\"2020-04-09T18:14:30.000Z\",\"updated_at\":\"2020-04-09T18:14:30.000Z\",\"deleted_at\":null,\"active\":false,\"comment\":\"\",\"deployed\":true,\"locked\":false,\"number\":1,\"staging\":false,\"testing\":false,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\"}],\"environments\":[{\"active_version\":1,\"name\":\"production\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\"}],\"version\":{\"active\":false,\"backends\":[],\"cache_settings\":[],\"comment\":\"\",\"conditions\":[],\"deployed\":true,\"dictionaries\":[],\"directors\":[],\"domains\":[],\"gzips\":[],\"headers\":[],\"healthchecks\":[],\"locked\":true,\"number\":1,\"request_settings\":[],\"response_objects\":[],\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"settings\":{\"general.default_host\":\"\",\"general.default_pci\":0,\"general.default_ttl\":3600},\"snippets\":[],\"staging\":true,\"testing\":true,\"vcls\":[],\"wordpress\":[]},\"active_version\":null}"}],"_postman_id":"a524e869-a89f-4f88-9b06-8a2f539660dc"},{"name":"Search for a service by name","id":"c006dc7e-b3c3-4116-9697-9182231a0970","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/search?name","description":"<p>Get a specific service by name.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","search"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>The name of the service.</p>\n","type":"text/plain"},"key":"name"}],"variable":[]}},"response":[{"id":"63597997-61e0-4481-b897-c023a401786b","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/service/search?name=test-service?name","protocol":"https","host":["api","fastly","com"],"path":["service","search"],"query":[{"key":"name","description":"The name of the service."}]},"description":"Get a specific service by name.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"comment\":\"\",\"created_at\":\"2020-04-27T19:40:49.000Z\",\"customer_id\":\"x4xCwxxJxGCx123Rx5xTx\",\"deleted_at\":null,\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"name\":\"test-service\",\"publish_key\":\"\",\"paused\":false,\"type\":\"vcl\",\"updated_at\":\"2020-04-27T19:40:49.000Z\",\"versions\":[{\"created_at\":\"2020-04-09T18:14:30.000Z\",\"updated_at\":\"2020-04-09T18:14:30.000Z\",\"deleted_at\":null,\"active\":true,\"comment\":\"\",\"deployed\":true,\"locked\":false,\"number\":1,\"staging\":false,\"testing\":false,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\"}],\"environments\":[{\"active_version\":1,\"name\":\"production\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\"}]}"}],"_postman_id":"c006dc7e-b3c3-4116-9697-9182231a0970"},{"name":"Get a service","id":"2fbeac27-70eb-420c-9891-69cacf40197e","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}","description":"<p>Get a specific service by id.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"e7f72792-b90b-4fde-91a8-70d0235b7f8d","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY","description":"Get a specific service by id.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"comment\":\"\",\"created_at\":\"2020-04-27T19:40:49.000Z\",\"customer_id\":\"x4xCwxxJxGCx123Rx5xTx\",\"deleted_at\":null,\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"name\":\"test-service\",\"publish_key\":\"\",\"paused\":false,\"type\":\"vcl\",\"updated_at\":\"2020-04-27T19:40:49.000Z\",\"versions\":[{\"created_at\":\"2020-04-09T18:14:30.000Z\",\"updated_at\":\"2020-04-09T18:14:30.000Z\",\"deleted_at\":null,\"active\":true,\"comment\":\"\",\"deployed\":true,\"locked\":false,\"number\":1,\"staging\":false,\"testing\":false,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\"}],\"environments\":[{\"active_version\":1,\"name\":\"production\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\"}]}"}],"_postman_id":"2fbeac27-70eb-420c-9891-69cacf40197e"},{"name":"Update a service","id":"87fb3f5f-f162-4409-b18e-9e03f87e9dbd","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/services/service/#update-service\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"747c762f-ced7-4da7-8c7e-e8614671beca","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/services/service/#update-service)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"comment\":\"\",\"created_at\":\"2020-04-27T19:40:49.000Z\",\"customer_id\":\"x4xCwxxJxGCx123Rx5xTx\",\"deleted_at\":null,\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"name\":\"test-service\",\"publish_key\":\"\",\"paused\":false,\"type\":\"vcl\",\"updated_at\":\"2020-04-27T19:40:49.000Z\",\"versions\":[{\"created_at\":\"2020-04-09T18:14:30.000Z\",\"updated_at\":\"2020-04-09T18:14:30.000Z\",\"deleted_at\":null,\"active\":true,\"comment\":\"\",\"deployed\":true,\"locked\":false,\"number\":1,\"staging\":false,\"testing\":false,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\"}],\"environments\":[{\"active_version\":1,\"name\":\"production\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\"}]}"}],"_postman_id":"87fb3f5f-f162-4409-b18e-9e03f87e9dbd"},{"name":"Delete a service","id":"a5ecbb85-3c7d-4bde-92bd-017011a18e9e","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/services/service/#delete-service\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"fe94830d-e6b1-4156-b296-e535080721b2","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/services/service/#delete-service)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"a5ecbb85-3c7d-4bde-92bd-017011a18e9e"},{"name":"List the domains within a service","id":"a01b6155-93c8-4bfd-aec3-3eae4c4334be","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/domain","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/services/service/#list-service-domains\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","domain"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"77c4e370-8374-479b-b3ba-d86a2fee4dd5","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/domain","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/services/service/#list-service-domains)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"comment\":\"\",\"name\":\"www.example.com\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":1,\"created_at\":\"2020-03-15T20:10:09.000Z\",\"updated_at\":\"2020-03-15T20:10:09.000Z\",\"deleted_at\":null}]"}],"_postman_id":"a01b6155-93c8-4bfd-aec3-3eae4c4334be"}],"id":"7504733e-4f92-4a25-b847-dcc406f5110c","description":"<p>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.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>comment</td>\n<td>string</td>\n<td>A freeform descriptive note.</td>\n</tr>\n<tr>\n<td>customer_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the customer.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The name of the service.</td>\n</tr>\n<tr>\n<td>type</td>\n<td>string</td>\n<td>The type of this service.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>environments</td>\n<td>array</td>\n<td>A list of environments where the service has been deployed.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>paused</td>\n<td>boolean</td>\n<td>Whether 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.</td>\n</tr>\n<tr>\n<td>publish_key</td>\n<td>string</td>\n<td>Unused at this time.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>versions</td>\n<td>array</td>\n<td>A list of versions associated with the service.</td>\n</tr>\n<tr>\n<td>active</td>\n<td>boolean</td>\n<td>Whether this is the active version or not.</td>\n</tr>\n<tr>\n<td>backends</td>\n<td>array</td>\n<td>List of backends associated to this service.</td>\n</tr>\n<tr>\n<td>cache_settings</td>\n<td>array</td>\n<td>List of cache settings associated to this service.</td>\n</tr>\n<tr>\n<td>conditions</td>\n<td>array</td>\n<td>List of conditions associated to this service.</td>\n</tr>\n<tr>\n<td>deployed</td>\n<td>boolean</td>\n<td>Unused at this time.</td>\n</tr>\n<tr>\n<td>directors</td>\n<td>array</td>\n<td>List of directors associated to this service.</td>\n</tr>\n<tr>\n<td>domains</td>\n<td>array</td>\n<td>List of domains associated to this service.</td>\n</tr>\n<tr>\n<td>gzips</td>\n<td>array</td>\n<td>List of gzip rules associated to this service.</td>\n</tr>\n<tr>\n<td>headers</td>\n<td>array</td>\n<td>List of headers associated to this service.</td>\n</tr>\n<tr>\n<td>healthchecks</td>\n<td>array</td>\n<td>List of healthchecks associated to this service.</td>\n</tr>\n<tr>\n<td>locked</td>\n<td>boolean</td>\n<td>Whether this version is locked or not. Objects can not be added or edited on locked versions.</td>\n</tr>\n<tr>\n<td>number</td>\n<td>integer</td>\n<td>The number of this version.</td>\n</tr>\n<tr>\n<td>request_settings</td>\n<td>array</td>\n<td>List of request settings for this service.</td>\n</tr>\n<tr>\n<td>response_objects</td>\n<td>array</td>\n<td>List of response objects for this service.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>settings</td>\n<td>object</td>\n<td>List of default settings for this service.</td>\n</tr>\n<tr>\n<td>snippets</td>\n<td>array</td>\n<td>List of VCL snippets for this service.</td>\n</tr>\n<tr>\n<td>staging</td>\n<td>boolean</td>\n<td>Unused at this time.</td>\n</tr>\n<tr>\n<td>testing</td>\n<td>boolean</td>\n<td>Unused at this time.</td>\n</tr>\n<tr>\n<td>vcls</td>\n<td>array</td>\n<td>List of VCL files for this service.</td>\n</tr>\n<tr>\n<td>wordpress</td>\n<td>array</td>\n<td>A list of Wordpress rules with this service.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"7504733e-4f92-4a25-b847-dcc406f5110c"},{"name":"Version","item":[{"name":"List versions of a service","id":"1c945348-0f10-40d8-9e5c-96223e1d6791","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version","description":"<p>List the versions for a particular service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"0506be76-12d4-494c-b04a-9e9118148c92","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version","description":"List the versions for a particular service.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"created_at\":\"2020-04-09T18:14:30.000Z\",\"updated_at\":\"2020-04-09T18:14:30.000Z\",\"deleted_at\":null,\"active\":true,\"comment\":\"\",\"deployed\":true,\"locked\":false,\"number\":1,\"staging\":false,\"testing\":false,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"environments\":[{\"active_version\":1,\"name\":\"production\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\"}]}]"}],"_postman_id":"1c945348-0f10-40d8-9e5c-96223e1d6791"},{"name":"Create a service version","id":"108865c3-775a-4efc-9b05-dbc912d4a3b7","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version","description":"<p>Create a version for a particular service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"18106e10-4c96-4eed-b1e9-adfd1eb1aade","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version","description":"Create a version for a particular service.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"number\":1,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\"}"}],"_postman_id":"108865c3-775a-4efc-9b05-dbc912d4a3b7"},{"name":"Get a version of a service","id":"ee2759c2-0a86-47b2-a2fa-f12d77b09474","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}","description":"<p>Get the version for a particular service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"9c40605d-2aa0-430d-86bb-d756d7f72688","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1","description":"Get the version for a particular service.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"created_at\":\"2020-04-09T18:14:30.000Z\",\"updated_at\":\"2020-04-09T18:14:30.000Z\",\"deleted_at\":null,\"active\":true,\"comment\":\"\",\"deployed\":true,\"locked\":false,\"number\":1,\"staging\":false,\"testing\":false,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"environments\":[{\"active_version\":1,\"name\":\"production\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\"}]}"}],"_postman_id":"ee2759c2-0a86-47b2-a2fa-f12d77b09474"},{"name":"Update a service version","id":"0464b7d0-befa-4701-aec9-0a18f22446de","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}","description":"<p>Update a particular version for a particular service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"7469b8d4-d90f-446c-a479-3d356c8536e3","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1","description":"Update a particular version for a particular service.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"created_at\":\"2020-04-09T18:14:30.000Z\",\"updated_at\":\"2020-04-09T18:15:30.000Z\",\"deleted_at\":null,\"active\":true,\"comment\":\"\",\"deployed\":true,\"locked\":false,\"number\":1,\"staging\":false,\"testing\":false,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"environments\":[{\"active_version\":1,\"name\":\"production\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\"}]}"}],"_postman_id":"0464b7d0-befa-4701-aec9-0a18f22446de"},{"name":"Validate a service version","id":"5b2c4c73-0d09-4d54-8c7c-ea688aedaa97","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/validate","description":"<p>Validate the version for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","validate"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"1c47da35-c2ab-4f2a-a062-f33ca10709ab","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/validate","description":"Validate the version for a particular service and version.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"5b2c4c73-0d09-4d54-8c7c-ea688aedaa97"},{"name":"Activate a service version","id":"c96532f5-fbb5-4105-8b8b-8e5ba6e113b4","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/activate","description":"<p>Activate the current version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","activate"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"428848b6-1d4e-42bf-b1a4-9a834c36ee69","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/activate","description":"Activate the current version.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"created_at\":\"2020-04-09T18:14:30.000Z\",\"updated_at\":\"2020-04-09T18:15:30.000Z\",\"deleted_at\":null,\"active\":true,\"comment\":\"\",\"deployed\":true,\"locked\":false,\"number\":1,\"staging\":false,\"testing\":false,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"environments\":[{\"active_version\":1,\"name\":\"production\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\"}]}"}],"_postman_id":"c96532f5-fbb5-4105-8b8b-8e5ba6e113b4"},{"name":"Activate a service version on the specified environment","id":"599eb5af-faa9-490f-8456-d5d2166b9f02","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/activate/{{environment_name}}","description":"<p>Activate a version on a given environment, i.e. \"staging\".</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","activate","{{environment_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"158d6dfa-a83c-4035-9f95-301ec27a0f58","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/activate/{{environment_name}}","description":"Activate a version on a given environment, i.e. \"staging\".\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"created_at\":\"2020-04-09T18:14:30.000Z\",\"updated_at\":\"2020-04-09T18:15:30.000Z\",\"deleted_at\":null,\"active\":true,\"comment\":\"\",\"deployed\":true,\"locked\":false,\"number\":1,\"staging\":true,\"testing\":false,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"environments\":[{\"active_version\":2,\"name\":\"production\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\"},{\"active_version\":3,\"name\":\"staging\",\"service_id\":\"Dj3vLgrOYflQRFRAFcUXW2\"}]}"}],"_postman_id":"599eb5af-faa9-490f-8456-d5d2166b9f02"},{"name":"Deactivate a service version","id":"3dbdd497-af8e-4e8d-ad7a-c19e94c6854a","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/deactivate","description":"<p>Deactivate the current version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","deactivate"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"ce518539-6143-49a3-aa85-9e4382dbce19","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/deactivate","description":"Deactivate the current version.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"created_at\":\"2020-04-09T18:14:30.000Z\",\"updated_at\":\"2020-04-09T18:15:30.000Z\",\"deleted_at\":null,\"active\":false,\"comment\":\"\",\"deployed\":true,\"locked\":false,\"number\":1,\"staging\":false,\"testing\":false,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"environments\":[{\"active_version\":1,\"name\":\"production\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\"}]}"}],"_postman_id":"3dbdd497-af8e-4e8d-ad7a-c19e94c6854a"},{"name":"Deactivate a service version on an environment","id":"e3c91474-9d04-4d0e-bf35-76058ee20bbe","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/deactivate/{{environment_name}}","description":"<p>Deactivate the current version on a given environment, i.e. \"staging\".</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","deactivate","{{environment_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"392e3d56-5fc7-4b53-bc07-b6dcc0211f89","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/deactivate/{{environment_name}}","description":"Deactivate the current version on a given environment, i.e. \"staging\".\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"created_at\":\"2020-04-09T18:14:30.000Z\",\"updated_at\":\"2020-04-09T18:15:30.000Z\",\"deleted_at\":null,\"active\":true,\"comment\":\"\",\"deployed\":true,\"locked\":false,\"number\":1,\"staging\":false,\"testing\":false,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"environments\":[{\"active_version\":1,\"name\":\"production\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\"}]}"}],"_postman_id":"e3c91474-9d04-4d0e-bf35-76058ee20bbe"},{"name":"Clone a service version","id":"3fc69794-5b10-4a6e-a3d0-c4282fdfebb0","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/clone","description":"<p>Clone the current configuration into a new version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","clone"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"b7d7cbd3-fef6-4b29-a5c0-e0a04124d799","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/clone","description":"Clone the current configuration into a new version.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"created_at\":\"2020-04-09T18:14:30.000Z\",\"updated_at\":\"2020-04-09T18:15:30.000Z\",\"deleted_at\":null,\"active\":true,\"comment\":\"\",\"deployed\":true,\"locked\":false,\"number\":2,\"staging\":false,\"testing\":false,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"environments\":[{\"active_version\":1,\"name\":\"production\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\"}]}"}],"_postman_id":"3fc69794-5b10-4a6e-a3d0-c4282fdfebb0"},{"name":"Lock a service version","id":"99e0fcf0-aec2-41cc-96cd-362691471b77","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/lock","description":"<p>Locks the specified version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","lock"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"1fa10200-24d3-41b3-bac4-8d920f3238e2","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/lock","description":"Locks the specified version.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"created_at\":\"2020-04-09T18:14:30.000Z\",\"updated_at\":\"2020-04-09T18:15:30.000Z\",\"deleted_at\":null,\"active\":true,\"comment\":\"\",\"deployed\":true,\"locked\":true,\"number\":1,\"staging\":false,\"testing\":false,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"environments\":[{\"active_version\":1,\"name\":\"production\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\"}]}"}],"_postman_id":"99e0fcf0-aec2-41cc-96cd-362691471b77"}],"id":"117d1418-5fbd-40c8-b842-e1741196403b","description":"<p>A Version represents a specific instance of the configuration for a service. A Version can be cloned, locked, activated, or deactivated.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>active</td>\n<td>boolean</td>\n<td>Whether this is the active version or not.</td>\n</tr>\n<tr>\n<td>comment</td>\n<td>string</td>\n<td>A freeform descriptive note.</td>\n</tr>\n<tr>\n<td>deployed</td>\n<td>boolean</td>\n<td>Unused at this time.</td>\n</tr>\n<tr>\n<td>locked</td>\n<td>boolean</td>\n<td>Whether this version is locked or not. Objects can not be added or edited on locked versions.</td>\n</tr>\n<tr>\n<td>number</td>\n<td>integer</td>\n<td>The number of this version.</td>\n</tr>\n<tr>\n<td>staging</td>\n<td>boolean</td>\n<td>Unused at this time.</td>\n</tr>\n<tr>\n<td>testing</td>\n<td>boolean</td>\n<td>Unused at this time.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>environments</td>\n<td>array</td>\n<td>A list of environments where the service has been deployed.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"117d1418-5fbd-40c8-b842-e1741196403b"}],"id":"04b9baed-2a06-4fc9-a79e-9dcb2fdbbc72","_postman_id":"04b9baed-2a06-4fc9-a79e-9dcb2fdbbc72","description":""},{"name":"Edge data storage","item":[{"name":"Config store item","item":[{"name":"List items in a config store","id":"7cc0c90f-4c42-4eb8-8be9-467d776c9f03","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/resources/stores/config/{{config_store_id}}/items","description":"<p>List the key-value pairs associated with a given config store ID.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","stores","config","{{config_store_id}}","items"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"f8e31fd6-719d-481d-932e-1cb10e985ca0","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/resources/stores/config/7Lsb7Y76rChV9hSrv3KgFl/items","description":"List the key-value pairs associated with a given config store ID.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"store_id\":\"3vjTN8v1O7nOAY7aNDGOL\",\"item_key\":\"test-key\",\"item_value\":\"test-value\",\"created_at\":\"2020-04-21T18:14:32.000Z\",\"deleted_at\":null,\"updated_at\":\"2020-04-21T18:14:32.000Z\"}]"}],"_postman_id":"7cc0c90f-4c42-4eb8-8be9-467d776c9f03"},{"name":"Update multiple entries in a config store","id":"09eb2f9b-fc9e-4924-99aa-938e8b614118","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"items\":[{\"op\":\"create\",\"item_key\":\"test-key\",\"item_value\":\"new-value\"},{\"op\":\"update\",\"item_key\":\"test-key-2\",\"item_value\":\"new-value-2\"},{\"op\":\"upsert\",\"item_key\":\"test-key-3\",\"item_value\":\"new-value-3\"},{\"op\":\"delete\",\"item_key\":\"test-key-4\"}]}"},"url":"https://api.fastly.com/resources/stores/config/{{config_store_id}}/items","description":"<p>Add multiple key-value pairs to an individual config store, specified by ID.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","stores","config","{{config_store_id}}","items"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"a121a3f1-e9a4-47dc-9e93-fd45f3a29b77","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"items\":[{\"op\":\"create\",\"item_key\":\"test-key\",\"item_value\":\"new-value\"},{\"op\":\"update\",\"item_key\":\"test-key-2\",\"item_value\":\"new-value-2\"},{\"op\":\"upsert\",\"item_key\":\"test-key-3\",\"item_value\":\"new-value-3\"},{\"op\":\"delete\",\"item_key\":\"test-key-4\"}]}"},"url":"https://api.fastly.com/resources/stores/config/7Lsb7Y76rChV9hSrv3KgFl/items","description":"Add multiple key-value pairs to an individual config store, specified by ID.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"09eb2f9b-fc9e-4924-99aa-938e8b614118"},{"name":"Create an entry in a config store","id":"fa7231a4-f384-4107-a84a-3587a80abb8c","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/resources/stores/config/{{config_store_id}}/item","description":"<p>Add a single key-value pair to an individual config store, specified by ID.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","stores","config","{{config_store_id}}","item"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"0299df02-4eb8-40eb-bdbe-8c3daa67342e","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/resources/stores/config/7Lsb7Y76rChV9hSrv3KgFl/item","description":"Add a single key-value pair to an individual config store, specified by ID.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"store_id\":\"3vjTN8v1O7nOAY7aNDGOL\",\"item_key\":\"test-key\",\"item_value\":\"test-value\",\"created_at\":\"2020-04-21T18:14:32.000Z\",\"deleted_at\":null,\"updated_at\":\"2020-04-21T18:14:32.000Z\"}"}],"_postman_id":"fa7231a4-f384-4107-a84a-3587a80abb8c"},{"name":"Get an item from a config store","id":"b828fd4c-2779-4f83-b199-0831b8a656c7","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/resources/stores/config/{{config_store_id}}/item/{{config_store_item_key}}","description":"<p>Retrieve a config store entry given a config store ID and item key.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","stores","config","{{config_store_id}}","item","{{config_store_item_key}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"8b3f0790-4915-4f95-92f4-c73b21404b60","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/resources/stores/config/7Lsb7Y76rChV9hSrv3KgFl/item/test-key","description":"Retrieve a config store entry given a config store ID and item key.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"store_id\":\"3vjTN8v1O7nOAY7aNDGOL\",\"item_key\":\"test-key\",\"item_value\":\"test-value\",\"created_at\":\"2020-04-21T18:14:32.000Z\",\"deleted_at\":null,\"updated_at\":\"2020-04-21T18:14:32.000Z\"}"}],"_postman_id":"b828fd4c-2779-4f83-b199-0831b8a656c7"},{"name":"Insert or update an entry in a config store","id":"33c89c27-1764-4cfe-afaa-d7e9107447ff","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/resources/stores/config/{{config_store_id}}/item/{{config_store_item_key}}","description":"<p>Insert or update an entry in a config store given a config store ID, item key, and item value.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","stores","config","{{config_store_id}}","item","{{config_store_item_key}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"82904673-f07c-4410-9a69-2b3695ef509c","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/resources/stores/config/7Lsb7Y76rChV9hSrv3KgFl/item/test-key","description":"Insert or update an entry in a config store given a config store ID, item key, and item value.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"store_id\":\"3vjTN8v1O7nOAY7aNDGOL\",\"item_key\":\"test-key\",\"item_value\":\"test-value\",\"created_at\":\"2020-04-21T18:14:32.000Z\",\"deleted_at\":null,\"updated_at\":\"2020-04-21T18:14:32.000Z\"}"}],"_postman_id":"33c89c27-1764-4cfe-afaa-d7e9107447ff"},{"name":"Delete an item from a config store","id":"f722eaa2-da54-4503-8908-f5aa56fd83c8","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/resources/stores/config/{{config_store_id}}/item/{{config_store_item_key}}","description":"<p>Delete an entry in a config store given a config store ID, and item key.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","stores","config","{{config_store_id}}","item","{{config_store_item_key}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"71df8bfe-7dc6-4022-bdb7-9524d41d552b","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/resources/stores/config/7Lsb7Y76rChV9hSrv3KgFl/item/test-key","description":"Delete an entry in a config store given a config store ID, and item key.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"f722eaa2-da54-4503-8908-f5aa56fd83c8"},{"name":"Update an entry in a config store","id":"5b1a1f4c-7e1e-4917-b899-841592a618a9","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/resources/stores/config/{{config_store_id}}/item/{{config_store_item_key}}","description":"<p>Update an entry in a config store given a config store ID, item key, and item value.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","stores","config","{{config_store_id}}","item","{{config_store_item_key}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"1c0ea5b5-7d5f-4435-9900-6ab6e73ddc75","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/resources/stores/config/7Lsb7Y76rChV9hSrv3KgFl/item/test-key","description":"Update an entry in a config store given a config store ID, item key, and item value.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"store_id\":\"3vjTN8v1O7nOAY7aNDGOL\",\"item_key\":\"test-key\",\"item_value\":\"test-value\",\"created_at\":\"2020-04-21T18:14:32.000Z\",\"deleted_at\":null,\"updated_at\":\"2020-04-21T18:14:32.000Z\"}"}],"_postman_id":"5b1a1f4c-7e1e-4917-b899-841592a618a9"}],"id":"64eca54b-4f38-4338-8d95-656d02671bdc","description":"<p>A key-value pair within a config store. Learn more about config stores.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>item_key</td>\n<td>string</td>\n<td>Item key, maximum 256 characters.</td>\n</tr>\n<tr>\n<td>item_value</td>\n<td>string</td>\n<td>Item value, maximum 8000 characters.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>store_id</td>\n<td>string</td>\n<td>An alphanumeric string identifying the config store.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"64eca54b-4f38-4338-8d95-656d02671bdc"},{"name":"Config store","item":[{"name":"List config stores","id":"e54a7e13-2f5d-48ff-ab66-7301b947f709","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/resources/stores/config?name","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/services/resources/config-store/#list-config-stores\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","stores","config"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Returns a one-element array containing the details for the named config store.</p>\n","type":"text/plain"},"key":"name"}],"variable":[]}},"response":[{"id":"a11c0e6c-e6f3-48b8-807d-a6962526d969","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/resources/stores/config?name","protocol":"https","host":["api","fastly","com"],"path":["resources","stores","config"],"query":[{"key":"name","description":"Returns a one-element array containing the details for the named config store."}]},"description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/services/resources/config-store/#list-config-stores)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"id\":\"7Lsb7Y76rChV9hSrv3KgFl\",\"name\":\"test-config-store\",\"updated_at\":\"2020-04-29T22:16:23.000Z\",\"created_at\":\"2020-04-29T22:16:23.000Z\",\"deleted_at\":null}]"}],"_postman_id":"e54a7e13-2f5d-48ff-ab66-7301b947f709"},{"name":"Create a config store","id":"ac9772b6-2d2d-4726-a70a-f596c4f420a4","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/resources/stores/config","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/services/resources/config-store/#create-config-store\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","stores","config"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"47db367d-658c-4d05-93d6-bf6b6136f68d","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/resources/stores/config","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/services/resources/config-store/#create-config-store)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"7Lsb7Y76rChV9hSrv3KgFl\",\"name\":\"test-config-store\",\"updated_at\":\"2020-04-29T22:16:23.000Z\",\"created_at\":\"2020-04-29T22:16:23.000Z\",\"deleted_at\":null}"}],"_postman_id":"ac9772b6-2d2d-4726-a70a-f596c4f420a4"},{"name":"Describe a config store","id":"69450570-944d-494e-8fb9-dd3b2806e287","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/resources/stores/config/{{config_store_id}}","description":"<p>Describe a config store by its identifier.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","stores","config","{{config_store_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"d1a5ac8a-29c4-4e1d-afac-35880167c4a3","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/resources/stores/config/7Lsb7Y76rChV9hSrv3KgFl","description":"Describe a config store by its identifier.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"7Lsb7Y76rChV9hSrv3KgFl\",\"name\":\"test-config-store\",\"updated_at\":\"2020-04-29T22:16:23.000Z\",\"created_at\":\"2020-04-29T22:16:23.000Z\",\"deleted_at\":null}"}],"_postman_id":"69450570-944d-494e-8fb9-dd3b2806e287"},{"name":"Update a config store","id":"1d0d92ff-13f3-4d98-a521-21f414d7779d","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/resources/stores/config/{{config_store_id}}","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/services/resources/config-store/#update-config-store\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","stores","config","{{config_store_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"715cbdd2-4b1a-4caf-b9f6-1d28b181d400","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/resources/stores/config/7Lsb7Y76rChV9hSrv3KgFl","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/services/resources/config-store/#update-config-store)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"7Lsb7Y76rChV9hSrv3KgFl\",\"name\":\"test-config-store\",\"updated_at\":\"2020-04-29T22:16:23.000Z\",\"created_at\":\"2020-04-29T22:16:23.000Z\",\"deleted_at\":null}"}],"_postman_id":"1d0d92ff-13f3-4d98-a521-21f414d7779d"},{"name":"Delete a config store","id":"e36500c5-b4b1-4fde-8702-7ae287c91cb7","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/resources/stores/config/{{config_store_id}}","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/services/resources/config-store/#delete-config-store\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","stores","config","{{config_store_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"4ef4b1c8-aa47-45b1-8082-50c361a663f3","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/resources/stores/config/7Lsb7Y76rChV9hSrv3KgFl","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/services/resources/config-store/#delete-config-store)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"e36500c5-b4b1-4fde-8702-7ae287c91cb7"},{"name":"Get config store metadata","id":"523f628e-2844-48c9-9dc8-0ad5ad69d697","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/resources/stores/config/{{config_store_id}}/info","description":"<p>Retrieve metadata for a single config store.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","stores","config","{{config_store_id}}","info"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"c1b40136-aa04-4bda-bd67-c284710a85d6","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/resources/stores/config/7Lsb7Y76rChV9hSrv3KgFl/info","description":"Retrieve metadata for a single config store.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"item_count\":1}"}],"_postman_id":"523f628e-2844-48c9-9dc8-0ad5ad69d697"},{"name":"List linked services","id":"bbfc0a2e-fbcb-432a-b1f7-fc62bc09a935","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/resources/stores/config/{{config_store_id}}/services","description":"<p>List services linked to a config store.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","stores","config","{{config_store_id}}","services"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"c074cb28-38da-4fc5-93ff-a2dc11d30ca5","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/resources/stores/config/7Lsb7Y76rChV9hSrv3KgFl/services","description":"List services linked to a config store.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"id\":\"0QbayrOodFILsM58jum2nt\",\"name\":\"api service\",\"type\":\"vcl\",\"customer_id\":\"x4xCwxxJxGCx123Rx5xTx\",\"comment\":\"\",\"paused\":false,\"created_at\":\"2021-05-17T17:56:25.000Z\",\"updated_at\":\"2021-05-17T17:56:25.000Z\",\"deleted_at\":null}]}"}],"_postman_id":"bbfc0a2e-fbcb-432a-b1f7-fc62bc09a935"}],"id":"a92a25c5-ecd7-4f21-8d4c-8d4024100300","description":"<p>A container that lets you store data in key-value pairs. Learn more about config stores.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The name of the config store.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>An alphanumeric string identifying the config store.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-1\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>item_count</td>\n<td>integer</td>\n<td>The number of items currently in the config store.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"a92a25c5-ecd7-4f21-8d4c-8d4024100300"},{"name":"KV store item","item":[{"name":"List item keys","id":"a31ce6bf-05e6-4fc9-b5a2-ada61cfd03b8","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/resources/stores/kv/{{store_id}}/keys?consistency&cursor&limit&prefix","description":"<p>Lists the matching item keys (or all item keys, if no prefix is supplied).</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","stores","kv","{{store_id}}","keys"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Determines whether the operation should read data from the primary data source, which is slower but strongly consistent (strong), or a local copy if available, which offers higher speed and may be a few seconds out of date (eventual).</p>\n","type":"text/plain"},"key":"consistency"},{"description":{"content":"<p>To be used for paginating through results.</p>\n","type":"text/plain"},"key":"cursor"},{"description":{"content":"<p>The maximum number of items to include in the response.</p>\n","type":"text/plain"},"key":"limit"},{"description":{"content":"<p>Restrict results to items whose keys match this prefix. The following characters cannot be included in a prefix query string: \"!\", \"\"\", \"$\", \"%\", \"&amp;\", \"(\", \")\", \"*\", \"+\", \",\", \"/\", \"\", \":\", \"&lt;\", \"=\", \"&gt;\", \"@\", \"[\", \"]\", \"`\", \"{\", \"}\".</p>\n","type":"text/plain"},"key":"prefix"}],"variable":[]}},"response":[{"id":"0790809a-8160-460c-be1d-984dad0ff2ea","name":"200 Successful retrieval","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/resources/stores/kv/{{store_id}}/keys?consistency&cursor&limit&prefix","protocol":"https","host":["api","fastly","com"],"path":["resources","stores","kv","{{store_id}}","keys"],"query":[{"key":"consistency","description":"Determines whether the operation should read data from the primary data source, which is slower but strongly consistent (strong), or a local copy if available, which offers higher speed and may be a few seconds out of date (eventual)."},{"key":"cursor","description":"To be used for paginating through results."},{"key":"limit","description":"The maximum number of items to include in the response."},{"key":"prefix","description":"Restrict results to items whose keys match this prefix. The following characters cannot be included in a prefix query string: \"!\", \"\"\", \"$\", \"%\", \"&\", \"(\", \")\", \"*\", \"+\", \",\", \"/\", \"\", \":\", \"<\", \"=\", \">\", \"@\", \"[\", \"]\", \"`\", \"{\", \"}\"."}]},"description":"Lists the matching item keys (or all item keys, if no prefix is supplied).\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Successful retrieval","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[\"key1\",\"key2\",\"key3\"],\"meta\":{\"next_cursor\":\"dXNlcjpVMEc5V0ZYTlo=\",\"limit\":5}}"}],"_postman_id":"a31ce6bf-05e6-4fc9-b5a2-ada61cfd03b8"},{"name":"Get an item","id":"0fd398f6-48e9-4279-b90c-209868e1a422","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/resources/stores/kv/{{store_id}}/keys/{{key}}","description":"<p>Get an item, including its value, metadata (if any), and generation marker.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","stores","kv","{{store_id}}","keys","{{key}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"4ca31fff-e76d-4ad6-84a8-b57489549bd1","name":"404 Item was not found, or store was not found","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/resources/stores/kv/{{store_id}}/keys/{{key}}","description":"Get an item, including its value, metadata (if any), and generation marker.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"404 Item was not found, or store was not found","code":404,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"0fd398f6-48e9-4279-b90c-209868e1a422"},{"name":"Insert or update an item","id":"80d5b947-ea34-4056-b0d2-2e14c1e24db4","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/resources/stores/kv/{{store_id}}/keys/{{key}}?add&append&background_fetch&prepend","description":"<p>Inserts or updates an item's value and metadata.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","stores","kv","{{store_id}}","keys","{{key}}"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Limit the operation to adding a new item. If an existing item with the specified key exists, the operation will fail.</p>\n","type":"text/plain"},"key":"add"},{"description":{"content":"<p>If an item with the specified key exists, the value provided in the operation is appended to the existing value instead of replacing it.</p>\n","type":"text/plain"},"key":"append"},{"description":{"content":"<p>If set to true, the new value for the item will not be immediately visible to other users of the KV store; they will receive the existing (stale) value while the platform updates cached copies. Setting this to true ensures that other users of the KV store will receive responses to 'get' operations for this item quickly, although they will be slightly out of date.</p>\n","type":"text/plain"},"key":"background_fetch"},{"description":{"content":"<p>If an item with the specified key exists, the value provided in the operation is prepended to the existing value instead of replacing it.</p>\n","type":"text/plain"},"key":"prepend"}],"variable":[]}},"response":[{"id":"5f47db1a-2f56-43dd-8fe6-32c40c076fb1","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"}],"url":{"raw":"https://api.fastly.com/resources/stores/kv/{{store_id}}/keys/{{key}}?add&append&background_fetch&prepend","protocol":"https","host":["api","fastly","com"],"path":["resources","stores","kv","{{store_id}}","keys","{{key}}"],"query":[{"key":"add","description":"Limit the operation to adding a new item. If an existing item with the specified key exists, the operation will fail."},{"key":"append","description":"If an item with the specified key exists, the value provided in the operation is appended to the existing value instead of replacing it."},{"key":"background_fetch","description":"If set to true, the new value for the item will not be immediately visible to other users of the KV store; they will receive the existing (stale) value while the platform updates cached copies. Setting this to true ensures that other users of the KV store will receive responses to 'get' operations for this item quickly, although they will be slightly out of date."},{"key":"prepend","description":"If an item with the specified key exists, the value provided in the operation is prepended to the existing value instead of replacing it."}]},"description":"Inserts or updates an item's value and metadata.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"80d5b947-ea34-4056-b0d2-2e14c1e24db4"},{"name":"Delete an item","id":"414f073d-1a85-4fd4-8c90-5d0c18b06088","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/resources/stores/kv/{{store_id}}/keys/{{key}}?force","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/services/resources/kv-store-item/#kv-store-delete-item\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","stores","kv","{{store_id}}","keys","{{key}}"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Return a successful result from a 'delete' operation even if the specified key was not found.</p>\n","type":"text/plain"},"key":"force"}],"variable":[]}},"response":[{"id":"2dffbb0e-fe1e-4173-a9e7-6b6ca4aa146e","name":"204 Successful deletion","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":{"raw":"https://api.fastly.com/resources/stores/kv/{{store_id}}/keys/{{key}}?force","protocol":"https","host":["api","fastly","com"],"path":["resources","stores","kv","{{store_id}}","keys","{{key}}"],"query":[{"key":"force","description":"Return a successful result from a 'delete' operation even if the specified key was not found."}]},"description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/services/resources/kv-store-item/#kv-store-delete-item)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 Successful deletion","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"414f073d-1a85-4fd4-8c90-5d0c18b06088"},{"name":"Insert or update multiple items","id":"25123dc8-e87d-4545-b8e0-5e6a647f8bc7","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-ndjson"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"[{\"key\":\"hello\",\"value\":\"d29ybGRzCg==\"},{\"key\":\"fastly\",\"value\":\"a3ZzdG9yZQo=\",\"time_to_live_sec\":60,\"metadata\":\"up to 2000 bytes of data\",\"background_fetch\":true}]"},"url":"https://api.fastly.com/resources/stores/kv/{{store_id}}/batch","description":"<p>Inserts or updates multiple items in a single operation.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","stores","kv","{{store_id}}","batch"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"eb00caab-2cb7-4559-a9ec-8aa7b6f68188","name":"200 All inserts and/or updates succeeded","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-ndjson"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"[{\"key\":\"hello\",\"value\":\"d29ybGRzCg==\"},{\"key\":\"fastly\",\"value\":\"a3ZzdG9yZQo=\",\"time_to_live_sec\":60,\"metadata\":\"up to 2000 bytes of data\",\"background_fetch\":true}]"},"url":"https://api.fastly.com/resources/stores/kv/{{store_id}}/batch","description":"Inserts or updates multiple items in a single operation.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 All inserts and/or updates succeeded","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"type\":\"\",\"title\":\"success\",\"errors\":[]}"}],"_postman_id":"25123dc8-e87d-4545-b8e0-5e6a647f8bc7"}],"id":"56cf5762-c38f-48b5-ad67-565b06542904","description":"<p>These endpoints are used to list, create, update, and delete items in a KV store.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>background_fetch</td>\n<td>boolean</td>\n<td>If set to true, the new value for the item will not be immediately visible to other users of the KV store; they will receive the existing (stale) value while the platform updates cached copies. Setting this to true ensures that other users of the KV store will receive responses to 'get' operations for this item quickly, although they will be slightly out of date.</td>\n</tr>\n<tr>\n<td>key</td>\n<td>string</td>\n<td>The key of the item to be added, updated, retrieved, or deleted.</td>\n</tr>\n<tr>\n<td>metadata</td>\n<td>string</td>\n<td>An arbitrary data field which can contain up to 2000 bytes of data.</td>\n</tr>\n<tr>\n<td>time_to_live_sec</td>\n<td>integer</td>\n<td>Indicates that the item should be deleted after the specified number of seconds have elapsed. Deletion is not immediate but will occur within 24 hours of the requested expiration.</td>\n</tr>\n<tr>\n<td>value</td>\n<td>string</td>\n<td>Value for the item (in Base64 encoding).</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"56cf5762-c38f-48b5-ad67-565b06542904"},{"name":"KV store","item":[{"name":"List all KV stores","id":"6b694db5-3981-48f5-9879-164e54e6b142","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/resources/stores/kv?cursor&limit&name","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/services/resources/kv-store/#kv-store-list\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","stores","kv"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>To be used for paginating through results.</p>\n","type":"text/plain"},"key":"cursor"},{"description":{"content":"<p>The maximum number of KV stores to include in the response.</p>\n","type":"text/plain"},"key":"limit"},{"description":{"content":"<p>Returns a one-element array containing the details for the named KV store.</p>\n","type":"text/plain"},"key":"name"}],"variable":[]}},"response":[{"id":"803a5c32-385f-4309-8515-0dc65d5d0ef3","name":"200 Stores listed.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/resources/stores/kv?cursor&limit&name","protocol":"https","host":["api","fastly","com"],"path":["resources","stores","kv"],"query":[{"key":"cursor","description":"To be used for paginating through results."},{"key":"limit","description":"The maximum number of KV stores to include in the response."},{"key":"name","description":"Returns a one-element array containing the details for the named KV store."}]},"description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/services/resources/kv-store/#kv-store-list)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Stores listed.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"id\":\"4Sgqo6S0NFWlWXnVPK1F4p\",\"name\":\"store-name-1\"},{\"id\":\"4Sgqo6S0NFWlWXnVPK1F4q\",\"name\":\"store-name-2\"},{\"id\":\"4Sgqo6S0NFWlWXnVPK1F4r\",\"name\":\"store-name-3\"}],\"meta\":{\"next_cursor\":\"dXNlcjpVMEc5V0ZYTlo=\",\"limit\":5}}"}],"_postman_id":"6b694db5-3981-48f5-9879-164e54e6b142"},{"name":"Create a KV store","id":"7eaf9c9d-ed77-4a74-8dbf-31617ee60ce6","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"my-store\"}"},"url":"https://api.fastly.com/resources/stores/kv?location","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/services/resources/kv-store/#kv-store-create\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","stores","kv"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Region where the KV store will be located.</p>\n","type":"text/plain"},"key":"location"}],"variable":[]}},"response":[{"id":"b8d2d2aa-7aaa-44fa-9020-852443745c81","name":"201 Store created.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"my-store\"}"},"url":{"raw":"https://api.fastly.com/resources/stores/kv?location","protocol":"https","host":["api","fastly","com"],"path":["resources","stores","kv"],"query":[{"key":"location","description":"Region where the KV store will be located."}]},"description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/services/resources/kv-store/#kv-store-create)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"201 Store created.","code":201,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"rOfpDPC22rNe2ZAMnnf2o\",\"name\":\"my-store\",\"created_at\":\"2025-01-01T00:00:00.000Z\",\"updated_at\":\"2025-01-01T00:00:00.000Z\"}"}],"_postman_id":"7eaf9c9d-ed77-4a74-8dbf-31617ee60ce6"},{"name":"Describe a KV store","id":"6373182a-b9a6-492a-b69f-a8777589a496","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/resources/stores/kv/{{store_id}}","description":"<p>Get details of a KV store.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","stores","kv","{{store_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"48911c39-6445-4570-a2f3-7c018726b683","name":"200 Store was found.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/resources/stores/kv/{{store_id}}","description":"Get details of a KV store.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Store was found.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"rOfpDPC22rNe2ZAMnnf2o\",\"name\":\"my-store\",\"created_at\":\"2025-01-01T00:00:00.000Z\",\"updated_at\":\"2025-01-01T00:00:00.000Z\"}"}],"_postman_id":"6373182a-b9a6-492a-b69f-a8777589a496"},{"name":"Update a KV store","id":"79cc1865-a43c-4247-adb8-bb955be9888f","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"my-renamed-store\"}"},"url":"https://api.fastly.com/resources/stores/kv/{{store_id}}","description":"<p>Update the name of a KV store.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","stores","kv","{{store_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"4875fd4a-696b-485d-bd24-ebb7104682b9","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"my-renamed-store\"}"},"url":"https://api.fastly.com/resources/stores/kv/{{store_id}}","description":"Update the name of a KV store.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"79cc1865-a43c-4247-adb8-bb955be9888f"},{"name":"Delete a KV store","id":"c61f058a-e607-4c14-93c8-4e2423e956e3","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/resources/stores/kv/{{store_id}}","description":"<p>A KV store must be empty before it can be deleted. Attempting to delete a KV store that contains items will result in a response with a 409 status code.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","stores","kv","{{store_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"62243f3a-ebb6-418a-a645-60e667319005","name":"204 Deletion succeeded","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/resources/stores/kv/{{store_id}}","description":"A KV store must be empty before it can be deleted. Attempting to delete a KV store that contains items will result in a response with a 409 status code.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 Deletion succeeded","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"c61f058a-e607-4c14-93c8-4e2423e956e3"}],"id":"ee4ab874-8453-411e-acc4-b63b82c53a6d","description":"<p>These endpoints are used to create, describe, list, and delete KV stores.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>A human-readable name for the store. Refer to <a href=\"https://docs.fastly.com/products/compute-resource-limits#kv-store\">https://docs.fastly.com/products/compute-resource-limits#kv-store</a> for limitations on the KV store name.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"ee4ab874-8453-411e-acc4-b63b82c53a6d"},{"name":"Object Storage Access Keys","item":[{"name":"List access keys","id":"8597666d-5e49-405f-b6c1-4f277a6ee13d","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/resources/object-storage/access-keys","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/services/resources/object-storage-access-keys/#list-access-keys\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","object-storage","access-keys"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"5e47f2a8-549e-4c5c-b02d-d8883d5ce108","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/resources/object-storage/access-keys","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/services/resources/object-storage-access-keys/#list-access-keys)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"access_key\":\"QAi4c3xcRq7YN50OrswoKU\",\"description\":\"My access key\",\"permission\":\"read-write-objects\",\"buckets\":[\"my-bucket\"],\"created_at\":\"2024-11-05T17:05:14.244Z\"}]}"}],"_postman_id":"8597666d-5e49-405f-b6c1-4f277a6ee13d"},{"name":"Create an access key","id":"8b92b178-ec93-4c14-bc7a-be8e97f2b2a2","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"description\":\"My access key\",\"permission\":\"read-write-objects\",\"buckets\":[\"my-bucket\"]}"},"url":"https://api.fastly.com/resources/object-storage/access-keys","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/services/resources/object-storage-access-keys/#create-access-key\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","object-storage","access-keys"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"83e5c4d5-3166-47d3-9d17-f2dd3bfbcdae","name":"201 Created","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"description\":\"My access key\",\"permission\":\"read-write-objects\",\"buckets\":[\"my-bucket\"]}"},"url":"https://api.fastly.com/resources/object-storage/access-keys","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/services/resources/object-storage-access-keys/#create-access-key)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"201 Created","code":201,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"access_key\":\"QAi4c3xcRq7YN50OrswoKU\",\"secret_key\":\"some secret key\",\"description\":\"My access key\",\"permission\":\"read-write-objects\",\"buckets\":[\"my-bucket\"],\"created_at\":\"2024-11-05T17:05:14.244Z\"}"}],"_postman_id":"8b92b178-ec93-4c14-bc7a-be8e97f2b2a2"},{"name":"Get an access key","id":"769b4f54-15a5-423a-9109-d0112dabc2c4","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/resources/object-storage/access-keys/{{access_key}}","description":"<p>Get an access key by its identifier.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","object-storage","access-keys","{{access_key}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"79358bda-08c8-436c-9b72-dfeaf8696cb4","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/resources/object-storage/access-keys/{{access_key}}","description":"Get an access key by its identifier.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"access_key\":\"QAi4c3xcRq7YN50OrswoKU\",\"description\":\"My access key\",\"permission\":\"read-write-objects\",\"buckets\":[\"my-bucket\"],\"created_at\":\"2024-11-05T17:05:14.244Z\"}"}],"_postman_id":"769b4f54-15a5-423a-9109-d0112dabc2c4"},{"name":"Delete an access key","id":"3b249851-4e35-41f9-bfdb-082f9a4afae7","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/resources/object-storage/access-keys/{{access_key}}","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/services/resources/object-storage-access-keys/#delete-access-key\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","object-storage","access-keys","{{access_key}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"257ddd20-5bfd-4b98-82b5-923b239fb02f","name":"204 No Content","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/resources/object-storage/access-keys/{{access_key}}","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/services/resources/object-storage-access-keys/#delete-access-key)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 No Content","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"3b249851-4e35-41f9-bfdb-082f9a4afae7"}],"id":"5def6fe9-3765-4248-9ea5-181ae7052c63","description":"<p>This API manages access keys for use with Fastly Object Storage.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>description</td>\n<td>string</td>\n<td>A description of the access key.</td>\n</tr>\n<tr>\n<td>permission</td>\n<td>string</td>\n<td>The permissions granted to an access key.</td>\n</tr>\n<tr>\n<td>access_key</td>\n<td>string</td>\n<td>Generated access key.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>secret_key</td>\n<td>string</td>\n<td>Generated secret key.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"5def6fe9-3765-4248-9ea5-181ae7052c63"},{"name":"Secret store secret","item":[{"name":"List secrets within a store","id":"01736f73-4889-429d-ad76-f9109d6fe0d8","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/resources/stores/secret/{{store_id}}/secrets?cursor&limit","description":"<p>List all secrets within a store.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","stores","secret","{{store_id}}","secrets"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Cursor value from the next_cursor field of a previous response, used to retrieve the next page. To request the first page, this should be empty.</p>\n","type":"text/plain"},"key":"cursor"},{"description":{"content":"<p>Number of results per page. The maximum is 200.</p>\n","type":"text/plain"},"key":"limit"}],"variable":[]}},"response":[{"id":"6ce4dd49-9005-4e54-9909-390baeed9da4","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/resources/stores/secret/{{store_id}}/secrets?cursor&limit","protocol":"https","host":["api","fastly","com"],"path":["resources","stores","secret","{{store_id}}","secrets"],"query":[{"key":"cursor","description":"Cursor value from the next_cursor field of a previous response, used to retrieve the next page. To request the first page, this should be empty."},{"key":"limit","description":"Number of results per page. The maximum is 200."}]},"description":"List all secrets within a store.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"name\":\"my-secret\",\"digest\":\"500162dc5358d51924861213c55077c881e729999febc29029e020e2e43151ea\",\"created_at\":\"2022-10-15T11:15:40.000Z\"}],\"meta\":{\"next_cursor\":\"aWQ6MTIzNDUK\",\"limit\":100}}"}],"_postman_id":"01736f73-4889-429d-ad76-f9109d6fe0d8"},{"name":"Create or recreate a secret in a store","id":"e6f1ecb1-b3e1-4377-a210-5560b36d99e3","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"my-secret\",\"secret\":\"SGVsbG8sIHdvcmxkIQ==\"}"},"url":"https://api.fastly.com/resources/stores/secret/{{store_id}}/secrets","description":"<p>Create or recreate a secret based on the secret's name.\nThe response object's recreated field will be true if the secret was recreated.\nThe secret field must be Base64-encoded because a secret can contain binary data.\nIn the example below, the unencoded secret is \"Hello, world!\".</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","stores","secret","{{store_id}}","secrets"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"43f9284d-9446-461e-b00b-0e4a39014c17","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"my-secret\",\"secret\":\"SGVsbG8sIHdvcmxkIQ==\"}"},"url":"https://api.fastly.com/resources/stores/secret/{{store_id}}/secrets","description":"Create or recreate a secret based on the secret's name.\nThe response object's recreated field will be true if the secret was recreated.\nThe secret field must be Base64-encoded because a secret can contain binary data.\nIn the example below, the unencoded secret is \"Hello, world!\".\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"name\":\"my-secret\",\"digest\":\"500162dc5358d51924861213c55077c881e729999febc29029e020e2e43151ea\",\"created_at\":\"2022-10-15T11:15:40.000Z\"}"}],"_postman_id":"e6f1ecb1-b3e1-4377-a210-5560b36d99e3"},{"name":"Create a new secret in a store","id":"cdb0c440-7359-4b4e-87fa-ec82edbb3a70","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"my-secret\",\"secret\":\"SGVsbG8sIHdvcmxkIQ==\"}"},"url":"https://api.fastly.com/resources/stores/secret/{{store_id}}/secrets","description":"<p>Create a new secret in a store.\nReturns an error if a secret already exists with the same name.\nSee PUT and PATCH methods for ways to recreate an existing secret.\nThe secret field must be Base64-encoded because a secret can contain binary data.\nIn the example below, the unencoded secret is \"Hello, world!\".</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","stores","secret","{{store_id}}","secrets"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"17875b82-8c0e-4e65-b59c-d41f4ca0ab1d","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"my-secret\",\"secret\":\"SGVsbG8sIHdvcmxkIQ==\"}"},"url":"https://api.fastly.com/resources/stores/secret/{{store_id}}/secrets","description":"Create a new secret in a store.\nReturns an error if a secret already exists with the same name.\nSee PUT and PATCH methods for ways to recreate an existing secret.\nThe secret field must be Base64-encoded because a secret can contain binary data.\nIn the example below, the unencoded secret is \"Hello, world!\".\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"name\":\"my-secret\",\"digest\":\"500162dc5358d51924861213c55077c881e729999febc29029e020e2e43151ea\",\"created_at\":\"2022-10-15T11:15:40.000Z\"}"}],"_postman_id":"cdb0c440-7359-4b4e-87fa-ec82edbb3a70"},{"name":"Recreate a secret in a store","id":"64b01c5d-0358-4f97-84c1-fed78b81c4b2","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"my-secret\",\"secret\":\"SGVsbG8sIHdvcmxkIQ==\"}"},"url":"https://api.fastly.com/resources/stores/secret/{{store_id}}/secrets","description":"<p>Recreate a secret based on the secret's name.\nReturns an error if there is no existing secret with the same name.\nThe secret field must be Base64-encoded because a secret can contain binary data.\nIn the example below, the unencoded secret is \"Hello, world!\".</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","stores","secret","{{store_id}}","secrets"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"37a53a39-0717-4460-8a3d-07d7d6307307","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"my-secret\",\"secret\":\"SGVsbG8sIHdvcmxkIQ==\"}"},"url":"https://api.fastly.com/resources/stores/secret/{{store_id}}/secrets","description":"Recreate a secret based on the secret's name.\nReturns an error if there is no existing secret with the same name.\nThe secret field must be Base64-encoded because a secret can contain binary data.\nIn the example below, the unencoded secret is \"Hello, world!\".\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"name\":\"my-secret\",\"digest\":\"500162dc5358d51924861213c55077c881e729999febc29029e020e2e43151ea\",\"created_at\":\"2022-10-15T11:15:40.000Z\"}"}],"_postman_id":"64b01c5d-0358-4f97-84c1-fed78b81c4b2"},{"name":"Get secret metadata","id":"87cc854d-23eb-4141-97f8-3d46c529561c","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/resources/stores/secret/{{store_id}}/secrets/{{secret_name}}","description":"<p>Get metadata about a secret by name.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","stores","secret","{{store_id}}","secrets","{{secret_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"611eaf5b-dffa-494d-a162-82dbba0d3b15","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/resources/stores/secret/{{store_id}}/secrets/{{secret_name}}","description":"Get metadata about a secret by name.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"name\":\"my-secret\",\"digest\":\"500162dc5358d51924861213c55077c881e729999febc29029e020e2e43151ea\",\"created_at\":\"2022-10-15T11:15:40.000Z\"}"}],"_postman_id":"87cc854d-23eb-4141-97f8-3d46c529561c"},{"name":"Delete a secret from a store","id":"7de5912a-1ec2-43f4-a948-b013af564cf5","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/resources/stores/secret/{{store_id}}/secrets/{{secret_name}}","description":"<p>Delete a secret from a store by name.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","stores","secret","{{store_id}}","secrets","{{secret_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"2ca58f58-ad20-43ad-938a-26e79cbc06f1","name":"204 No Content","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/resources/stores/secret/{{store_id}}/secrets/{{secret_name}}","description":"Delete a secret from a store by name.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 No Content","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"7de5912a-1ec2-43f4-a948-b013af564cf5"}],"id":"925dae65-c749-4ecc-bc5b-8fb61dae4c72","description":"<p>A secret within a secret store. Learn more about secret stores.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>client_key</td>\n<td>string</td>\n<td>The Base64-encoded string containing the client key used to encrypt the secret, if applicable.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>A human-readable name for the secret. The value must contain only letters, numbers, dashes (-), underscores (_), and periods (.).</td>\n</tr>\n<tr>\n<td>secret</td>\n<td>string</td>\n<td>A Base64-encoded string containing either the secret or the encrypted secret (when using client_key). The maximum secret size (before Base64 encoding and optional local encryption) is 64KB.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>digest</td>\n<td>string</td>\n<td>An opaque identifier of the plaintext secret value. This can be used to determine if a secret value has changed.</td>\n</tr>\n<tr>\n<td>recreated</td>\n<td>boolean</td>\n<td>True if the secret replaced a secret with the same name.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"925dae65-c749-4ecc-bc5b-8fb61dae4c72"},{"name":"Secret store","item":[{"name":"Get all secret stores","id":"bd94abd0-5b22-44b5-b4d0-389c7a16f268","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/resources/stores/secret?cursor&limit&name","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/services/resources/secret-store/#get-secret-stores\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","stores","secret"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Cursor value from the next_cursor field of a previous response, used to retrieve the next page. To request the first page, this should be empty.</p>\n","type":"text/plain"},"key":"cursor"},{"description":{"content":"<p>Number of results per page. The maximum is 200.</p>\n","type":"text/plain"},"key":"limit"},{"description":{"content":"<p>Returns a one-element array containing the details for the named secret store.</p>\n","type":"text/plain"},"key":"name"}],"variable":[]}},"response":[{"id":"d675006a-3ef8-443a-98c6-c9e498325fbf","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/resources/stores/secret?cursor&limit&name","protocol":"https","host":["api","fastly","com"],"path":["resources","stores","secret"],"query":[{"key":"cursor","description":"Cursor value from the next_cursor field of a previous response, used to retrieve the next page. To request the first page, this should be empty."},{"key":"limit","description":"Number of results per page. The maximum is 200."},{"key":"name","description":"Returns a one-element array containing the details for the named secret store."}]},"description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/services/resources/secret-store/#get-secret-stores)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"id\":\"6XDE5T4v1EiIQqqD0hlXcI\",\"name\":\"store-name-1\",\"created_at\":\"2022-11-28T21:22:48.000Z\"},{\"id\":\"2b8DKOXsDzUdzqum4jkBKn\",\"name\":\"store-name-2\",\"created_at\":\"2022-10-28T20:42:23.000Z\"},{\"id\":\"4QipZ3GZKSviwlgyfkkipH\",\"name\":\"store-name-3\",\"created_at\":\"2021-11-15T19:15:40.000Z\"}],\"meta\":{\"next_cursor\":\"aWQ6MTIzNDUK\",\"limit\":100}}"}],"_postman_id":"bd94abd0-5b22-44b5-b4d0-389c7a16f268"},{"name":"Create new secret store","id":"4fb96d4f-6f84-4b83-a602-39b47bcb80c1","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"my-store\"}"},"url":"https://api.fastly.com/resources/stores/secret","description":"<p>Create a new secret store.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","stores","secret"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"e3a78f6c-bdb0-4e48-81ad-1c2c21c827f3","name":"201 Created","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"my-store\"}"},"url":"https://api.fastly.com/resources/stores/secret","description":"Create a new secret store.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"201 Created","code":201,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"4Jhw4zWNh2rWyVii0RI8i4\",\"name\":\"my-store\",\"created_at\":\"2022-10-15T20:20:40.000Z\"}"}],"_postman_id":"4fb96d4f-6f84-4b83-a602-39b47bcb80c1"},{"name":"Get secret store by ID","id":"6cee4719-2c6a-4eea-a0e4-7d6535378c32","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/resources/stores/secret/{{store_id}}","description":"<p>Get a secret store by ID.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","stores","secret","{{store_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"c158d07d-8db1-41e3-824e-f5079e98708f","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/resources/stores/secret/{{store_id}}","description":"Get a secret store by ID.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"4Jhw4zWNh2rWyVii0RI8i4\",\"name\":\"my-store\",\"created_at\":\"2022-10-15T20:20:40.000Z\"}"}],"_postman_id":"6cee4719-2c6a-4eea-a0e4-7d6535378c32"},{"name":"Delete secret store","id":"c03edb31-f619-4c46-9944-b828b6548de6","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/resources/stores/secret/{{store_id}}","description":"<p>Delete a secret store and all of its contents.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","stores","secret","{{store_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"be7d89a5-66bc-4770-9160-2cc204f01702","name":"204 No Content","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/resources/stores/secret/{{store_id}}","description":"Delete a secret store and all of its contents.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 No Content","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"c03edb31-f619-4c46-9944-b828b6548de6"},{"name":"Create new client key","id":"4586b1fc-061b-4029-a60c-3e5f6c618ddc","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/resources/stores/secret/client-key","description":"<p>Create a new client key for encrypting secrets locally before uploading.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","stores","secret","client-key"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"c1e9c4be-c1df-4d3d-aab5-0e0ce838b32a","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/resources/stores/secret/client-key","description":"Create a new client key for encrypting secrets locally before uploading.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"client_key\":\"P7J+E5O/RIR+yebt28dMub62ZGBvYKrMSsGz76V68lo=\",\"signature\":\"8rc4XHI3/zZhH8bmGqq/DGu/r9aXRQ5oNbVDMcTIo+4QQ+S4olIgORyks9S/0NyoMmjciV0d0V2n7Bh9JTTnBw==\",\"expires_at\":\"2022-10-15T11:25:40.000Z\"}"}],"_postman_id":"4586b1fc-061b-4029-a60c-3e5f6c618ddc"},{"name":"Get public key","id":"0982b81a-7155-4386-9138-3ee5ac2d2c83","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/resources/stores/secret/signing-key","description":"<p>Get the public key used for signing client keys.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["resources","stores","secret","signing-key"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"0b763af6-bcac-494d-b2c4-87ea72a0d756","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/resources/stores/secret/signing-key","description":"Get the public key used for signing client keys.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"signing_key\":\"8Hu0hwJf17D/9q87bIZmYWuNW6CAQ3qrhZR1+gEZGzI=\"}"}],"_postman_id":"0982b81a-7155-4386-9138-3ee5ac2d2c83"}],"id":"3f22aec8-44e6-45ab-aae8-3f1ea2550fae","description":"<p>A secret store is a persistent, globally distributed store for secrets accessible to Compute services during request processing. Learn more about secret stores.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>A human-readable name for the store. The value must contain only letters, numbers, dashes (-), underscores (_), or periods (.).</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>ID of the store.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-1\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>client_key</td>\n<td>string</td>\n<td>A Base64-encoded X25519 public key that can be used with a libsodium-compatible sealed box to encrypt secrets before upload.</td>\n</tr>\n<tr>\n<td>expires_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>signature</td>\n<td>string</td>\n<td>A Base64-encoded signature of the client key. The signature is generated using the signing key and must be verified before using the client key.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-2\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>signing_key</td>\n<td>string</td>\n<td>A Base64-encoded Ed25519 public key that can be used to verify signatures of client keys.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"3f22aec8-44e6-45ab-aae8-3f1ea2550fae"}],"id":"e1c4debb-388f-4532-97fe-53d568f351c3","_postman_id":"e1c4debb-388f-4532-97fe-53d568f351c3","description":""},{"name":"TLS","item":[{"name":"TLS Configuration","item":[{"name":"List TLS configurations","id":"07229f3b-14a9-4d19-a4db-e3c755b63f85","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":"https://api.fastly.com/tls/configurations?filter[bulk]&include&page[number]&page[size]","description":"<p>List all TLS configurations.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["tls","configurations"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Optionally filters by the bulk attribute.</p>\n","type":"text/plain"},"key":"filter[bulk]"},{"description":{"content":"<p>Include related objects. Optional, comma-separated values. Permitted values: dns_records.</p>\n","type":"text/plain"},"key":"include"},{"description":{"content":"<p>Current page.</p>\n","type":"text/plain"},"key":"page[number]"},{"description":{"content":"<p>Number of records per page.</p>\n","type":"text/plain"},"key":"page[size]"}],"variable":[]}},"response":[{"id":"0cbb2e2c-0235-4cab-974a-1096c2d6d904","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":{"raw":"https://api.fastly.com/tls/configurations?include=dns_records&page%5Bnumber%5D=1&page%5Bsize%5D=20?filter[bulk]&include&page[number]&page[size]","protocol":"https","host":["api","fastly","com"],"path":["tls","configurations"],"query":[{"key":"filter[bulk]","description":"Optionally filters by the bulk attribute."},{"key":"include","description":"Include related objects. Optional, comma-separated values. Permitted values: dns_records."},{"key":"page[number]","description":"Current page."},{"key":"page[size]","description":"Number of records per page."}]},"description":"List all TLS configurations.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"id\":\"t7CguUGZzb2W9Euo5FoKa\",\"type\":\"tls_configuration\",\"attributes\":{\"bulk\":false,\"created_at\":\"2020-02-01T12:12:12.000Z\",\"default\":true,\"http_protocols\":[\"http/1.1\",\"http/2\"],\"name\":\"TLS Configuration A\",\"tls_protocols\":[\"1.1\",\"1.2\"],\"updated_at\":\"2020-02-01T12:12:12.000Z\"},\"relationships\":{\"dns_records\":{\"data\":[{\"id\":\"151.101.2.133\",\"type\":\"dns_record\"},{\"id\":\"151.101.66.133\",\"type\":\"dns_record\"},{\"id\":\"151.101.130.133\",\"type\":\"dns_record\"},{\"id\":\"151.101.194.133\",\"type\":\"dns_record\"},{\"id\":\"d.sni.global.fastly.net\",\"type\":\"dns_record\"}]},\"service\":{\"data\":{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"type\":\"service\"}}}}],\"included\":[{\"id\":\"151.101.2.133\",\"type\":\"dns_record\",\"attributes\":{\"record_type\":\"A\",\"region\":\"global\"}},{\"id\":\"151.101.66.133\",\"type\":\"dns_record\",\"attributes\":{\"record_type\":\"A\",\"region\":\"global\"}},{\"id\":\"151.101.130.133\",\"type\":\"dns_record\",\"attributes\":{\"record_type\":\"A\",\"region\":\"global\"}},{\"id\":\"151.101.194.133\",\"type\":\"dns_record\",\"attributes\":{\"record_type\":\"A\",\"region\":\"global\"}},{\"id\":\"d.sni.global.fastly.net\",\"type\":\"dns_record\",\"attributes\":{\"record_type\":\"CNAME\",\"region\":\"global\"}}],\"links\":{\"self\":\"https://api.fastly.com/tls/configurations?include=dns_records&page%5Bnumber%5D=1&page%5Bsize%5D=100\",\"first\":\"https://api.fastly.com/tls/configurations?include=dns_records&page%5Bnumber%5D=1&page%5Bsize%5D=100\",\"prev\":null,\"next\":null,\"last\":\"https://api.fastly.com/tls/configurations?include=dns_records&page%5Bnumber%5D=1&page%5Bsize%5D=100\"},\"meta\":{\"per_page\":100,\"current_page\":1,\"record_count\":1,\"total_pages\":1}}"}],"_postman_id":"07229f3b-14a9-4d19-a4db-e3c755b63f85"},{"name":"Get a TLS configuration","id":"29642d18-2ff0-429d-a6ca-384e0ca226ba","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":"https://api.fastly.com/tls/configurations/{{tls_configuration_id}}?include","description":"<p>Show a TLS configuration.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["tls","configurations","{{tls_configuration_id}}"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Include related objects. Optional, comma-separated values. Permitted values: dns_records.</p>\n","type":"text/plain"},"key":"include"}],"variable":[]}},"response":[{"id":"719a6dfc-18d3-4465-b531-bffab4f35f1f","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":{"raw":"https://api.fastly.com/tls/configurations/t7CguUGZzb2W9Euo5FoKa?include=dns_records?include","protocol":"https","host":["api","fastly","com"],"path":["tls","configurations","t7CguUGZzb2W9Euo5FoKa"],"query":[{"key":"include","description":"Include related objects. Optional, comma-separated values. Permitted values: dns_records."}]},"description":"Show a TLS configuration.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":{\"id\":\"t7CguUGZzb2W9Euo5FoKa\",\"type\":\"tls_configuration\",\"attributes\":{\"bulk\":false,\"created_at\":\"2020-02-01T12:12:12.000Z\",\"default\":true,\"http_protocols\":[\"http/1.1\",\"http/2\"],\"name\":\"TLS Configuration A\",\"tls_protocols\":[\"1.1\",\"1.2\"],\"updated_at\":\"2020-02-01T12:12:12.000Z\"},\"relationships\":{\"dns_records\":{\"data\":[{\"id\":\"151.101.2.133\",\"type\":\"dns_record\"},{\"id\":\"151.101.66.133\",\"type\":\"dns_record\"},{\"id\":\"151.101.130.133\",\"type\":\"dns_record\"},{\"id\":\"151.101.194.133\",\"type\":\"dns_record\"},{\"id\":\"d.sni.global.fastly.net\",\"type\":\"dns_record\"}]},\"service\":{\"data\":{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"type\":\"service\"}}}},\"included\":[{\"id\":\"151.101.2.133\",\"type\":\"dns_record\",\"attributes\":{\"record_type\":\"A\",\"region\":\"global\"}},{\"id\":\"151.101.66.133\",\"type\":\"dns_record\",\"attributes\":{\"record_type\":\"A\",\"region\":\"global\"}},{\"id\":\"151.101.130.133\",\"type\":\"dns_record\",\"attributes\":{\"record_type\":\"A\",\"region\":\"global\"}},{\"id\":\"151.101.194.133\",\"type\":\"dns_record\",\"attributes\":{\"record_type\":\"A\",\"region\":\"global\"}},{\"id\":\"d.sni.global.fastly.net\",\"type\":\"dns_record\",\"attributes\":{\"record_type\":\"CNAME\",\"region\":\"global\"}}]}"}],"_postman_id":"29642d18-2ff0-429d-a6ca-384e0ca226ba"},{"name":"Update a TLS configuration","id":"b8abee52-e4f7-4fd5-a73d-d98bce9c9904","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"data\":{\"type\":\"tls_configuration\",\"attributes\":{\"name\":\"New TLS configuration name\"}}}"},"url":"https://api.fastly.com/tls/configurations/{{tls_configuration_id}}","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/tls/configuration/#update-tls-config\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["tls","configurations","{{tls_configuration_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"5ddaa1e8-199c-4c50-9477-152ab469370f","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"data\":{\"type\":\"tls_configuration\",\"attributes\":{\"name\":\"New TLS configuration name\"}}}"},"url":"https://api.fastly.com/tls/configurations/t7CguUGZzb2W9Euo5FoKa","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/tls/configuration/#update-tls-config)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":{\"id\":\"t7CguUGZzb2W9Euo5FoKa\",\"type\":\"tls_configuration\",\"attributes\":{\"bulk\":false,\"created_at\":\"2020-02-01T12:12:12.000Z\",\"default\":true,\"http_protocols\":[\"http/1.1\",\"http/2\"],\"name\":\"New TLS configuration name\",\"tls_protocols\":[\"1.1\",\"1.2\"],\"updated_at\":\"2020-02-01T12:12:12.000Z\"},\"relationships\":{\"service\":{\"data\":{\"id\":\"SU1Z0isxPaozGVKXdv0eY\",\"type\":\"service\"}}}}}"}],"_postman_id":"b8abee52-e4f7-4fd5-a73d-d98bce9c9904"}],"id":"ea30b0c7-866d-4a2b-b101-008d84d71047","description":"<p>Customers with access to multiple sets of IP pools are able to apply different configuration options to their TLS enabled domains.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>A custom name for your TLS configuration.</td>\n</tr>\n<tr>\n<td>relationships.dns_records.id</td>\n<td>string</td>\n<td>The IP address or hostname of the DNS record.</td>\n</tr>\n<tr>\n<td>relationships.service.id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>type</td>\n<td>string</td>\n<td>Resource type.</td>\n</tr>\n<tr>\n<td>bulk</td>\n<td>boolean</td>\n<td>Signifies whether the configuration is used for Platform TLS or not.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>default</td>\n<td>boolean</td>\n<td>Signifies whether or not Fastly will use this configuration as a default when creating a new TLS Activation.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>http_protocols</td>\n<td>array</td>\n<td>HTTP protocols available on your configuration.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>Alphanumeric string identifying a TLS configuration.</td>\n</tr>\n<tr>\n<td>tls_protocols</td>\n<td>array</td>\n<td>TLS protocols available on your configuration.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"ea30b0c7-866d-4a2b-b101-008d84d71047"},{"name":"Bulk Certificates","item":[{"name":"List certificates","id":"137f9c2e-60dc-4d41-b191-69353dc891a5","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":"https://api.fastly.com/tls/bulk/certificates?filter[not_after]&filter[not_before]&filter[tls_domain.id]&page[number]&page[size]&sort","description":"<p>List all certificates.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["tls","bulk","certificates"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Filter the returned certificates by expiry date in UTC.  Accepts parameters: lt, lte, gt, gte (e.g., filter[not_after][lte]=2020-05-05).</p>\n","type":"text/plain"},"key":"filter[not_after]"},{"description":{"content":"<p>Filter the returned certificates by not_before date in UTC.  Accepts parameters: lt, lte, gt, gte (e.g., filter[not_before][gte]=2020-05-05).</p>\n","type":"text/plain"},"key":"filter[not_before]"},{"description":{"content":"<p>Filter certificates by their matching, fully-qualified domain name.</p>\n","type":"text/plain"},"key":"filter[tls_domain.id]"},{"description":{"content":"<p>Current page.</p>\n","type":"text/plain"},"key":"page[number]"},{"description":{"content":"<p>Number of records per page.</p>\n","type":"text/plain"},"key":"page[size]"},{"description":{"content":"<p>The order in which to list the results by creation date.</p>\n","type":"text/plain"},"key":"sort"}],"variable":[]}},"response":[{"id":"c0082066-ae8a-436d-97ed-75d51324f42d","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":{"raw":"https://api.fastly.com/tls/bulk/certificates?page%5Bnumber%5D=1&page%5Bsize%5D=20&sort=created_at?filter[not_after]&filter[not_before]&filter[tls_domain.id]&page[number]&page[size]&sort","protocol":"https","host":["api","fastly","com"],"path":["tls","bulk","certificates"],"query":[{"key":"filter[not_after]","description":"Filter the returned certificates by expiry date in UTC.  Accepts parameters: lt, lte, gt, gte (e.g., filter[not_after][lte]=2020-05-05)."},{"key":"filter[not_before]","description":"Filter the returned certificates by not_before date in UTC.  Accepts parameters: lt, lte, gt, gte (e.g., filter[not_before][gte]=2020-05-05)."},{"key":"filter[tls_domain.id]","description":"Filter certificates by their matching, fully-qualified domain name."},{"key":"page[number]","description":"Current page."},{"key":"page[size]","description":"Number of records per page."},{"key":"sort","description":"The order in which to list the results by creation date."}]},"description":"List all certificates.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"id\":\"cRTguUGZzb2W9Euo4moOr\",\"type\":\"tls_bulk_certificate\",\"attributes\":{\"not_after\":\"2020-06-06T18:14:32.000Z\",\"not_before\":\"2020-06-06T18:14:32.000Z\",\"created_at\":\"2020-06-06T18:14:32.000Z\",\"updated_at\":\"2020-06-06T18:14:32.000Z\",\"replace\":false},\"relationships\":{\"tls_configurations\":{\"data\":[{\"type\":\"tls_configuration\",\"id\":\"t7CguUGZzb2W9Euo5FoKa\"}]},\"tls_domains\":{\"data\":[{\"type\":\"tls_domain\",\"id\":\"DOMAIN_NAME\"}]}}}]}"}],"_postman_id":"137f9c2e-60dc-4d41-b191-69353dc891a5"},{"name":"Upload a certificate","id":"5d09380a-0bfd-4f90-ace4-9413801af19e","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"data\":{\"type\":\"tls_bulk_certificate\",\"attributes\":{\"allow_untrusted_root\":false,\"cert_blob\":\"-----BEGIN CERTIFICATE-----\\n...\\n-----END CERTIFICATE-----\\n\",\"intermediates_blob\":\"-----BEGIN CERTIFICATE-----\\n...\\n-----END CERTIFICATE-----\\n\"},\"relationships\":{\"tls_configurations\":{\"data\":[{\"type\":\"tls_configuration\",\"id\":\"t7CguUGZzb2W9Euo5FoKa\"}]}}}}"},"url":"https://api.fastly.com/tls/bulk/certificates","description":"<p>Upload a new certificate. TLS domains are automatically enabled upon certificate creation. If a domain is already enabled on a previously uploaded certificate, that domain will be updated to use the new certificate for all future TLS handshake requests.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["tls","bulk","certificates"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"e4f695c0-ff0e-457e-928c-781c866f79a3","name":"201 Created","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"data\":{\"type\":\"tls_bulk_certificate\",\"attributes\":{\"allow_untrusted_root\":false,\"cert_blob\":\"-----BEGIN CERTIFICATE-----\\n...\\n-----END CERTIFICATE-----\\n\",\"intermediates_blob\":\"-----BEGIN CERTIFICATE-----\\n...\\n-----END CERTIFICATE-----\\n\"},\"relationships\":{\"tls_configurations\":{\"data\":[{\"type\":\"tls_configuration\",\"id\":\"t7CguUGZzb2W9Euo5FoKa\"}]}}}}"},"url":"https://api.fastly.com/tls/bulk/certificates","description":"Upload a new certificate. TLS domains are automatically enabled upon certificate creation. If a domain is already enabled on a previously uploaded certificate, that domain will be updated to use the new certificate for all future TLS handshake requests.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"201 Created","code":201,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":{\"id\":\"cRTguUGZzb2W9Euo4moOr\",\"type\":\"tls_bulk_certificate\",\"attributes\":{\"not_after\":\"2020-06-06T18:14:32.000Z\",\"not_before\":\"2020-06-06T18:14:32.000Z\",\"created_at\":\"2020-06-06T18:14:32.000Z\",\"updated_at\":\"2020-06-06T18:14:32.000Z\",\"replace\":false},\"relationships\":{\"tls_configurations\":{\"data\":[{\"type\":\"tls_configuration\",\"id\":\"t7CguUGZzb2W9Euo5FoKa\"}]},\"tls_domains\":{\"data\":[{\"type\":\"tls_domain\",\"id\":\"DOMAIN_NAME\"}]}}}}"}],"_postman_id":"5d09380a-0bfd-4f90-ace4-9413801af19e"},{"name":"Get a certificate","id":"aa277268-fd59-4a37-ad68-c55b4dafa4ff","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":"https://api.fastly.com/tls/bulk/certificates/{{certificate_id}}","description":"<p>Retrieve a single certificate.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["tls","bulk","certificates","{{certificate_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"0ac1cca7-f474-4fe7-82c9-97ab1d4794d3","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":"https://api.fastly.com/tls/bulk/certificates/cRTguUGZzb2W9Euo4moOr","description":"Retrieve a single certificate.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":{\"id\":\"cRTguUGZzb2W9Euo4moOr\",\"type\":\"tls_bulk_certificate\",\"attributes\":{\"not_after\":\"2020-06-06T18:14:32.000Z\",\"not_before\":\"2020-06-06T18:14:32.000Z\",\"created_at\":\"2020-06-06T18:14:32.000Z\",\"updated_at\":\"2020-06-06T18:14:32.000Z\",\"replace\":false},\"relationships\":{\"tls_configurations\":{\"data\":[{\"type\":\"tls_configuration\",\"id\":\"t7CguUGZzb2W9Euo5FoKa\"}]},\"tls_domains\":{\"data\":[{\"type\":\"tls_domain\",\"id\":\"DOMAIN_NAME\"}]}}}}"}],"_postman_id":"aa277268-fd59-4a37-ad68-c55b4dafa4ff"},{"name":"Delete a certificate","id":"a394ced2-9be0-41ab-b23f-bc3eba2fbb8f","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/tls/bulk/certificates/{{certificate_id}}","description":"<p>Destroy a certificate. This disables TLS for all domains listed as SAN entries.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["tls","bulk","certificates","{{certificate_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"8951b484-695d-449a-b9e0-3beee3a3a121","name":"204 No Content","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/tls/bulk/certificates/cRTguUGZzb2W9Euo4moOr","description":"Destroy a certificate. This disables TLS for all domains listed as SAN entries.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 No Content","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"a394ced2-9be0-41ab-b23f-bc3eba2fbb8f"},{"name":"Update a certificate","id":"55ec0612-9e1c-4410-8b91-727b2de1119c","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"data\":{\"id\":\"cRTguUGZzb2W9Euo4moOr\",\"type\":\"tls_bulk_certificate\",\"attributes\":{\"allow_untrusted_root\":false,\"cert_blob\":\"-----BEGIN CERTIFICATE-----\\n...\\n-----END CERTIFICATE-----\\n\",\"intermediates_blob\":\"-----BEGIN CERTIFICATE-----\\n...\\n-----END CERTIFICATE-----\\n\"}}}"},"url":"https://api.fastly.com/tls/bulk/certificates/{{certificate_id}}","description":"<p>Replace a certificate with a newly reissued certificate. By using this endpoint, the original certificate will cease to be used for future TLS handshakes. Thus, only SAN entries that appear in the replacement certificate will become TLS enabled. Any SAN entries that are missing in the replacement certificate will become disabled.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["tls","bulk","certificates","{{certificate_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"01b8ef46-5ed7-4d02-99ed-ef859087e6ba","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"data\":{\"id\":\"cRTguUGZzb2W9Euo4moOr\",\"type\":\"tls_bulk_certificate\",\"attributes\":{\"allow_untrusted_root\":false,\"cert_blob\":\"-----BEGIN CERTIFICATE-----\\n...\\n-----END CERTIFICATE-----\\n\",\"intermediates_blob\":\"-----BEGIN CERTIFICATE-----\\n...\\n-----END CERTIFICATE-----\\n\"}}}"},"url":"https://api.fastly.com/tls/bulk/certificates/cRTguUGZzb2W9Euo4moOr","description":"Replace a certificate with a newly reissued certificate. By using this endpoint, the original certificate will cease to be used for future TLS handshakes. Thus, only SAN entries that appear in the replacement certificate will become TLS enabled. Any SAN entries that are missing in the replacement certificate will become disabled.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":{\"id\":\"cRTguUGZzb2W9Euo4moOr\",\"type\":\"tls_bulk_certificate\",\"attributes\":{\"not_after\":\"2020-06-06T18:14:32.000Z\",\"not_before\":\"2020-06-06T18:14:32.000Z\",\"created_at\":\"2020-06-06T18:14:32.000Z\",\"updated_at\":\"2020-06-06T18:14:32.000Z\",\"replace\":false},\"relationships\":{\"tls_configurations\":{\"data\":[{\"type\":\"tls_configuration\",\"id\":\"t7CguUGZzb2W9Euo5FoKa\"}]},\"tls_domains\":{\"data\":[{\"type\":\"tls_domain\",\"id\":\"DOMAIN_NAME\"}]}}}}"}],"_postman_id":"55ec0612-9e1c-4410-8b91-727b2de1119c"}],"id":"2d590db7-dcb2-418b-bd41-f1e0bb312ecd","description":"<p>Available to Platform TLS customers, these endpoints streamline the upload, deployment and management of large numbers of TLS certificates. A certificate is used to terminate TLS traffic for one or more of your fully qualified domain names (domains). Uploading a new certificate automatically enables TLS for all domains listed as Subject Alternative Names (SAN entries) on the certificate.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>allow_untrusted_root</td>\n<td>boolean</td>\n<td>Allow certificates that chain to untrusted roots.</td>\n</tr>\n<tr>\n<td>cert_blob</td>\n<td>string</td>\n<td>The PEM-formatted certificate blob. Required.</td>\n</tr>\n<tr>\n<td>intermediates_blob</td>\n<td>string</td>\n<td>The PEM-formatted chain of intermediate blobs. Required.</td>\n</tr>\n<tr>\n<td>relationships.tls_configurations.id</td>\n<td>string</td>\n<td>Alphanumeric string identifying a TLS configuration.</td>\n</tr>\n<tr>\n<td>relationships.tls_domains.id</td>\n<td>string</td>\n<td>The domain name.</td>\n</tr>\n<tr>\n<td>type</td>\n<td>string</td>\n<td>Resource type.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>Alphanumeric string identifying a TLS bulk certificate.</td>\n</tr>\n<tr>\n<td>not_after</td>\n<td>string</td>\n<td>Time-stamp (GMT) when the certificate will expire. Must be in the future to be used to terminate TLS traffic.</td>\n</tr>\n<tr>\n<td>not_before</td>\n<td>string</td>\n<td>Time-stamp (GMT) when the certificate will become valid. Must be in the past to be used to terminate TLS traffic.</td>\n</tr>\n<tr>\n<td>replace</td>\n<td>boolean</td>\n<td>A recommendation from Fastly indicating the key associated with this certificate is in need of rotation.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"2d590db7-dcb2-418b-bd41-f1e0bb312ecd"},{"name":"TLS Subscriptions","item":[{"name":"List TLS subscriptions","id":"95931478-9874-40e8-9a0d-756aa0eff17a","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":"https://api.fastly.com/tls/subscriptions?filter[certificate_authority]&filter[has_active_order]&filter[state]&filter[tls_domains.id]&include&page[number]&page[size]&sort","description":"<p>List all TLS subscriptions.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["tls","subscriptions"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Limit the returned subscriptions to a specific certification authority. Values may include certainly, lets-encrypt, or globalsign.</p>\n","type":"text/plain"},"key":"filter[certificate_authority]"},{"description":{"content":"<p>Limit the returned subscriptions to those that have currently active orders. Permitted values: true.</p>\n","type":"text/plain"},"key":"filter[has_active_order]"},{"description":{"content":"<p>Limit the returned subscriptions by state. Valid values are pending, processing, issued, renewing, and failed. Accepts parameters: not (e.g., filter[state][not]=renewing).</p>\n","type":"text/plain"},"key":"filter[state]"},{"description":{"content":"<p>Limit the returned subscriptions to those that include the specific domain.</p>\n","type":"text/plain"},"key":"filter[tls_domains.id]"},{"description":{"content":"<p>Include related objects. Optional, comma-separated values. Permitted values: tls_authorizations, tls_authorizations.globalsign_email_challenge, tls_authorizations.self_managed_http_challenge, and tls_certificates.</p>\n","type":"text/plain"},"key":"include"},{"description":{"content":"<p>Current page.</p>\n","type":"text/plain"},"key":"page[number]"},{"description":{"content":"<p>Number of records per page.</p>\n","type":"text/plain"},"key":"page[size]"},{"description":{"content":"<p>The order in which to list the results.</p>\n","type":"text/plain"},"key":"sort"}],"variable":[]}},"response":[{"id":"aa12e937-f8e3-481b-b419-07f8a4722d92","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":{"raw":"https://api.fastly.com/tls/subscriptions?include=tls_authorizations&page%5Bnumber%5D=1&page%5Bsize%5D=20?filter[certificate_authority]&filter[has_active_order]&filter[state]&filter[tls_domains.id]&include&page[number]&page[size]&sort","protocol":"https","host":["api","fastly","com"],"path":["tls","subscriptions"],"query":[{"key":"filter[certificate_authority]","description":"Limit the returned subscriptions to a specific certification authority. Values may include certainly, lets-encrypt, or globalsign."},{"key":"filter[has_active_order]","description":"Limit the returned subscriptions to those that have currently active orders. Permitted values: true."},{"key":"filter[state]","description":"Limit the returned subscriptions by state. Valid values are pending, processing, issued, renewing, and failed. Accepts parameters: not (e.g., filter[state][not]=renewing)."},{"key":"filter[tls_domains.id]","description":"Limit the returned subscriptions to those that include the specific domain."},{"key":"include","description":"Include related objects. Optional, comma-separated values. Permitted values: tls_authorizations, tls_authorizations.globalsign_email_challenge, tls_authorizations.self_managed_http_challenge, and tls_certificates."},{"key":"page[number]","description":"Current page."},{"key":"page[size]","description":"Number of records per page."},{"key":"sort","description":"The order in which to list the results."}]},"description":"List all TLS subscriptions.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"id\":\"sU3guUGZzb2W9Euo4Mo0r\",\"type\":\"tls_subscription\",\"attributes\":{\"certificate_authority\":\"certainly\",\"created_at\":\"2020-02-01T12:12:12.000Z\",\"state\":\"issued\",\"has_active_order\":false,\"updated_at\":\"2020-02-01T12:12:12.000Z\"},\"relationships\":{\"common_name\":{\"data\":{\"id\":\"DOMAIN_NAME\",\"type\":\"tls_domain\"}},\"tls_authorizations\":{\"data\":[{\"id\":\"AuTguUGZzb2W9Euo4moOr\",\"type\":\"tls_authorization\"}]},\"tls_certificates\":{\"data\":[{\"id\":\"cRTguUGZzb2W9Euo4moOr\",\"type\":\"tls_certificate\"}]},\"tls_domains\":{\"data\":{\"id\":\"DOMAIN_NAME\",\"type\":\"tls_domain\"}},\"tls_configuration\":{\"data\":{\"id\":\"t7CguUGZzb2W9Euo5FoKa\",\"type\":\"tls_configuration\"}}}}],\"included\":[{\"id\":\"AuTguUGZzb2W9Euo4moOr\",\"type\":\"tls_authorization\",\"attributes\":{\"challenges\":[{\"type\":\"managed-dns\",\"record_type\":\"CNAME\",\"record_name\":\"ACME_CHALLENGE_HOSTNAME\",\"values\":[\"FASTLY_VALIDATION_HOSTNAME\"]},{\"type\":\"managed-http-cname\",\"record_type\":\"CNAME\",\"record_name\":\"DOMAIN_NAME\",\"values\":[\"FASTLY_CNAME\"]},{\"type\":\"managed-http-a\",\"record_type\":\"A\",\"record_name\":\"DOMAIN_NAME\",\"values\":[\"FASTLY_IP_ADDRESSES\"]}],\"created_at\":\"2020-02-01T12:12:12.000Z\",\"state\":\"pending\",\"updated_at\":\"2020-02-01T12:12:12.000Z\",\"warnings\":null}}],\"links\":{\"self\":\"https://api.fastly.com/tls/subscriptions?page%5Bnumber%5D=1&page%5Bsize%5D=100\",\"first\":\"https://api.fastly.com/tls/subscriptions?page%5Bnumber%5D=1&page%5Bsize%5D=100\",\"prev\":null,\"next\":null,\"last\":\"https://api.fastly.com/tls/subscriptions?page%5Bnumber%5D=1&page%5Bsize%5D=100\"},\"meta\":{\"per_page\":100,\"current_page\":1,\"record_count\":1,\"total_pages\":1}}"}],"_postman_id":"95931478-9874-40e8-9a0d-756aa0eff17a"},{"name":"Create a TLS subscription","id":"21d7597f-88e2-4457-be27-c8a069b5a28c","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"data\":{\"type\":\"tls_subscription\",\"attributes\":{\"certificate_authority\":\"certainly\"},\"relationships\":{\"tls_domains\":{\"data\":[{\"type\":\"tls_domain\",\"id\":\"DOMAIN_NAME\"}]},\"tls_configuration\":{\"data\":{\"type\":\"tls_configuration\",\"id\":\"t7CguUGZzb2W9Euo5FoKa\"}}}}}"},"url":"https://api.fastly.com/tls/subscriptions","description":"<p>Create a new TLS subscription. This response includes a list of possible challenges to verify domain ownership.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["tls","subscriptions"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"5d693722-c260-467f-bb66-f8e24fb441f5","name":"201 Created","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"data\":{\"type\":\"tls_subscription\",\"attributes\":{\"certificate_authority\":\"certainly\"},\"relationships\":{\"tls_domains\":{\"data\":[{\"type\":\"tls_domain\",\"id\":\"DOMAIN_NAME\"}]},\"tls_configuration\":{\"data\":{\"type\":\"tls_configuration\",\"id\":\"t7CguUGZzb2W9Euo5FoKa\"}}}}}"},"url":"https://api.fastly.com/tls/subscriptions","description":"Create a new TLS subscription. This response includes a list of possible challenges to verify domain ownership.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"201 Created","code":201,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":{\"id\":\"sU3guUGZzb2W9Euo4Mo0r\",\"type\":\"tls_subscription\",\"attributes\":{\"certificate_authority\":\"certainly\",\"created_at\":\"2020-02-01T12:12:12.000Z\",\"state\":\"pending\",\"updated_at\":\"2020-02-01T12:12:12.000Z\"},\"relationships\":{\"common_name\":{\"data\":{\"id\":\"DOMAIN_NAME\",\"type\":\"tls_domain\"}},\"tls_authorizations\":{\"data\":[{\"id\":\"AuTguUGZzb2W9Euo4moOr\",\"type\":\"tls_authorization\"}]},\"tls_certificates\":{\"data\":[]},\"tls_domains\":{\"data\":{\"id\":\"DOMAIN_NAME\",\"type\":\"tls_domain\"}},\"tls_configuration\":{\"data\":[{\"id\":\"t7CguUGZzb2W9Euo5FoKa\",\"type\":\"tls_configuration\"}]}}},\"included\":[{\"id\":\"AuTguUGZzb2W9Euo4moOr\",\"type\":\"tls_authorization\",\"attributes\":{\"challenges\":[{\"type\":\"managed-dns\",\"record_type\":\"CNAME\",\"record_name\":\"ACME_CHALLENGE_HOSTNAME\",\"values\":[\"FASTLY_VALIDATION_HOSTNAME\"]},{\"type\":\"managed-http-cname\",\"record_type\":\"CNAME\",\"record_name\":\"DOMAIN_NAME\",\"values\":[\"FASTLY_CNAME\"]},{\"type\":\"managed-http-a\",\"record_type\":\"A\",\"record_name\":\"DOMAIN_NAME\",\"values\":[\"FASTLY_IP_ADDRESSES\"]}],\"created_at\":\"2020-02-01T12:12:12.000Z\",\"state\":\"pending\",\"updated_at\":\"2020-02-01T12:12:12.000Z\",\"warnings\":null}}]}"}],"_postman_id":"21d7597f-88e2-4457-be27-c8a069b5a28c"},{"name":"Get a TLS subscription","id":"82f21b12-e7e7-4ef7-b914-36fda1704148","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":"https://api.fastly.com/tls/subscriptions/{{tls_subscription_id}}?include","description":"<p>Show a TLS subscription.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["tls","subscriptions","{{tls_subscription_id}}"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Include related objects. Optional, comma-separated values. Permitted values: tls_authorizations, tls_authorizations.globalsign_email_challenge, tls_authorizations.self_managed_http_challenge, and tls_certificates.</p>\n","type":"text/plain"},"key":"include"}],"variable":[]}},"response":[{"id":"d82a5253-e621-4cd9-9160-5f5bb153c252","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":{"raw":"https://api.fastly.com/tls/subscriptions/sU3guUGZzb2W9Euo4Mo0r?include=tls_authorizations?include","protocol":"https","host":["api","fastly","com"],"path":["tls","subscriptions","sU3guUGZzb2W9Euo4Mo0r"],"query":[{"key":"include","description":"Include related objects. Optional, comma-separated values. Permitted values: tls_authorizations, tls_authorizations.globalsign_email_challenge, tls_authorizations.self_managed_http_challenge, and tls_certificates."}]},"description":"Show a TLS subscription.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":{\"id\":\"sU3guUGZzb2W9Euo4Mo0r\",\"type\":\"tls_subscription\",\"attributes\":{\"certificate_authority\":\"certainly\",\"created_at\":\"2020-02-01T12:12:12.000Z\",\"state\":\"issued\",\"has_active_order\":false,\"updated_at\":\"2020-02-01T12:12:12.000Z\"},\"relationships\":{\"common_name\":{\"data\":{\"id\":\"DOMAIN_NAME\",\"type\":\"tls_domain\"}},\"tls_authorizations\":{\"data\":[{\"id\":\"AuTguUGZzb2W9Euo4moOr\",\"type\":\"tls_authorization\"}]},\"tls_certificates\":{\"data\":[{\"id\":\"cRTguUGZzb2W9Euo4moOr\",\"type\":\"tls_certificate\"}]},\"tls_domains\":{\"data\":{\"id\":\"DOMAIN_NAME\",\"type\":\"tls_domain\"}},\"tls_configuration\":{\"data\":[{\"id\":\"t7CguUGZzb2W9Euo5FoKa\",\"type\":\"tls_configuration\"}]}}},\"included\":[{\"id\":\"AuTguUGZzb2W9Euo4moOr\",\"type\":\"tls_authorization\",\"attributes\":{\"challenges\":[{\"type\":\"managed-dns\",\"record_type\":\"CNAME\",\"record_name\":\"ACME_CHALLENGE_HOSTNAME\",\"values\":[\"FASTLY_VALIDATION_HOSTNAME\"]},{\"type\":\"managed-http-cname\",\"record_type\":\"CNAME\",\"record_name\":\"DOMAIN_NAME\",\"values\":[\"FASTLY_CNAME\"]},{\"type\":\"managed-http-a\",\"record_type\":\"A\",\"record_name\":\"DOMAIN_NAME\",\"values\":[\"FASTLY_IP_ADDRESSES\"]}],\"created_at\":\"2020-02-01T12:12:12.000Z\",\"state\":\"passing\",\"updated_at\":\"2020-02-01T12:12:12.000Z\",\"warnings\":null}}]}"}],"_postman_id":"82f21b12-e7e7-4ef7-b914-36fda1704148"},{"name":"Delete a TLS subscription","id":"98761560-3d74-4ca6-b4a9-c3c0a3b275c7","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/tls/subscriptions/{{tls_subscription_id}}","description":"<p>Destroy a TLS subscription. A subscription cannot be destroyed if there are domains in the TLS enabled state.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["tls","subscriptions","{{tls_subscription_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"cebb900a-4ffb-42cb-935a-c66a10faee18","name":"204 No Content","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/tls/subscriptions/sU3guUGZzb2W9Euo4Mo0r","description":"Destroy a TLS subscription. A subscription cannot be destroyed if there are domains in the TLS enabled state.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 No Content","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"98761560-3d74-4ca6-b4a9-c3c0a3b275c7"},{"name":"Update a TLS subscription","id":"8b1d170b-75fd-4494-910d-9bef31842cba","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"data\":{\"type\":\"tls_subscription\",\"attributes\":{\"state\":\"retry\"},\"relationships\":{\"common_name\":{\"data\":{\"type\":\"tls_domain\",\"id\":\"DOMAIN_NAME\"}},\"tls_domains\":{\"data\":[{\"type\":\"tls_domain\",\"id\":\"DOMAIN_NAME\"}]},\"tls_configuration\":{\"data\":{\"type\":\"tls_configuration\",\"id\":\"t7CguUGZzb2W9Euo5FoKa\"}}}}}"},"url":"https://api.fastly.com/tls/subscriptions/{{tls_subscription_id}}?force","description":"<p>Change the TLS domains or common name associated with this subscription, update the TLS configuration for this set of domains, or retry a subscription with state failed by setting the state to retry.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["tls","subscriptions","{{tls_subscription_id}}"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>A flag that allows you to edit and delete a subscription with active domains. Valid to use on PATCH and DELETE actions. As a warning, removing an active domain from a subscription or forcing the deletion of a subscription may result in breaking TLS termination to that domain.</p>\n","type":"text/plain"},"key":"force"}],"variable":[]}},"response":[{"id":"7cccdc67-6ca1-41c5-bc7c-b181b4223e93","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"data\":{\"type\":\"tls_subscription\",\"attributes\":{\"state\":\"retry\"},\"relationships\":{\"common_name\":{\"data\":{\"type\":\"tls_domain\",\"id\":\"DOMAIN_NAME\"}},\"tls_domains\":{\"data\":[{\"type\":\"tls_domain\",\"id\":\"DOMAIN_NAME\"}]},\"tls_configuration\":{\"data\":{\"type\":\"tls_configuration\",\"id\":\"t7CguUGZzb2W9Euo5FoKa\"}}}}}"},"url":{"raw":"https://api.fastly.com/tls/subscriptions/sU3guUGZzb2W9Euo4Mo0r?force=true?force","protocol":"https","host":["api","fastly","com"],"path":["tls","subscriptions","sU3guUGZzb2W9Euo4Mo0r"],"query":[{"key":"force","description":"A flag that allows you to edit and delete a subscription with active domains. Valid to use on PATCH and DELETE actions. As a warning, removing an active domain from a subscription or forcing the deletion of a subscription may result in breaking TLS termination to that domain."}]},"description":"Change the TLS domains or common name associated with this subscription, update the TLS configuration for this set of domains, or retry a subscription with state failed by setting the state to retry.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":{\"id\":\"sU3guUGZzb2W9Euo4Mo0r\",\"type\":\"tls_subscription\",\"attributes\":{\"certificate_authority\":\"certainly\",\"created_at\":\"2020-02-01T12:12:12.000Z\",\"state\":\"processing\",\"has_active_order\":true,\"updated_at\":\"2020-02-01T12:12:12.000Z\"},\"relationships\":{\"common_name\":{\"data\":{\"id\":\"DOMAIN_NAME\",\"type\":\"tls_domain\"}},\"tls_authorizations\":{\"data\":[{\"id\":\"AuTguUGZzb2W9Euo4moOr\",\"type\":\"tls_authorization\"}]},\"tls_certificates\":{\"data\":[{\"id\":\"cRTguUGZzb2W9Euo4moOr\",\"type\":\"tls_certificate\"}]},\"tls_domains\":{\"data\":{\"id\":\"DOMAIN_NAME\",\"type\":\"tls_domain\"}},\"tls_configuration\":{\"data\":[{\"id\":\"t7CguUGZzb2W9Euo5FoKa\",\"type\":\"tls_configuration\"}]}}},\"included\":[{\"id\":\"AuTguUGZzb2W9Euo4moOr\",\"type\":\"tls_authorization\",\"attributes\":{\"challenges\":[{\"type\":\"managed-dns\",\"record_type\":\"CNAME\",\"record_name\":\"ACME_CHALLENGE_HOSTNAME\",\"values\":[\"FASTLY_VALIDATION_HOSTNAME\"]},{\"type\":\"managed-http-cname\",\"record_type\":\"CNAME\",\"record_name\":\"DOMAIN_NAME\",\"values\":[\"FASTLY_CNAME\"]},{\"type\":\"managed-http-a\",\"record_type\":\"A\",\"record_name\":\"DOMAIN_NAME\",\"values\":[\"FASTLY_IP_ADDRESSES\"]}],\"created_at\":\"2020-02-01T12:12:12.000Z\",\"state\":\"passing\",\"updated_at\":\"2020-02-01T12:12:12.000Z\",\"warnings\":null}}]}"}],"_postman_id":"8b1d170b-75fd-4494-910d-9bef31842cba"},{"name":"Creates a GlobalSign email challenge","id":"1aa7f1db-2efe-47e4-903c-bd927e899dd2","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"data\":{\"type\":\"globalsign_email_challenge\",\"attributes\":{\"preferred_email\":\"admin@example.com\"}}}"},"url":"https://api.fastly.com/tls/subscriptions/{{tls_subscription_id}}/authorizations/{{tls_authorization_id}}/globalsign_email_challenges","description":"<p>Creates an email challenge for a domain on a GlobalSign subscription. An email challenge will generate an email that can be used to validate domain ownership. If this challenge is created, then the domain can only be validated using email for the given subscription.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["tls","subscriptions","{{tls_subscription_id}}","authorizations","{{tls_authorization_id}}","globalsign_email_challenges"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"88e7f861-440c-4082-a6e9-e29fc8720e38","name":"201 Created","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"data\":{\"type\":\"globalsign_email_challenge\",\"attributes\":{\"preferred_email\":\"admin@example.com\"}}}"},"url":"https://api.fastly.com/tls/subscriptions/sU3guUGZzb2W9Euo4Mo0r/authorizations/aU3guUGZzb2W9Euo4Mo0r/globalsign_email_challenges","description":"Creates an email challenge for a domain on a GlobalSign subscription. An email challenge will generate an email that can be used to validate domain ownership. If this challenge is created, then the domain can only be validated using email for the given subscription.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"201 Created","code":201,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":{\"id\":\"9RPIWHj89UrF3ZvUJ20XsQ\",\"type\":\"globalsign_email_challenge\",\"attributes\":{\"created_at\":\"2020-02-01T12:12:12Z\",\"verified_at\":null,\"state\":\"setup\",\"emails\":[\"admin@example.com\"],\"preferred_email\":\"admin@example.com\",\"sent_at\":null},\"relationships\":{\"data\":{\"id\":\"xHNEnd0ZgRJwt27K6vI4wg\",\"type\":\"tls_authorization\"}}}}"}],"_postman_id":"1aa7f1db-2efe-47e4-903c-bd927e899dd2"},{"name":"Delete a GlobalSign email challenge","id":"d91b02b8-1503-4c3d-b7f1-85512f0b9d8e","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/tls/subscriptions/{{tls_subscription_id}}/authorizations/{{tls_authorization_id}}/globalsign_email_challenges/{{globalsign_email_challenge_id}}","description":"<p>Deletes a GlobalSign email challenge. After a GlobalSign email challenge is deleted, the domain can use HTTP and DNS validation methods again.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["tls","subscriptions","{{tls_subscription_id}}","authorizations","{{tls_authorization_id}}","globalsign_email_challenges","{{globalsign_email_challenge_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"14426c62-3eeb-4ff5-9d85-9e27cbe3323b","name":"204 No Content","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/tls/subscriptions/sU3guUGZzb2W9Euo4Mo0r/authorizations/aU3guUGZzb2W9Euo4Mo0r/globalsign_email_challenges/gU3guUGZzb2W9Euo4Mo0r","description":"Deletes a GlobalSign email challenge. After a GlobalSign email challenge is deleted, the domain can use HTTP and DNS validation methods again.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 No Content","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"d91b02b8-1503-4c3d-b7f1-85512f0b9d8e"}],"id":"d7304552-87a1-4908-89f1-3d69ac745cf3","description":"<p>The TLS subscriptions API allows you to programmatically generate TLS certificates that are procured and renewed by Fastly. Once a subscription is created for a given hostname or wildcard domain, DNS records are checked to ensure that the domain on the subscription is owned by the subscription creator. Provided DNS records are maintained, TLS certificates will automatically renew. If Fastly is unable to issue a certificate, we will retry to issue the certificate for 7 days past subscription creation or the latest certificate's not_after date, whichever is later. If after 7 days Fastly is unable to issue a certificate, the subscription state will change to failed and Fastly will stop retrying.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>certificate_authority</td>\n<td>string</td>\n<td>The entity that issues and certifies the TLS certificates for your subscription, either certainly, lets-encrypt, or globalsign. To migrate the subscription from one certificate authority to another, such as to migrate from 'lets-encrypt' to 'certainly',  pass certificate_authority to the PATCH endpoint. To migrate from 'globalsign' to 'certainly', contact Fastly Support.</td>\n</tr>\n<tr>\n<td>relationships.common_name.id</td>\n<td>string</td>\n<td>The domain name.</td>\n</tr>\n<tr>\n<td>relationships.tls_certificates.id</td>\n<td>string</td>\n<td>Alphanumeric string identifying a TLS certificate.</td>\n</tr>\n<tr>\n<td>relationships.tls_configuration.id</td>\n<td>string</td>\n<td>Alphanumeric string identifying a TLS configuration.</td>\n</tr>\n<tr>\n<td>relationships.tls_domains.id</td>\n<td>string</td>\n<td>The domain name.</td>\n</tr>\n<tr>\n<td>type</td>\n<td>string</td>\n<td>Resource type.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>has_active_order</td>\n<td>boolean</td>\n<td>Subscription has an active order.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>Alphanumeric string identifying a TLS subscription.</td>\n</tr>\n<tr>\n<td>state</td>\n<td>string</td>\n<td>The current state of your subscription.</td>\n</tr>\n<tr>\n<td></td>\n<td>pending</td>\n<td>Subscription is waiting to be processed.</td>\n</tr>\n<tr>\n<td></td>\n<td>processing</td>\n<td>Subscription is currently being processed.</td>\n</tr>\n<tr>\n<td></td>\n<td>issued</td>\n<td>Subscription has issued a certificate.</td>\n</tr>\n<tr>\n<td></td>\n<td>renewing</td>\n<td>Subscription is processing a certificate renewal.</td>\n</tr>\n<tr>\n<td></td>\n<td>failed</td>\n<td>Fastly was unable to issue a certificate for the subscription due to errors. To force Fastly to retry a failed subscription, set the state to retry via the PATCH method on /tls/subscriptions/tls_subscription_id.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"d7304552-87a1-4908-89f1-3d69ac745cf3"},{"name":"Custom TLS certificates","item":[{"name":"TLS Activations","item":[{"name":"List TLS activations","id":"6ae4c8a9-af14-487b-9854-7281eeb90759","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":"https://api.fastly.com/tls/activations?filter[tls_certificate.id]&filter[tls_configuration.id]&filter[tls_domain.id]&include&page[number]&page[size]","description":"<p>List all TLS activations.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["tls","activations"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Limit the returned activations to a specific certificate.</p>\n","type":"text/plain"},"key":"filter[tls_certificate.id]"},{"description":{"content":"<p>Limit the returned activations to a specific TLS configuration.</p>\n","type":"text/plain"},"key":"filter[tls_configuration.id]"},{"description":{"content":"<p>Limit the returned rules to a specific domain name.</p>\n","type":"text/plain"},"key":"filter[tls_domain.id]"},{"description":{"content":"<p>Include related objects. Optional, comma-separated values. Permitted values: tls_certificate, tls_configuration, and tls_domain.</p>\n","type":"text/plain"},"key":"include"},{"description":{"content":"<p>Current page.</p>\n","type":"text/plain"},"key":"page[number]"},{"description":{"content":"<p>Number of records per page.</p>\n","type":"text/plain"},"key":"page[size]"}],"variable":[]}},"response":[{"id":"299bfe4c-8fa5-4ca5-af01-2416e01fe666","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":{"raw":"https://api.fastly.com/tls/activations?include=tls_certificate%2Ctls_configuration%2Ctls_domain&page%5Bnumber%5D=1&page%5Bsize%5D=20?filter[tls_certificate.id]&filter[tls_configuration.id]&filter[tls_domain.id]&include&page[number]&page[size]","protocol":"https","host":["api","fastly","com"],"path":["tls","activations"],"query":[{"key":"filter[tls_certificate.id]","description":"Limit the returned activations to a specific certificate."},{"key":"filter[tls_configuration.id]","description":"Limit the returned activations to a specific TLS configuration."},{"key":"filter[tls_domain.id]","description":"Limit the returned rules to a specific domain name."},{"key":"include","description":"Include related objects. Optional, comma-separated values. Permitted values: tls_certificate, tls_configuration, and tls_domain."},{"key":"page[number]","description":"Current page."},{"key":"page[size]","description":"Number of records per page."}]},"description":"List all TLS activations.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"id\":\"aCtguUGZzb2W9Euo4moOR\",\"type\":\"tls_activation\",\"attributes\":{\"created_at\":\"2020-02-01T12:12:12.000Z\"},\"relationships\":{\"tls_certificate\":{\"data\":{\"id\":\"cRTguUGZzb2W9Euo4moOr\",\"type\":\"tls_certificate\"}},\"tls_configuration\":{\"data\":{\"id\":\"t7CguUGZzb2W9Euo5FoKa\",\"type\":\"tls_configuration\"}},\"tls_domain\":{\"data\":{\"id\":\"example.com\",\"type\":\"tls_domain\"}}}}],\"links\":{\"self\":\"https://api.fastly.com/tls/activations?page%5Bnumber%5D=1&page%5Bsize%5D=100\",\"first\":\"https://api.fastly.com/tls/activations?page%5Bnumber%5D=1&page%5Bsize%5D=100\",\"prev\":null,\"next\":null,\"last\":\"https://api.fastly.com/tls/activations?page%5Bnumber%5D=1&page%5Bsize%5D=100\"},\"meta\":{\"per_page\":100,\"current_page\":1,\"record_count\":1,\"total_pages\":1}}"}],"_postman_id":"6ae4c8a9-af14-487b-9854-7281eeb90759"},{"name":"Enable TLS for a domain using a custom certificate","id":"b562d44f-1956-4f96-adcc-a5a3eb59a1bd","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"data\":{\"type\":\"tls_activation\",\"relationships\":{\"tls_certificate\":{\"data\":{\"id\":\"cRTguUGZzb2W9Euo4moOr\",\"type\":\"tls_certificate\"}},\"tls_configuration\":{\"data\":{\"id\":\"t7CguUGZzb2W9Euo5FoKa\",\"type\":\"tls_configuration\"}},\"tls_domain\":{\"data\":{\"id\":\"example.com\",\"type\":\"tls_domain\"}}}}}"},"url":"https://api.fastly.com/tls/activations","description":"<p>Enable TLS for a particular TLS domain and certificate combination. These relationships must be specified to create the TLS activation.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["tls","activations"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"32a26db0-581e-4e6c-8548-04dc4b2d7421","name":"201 Created","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"data\":{\"type\":\"tls_activation\",\"relationships\":{\"tls_certificate\":{\"data\":{\"id\":\"cRTguUGZzb2W9Euo4moOr\",\"type\":\"tls_certificate\"}},\"tls_configuration\":{\"data\":{\"id\":\"t7CguUGZzb2W9Euo5FoKa\",\"type\":\"tls_configuration\"}},\"tls_domain\":{\"data\":{\"id\":\"example.com\",\"type\":\"tls_domain\"}}}}}"},"url":"https://api.fastly.com/tls/activations","description":"Enable TLS for a particular TLS domain and certificate combination. These relationships must be specified to create the TLS activation.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"201 Created","code":201,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":{\"id\":\"aCtguUGZzb2W9Euo4moOR\",\"type\":\"tls_activation\",\"attributes\":{\"created_at\":\"2020-02-01T12:12:12.000Z\"},\"relationships\":{\"tls_certificate\":{\"data\":{\"id\":\"cRTguUGZzb2W9Euo4moOr\",\"type\":\"tls_certificate\"}},\"tls_configuration\":{\"data\":{\"id\":\"t7CguUGZzb2W9Euo5FoKa\",\"type\":\"tls_configuration\"}},\"tls_domain\":{\"data\":{\"id\":\"example.com\",\"type\":\"tls_domain\"}}}}}"}],"_postman_id":"b562d44f-1956-4f96-adcc-a5a3eb59a1bd"},{"name":"Get a TLS activation","id":"ba7044ef-0517-4231-b82b-a44754872308","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":"https://api.fastly.com/tls/activations/{{tls_activation_id}}?include","description":"<p>Show a TLS activation.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["tls","activations","{{tls_activation_id}}"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Include related objects. Optional, comma-separated values. Permitted values: tls_certificate, tls_configuration, and tls_domain.</p>\n","type":"text/plain"},"key":"include"}],"variable":[]}},"response":[{"id":"b6fed487-9736-4967-baa4-8bf772b10276","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":{"raw":"https://api.fastly.com/tls/activations/aCtguUGZzb2W9Euo4moOR?include=tls_certificate%2Ctls_configuration%2Ctls_domain?include","protocol":"https","host":["api","fastly","com"],"path":["tls","activations","aCtguUGZzb2W9Euo4moOR"],"query":[{"key":"include","description":"Include related objects. Optional, comma-separated values. Permitted values: tls_certificate, tls_configuration, and tls_domain."}]},"description":"Show a TLS activation.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":{\"id\":\"aCtguUGZzb2W9Euo4moOR\",\"type\":\"tls_activation\",\"attributes\":{\"created_at\":\"2020-02-01T12:12:12.000Z\"},\"relationships\":{\"tls_certificate\":{\"data\":{\"id\":\"cRTguUGZzb2W9Euo4moOr\",\"type\":\"tls_certificate\"}},\"tls_configuration\":{\"data\":{\"id\":\"t7CguUGZzb2W9Euo5FoKa\",\"type\":\"tls_configuration\"}},\"tls_domain\":{\"data\":{\"id\":\"example.com\",\"type\":\"tls_domain\"}}}}}"}],"_postman_id":"ba7044ef-0517-4231-b82b-a44754872308"},{"name":"Disable TLS on a domain","id":"14529d30-89ba-415a-903e-c4ffb5286f65","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/tls/activations/{{tls_activation_id}}","description":"<p>Disable TLS on the domain associated with this TLS activation.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["tls","activations","{{tls_activation_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"7dc4c3f4-ccb1-4b20-858b-82c9d0117c4d","name":"204 No Content","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/tls/activations/aCtguUGZzb2W9Euo4moOR","description":"Disable TLS on the domain associated with this TLS activation.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 No Content","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"14529d30-89ba-415a-903e-c4ffb5286f65"},{"name":"Update a certificate","id":"c257549e-081f-44ad-8ffc-9f1f91344753","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"data\":{\"type\":\"tls_activation\",\"relationships\":{\"tls_certificate\":{\"data\":{\"type\":\"tls_certificate\",\"id\":\"cRTguUGZzb2W9Euo4moOr\"}}}}}"},"url":"https://api.fastly.com/tls/activations/{{tls_activation_id}}","description":"<p>Update the certificate used to terminate TLS traffic for the domain associated with this TLS activation.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["tls","activations","{{tls_activation_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"81f3aadf-5261-4c2c-b4a8-49a81004021f","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"data\":{\"type\":\"tls_activation\",\"relationships\":{\"tls_certificate\":{\"data\":{\"type\":\"tls_certificate\",\"id\":\"cRTguUGZzb2W9Euo4moOr\"}}}}}"},"url":"https://api.fastly.com/tls/activations/aCtguUGZzb2W9Euo4moOR","description":"Update the certificate used to terminate TLS traffic for the domain associated with this TLS activation.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":{\"id\":\"aCtguUGZzb2W9Euo4moOR\",\"type\":\"tls_activation\",\"attributes\":{\"created_at\":\"2020-02-01T12:12:12.000Z\"},\"relationships\":{\"tls_certificate\":{\"data\":{\"id\":\"cRTguUGZzb2W9Euo4moOr\",\"type\":\"tls_certificate\"}},\"tls_configuration\":{\"data\":{\"id\":\"t7CguUGZzb2W9Euo5FoKa\",\"type\":\"tls_configuration\"}},\"tls_domain\":{\"data\":{\"id\":\"example.com\",\"type\":\"tls_domain\"}}}}}"}],"_postman_id":"c257549e-081f-44ad-8ffc-9f1f91344753"}],"id":"c9eca7d5-1e85-4bac-9bd7-bcc363a1b3e4","description":"<p>TLS activations.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>relationships.tls_certificate.id</td>\n<td>string</td>\n<td>Alphanumeric string identifying a TLS certificate.</td>\n</tr>\n<tr>\n<td>relationships.tls_configuration.id</td>\n<td>string</td>\n<td>Alphanumeric string identifying a TLS configuration.</td>\n</tr>\n<tr>\n<td>relationships.tls_domain.id</td>\n<td>string</td>\n<td>The domain name.</td>\n</tr>\n<tr>\n<td>type</td>\n<td>string</td>\n<td>Resource type.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>Alphanumeric string identifying a TLS activation.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"c9eca7d5-1e85-4bac-9bd7-bcc363a1b3e4"},{"name":"TLS Certificates","item":[{"name":"List TLS certificates","id":"dc2f974d-08fe-4da9-ace5-4c29992fda6e","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":"https://api.fastly.com/tls/certificates?filter[in_use]&filter[not_after]&filter[tls_domains.id]&include&page[number]&page[size]&sort","description":"<p>List all TLS certificates.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["tls","certificates"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Optional. Limit the returned certificates to those currently using Fastly to terminate TLS (that is, certificates associated with an activation). Permitted values: true, false.</p>\n","type":"text/plain"},"key":"filter[in_use]"},{"description":{"content":"<p>Limit the returned certificates to those that expire prior to the specified date in UTC. Accepts parameters: lte (e.g., filter[not_after][lte]=2020-05-05).</p>\n","type":"text/plain"},"key":"filter[not_after]"},{"description":{"content":"<p>Limit the returned certificates to those that include the specific domain.</p>\n","type":"text/plain"},"key":"filter[tls_domains.id]"},{"description":{"content":"<p>Include related objects. Optional, comma-separated values. Permitted values: tls_activations.</p>\n","type":"text/plain"},"key":"include"},{"description":{"content":"<p>Current page.</p>\n","type":"text/plain"},"key":"page[number]"},{"description":{"content":"<p>Number of records per page.</p>\n","type":"text/plain"},"key":"page[size]"},{"description":{"content":"<p>The order in which to list the results.</p>\n","type":"text/plain"},"key":"sort"}],"variable":[]}},"response":[{"id":"5082f2ce-d5f0-46e8-b27d-382ba2d0faf5","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":{"raw":"https://api.fastly.com/tls/certificates?page%5Bnumber%5D=1&page%5Bsize%5D=20?filter[in_use]&filter[not_after]&filter[tls_domains.id]&include&page[number]&page[size]&sort","protocol":"https","host":["api","fastly","com"],"path":["tls","certificates"],"query":[{"key":"filter[in_use]","description":"Optional. Limit the returned certificates to those currently using Fastly to terminate TLS (that is, certificates associated with an activation). Permitted values: true, false."},{"key":"filter[not_after]","description":"Limit the returned certificates to those that expire prior to the specified date in UTC. Accepts parameters: lte (e.g., filter[not_after][lte]=2020-05-05)."},{"key":"filter[tls_domains.id]","description":"Limit the returned certificates to those that include the specific domain."},{"key":"include","description":"Include related objects. Optional, comma-separated values. Permitted values: tls_activations."},{"key":"page[number]","description":"Current page."},{"key":"page[size]","description":"Number of records per page."},{"key":"sort","description":"The order in which to list the results."}]},"description":"List all TLS certificates.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"id\":\"cRTguUGZzb2W9Euo4moOr\",\"type\":\"tls_certificate\",\"attributes\":{\"created_at\":\"2020-02-01T12:12:12.000Z\",\"issued_to\":\"...\",\"issuer\":\"Let's Encrypt Authority X3\",\"name\":\"My certificate\",\"not_after\":\"2020-02-01T12:12:12.000Z\",\"not_before\":\"2020-02-01T12:12:12.000Z\",\"replace\":false,\"serial_number\":\"1234567890\",\"signature_algorithm\":\"SHA256\",\"updated_at\":\"2020-02-01T12:12:12.000Z\"},\"relationships\":{\"tls_domains\":{\"data\":[{\"id\":\"DOMAIN_NAME\",\"type\":\"tls_domain\"}]}}}],\"links\":{\"self\":\"https://api.fastly.com/tls/certificates?page%5Bnumber%5D=1&page%5Bsize%5D=20\",\"first\":\"https://api.fastly.com/tls/certificates?page%5Bnumber%5D=1&page%5Bsize%5D=20\",\"prev\":null,\"next\":null,\"last\":\"https://api.fastly.com/tls/certificates?page%5Bnumber%5D=1&page%5Bsize%5D=20\"},\"meta\":{\"per_page\":20,\"current_page\":1,\"record_count\":1,\"total_pages\":1}}"}],"_postman_id":"dc2f974d-08fe-4da9-ace5-4c29992fda6e"},{"name":"Create a TLS certificate","id":"7b471593-98ae-4caf-83ff-0aa2ff8df538","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"data\":{\"type\":\"tls_certificate\",\"attributes\":{\"cert_blob\":\"-----BEGIN CERTIFICATE-----\\n...\\n-----END CERTIFICATE-----\\n\",\"name\":\"My certificate\"}}}"},"url":"https://api.fastly.com/tls/certificates","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/tls/custom-certs/certificates/#create-tls-cert\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["tls","certificates"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"eeaacf31-a3dd-480e-a722-da7589a97a62","name":"201 Created","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"data\":{\"type\":\"tls_certificate\",\"attributes\":{\"cert_blob\":\"-----BEGIN CERTIFICATE-----\\n...\\n-----END CERTIFICATE-----\\n\",\"name\":\"My certificate\"}}}"},"url":"https://api.fastly.com/tls/certificates","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/tls/custom-certs/certificates/#create-tls-cert)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"201 Created","code":201,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":{\"id\":\"cRTguUGZzb2W9Euo4moOr\",\"type\":\"tls_certificate\",\"attributes\":{\"created_at\":\"2020-02-01T12:12:12.000Z\",\"issued_to\":\"...\",\"issuer\":\"Let's Encrypt Authority X3\",\"name\":\"My certificate\",\"not_after\":\"2020-02-01T12:12:12.000Z\",\"not_before\":\"2020-02-01T12:12:12.000Z\",\"replace\":false,\"serial_number\":\"1234567890\",\"signature_algorithm\":\"SHA256\",\"updated_at\":\"2020-02-01T12:12:12.000Z\"},\"relationships\":{\"tls_domains\":{\"data\":[{\"id\":\"DOMAIN_NAME\",\"type\":\"tls_domain\"}]}}}}"}],"_postman_id":"7b471593-98ae-4caf-83ff-0aa2ff8df538"},{"name":"Get a TLS certificate","id":"6111651e-0979-4803-9aac-9f45b540a939","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":"https://api.fastly.com/tls/certificates/{{tls_certificate_id}}","description":"<p>Show a TLS certificate.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["tls","certificates","{{tls_certificate_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"1862b522-938e-4730-be8b-04c62264242e","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":"https://api.fastly.com/tls/certificates/cRTguUGZzb2W9Euo4moOr","description":"Show a TLS certificate.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":{\"id\":\"cRTguUGZzb2W9Euo4moOr\",\"type\":\"tls_certificate\",\"attributes\":{\"created_at\":\"2020-02-01T12:12:12.000Z\",\"issued_to\":\"...\",\"issuer\":\"Let's Encrypt Authority X3\",\"name\":\"My certificate\",\"not_after\":\"2020-02-01T12:12:12.000Z\",\"not_before\":\"2020-02-01T12:12:12.000Z\",\"replace\":false,\"serial_number\":\"1234567890\",\"signature_algorithm\":\"SHA256\",\"updated_at\":\"2020-02-01T12:12:12.000Z\"},\"relationships\":{\"tls_domains\":{\"data\":[{\"id\":\"DOMAIN_NAME\",\"type\":\"tls_domain\"}]}}}}"}],"_postman_id":"6111651e-0979-4803-9aac-9f45b540a939"},{"name":"Delete a TLS certificate","id":"8f521c69-292c-410f-bed3-e0f936eabe0e","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/tls/certificates/{{tls_certificate_id}}","description":"<p>Destroy a TLS certificate. TLS certificates already enabled for a domain cannot be destroyed.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["tls","certificates","{{tls_certificate_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"921ada07-7133-42d9-80dc-0f4295ce6b36","name":"204 No Content","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/tls/certificates/cRTguUGZzb2W9Euo4moOr","description":"Destroy a TLS certificate. TLS certificates already enabled for a domain cannot be destroyed.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 No Content","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"8f521c69-292c-410f-bed3-e0f936eabe0e"},{"name":"Update a TLS certificate","id":"f4146906-6187-4de4-a138-692198870103","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"data\":{\"type\":\"tls_certificate\",\"attributes\":{\"cert_blob\":\"-----BEGIN CERTIFICATE-----\\n...\\n-----END CERTIFICATE-----\\n\",\"name\":\"My certificate\"}}}"},"url":"https://api.fastly.com/tls/certificates/{{tls_certificate_id}}","description":"<p>Replace a TLS certificate with a newly reissued TLS certificate, or update a TLS certificate's name. If replacing a TLS certificate, the new TLS certificate must contain all SAN entries as the current TLS certificate. It must either have an exact matching list or contain a superset.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["tls","certificates","{{tls_certificate_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"9a0eeef0-974e-4e61-af17-2dd67fbbc559","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"data\":{\"type\":\"tls_certificate\",\"attributes\":{\"cert_blob\":\"-----BEGIN CERTIFICATE-----\\n...\\n-----END CERTIFICATE-----\\n\",\"name\":\"My certificate\"}}}"},"url":"https://api.fastly.com/tls/certificates/cRTguUGZzb2W9Euo4moOr","description":"Replace a TLS certificate with a newly reissued TLS certificate, or update a TLS certificate's name. If replacing a TLS certificate, the new TLS certificate must contain all SAN entries as the current TLS certificate. It must either have an exact matching list or contain a superset.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":{\"id\":\"cRTguUGZzb2W9Euo4moOr\",\"type\":\"tls_certificate\",\"attributes\":{\"created_at\":\"2020-02-01T12:12:12.000Z\",\"issued_to\":\"...\",\"issuer\":\"Let's Encrypt Authority X3\",\"name\":\"My certificate\",\"not_after\":\"2020-02-01T12:12:12.000Z\",\"not_before\":\"2020-02-01T12:12:12.000Z\",\"replace\":false,\"serial_number\":\"1234567890\",\"signature_algorithm\":\"SHA256\",\"updated_at\":\"2020-02-01T12:12:12.000Z\"},\"relationships\":{\"tls_domains\":{\"data\":[{\"id\":\"DOMAIN_NAME\",\"type\":\"tls_domain\"}]}}}}"}],"_postman_id":"f4146906-6187-4de4-a138-692198870103"},{"name":"Get a TLS certificate blob (Limited Availability)","id":"0b8ffaa3-0469-476b-9b8b-84584bddbf01","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/tls/certificates/{{tls_certificate_id}}/blob","description":"<p>Retrieve a TLS certificate blob. This feature is part of a limited availability release.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["tls","certificates","{{tls_certificate_id}}","blob"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"3688bc04-9c01-47d0-9791-3fcacc43b4d4","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/tls/certificates/cRTguUGZzb2W9Euo4moOr/blob","description":"Retrieve a TLS certificate blob. This feature is part of a limited availability release.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"cert_blob\":\"-----BEGIN CERTIFICATE-----\\n...\\n-----END CERTIFICATE-----\\n\"}"}],"_postman_id":"0b8ffaa3-0469-476b-9b8b-84584bddbf01"}],"id":"3359fa8f-6fdd-4d2e-b0cc-2560f121714d","description":"<p>A TLS certificate is used to terminate TLS traffic for one or more of your TLS domains.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>allow_untrusted_root</td>\n<td>boolean</td>\n<td>Indicates that the supplied certificate was not signed by a trusted CA.</td>\n</tr>\n<tr>\n<td>cert_blob</td>\n<td>string</td>\n<td>The PEM-formatted certificate blob. Required.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>A customizable name for your certificate. Defaults to the certificate's Common Name or first Subject Alternative Names (SAN) entry. Optional.</td>\n</tr>\n<tr>\n<td>relationships.tls_domains.id</td>\n<td>string</td>\n<td>The domain name.</td>\n</tr>\n<tr>\n<td>type</td>\n<td>string</td>\n<td>Resource type.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>Alphanumeric string identifying a TLS certificate.</td>\n</tr>\n<tr>\n<td>issued_to</td>\n<td>string</td>\n<td>The hostname for which a certificate was issued.</td>\n</tr>\n<tr>\n<td>issuer</td>\n<td>string</td>\n<td>The certificate authority that issued the certificate.</td>\n</tr>\n<tr>\n<td>not_after</td>\n<td>string</td>\n<td>Time-stamp (GMT) when the certificate will expire. Must be in the future to be used to terminate TLS traffic.</td>\n</tr>\n<tr>\n<td>not_before</td>\n<td>string</td>\n<td>Time-stamp (GMT) when the certificate will become valid. Must be in the past to be used to terminate TLS traffic.</td>\n</tr>\n<tr>\n<td>replace</td>\n<td>boolean</td>\n<td>A recommendation from Fastly indicating the key associated with this certificate is in need of rotation.</td>\n</tr>\n<tr>\n<td>serial_number</td>\n<td>string</td>\n<td>A value assigned by the issuer that is unique to a certificate.</td>\n</tr>\n<tr>\n<td>signature_algorithm</td>\n<td>string</td>\n<td>The algorithm used to sign the certificate.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"3359fa8f-6fdd-4d2e-b0cc-2560f121714d"},{"name":"Certificate Signing Requests","item":[{"name":"Create CSR","id":"9a0054b7-5886-42af-9d12-d0c0e0689ad9","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"data\":{\"type\":\"csr\",\"attributes\":{\"sans\":[\"DOMAIN_NAME\"],\"common_name\":\"DOMAIN_NAME\",\"key_type\":\"RSA2048\",\"country\":\"US\",\"state\":\"California\",\"city\":\"San Francisco\",\"organization\":\"Fastly, Inc.\",\"organizational_unit\":\"Engineering\"},\"relationships\":{\"tls_private_key\":{\"data\":{\"type\":\"tls_private_key\",\"id\":\"KeYguUGZzb2W9Euo4moOR\"}}}}}"},"url":"https://api.fastly.com/tls/certificate_signing_requests","description":"<p>Creates a certificate signing request (CSR).</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["tls","certificate_signing_requests"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"9bfa8d06-340d-437e-a28b-d4f20f4f1bc4","name":"201 Created","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"data\":{\"type\":\"csr\",\"attributes\":{\"sans\":[\"DOMAIN_NAME\"],\"common_name\":\"DOMAIN_NAME\",\"key_type\":\"RSA2048\",\"country\":\"US\",\"state\":\"California\",\"city\":\"San Francisco\",\"organization\":\"Fastly, Inc.\",\"organizational_unit\":\"Engineering\"},\"relationships\":{\"tls_private_key\":{\"data\":{\"type\":\"tls_private_key\",\"id\":\"KeYguUGZzb2W9Euo4moOR\"}}}}}"},"url":"https://api.fastly.com/tls/certificate_signing_requests","description":"Creates a certificate signing request (CSR).\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"201 Created","code":201,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":{\"id\":\"1664973526709\",\"type\":\"csr\",\"attributes\":{\"content\":\"-----BEGIN CERTIFICATE REQUEST-----\\n...\\n-----END CERTIFICATE REQUEST-----\\n\"},\"relationships\":{\"tls_private_key\":{\"data\":{\"type\":\"tls_private_key\",\"id\":\"KeYguUGZzb2W9Euo4moOR\"}}}}}"}],"_postman_id":"9a0054b7-5886-42af-9d12-d0c0e0689ad9"}],"id":"917608b2-d138-4e27-be93-c1e0ffe1f5d5","description":"<p>A certificate signing request is needed to obtain a TLS certificate from a Certificate Authority (CA).</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>city</td>\n<td>string</td>\n<td>Locality (L) - The locality, city, town, or village where the organization is located.</td>\n</tr>\n<tr>\n<td>common_name</td>\n<td>string</td>\n<td>Common Name (CN) - The fully qualified domain name (FQDN) to be secured by this certificate. The common name should be one of the entries in the SANs parameter.</td>\n</tr>\n<tr>\n<td>country</td>\n<td>string</td>\n<td>Country (C) - The two-letter ISO country code where the organization is located.</td>\n</tr>\n<tr>\n<td>email</td>\n<td>string</td>\n<td>Email Address (EMAIL) - The organizational contact for this.</td>\n</tr>\n<tr>\n<td>key_type</td>\n<td>string</td>\n<td>CSR Key Type.</td>\n</tr>\n<tr>\n<td>organization</td>\n<td>string</td>\n<td>Organization (O) - The legal name of the organization, including any suffixes. This should not be abbreviated.</td>\n</tr>\n<tr>\n<td>organizational_unit</td>\n<td>string</td>\n<td>Organizational Unit (OU) - The internal division of the organization managing the certificate.</td>\n</tr>\n<tr>\n<td>postal_code</td>\n<td>string</td>\n<td>Postal Code - The postal code where the organization is located.</td>\n</tr>\n<tr>\n<td>relationships.tls_private_key.id</td>\n<td>string</td>\n<td>Optional. An alphanumeric string identifying the private key you've uploaded for use with your TLS certificate. If left blank, Fastly will create and manage a key for you.</td>\n</tr>\n<tr>\n<td>sans</td>\n<td>array</td>\n<td>Subject Alternate Names - An array of one or more fully qualified domain names or public IP addresses to be secured by this certificate. Required.</td>\n</tr>\n<tr>\n<td>state</td>\n<td>string</td>\n<td>State (S) - The state, province, region, or county where the organization is located. This should not be abbreviated.</td>\n</tr>\n<tr>\n<td>street_address</td>\n<td>string</td>\n<td>Street Address - The street address where the organization is located.</td>\n</tr>\n<tr>\n<td>type</td>\n<td>string</td>\n<td>CSR Resource Type.</td>\n</tr>\n<tr>\n<td>content</td>\n<td>string</td>\n<td>The PEM encoded CSR.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"917608b2-d138-4e27-be93-c1e0ffe1f5d5"},{"name":"TLS Domains","item":[{"name":"List TLS domains","id":"3cab6a64-58c4-40f2-9580-7b97a4254a0c","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":"https://api.fastly.com/tls/domains?filter[in_use]&filter[tls_certificates.id]&filter[tls_subscriptions.id]&include&page[number]&page[size]&sort","description":"<p>List all TLS domains.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["tls","domains"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Optional. Limit the returned domains to those currently using Fastly to terminate TLS with SNI (that is, domains considered \"in use\") Permitted values: true, false.</p>\n","type":"text/plain"},"key":"filter[in_use]"},{"description":{"content":"<p>Optional. Limit the returned domains to those listed in the given TLS certificate's SAN list.</p>\n","type":"text/plain"},"key":"filter[tls_certificates.id]"},{"description":{"content":"<p>Optional. Limit the returned domains to those for a given TLS subscription.</p>\n","type":"text/plain"},"key":"filter[tls_subscriptions.id]"},{"description":{"content":"<p>Include related objects. Optional, comma-separated values. Permitted values: tls_activations, tls_certificates, tls_subscriptions, tls_subscriptions.tls_authorizations, tls_authorizations.globalsign_email_challenge, and tls_authorizations.self_managed_http_challenge.</p>\n","type":"text/plain"},"key":"include"},{"description":{"content":"<p>Current page.</p>\n","type":"text/plain"},"key":"page[number]"},{"description":{"content":"<p>Number of records per page.</p>\n","type":"text/plain"},"key":"page[size]"},{"description":{"content":"<p>The order in which to list the results.</p>\n","type":"text/plain"},"key":"sort"}],"variable":[]}},"response":[{"id":"d23fb6db-ce9f-40c9-959d-f362d1bc8be7","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":{"raw":"https://api.fastly.com/tls/domains?page%5Bnumber%5D=1&page%5Bsize%5D=20?filter[in_use]&filter[tls_certificates.id]&filter[tls_subscriptions.id]&include&page[number]&page[size]&sort","protocol":"https","host":["api","fastly","com"],"path":["tls","domains"],"query":[{"key":"filter[in_use]","description":"Optional. Limit the returned domains to those currently using Fastly to terminate TLS with SNI (that is, domains considered \"in use\") Permitted values: true, false."},{"key":"filter[tls_certificates.id]","description":"Optional. Limit the returned domains to those listed in the given TLS certificate's SAN list."},{"key":"filter[tls_subscriptions.id]","description":"Optional. Limit the returned domains to those for a given TLS subscription."},{"key":"include","description":"Include related objects. Optional, comma-separated values. Permitted values: tls_activations, tls_certificates, tls_subscriptions, tls_subscriptions.tls_authorizations, tls_authorizations.globalsign_email_challenge, and tls_authorizations.self_managed_http_challenge."},{"key":"page[number]","description":"Current page."},{"key":"page[size]","description":"Number of records per page."},{"key":"sort","description":"The order in which to list the results."}]},"description":"List all TLS domains.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"id\":\"DOMAIN_NAME\",\"type\":\"tls_domain\",\"relationships\":{\"tls_activations\":{\"data\":[{\"id\":\"aCtguUGZzb2W9Euo4moOR\",\"type\":\"tls_activation\"}]},\"tls_certificates\":{\"data\":[{\"id\":\"cRTguUGZzb2W9Euo4moOr\",\"type\":\"tls_certificate\"}]},\"tls_subscriptions\":{\"data\":[{\"id\":\"sU3guUGZzb2W9Euo4Mo0r\",\"type\":\"tls_subscription\"}]}}}],\"links\":{\"self\":\"https://api.fastly.com/tls/domains?page%5Bnumber%5D=1&page%5Bsize%5D=20\",\"first\":\"https://api.fastly.com/tls/domains?page%5Bnumber%5D=1&page%5Bsize%5D=20\",\"last\":\"https://api.fastly.com/tls/domains?page%5Bnumber%5D=1&page%5Bsize%5D=20\"},\"meta\":{\"record_count\":1,\"current_page\":1,\"per_page\":20,\"total_pages\":1}}"}],"_postman_id":"3cab6a64-58c4-40f2-9580-7b97a4254a0c"}],"id":"509e05f9-7adb-4f23-8d77-49da50297517","description":"<p>TLS domains are all the domains (including wildcard domains) included in any TLS certificate's Subject Alternative Names (SAN) list. Included in the response is information about which certificates reference this domain as well as the TLS activation indicating which certificate is enabled to serve TLS traffic for the domain.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>The domain name.</td>\n</tr>\n<tr>\n<td>relationships.tls_activations.id</td>\n<td>string</td>\n<td>Alphanumeric string identifying a TLS activation.</td>\n</tr>\n<tr>\n<td>relationships.tls_certificates.id</td>\n<td>string</td>\n<td>Alphanumeric string identifying a TLS certificate.</td>\n</tr>\n<tr>\n<td>relationships.tls_subscriptions.id</td>\n<td>string</td>\n<td>Alphanumeric string identifying a TLS subscription.</td>\n</tr>\n<tr>\n<td>type</td>\n<td>string</td>\n<td>Resource type.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"509e05f9-7adb-4f23-8d77-49da50297517"},{"name":"Private Keys","item":[{"name":"List TLS private keys","id":"93698db5-b38d-4862-a2e5-76867d75d496","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":"https://api.fastly.com/tls/private_keys?filter[in_use]&page[number]&page[size]","description":"<p>List all TLS private keys.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["tls","private_keys"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Limit the returned keys to those without any matching TLS certificates. The only valid value is false.</p>\n","type":"text/plain"},"key":"filter[in_use]"},{"description":{"content":"<p>Current page.</p>\n","type":"text/plain"},"key":"page[number]"},{"description":{"content":"<p>Number of records per page.</p>\n","type":"text/plain"},"key":"page[size]"}],"variable":[]}},"response":[{"id":"4b9ce9c1-ce3a-452b-b618-5577f0151d6f","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":{"raw":"https://api.fastly.com/tls/private_keys?page%5Bnumber%5D=1&page%5Bsize%5D=20?filter[in_use]&page[number]&page[size]","protocol":"https","host":["api","fastly","com"],"path":["tls","private_keys"],"query":[{"key":"filter[in_use]","description":"Limit the returned keys to those without any matching TLS certificates. The only valid value is false."},{"key":"page[number]","description":"Current page."},{"key":"page[size]","description":"Number of records per page."}]},"description":"List all TLS private keys.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"id\":\"KeYguUGZzb2W9Euo4moOR\",\"type\":\"tls_private_key\",\"attributes\":{\"key_length\":2048,\"key_type\":\"RSA\",\"name\":\"My private key\",\"created_at\":\"2020-02-01T12:12:12.000Z\",\"replace\":false,\"public_key_sha1\":\"KEY_DIGEST\"}}],\"meta\":{\"record_count\":1,\"current_page\":1,\"per_page\":20,\"total_pages\":1}}"}],"_postman_id":"93698db5-b38d-4862-a2e5-76867d75d496"},{"name":"Create a TLS private key","id":"de10b000-6506-4e83-8366-ab01d9e62aa0","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"data\":{\"type\":\"tls_private_key\",\"attributes\":{\"key\":\"-----BEGIN PRIVATE KEY-----\\n...\\n-----END PRIVATE KEY-----\\n\",\"name\":\"My private key\"}}}"},"url":"https://api.fastly.com/tls/private_keys","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/tls/custom-certs/private-keys/#create-tls-key\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["tls","private_keys"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"f08941b1-4b28-4983-adda-8c07c965cee7","name":"201 Created","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"data\":{\"type\":\"tls_private_key\",\"attributes\":{\"key\":\"-----BEGIN PRIVATE KEY-----\\n...\\n-----END PRIVATE KEY-----\\n\",\"name\":\"My private key\"}}}"},"url":"https://api.fastly.com/tls/private_keys","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/tls/custom-certs/private-keys/#create-tls-key)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"201 Created","code":201,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":{\"id\":\"KeYguUGZzb2W9Euo4moOR\",\"type\":\"tls_private_key\",\"attributes\":{\"key_length\":2048,\"key_type\":\"RSA\",\"name\":\"My private key\",\"created_at\":null,\"replace\":false,\"public_key_sha1\":\"KEY_DIGEST\"}}}"}],"_postman_id":"de10b000-6506-4e83-8366-ab01d9e62aa0"},{"name":"Get a TLS private key","id":"92d9adb1-04a4-4de8-a553-31fd770381da","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":"https://api.fastly.com/tls/private_keys/{{tls_private_key_id}}","description":"<p>Show a TLS private key.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["tls","private_keys","{{tls_private_key_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"e6a6f3b6-8f73-4e0e-a275-d4e9cebe162e","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":"https://api.fastly.com/tls/private_keys/KeYguUGZzb2W9Euo4moOR","description":"Show a TLS private key.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":{\"id\":\"KeYguUGZzb2W9Euo4moOR\",\"type\":\"tls_private_key\",\"attributes\":{\"key_length\":2048,\"key_type\":\"RSA\",\"name\":\"My private key\",\"created_at\":\"2020-02-01T12:12:12.000Z\",\"replace\":false,\"public_key_sha1\":\"KEY_DIGEST\"}}}"}],"_postman_id":"92d9adb1-04a4-4de8-a553-31fd770381da"},{"name":"Delete a TLS private key","id":"f30cffee-3802-4e9a-afa2-5a4c16eddd20","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/tls/private_keys/{{tls_private_key_id}}","description":"<p>Destroy a TLS private key. Only private keys not already matched to any certificates can be deleted.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["tls","private_keys","{{tls_private_key_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"16545f3b-fe3a-4d88-af9b-5701b7d39dfb","name":"204 No Content","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/tls/private_keys/KeYguUGZzb2W9Euo4moOR","description":"Destroy a TLS private key. Only private keys not already matched to any certificates can be deleted.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 No Content","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"f30cffee-3802-4e9a-afa2-5a4c16eddd20"}],"id":"9835b0fe-0628-46d1-a304-6a85df9f6055","description":"<p>A private key is used to sign a Certificate. A key can be used to sign multiple certificates.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>key</td>\n<td>string</td>\n<td>The contents of the private key. Must be a PEM-formatted key. Not returned in response body. Required.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>A customizable name for your private key. Optional.</td>\n</tr>\n<tr>\n<td>relationships.tls_activations.id</td>\n<td>string</td>\n<td>Alphanumeric string identifying a TLS activation.</td>\n</tr>\n<tr>\n<td>relationships.tls_domains.id</td>\n<td>string</td>\n<td>The domain name.</td>\n</tr>\n<tr>\n<td>type</td>\n<td>string</td>\n<td>Resource type.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>Alphanumeric string identifying a private Key.</td>\n</tr>\n<tr>\n<td>key_length</td>\n<td>integer</td>\n<td>The key length used to generate the private key.</td>\n</tr>\n<tr>\n<td>key_type</td>\n<td>string</td>\n<td>The algorithm used to generate the private key. Must be RSA.</td>\n</tr>\n<tr>\n<td>public_key_sha1</td>\n<td>string</td>\n<td>Useful for safely identifying the key.</td>\n</tr>\n<tr>\n<td>replace</td>\n<td>boolean</td>\n<td>A recommendation from Fastly to replace this private key and all associated certificates.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"9835b0fe-0628-46d1-a304-6a85df9f6055"}],"id":"04921b48-fb3a-4d01-99d4-7c514bb863ca","_postman_id":"04921b48-fb3a-4d01-99d4-7c514bb863ca","description":""}],"id":"beaff938-be32-4fba-8b80-ee5b9fdd50a4","_postman_id":"beaff938-be32-4fba-8b80-ee5b9fdd50a4","description":""},{"name":"Mutual TLS","item":[{"name":"Setting and Unsetting Mutual TLS on TLS Activations","item":[{"name":"List TLS activations","id":"48049f7e-7c00-426c-ab25-b78baaf1964a","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":"https://api.fastly.com/tls/activations?filter[mutual_authentication.id]&filter[tls_certificate.id]&filter[tls_configuration.id]&filter[tls_domain.id]&include&page[number]&page[size]","description":"<p>List all TLS activations.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["tls","activations"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Limit the returned rules to a specific mutual authentication ID (or null ID).</p>\n","type":"text/plain"},"key":"filter[mutual_authentication.id]"},{"description":{"content":"<p>Limit the returned activations to a specific certificate.</p>\n","type":"text/plain"},"key":"filter[tls_certificate.id]"},{"description":{"content":"<p>Limit the returned activations to a specific TLS configuration.</p>\n","type":"text/plain"},"key":"filter[tls_configuration.id]"},{"description":{"content":"<p>Limit the returned rules to a specific domain name.</p>\n","type":"text/plain"},"key":"filter[tls_domain.id]"},{"description":{"content":"<p>Include related objects. Optional, comma-separated values. Permitted values: tls_certificate, tls_configuration, and tls_domain.</p>\n","type":"text/plain"},"key":"include"},{"description":{"content":"<p>Current page.</p>\n","type":"text/plain"},"key":"page[number]"},{"description":{"content":"<p>Number of records per page.</p>\n","type":"text/plain"},"key":"page[size]"}],"variable":[]}},"response":[{"id":"451e8c84-8cdf-4ae5-84c2-995155388751","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":{"raw":"https://api.fastly.com/tls/activations?include=tls_certificate%2Ctls_configuration%2Ctls_domain&page%5Bnumber%5D=1&page%5Bsize%5D=20?filter[mutual_authentication.id]&filter[tls_certificate.id]&filter[tls_configuration.id]&filter[tls_domain.id]&include&page[number]&page[size]","protocol":"https","host":["api","fastly","com"],"path":["tls","activations"],"query":[{"key":"filter[mutual_authentication.id]","description":"Limit the returned rules to a specific mutual authentication ID (or null ID)."},{"key":"filter[tls_certificate.id]","description":"Limit the returned activations to a specific certificate."},{"key":"filter[tls_configuration.id]","description":"Limit the returned activations to a specific TLS configuration."},{"key":"filter[tls_domain.id]","description":"Limit the returned rules to a specific domain name."},{"key":"include","description":"Include related objects. Optional, comma-separated values. Permitted values: tls_certificate, tls_configuration, and tls_domain."},{"key":"page[number]","description":"Current page."},{"key":"page[size]","description":"Number of records per page."}]},"description":"List all TLS activations.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"id\":\"aCtguUGZzb2W9Euo4moOR\",\"type\":\"tls_activation\",\"attributes\":{\"created_at\":\"2020-02-01T12:12:12.000Z\"},\"relationships\":{\"tls_certificate\":{\"data\":{\"id\":\"cRTguUGZzb2W9Euo4moOr\",\"type\":\"tls_certificate\"}},\"tls_configuration\":{\"data\":{\"id\":\"t7CguUGZzb2W9Euo5FoKa\",\"type\":\"tls_configuration\"}},\"tls_domain\":{\"data\":{\"id\":\"example.com\",\"type\":\"tls_domain\"}},\"mutual_authentication\":{\"data\":{\"id\":\"SEAwSOsP7dEpTgGZdP7ZFw\",\"type\":\"mutual_authentication\"}}}}],\"links\":{\"self\":\"https://api.fastly.com/tls/activations?page%5Bnumber%5D=1&page%5Bsize%5D=100\",\"first\":\"https://api.fastly.com/tls/activations?page%5Bnumber%5D=1&page%5Bsize%5D=100\",\"prev\":null,\"next\":null,\"last\":\"https://api.fastly.com/tls/activations?page%5Bnumber%5D=1&page%5Bsize%5D=100\"},\"meta\":{\"per_page\":100,\"current_page\":1,\"record_count\":1,\"total_pages\":1}}"}],"_postman_id":"48049f7e-7c00-426c-ab25-b78baaf1964a"},{"name":"Get a TLS activation","id":"6870a87f-0936-4da4-be97-35710f4bd764","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":"https://api.fastly.com/tls/activations/{{tls_activation_id}}?include","description":"<p>Show a TLS activation.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["tls","activations","{{tls_activation_id}}"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Include related objects. Optional, comma-separated values. Permitted values: tls_certificate, tls_configuration, and tls_domain.</p>\n","type":"text/plain"},"key":"include"}],"variable":[]}},"response":[{"id":"b3f86073-a20a-411a-b852-bc1cc61b27b0","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":{"raw":"https://api.fastly.com/tls/activations/aCtguUGZzb2W9Euo4moOR?include=tls_certificate%2Ctls_configuration%2Ctls_domain?include","protocol":"https","host":["api","fastly","com"],"path":["tls","activations","aCtguUGZzb2W9Euo4moOR"],"query":[{"key":"include","description":"Include related objects. Optional, comma-separated values. Permitted values: tls_certificate, tls_configuration, and tls_domain."}]},"description":"Show a TLS activation.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":{\"id\":\"aCtguUGZzb2W9Euo4moOR\",\"type\":\"tls_activation\",\"attributes\":{\"created_at\":\"2020-02-01T12:12:12.000Z\"},\"relationships\":{\"tls_certificate\":{\"data\":{\"id\":\"cRTguUGZzb2W9Euo4moOr\",\"type\":\"tls_certificate\"}},\"tls_configuration\":{\"data\":{\"id\":\"t7CguUGZzb2W9Euo5FoKa\",\"type\":\"tls_configuration\"}},\"tls_domain\":{\"data\":{\"id\":\"example.com\",\"type\":\"tls_domain\"}},\"mutual_authentication\":{\"data\":{\"id\":\"SEAwSOsP7dEpTgGZdP7ZFw\",\"type\":\"mutual_authentication\"}}}}}"}],"_postman_id":"6870a87f-0936-4da4-be97-35710f4bd764"},{"name":"Update Mutual TLS","id":"d1461f6f-da4b-46fb-9e5c-2c96604c4903","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"data\":{\"type\":\"tls_activation\",\"relationships\":{\"mutual_authentication\":{\"data\":{\"type\":\"mutual_authentication\",\"id\":\"SEAwSOsP7dEpTgGZdP7ZFw\"}}}}}"},"url":"https://api.fastly.com/tls/activations/{{tls_activation_id}}","description":"<p>Update the mutual authentication for the domain associated with this TLS activation. You may either 1) pass a valid mutual authentication ID to activate Mutual TLS, or 2) pass null as the ID to deactivate from Mutual TLS.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["tls","activations","{{tls_activation_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"29a6bfcc-d6b9-4d27-a862-5cd7ce7b7bf5","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"data\":{\"type\":\"tls_activation\",\"relationships\":{\"mutual_authentication\":{\"data\":{\"type\":\"mutual_authentication\",\"id\":\"SEAwSOsP7dEpTgGZdP7ZFw\"}}}}}"},"url":"https://api.fastly.com/tls/activations/aCtguUGZzb2W9Euo4moOR","description":"Update the mutual authentication for the domain associated with this TLS activation. You may either 1) pass a valid mutual authentication ID to activate Mutual TLS, or 2) pass null as the ID to deactivate from Mutual TLS.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":{\"id\":\"aCtguUGZzb2W9Euo4moOR\",\"type\":\"tls_activation\",\"attributes\":{\"created_at\":\"2020-02-01T12:12:12.000Z\"},\"relationships\":{\"tls_certificate\":{\"data\":{\"id\":\"cRTguUGZzb2W9Euo4moOr\",\"type\":\"tls_certificate\"}},\"tls_configuration\":{\"data\":{\"id\":\"t7CguUGZzb2W9Euo5FoKa\",\"type\":\"tls_configuration\"}},\"tls_domain\":{\"data\":{\"id\":\"example.com\",\"type\":\"tls_domain\"}},\"mutual_authentication\":{\"data\":{\"id\":\"SEAwSOsP7dEpTgGZdP7ZFw\",\"type\":\"mutual_authentication\"}}}}}"}],"_postman_id":"d1461f6f-da4b-46fb-9e5c-2c96604c4903"}],"id":"0f7111a4-b4aa-4f72-b2c0-7837dcefe774","description":"<p>Mutual TLS can be added to existing TLS activations to allow for client-to-server authentication. In order to use mutual TLS, you must already have active server-side TLS using either custom certificates or an enabled Fastly-managed subscription.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>relationships.mutual_authentication.id</td>\n<td>string</td>\n<td>Alphanumeric string identifying a mutual authentication.</td>\n</tr>\n<tr>\n<td>relationships.tls_certificate.id</td>\n<td>string</td>\n<td>Alphanumeric string identifying a TLS certificate.</td>\n</tr>\n<tr>\n<td>relationships.tls_configuration.id</td>\n<td>string</td>\n<td>Alphanumeric string identifying a TLS configuration.</td>\n</tr>\n<tr>\n<td>relationships.tls_domain.id</td>\n<td>string</td>\n<td>The domain name.</td>\n</tr>\n<tr>\n<td>type</td>\n<td>string</td>\n<td>Resource type.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>Alphanumeric string identifying a TLS activation.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"0f7111a4-b4aa-4f72-b2c0-7837dcefe774"},{"name":"Managing and Uploading Mutual Authentications","item":[{"name":"List Mutual Authentications","id":"c57d1f2f-0d30-4150-8d9b-3ecf2dc4a40b","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":"https://api.fastly.com/tls/mutual_authentications?include&page[number]&page[size]","description":"<p>List all mutual authentications.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["tls","mutual_authentications"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Comma-separated list of related objects to include (optional). Permitted values: tls_activations. Including TLS activations will provide you with the TLS domain names that are related to your Mutual TLS authentication.</p>\n","type":"text/plain"},"key":"include"},{"description":{"content":"<p>Current page.</p>\n","type":"text/plain"},"key":"page[number]"},{"description":{"content":"<p>Number of records per page.</p>\n","type":"text/plain"},"key":"page[size]"}],"variable":[]}},"response":[{"id":"96ba0cb7-0be4-46c9-9d5e-0bcdb15b1e03","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":{"raw":"https://api.fastly.com/tls/mutual_authentications?page%5Bnumber%5D=1&page%5Bsize%5D=20?include&page[number]&page[size]","protocol":"https","host":["api","fastly","com"],"path":["tls","mutual_authentications"],"query":[{"key":"include","description":"Comma-separated list of related objects to include (optional). Permitted values: tls_activations. Including TLS activations will provide you with the TLS domain names that are related to your Mutual TLS authentication."},{"key":"page[number]","description":"Current page."},{"key":"page[size]","description":"Number of records per page."}]},"description":"List all mutual authentications.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"id\":\"SEAwSOsP7dEpTgGZdP7ZFw\",\"type\":\"mutual_authentication\",\"attributes\":{\"created_at\":\"2020-02-01T12:12:12.000Z\",\"enforced\":true,\"name\":\"Mutual Authentication A\",\"updated_at\":\"2020-02-01T12:12:12.000Z\"},\"relationships\":{\"tls_activations\":{\"data\":[{\"id\":\"TLS_ACTIVATION_ID\",\"type\":\"tls_activation\"}]}}}],\"links\":{\"self\":\"https://api.fastly.com/tls/mutual_authentications?page%5Bnumber%5D=1&page%5Bsize%5D=100\",\"first\":\"https://api.fastly.com/tls/mutual_authentications?page%5Bnumber%5D=1&page%5Bsize%5D=100\",\"prev\":null,\"next\":null,\"last\":\"https://api.fastly.com/tls/mutual_authentications?page%5Bnumber%5D=1&page%5Bsize%5D=100\"},\"meta\":{\"per_page\":100,\"current_page\":1,\"record_count\":1,\"total_pages\":1}}"}],"_postman_id":"c57d1f2f-0d30-4150-8d9b-3ecf2dc4a40b"},{"name":"Create a Mutual Authentication","id":"1043c637-9455-43fe-92fc-3074c018a84d","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"data\":{\"type\":\"mutual_authentication\",\"attributes\":{\"cert_bundle\":\"-----BEGIN CERTIFICATE-----\\n...\\n-----END CERTIFICATE-----\\n\",\"name\":\"Mutual Authentication A\"}}}"},"url":"https://api.fastly.com/tls/mutual_authentications","description":"<p>Create a mutual authentication using a bundle of certificates to enable client-to-server mutual TLS.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["tls","mutual_authentications"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"929ca677-22fa-42c4-a9ce-3fe39a553cf1","name":"201 Created","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"data\":{\"type\":\"mutual_authentication\",\"attributes\":{\"cert_bundle\":\"-----BEGIN CERTIFICATE-----\\n...\\n-----END CERTIFICATE-----\\n\",\"name\":\"Mutual Authentication A\"}}}"},"url":"https://api.fastly.com/tls/mutual_authentications","description":"Create a mutual authentication using a bundle of certificates to enable client-to-server mutual TLS.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"201 Created","code":201,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":{\"id\":\"aCtguUGZzb2W9Euo4moOR\",\"type\":\"mutual_authentication\",\"attributes\":{\"created_at\":\"2020-02-01T12:12:12.000Z\",\"enforced\":true,\"name\":\"Mutual Authentication A\",\"updated_at\":\"2020-02-01T12:12:12.000Z\"}}}"}],"_postman_id":"1043c637-9455-43fe-92fc-3074c018a84d"},{"name":"Get a Mutual Authentication","id":"51c30133-97f6-4318-8fc4-c25c86938db4","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":"https://api.fastly.com/tls/mutual_authentications/{{mutual_authentication_id}}?include","description":"<p>Show a Mutual Authentication.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["tls","mutual_authentications","{{mutual_authentication_id}}"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Comma-separated list of related objects to include (optional). Permitted values: tls_activations. Including TLS activations will provide you with the TLS domain names that are related to your Mutual TLS authentication.</p>\n","type":"text/plain"},"key":"include"}],"variable":[]}},"response":[{"id":"476c37f1-5601-4d9e-830c-315d2c512375","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/vnd.api+json"}],"url":{"raw":"https://api.fastly.com/tls/mutual_authentications/SEAwSOsP7dEpTgGZdP7ZFw?include","protocol":"https","host":["api","fastly","com"],"path":["tls","mutual_authentications","SEAwSOsP7dEpTgGZdP7ZFw"],"query":[{"key":"include","description":"Comma-separated list of related objects to include (optional). Permitted values: tls_activations. Including TLS activations will provide you with the TLS domain names that are related to your Mutual TLS authentication."}]},"description":"Show a Mutual Authentication.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":{\"id\":\"SEAwSOsP7dEpTgGZdP7ZFw\",\"type\":\"mutual_authentication\",\"attributes\":{\"created_at\":\"2020-02-01T12:12:12.000Z\",\"enforced\":true,\"name\":\"Mutual Authentication A\",\"updated_at\":\"2020-02-01T12:12:12.000Z\"},\"relationships\":{\"tls_activations\":{\"data\":[{\"id\":\"TLS_ACTIVATION_ID\",\"type\":\"tls_activation\"}]}}}}"}],"_postman_id":"51c30133-97f6-4318-8fc4-c25c86938db4"},{"name":"Delete a Mutual TLS","id":"176f7416-6094-422f-8f21-17cbddf99eb5","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/tls/mutual_authentications/{{mutual_authentication_id}}","description":"<p>Remove a Mutual TLS authentication.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["tls","mutual_authentications","{{mutual_authentication_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"308e9293-c067-4d3a-98ef-08ae1876fd55","name":"204 No Content","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/tls/mutual_authentications/SEAwSOsP7dEpTgGZdP7ZFw","description":"Remove a Mutual TLS authentication.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 No Content","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"176f7416-6094-422f-8f21-17cbddf99eb5"},{"name":"Update a Mutual Authentication","id":"f6f9e144-e7a8-4cc3-8d64-0107bb18f5aa","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"data\":{\"type\":\"mutual_authentication\",\"attributes\":{\"cert_bundle\":\"-----BEGIN CERTIFICATE-----\\n...\\n-----END CERTIFICATE-----\\n\",\"enforced\":false,\"name\":\"Mutual Authentication B\"}}}"},"url":"https://api.fastly.com/tls/mutual_authentications/{{mutual_authentication_id}}","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/tls/mutual-tls/authentication/#patch-mutual-authentication\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["tls","mutual_authentications","{{mutual_authentication_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"39338b4c-5530-4b46-8b39-6014080cdd2e","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/vnd.api+json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"data\":{\"type\":\"mutual_authentication\",\"attributes\":{\"cert_bundle\":\"-----BEGIN CERTIFICATE-----\\n...\\n-----END CERTIFICATE-----\\n\",\"enforced\":false,\"name\":\"Mutual Authentication B\"}}}"},"url":"https://api.fastly.com/tls/mutual_authentications/SEAwSOsP7dEpTgGZdP7ZFw","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/tls/mutual-tls/authentication/#patch-mutual-authentication)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [TLS management](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":{\"id\":\"SEAwSOsP7dEpTgGZdP7ZFw\",\"type\":\"mutual_authentication\",\"attributes\":{\"created_at\":\"2020-02-01T12:12:12.000Z\",\"enforced\":false,\"name\":\"Mutual Authentication B\",\"updated_at\":\"2022-02-01T12:12:12.000Z\"},\"relationships\":{\"tls_activations\":{\"data\":[{\"id\":\"TLS_ACTIVATION_ID\",\"type\":\"tls_activation\"}]}}}}"}],"_postman_id":"f6f9e144-e7a8-4cc3-8d64-0107bb18f5aa"}],"id":"afa58970-bb7f-4bc3-924e-d41719d84002","description":"<p>The Mutual TLS API allows for client-to-server authentication using client-side X.509 authentication. The main Mutual Authentication object represents the certificate bundle and other configurations which support Mutual TLS for your domains.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">TLS management</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>cert_bundle</td>\n<td>string</td>\n<td>One or more certificates. Enter each individual certificate blob on a new line. Must be PEM-formatted. Required on create. You may optionally rotate the cert_bundle on update.</td>\n</tr>\n<tr>\n<td>enforced</td>\n<td>boolean</td>\n<td>Determines whether Mutual TLS will fail closed (enforced) or fail open. A true value will require a successful Mutual TLS handshake for the connection to continue and will fail closed if unsuccessful. A false value will fail open and allow the connection to proceed. Optional. Defaults to true.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>A custom name for your mutual authentication. Optional. If name is not supplied we will auto-generate one.</td>\n</tr>\n<tr>\n<td>relationships.tls_activations.id</td>\n<td>string</td>\n<td>Alphanumeric string identifying a TLS activation.</td>\n</tr>\n<tr>\n<td>type</td>\n<td>string</td>\n<td>Resource type.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>Alphanumeric string identifying a mutual authentication.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"afa58970-bb7f-4bc3-924e-d41719d84002"}],"id":"202a2967-4c7e-438b-8cfb-f12033d14147","_postman_id":"202a2967-4c7e-438b-8cfb-f12033d14147","description":""},{"name":"Utilities","item":[{"name":"Check content status","item":[{"name":"Check status of content in each POP's cache","id":"86159db0-e990-4ca7-9ebf-31c93597107a","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/content/edge_check?url","description":"<p>Retrieve headers and MD5 hash of the content for a particular URL from each Fastly edge server. This API is limited to 200 requests per hour. If the content takes too long to download, the hash will be set to error-timeout-$pop. If the response is too large, it will be set to warning-too-large-$pop.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions (this endpoint does not accept a token with the <code>global:read</code> scope).</p>\n</blockquote>\n","urlObject":{"path":["content","edge_check"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Full URL (host and path) to check on all nodes. if protocol is omitted, http will be assumed.</p>\n","type":"text/plain"},"key":"url"}],"variable":[]}},"response":[{"id":"18ac267b-97bd-4344-8e8d-ebaeb81524f7","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/content/edge_check?url=https%3A%2F%2Fwww.example.com%2Ffoo%2Fbar?url","protocol":"https","host":["api","fastly","com"],"path":["content","edge_check"],"query":[{"key":"url","description":"Full URL (host and path) to check on all nodes. if protocol is omitted, http will be assumed."}]},"description":"Retrieve headers and MD5 hash of the content for a particular URL from each Fastly edge server. This API is limited to 200 requests per hour. If the content takes too long to download, the hash will be set to error-timeout-$pop. If the response is too large, it will be set to warning-too-large-$pop.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions (this endpoint does not accept a token with the `global:read` scope).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"hash\":\"c6447943be2cff04787d9367ddd58fa0\",\"request\":{\"headers\":{\"Host\":\"www.example.com/foo/bar\",\"User-Agent\":\"Fastly/cache-check\"},\"method\":null,\"url\":null},\"response\":{\"headers\":{\"Accept-Ranges\":\"bytes\",\"Age\":\"0\",\"Connection\":\"keep-alive\",\"Content-Length\":\"154189\",\"Content-Type\":\"text/html; charset=UTF-8\",\"Date\":\"Mon, 06 Jun 2016 15:26:05 GMT\",\"ETag\":\"W/\\\"76cdf069e25c5e32bb8005982d3f8e0d\\\"\",\"Expires\":\"Thu, 01 Jan 1970 00:00:00 GMT\",\"Set-Cookie\":[\"crumb=EUmnHJvt3XCJP2hZmlzWCvVNzOHq5Wb1;Path=/\",\"SS_MID=7b22de59-a0ca-4d2f-aea2-dbe337990ba3ip466npy;Path=/;Domain=.example.com;Expires=Thu, 04-Jun-2026 15:26:05 GMT\"],\"Vary\":\"Accept-Encoding, User-Agent\",\"Via\":\"1.1 varnish\",\"X-Cache\":\"MISS\",\"X-Cache-Hits\":\"0\",\"X-ContextId\":\"P0IlaNKm/roP4a7jq\",\"X-PC-AppVer\":\"7951\",\"X-PC-Date\":\"Mon, 06 Jun 2016 15:26:04 GMT\",\"X-PC-Hit\":\"true\",\"X-PC-Host\":\"127.0.0.1\",\"X-PC-Key\":\"OZs6DMRDuX2Tj7xXJlbWIZgI2cI-example\",\"X-Served-By\":\"cache-sjc3120-SJC\",\"X-ServedBy\":\"web029\",\"X-Timer\":\"S1465226764.194256,VS0,VE1054\",\"X-Via\":\"1.1 echo007\"},\"status\":200},\"response_time\":2.604431,\"server\":\"cache-sjc3120\",\"pop\":\"SJC\"}]"}],"_postman_id":"86159db0-e990-4ca7-9ebf-31c93597107a"}],"id":"0f0aa3da-4480-453b-9547-23fdff1368a5","description":"<p>Fastly makes it possible to see which version of a particular URL is cached on each edge server.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions (this endpoint does not accept a token with the <code>global:read</code> scope).</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"0f0aa3da-4480-453b-9547-23fdff1368a5"},{"name":"Diff","item":[{"name":"Diff two service versions","id":"5605a67f-762b-4b80-8aad-51f644d1e1c4","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/diff/from/{{from_version_id}}/to/{{to_version_id}}?format","description":"<p>Get diff between two versions.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","diff","from","{{from_version_id}}","to","{{to_version_id}}"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Optional method to format the diff field.</p>\n","type":"text/plain"},"key":"format"}],"variable":[]}},"response":[{"id":"50bd13bc-5fc2-45a9-91c9-dbc8d38cbe19","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/diff/from/1/to/2?format","protocol":"https","host":["api","fastly","com"],"path":["service","SU1Z0isxPaozGVKXdv0eY","diff","from","1","to","2"],"query":[{"key":"format","description":"Optional method to format the diff field."}]},"description":"Get diff between two versions.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"from\":1,\"to\":2,\"format\":\"text\",\"diff\":\"backends:\\n- name: My Backend\\n  address: backend.example.com\\n  auto_loadbalance: '0'\\n  between_bytes_timeout: 10000\\n  client_cert:\\n  comment: ''\\n  connect_timeout: 1000\\n  first_byte_timeout: 15000\\n  healthcheck:\\n  hostname: www.example.com\\n  ipv4:\\n  ipv6:\\n  max_conn: 200\\n  port: 80\\n  request_condition: ''\\n  share_key:\\n  shield:\\n  ssl_ca_cert:\\n  ssl_client_cert:\\n  ssl_client_key:\\n  ssl_hostname:\\n  use_ssl: false\\n  weight: 100\\ncache_settings: []\\ncomment: ''\\nconditions: []\\ndeployed:\\ndirectors: []\\ndomains:\\n- name: www.example.com\\n  comment: ''\\ngzips: []\\n-headers: []\\n+headers:\\n+- name: Debug\\n+  action: set\\n+  cache_condition:\\n+  dst: http.X-Test\\n+  ignore_if_set: '0'\\n+  priority: '10'\\n+  regex: ''\\n+  request_condition:\\n+  response_condition:\\n+  src: '\\\"testing\\\"'\\n+  substitution: ''\\n+  type: request\\nhealthchecks: []\\norigins: []\\nrequest_settings: []\\nresponse_objects: []\\nservice_id: SU1Z0isxPaozGVKXdv0eY\\nsettings:\\n  general.default_host: ''\\n  general.default_ttl: 3600\\nsnippets: []\\nstaging:\\nsyslogs: []\\ntesting:\\nvcls: []\\nwordpress: []\\n\"}"}],"_postman_id":"5605a67f-762b-4b80-8aad-51f644d1e1c4"}],"id":"8e4e28d6-c212-40e7-bf9c-b11198bb0af9","description":"<p>See the line-by-line changes in configuration between two different versions of a service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>diff</td>\n<td>string</td>\n<td>The differences between two specified service versions. Returns the full config if the version configurations are identical.</td>\n</tr>\n<tr>\n<td>format</td>\n<td>string</td>\n<td>The format the diff is being returned in (text, html or html_simple).</td>\n</tr>\n<tr>\n<td>from</td>\n<td>integer</td>\n<td>The version number being diffed from.</td>\n</tr>\n<tr>\n<td>to</td>\n<td>integer</td>\n<td>The version number being diffed to.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"8e4e28d6-c212-40e7-bf9c-b11198bb0af9"},{"name":"Docs","item":[{"name":"Get Fastly API docs as structured data","id":"9cff2281-2d25-4d3b-9599-83f2f3c9437f","request":{"method":"GET","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/docs","description":"<p>Gets all documentation associated with the Fastly API.</p>\n","urlObject":{"path":["docs"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"b9ed50a0-45b1-4e6e-a28c-7d87342a41d8","name":"200 OK","originalRequest":{"method":"GET","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/docs","description":"Gets all documentation associated with the Fastly API."},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"actions\":[{\"authentication\":\"engineer\",\"description\":[\"List all backends for a particular service and version.\"],\"http_method\":\"GET\",\"request\":[\"GET /service/SU1Z0isxPaozGVKXdv0eY/version/1/backend\",\"Fastly-Key: YOUR_FASTLY_TOKEN\",\"Accept: application/json\"],\"response\":[\"HTTP/1.1 200 OK\",\"Content-Type: application/json\"],\"response_body\":[\"[\",\"  {\",\"    \\\"address\\\": \\\"127.0.0.1\\\",\",\"    \\\"auto_loadbalance\\\": false,\",\"    \\\"between_bytes_timeout\\\": 10000,\",\"    \\\"client_cert\\\": null,\",\"    \\\"comment\\\": \\\"\\\",\",\"    \\\"connect_timeout\\\": 1000,\",\"    \\\"first_byte_timeout\\\": 15000,\",\"    \\\"healthcheck\\\": null,\",\"    \\\"hostname\\\": null,\",\"    \\\"ipv4\\\": \\\"127.0.0.1\\\",\",\"    \\\"ipv6\\\": null,\",\"    \\\"locked\\\": true,\",\"    \\\"max_conn\\\": 200,\",\"    \\\"max_tls_version\\\": null,\",\"    \\\"min_tls_version\\\": null,\",\"    \\\"name\\\": \\\"backend-name\\\",\",\"    \\\"port\\\": 80,\",\"    \\\"request_condition\\\": \\\"\\\",\",\"    \\\"service_id\\\": \\\"SU1Z0isxPaozGVKXdv0eY\\\",\",\"    \\\"share_key\\\": null,\",\"    \\\"shield\\\": null,\",\"    \\\"ssl_ca_cert\\\": null,\",\"    \\\"ssl_cert_hostname\\\": null,\",\"    \\\"ssl_check_cert\\\": true,\",\"    \\\"ssl_ciphers\\\": null,\",\"    \\\"ssl_client_cert\\\": null,\",\"    \\\"ssl_client_key\\\": null,\",\"    \\\"ssl_hostname\\\": null,\",\"    \\\"ssl_sni_hostname\\\": null,\",\"    \\\"use_ssl\\\": false,\",\"    \\\"version\\\": 1,\",\"    \\\"weight\\\": 100\",\"  }\",\"]\"],\"url\":\"/service/:service_id/version/:version/backend\"}],\"description\":[\"A backend is an address (IP or domain) from which Fastly pulls content. There can be multiple backends for a service.\"],\"fields\":[\"address String. An hostname, IPv4, or IPv6 address for the backend.\",\"auto_loadbalance Boolean. Whether or not this backend should be automatically load balanced.\",\"between_bytes_timeout Integer. How long to wait between bytes in milliseconds.\",\"client_cert String.\",\"comment String.\",\"connect_timeout Integer. How long to wait for a timeout in milliseconds.\",\"first_byte_timeout Integer. How long to wait for the first bytes in milliseconds.\",\"healthcheck String. The name of the healthcheck to use with this backend. Can be empty.\",\"hostname String. The hostname of the backend.\",\"ipv4 String. IPv4 address of the host.\",\"ipv6 String. IPv6 address of the host.\",\"locked Boolean. Specifies whether or not the version is locked for editing.\",\"max_conn Integer. Maximum number of connections.\",\"max_tls_version Integer. Maximum allowed TLS version on SSL connections to this backend.\",\"min_tls_version Integer. Minimum allowed TLS version on SSL connections to this backend.\",\"name String. The name of the backend.\",\"port Integer. The port number.\",\"request_condition String. Condition, which if met, will select this backend during a request.\",\"service_id String. The alphanumeric string identifying a service.\",\"share_key String. Value that when shared across backends will enable those backends to share the same health check.\",\"shield String. Selected POP to serve as a shield for the backend. Optional. Defaults to `null` meaning no origin shielding if not set. Refer to the POPs API endpoint to get a list of available POPs used for shielding.\",\"ssl_ca_cert String. CA certificate attached to origin.\",\"ssl_cert_hostname String. Overrides ssl_hostname, but only for cert verification. Does not affect SNI at all.\",\"ssl_check_cert Boolean. Be strict on checking SSL certs.\",\"ssl_ciphers String. List of openssl ciphers (see https://www.openssl.org/docs/manmaster/apps/ciphers.html for details)\",\"ssl_client_cert String. Client certificate attached to origin.\",\"ssl_client_key String. Client key attached to origin.\",\"ssl_hostname String. Used for both SNI during the TLS handshake and to validate the cert.\",\"ssl_sni_hostname String. Overrides ssl_hostname, but only for SNI in the handshake. Does not affect cert validation at all.\",\"use_ssl Boolean. Whether or not to use SSL to reach the backend.\",\"version Integer. The current version number of a service.\",\"weight Integer. Weight used to load balance this backend against others.\"],\"section\":\"backend\"}]"}],"_postman_id":"9cff2281-2d25-4d3b-9599-83f2f3c9437f"},{"name":"Get API docs for a single subject","id":"e36e83bc-4b33-4565-8f46-fde784eeed14","request":{"method":"GET","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/docs/subject/{{subject}}","description":"<p>Gets all documentation relating to a given 'Subject'.</p>\n","urlObject":{"path":["docs","subject","{{subject}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"d8a66382-de3c-4355-a0a3-378388cf2521","name":"200 OK","originalRequest":{"method":"GET","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/docs/subject/backend","description":"Gets all documentation relating to a given 'Subject'."},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"actions\":[{\"authentication\":\"engineer\",\"description\":[\"List all backends for a particular service and version.\"],\"http_method\":\"GET\",\"request\":[\"GET /service/SU1Z0isxPaozGVKXdv0eY/version/1/backend\",\"Fastly-Key: YOUR_FASTLY_TOKEN\",\"Accept: application/json\"],\"response\":[\"HTTP/1.1 200 OK\",\"Content-Type: application/json\"],\"response_body\":[\"[\",\"  {\",\"    \\\"address\\\": \\\"127.0.0.1\\\",\",\"    \\\"auto_loadbalance\\\": false,\",\"    \\\"between_bytes_timeout\\\": 10000,\",\"    \\\"client_cert\\\": null,\",\"    \\\"comment\\\": \\\"\\\",\",\"    \\\"connect_timeout\\\": 1000,\",\"    \\\"first_byte_timeout\\\": 15000,\",\"    \\\"healthcheck\\\": null,\",\"    \\\"hostname\\\": null,\",\"    \\\"ipv4\\\": \\\"127.0.0.1\\\",\",\"    \\\"ipv6\\\": null,\",\"    \\\"locked\\\": true,\",\"    \\\"max_conn\\\": 200,\",\"    \\\"max_tls_version\\\": null,\",\"    \\\"min_tls_version\\\": null,\",\"    \\\"name\\\": \\\"backend-name\\\",\",\"    \\\"port\\\": 80,\",\"    \\\"request_condition\\\": \\\"\\\",\",\"    \\\"service_id\\\": \\\"SU1Z0isxPaozGVKXdv0eY\\\",\",\"    \\\"share_key\\\": null,\",\"    \\\"shield\\\": null,\",\"    \\\"ssl_ca_cert\\\": null,\",\"    \\\"ssl_cert_hostname\\\": null,\",\"    \\\"ssl_check_cert\\\": true,\",\"    \\\"ssl_ciphers\\\": null,\",\"    \\\"ssl_client_cert\\\": null,\",\"    \\\"ssl_client_key\\\": null,\",\"    \\\"ssl_hostname\\\": null,\",\"    \\\"ssl_sni_hostname\\\": null,\",\"    \\\"use_ssl\\\": false,\",\"    \\\"version\\\": 1,\",\"    \\\"weight\\\": 100\",\"  }\",\"]\"],\"url\":\"/service/:service_id/version/:version/backend\"}],\"description\":[\"A backend is an address (IP or domain) from which Fastly pulls content. There can be multiple backends for a service.\"],\"fields\":[\"address String. An hostname, IPv4, or IPv6 address for the backend.\",\"auto_loadbalance Boolean. Whether or not this backend should be automatically load balanced.\",\"between_bytes_timeout Integer. How long to wait between bytes in milliseconds.\",\"client_cert String.\",\"comment String.\",\"connect_timeout Integer. How long to wait for a timeout in milliseconds.\",\"first_byte_timeout Integer. How long to wait for the first bytes in milliseconds.\",\"healthcheck String. The name of the healthcheck to use with this backend. Can be empty.\",\"hostname String. The hostname of the backend.\",\"ipv4 String. IPv4 address of the host.\",\"ipv6 String. IPv6 address of the host.\",\"locked Boolean. Specifies whether or not the version is locked for editing.\",\"max_conn Integer. Maximum number of connections.\",\"max_tls_version Integer. Maximum allowed TLS version on SSL connections to this backend.\",\"min_tls_version Integer. Minimum allowed TLS version on SSL connections to this backend.\",\"name String. The name of the backend.\",\"port Integer. The port number.\",\"request_condition String. Condition, which if met, will select this backend during a request.\",\"service_id String. The alphanumeric string identifying a service.\",\"share_key String. Value that when shared across backends will enable those backends to share the same health check.\",\"shield String. Selected POP to serve as a shield for the backend. Optional. Defaults to `null` meaning no origin shielding if not set. Refer to the POPs API endpoint to get a list of available POPs used for shielding.\",\"ssl_ca_cert String. CA certificate attached to origin.\",\"ssl_cert_hostname String. Overrides ssl_hostname, but only for cert verification. Does not affect SNI at all.\",\"ssl_check_cert Boolean. Be strict on checking SSL certs.\",\"ssl_ciphers String. List of openssl ciphers (see https://www.openssl.org/docs/manmaster/apps/ciphers.html for details)\",\"ssl_client_cert String. Client certificate attached to origin.\",\"ssl_client_key String. Client key attached to origin.\",\"ssl_hostname String. Used for both SNI during the TLS handshake and to validate the cert.\",\"ssl_sni_hostname String. Overrides ssl_hostname, but only for SNI in the handshake. Does not affect cert validation at all.\",\"use_ssl Boolean. Whether or not to use SSL to reach the backend.\",\"version Integer. The current version number of a service.\",\"weight Integer. Weight used to load balance this backend against others.\"],\"section\":\"backend\"}"}],"_postman_id":"e36e83bc-4b33-4565-8f46-fde784eeed14"},{"name":"Get API docs matching a section filter","id":"f471b228-c947-47c5-8793-b4704743e650","request":{"method":"GET","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/docs/section/{{section}}?invert","description":"<p>Gets all documentation associated with a given Categorical Section where section is a regular_expression. Passing invert=true will force a return of everything that does not match the given regular expression.</p>\n","urlObject":{"path":["docs","section","{{section}}"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Get everything that does not match section.</p>\n","type":"text/plain"},"key":"invert"}],"variable":[]}},"response":[{"id":"42bb0f28-b09d-4733-aade-aa56f5c44307","name":"200 OK","originalRequest":{"method":"GET","header":[{"key":"Host","value":"api.fastly.com"}],"url":{"raw":"https://api.fastly.com/docs/section/backend?invert","protocol":"https","host":["api","fastly","com"],"path":["docs","section","backend"],"query":[{"key":"invert","description":"Get everything that does not match section."}]},"description":"Gets all documentation associated with a given Categorical Section where section is a regular_expression. Passing invert=true will force a return of everything that does not match the given regular expression."},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"actions\":[{\"authentication\":\"engineer\",\"description\":[\"List all backends for a particular service and version.\"],\"http_method\":\"GET\",\"request\":[\"GET /service/SU1Z0isxPaozGVKXdv0eY/version/1/backend\",\"Fastly-Key: YOUR_FASTLY_TOKEN\",\"Accept: application/json\"],\"response\":[\"HTTP/1.1 200 OK\",\"Content-Type: application/json\"],\"response_body\":[\"[\",\"  {\",\"    \\\"address\\\": \\\"127.0.0.1\\\",\",\"    \\\"auto_loadbalance\\\": false,\",\"    \\\"between_bytes_timeout\\\": 10000,\",\"    \\\"client_cert\\\": null,\",\"    \\\"comment\\\": \\\"\\\",\",\"    \\\"connect_timeout\\\": 1000,\",\"    \\\"first_byte_timeout\\\": 15000,\",\"    \\\"healthcheck\\\": null,\",\"    \\\"hostname\\\": null,\",\"    \\\"ipv4\\\": \\\"127.0.0.1\\\",\",\"    \\\"ipv6\\\": null,\",\"    \\\"locked\\\": true,\",\"    \\\"max_conn\\\": 200,\",\"    \\\"max_tls_version\\\": null,\",\"    \\\"min_tls_version\\\": null,\",\"    \\\"name\\\": \\\"backend-name\\\",\",\"    \\\"port\\\": 80,\",\"    \\\"request_condition\\\": \\\"\\\",\",\"    \\\"service_id\\\": \\\"SU1Z0isxPaozGVKXdv0eY\\\",\",\"    \\\"share_key\\\": null,\",\"    \\\"shield\\\": null,\",\"    \\\"ssl_ca_cert\\\": null,\",\"    \\\"ssl_cert_hostname\\\": null,\",\"    \\\"ssl_check_cert\\\": true,\",\"    \\\"ssl_ciphers\\\": null,\",\"    \\\"ssl_client_cert\\\": null,\",\"    \\\"ssl_client_key\\\": null,\",\"    \\\"ssl_hostname\\\": null,\",\"    \\\"ssl_sni_hostname\\\": null,\",\"    \\\"use_ssl\\\": false,\",\"    \\\"version\\\": 1,\",\"    \\\"weight\\\": 100\",\"  }\",\"]\"],\"url\":\"/service/:service_id/version/:version/backend\"}],\"description\":[\"A backend is an address (IP or domain) from which Fastly pulls content. There can be multiple backends for a service.\"],\"fields\":[\"address String. An hostname, IPv4, or IPv6 address for the backend.\",\"auto_loadbalance Boolean. Whether or not this backend should be automatically load balanced.\",\"between_bytes_timeout Integer. How long to wait between bytes in milliseconds.\",\"client_cert String.\",\"comment String.\",\"connect_timeout Integer. How long to wait for a timeout in milliseconds.\",\"first_byte_timeout Integer. How long to wait for the first bytes in milliseconds.\",\"healthcheck String. The name of the healthcheck to use with this backend. Can be empty.\",\"hostname String. The hostname of the backend.\",\"ipv4 String. IPv4 address of the host.\",\"ipv6 String. IPv6 address of the host.\",\"locked Boolean. Specifies whether or not the version is locked for editing.\",\"max_conn Integer. Maximum number of connections.\",\"max_tls_version Integer. Maximum allowed TLS version on SSL connections to this backend.\",\"min_tls_version Integer. Minimum allowed TLS version on SSL connections to this backend.\",\"name String. The name of the backend.\",\"port Integer. The port number.\",\"request_condition String. Condition, which if met, will select this backend during a request.\",\"service_id String. The alphanumeric string identifying a service.\",\"share_key String. Value that when shared across backends will enable those backends to share the same health check.\",\"shield String. Selected POP to serve as a shield for the backend. Optional. Defaults to `null` meaning no origin shielding if not set. Refer to the POPs API endpoint to get a list of available POPs used for shielding.\",\"ssl_ca_cert String. CA certificate attached to origin.\",\"ssl_cert_hostname String. Overrides ssl_hostname, but only for cert verification. Does not affect SNI at all.\",\"ssl_check_cert Boolean. Be strict on checking SSL certs.\",\"ssl_ciphers String. List of openssl ciphers (see https://www.openssl.org/docs/manmaster/apps/ciphers.html for details)\",\"ssl_client_cert String. Client certificate attached to origin.\",\"ssl_client_key String. Client key attached to origin.\",\"ssl_hostname String. Used for both SNI during the TLS handshake and to validate the cert.\",\"ssl_sni_hostname String. Overrides ssl_hostname, but only for SNI in the handshake. Does not affect cert validation at all.\",\"use_ssl Boolean. Whether or not to use SSL to reach the backend.\",\"version Integer. The current version number of a service.\",\"weight Integer. Weight used to load balance this backend against others.\"],\"section\":\"backend\"}"}],"_postman_id":"f471b228-c947-47c5-8793-b4704743e650"}],"id":"c3f2fc28-f577-46dc-a715-590240cfe695","description":"<p>Documentation of the endpoints that return the Fastly API Documentation.</p>\n","_postman_id":"c3f2fc28-f577-46dc-a715-590240cfe695"},{"name":"POPs","item":[{"name":"List Fastly POPs","id":"04eeb440-e856-4407-b9f3-6a32f53f96e6","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/datacenters","description":"<p>Get a list of all Fastly POPs.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["datacenters"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"73b7474d-850f-47b0-aedb-2c1aaf207644","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/datacenters","description":"Get a list of all Fastly POPs.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"code\":\"AMS\",\"name\":\"Amsterdam\",\"group\":\"Europe\",\"region\":\"EU-Central\",\"stats_region\":\"europe\",\"billing_region\":\"Europe\",\"coordinates\":{\"latitude\":52.308613,\"longitude\":4.763889},\"shield\":\"amsterdam-nl\"},{\"code\":\"IAD\",\"name\":\"Ashburn (Metro)\",\"group\":\"United States\",\"region\":\"US-East\",\"stats_region\":\"usa\",\"billing_region\":\"North America\",\"coordinates\":{\"latitude\":38.944533,\"longitude\":-77.455811},\"shield\":\"iad-va-us\"},{\"code\":\"EZE\",\"name\":\"Buenos Aires\",\"group\":\"South America\",\"region\":\"SA-South\",\"stats_region\":\"southamerica_std\",\"billing_region\":\"South America\",\"coordinates\":{\"latitude\":-34.815,\"longitude\":-58.5348}},{\"code\":\"AKL\",\"name\":\"Auckland\",\"group\":\"Asia/Pacific\",\"region\":\"APAC\",\"stats_region\":\"anzac\",\"billing_region\":\"Australia\",\"coordinates\":{\"latitude\":-37.008056,\"longitude\":174.791667},\"shield\":\"auckland-akl\"},{\"code\":\"TYO\",\"name\":\"Tokyo\",\"group\":\"Asia/Pacific\",\"region\":\"Asia\",\"stats_region\":\"asia\",\"billing_region\":\"Asia\",\"coordinates\":{\"latitude\":35.617,\"longitude\":139.748},\"shield\":\"tyo-tokyo-jp\"},{\"code\":\"CPT\",\"name\":\"Cape Town\",\"group\":\"Africa\",\"region\":\"South-Africa\",\"stats_region\":\"africa_std\",\"billing_region\":\"Africa\",\"coordinates\":{\"latitude\":-33.97,\"longitude\":18.464},\"shield\":\"cpt-capetown-za\"}]"}],"_postman_id":"04eeb440-e856-4407-b9f3-6a32f53f96e6"}],"id":"f97ff1b9-ea40-40a2-bb05-1e0e42b51305","description":"<p>List Fastly POPs and their locations.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"f97ff1b9-ea40-40a2-bb05-1e0e42b51305"},{"name":"Public IP List","item":[{"name":"List Fastly's public IPs","id":"ba230a84-429e-4fc9-9d9b-c766fecc23d0","request":{"method":"GET","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/public-ip-list","description":"<p>List the public IP addresses for the Fastly network.</p>\n","urlObject":{"path":["public-ip-list"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"fc2777ee-454c-4c3a-b6e1-c6777ae01c19","name":"200 OK","originalRequest":{"method":"GET","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/public-ip-list","description":"List the public IP addresses for the Fastly network."},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"addresses\":[\"...\"],\"ipv6_addresses\":[\"...\"]}"}],"_postman_id":"ba230a84-429e-4fc9-9d9b-c766fecc23d0"}],"id":"e3ce6dae-75b9-4aff-96c3-9db270f86a9c","description":"<p>To help you manage firewall rules for connections from Fastly to your origin, we provide access to the list of Fastly's assigned IP ranges. Changes to this list will be announced in advance as an \"IP address announcement\" along with other service announcements to our status page, which you can subscribe to. This list is exhaustive and includes all Fastly-owned IP ranges, so any client connections, log streaming reports, and origin connections should use these addresses.</p>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>addresses</td>\n<td>array</td>\n<td>Fastly's IPv4 ranges.</td>\n</tr>\n<tr>\n<td>ipv6_addresses</td>\n<td>array</td>\n<td>Fastly's IPv6 ranges.</td>\n</tr>\n</tbody>\n</table>\n</div>","_postman_id":"e3ce6dae-75b9-4aff-96c3-9db270f86a9c"},{"name":"Sudo mode","item":[{"name":"Request Sudo access","id":"fd479319-ed09-4fea-96c1-4adcc5df8247","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"username\":\"FASTLY_USERNAME\",\"password\":\"FASTLY_PASSWORD\"}"},"url":"https://api.fastly.com/sudo","description":"<p>Re-authenticate to allow the provided user to obtain sudo access.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["sudo"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"6b413a5e-14c6-4371-b6af-e20e67102920","name":"200 Success","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/vnd.api+json"}],"body":{"mode":"raw","raw":"{\"username\":\"FASTLY_USERNAME\",\"password\":\"FASTLY_PASSWORD\"}"},"url":"https://api.fastly.com/sudo","description":"Re-authenticate to allow the provided user to obtain sudo access.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 Success","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"expiry_time\":\"2022-07-21T14:41:25+00:00\"}"}],"_postman_id":"fd479319-ed09-4fea-96c1-4adcc5df8247"}],"id":"a6467de4-6678-4032-bd9c-8d7265972ef7","description":"<p>Sudo mode allows users to perform privileged actions after going through a re-authentication flow.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>expiry_time</td>\n<td>string</td>\n<td>A UTC time-stamp of when sudo access will expire. If blank, sudo access expires five minutes after the request.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"a6467de4-6678-4032-bd9c-8d7265972ef7"}],"id":"97633021-46f8-4d79-a9c1-a9e09b7ef811","_postman_id":"97633021-46f8-4d79-a9c1-a9e09b7ef811","description":""},{"name":"Client-Side Protection","item":[{"name":"Client-Side Protection","item":[{"name":"List websites","id":"1fb27989-75a5-4b57-b151-8d857c5c9c42","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/client-side-protection/v1/websites?limit&page","description":"<p>List all websites configured for Client-Side Protection.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["client-side-protection","v1","websites"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Limit how many results are returned.</p>\n","type":"text/plain"},"key":"limit"},{"description":{"content":"<p>Page number of the collection to request.</p>\n","type":"text/plain"},"key":"page"}],"variable":[]}},"response":[{"id":"d07ec492-b258-46cf-a276-7754bd0d8f7d","name":"200 List of websites","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/client-side-protection/v1/websites?limit=100&page=1?limit&page","protocol":"https","host":["api","fastly","com"],"path":["client-side-protection","v1","websites"],"query":[{"key":"limit","description":"Limit how many results are returned."},{"key":"page","description":"Page number of the collection to request."}]},"description":"List all websites configured for Client-Side Protection.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 List of websites","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"id\":\"2Xk9JgPCkf1NzVsNmKrECp\",\"domain\":\"example.com\",\"page_ids\":[\"3Yl0KhQDlg2OaWtOnLsFDq\"],\"created_at\":\"2026-01-15T10:30:00Z\",\"updated_at\":\"2026-01-15T10:30:00Z\"},{\"id\":\"4Zm1LiREng3PbXuPoMtGEr\",\"domain\":\"staging.example.com\",\"page_ids\":[],\"created_at\":\"2026-01-16T14:20:00Z\",\"updated_at\":\"2026-01-16T14:20:00Z\"}],\"meta\":{\"limit\":20,\"total\":2,\"page\":1}}"}],"_postman_id":"1fb27989-75a5-4b57-b151-8d857c5c9c42"},{"name":"Create website","id":"fd30cc67-f930-4a08-8314-66c0479bb94a","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"domain\":\"example.com\"}"},"url":"https://api.fastly.com/client-side-protection/v1/websites","description":"<p>Create a new website for Client-Side Protection monitoring.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["client-side-protection","v1","websites"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"83b19e45-9960-4cc1-b391-365160343714","name":"201 Website created","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"domain\":\"example.com\"}"},"url":"https://api.fastly.com/client-side-protection/v1/websites","description":"Create a new website for Client-Side Protection monitoring.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"201 Website created","code":201,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"2Xk9JgPCkf1NzVsNmKrECp\",\"domain\":\"example.com\",\"page_ids\":[\"3Yl0KhQDlg2OaWtOnLsFDq\"],\"created_at\":\"2026-01-15T10:30:00Z\",\"updated_at\":\"2026-01-15T10:30:00Z\"}"}],"_postman_id":"fd30cc67-f930-4a08-8314-66c0479bb94a"},{"name":"Get website","id":"945f10b9-c0f8-464b-96ce-ab69425ec2c1","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/client-side-protection/v1/websites/{{website_id}}","description":"<p>Get details for a specific website.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["client-side-protection","v1","websites","{{website_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"1817cb65-d46d-4e64-b0d8-0e7fd485ee13","name":"200 Website details","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/client-side-protection/v1/websites/2Xk9JgPCkf1NzVsNmKrECp","description":"Get details for a specific website.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Website details","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"2Xk9JgPCkf1NzVsNmKrECp\",\"domain\":\"example.com\",\"page_ids\":[\"3Yl0KhQDlg2OaWtOnLsFDq\"],\"created_at\":\"2026-01-15T10:30:00Z\",\"updated_at\":\"2026-01-15T10:30:00Z\"}"}],"_postman_id":"945f10b9-c0f8-464b-96ce-ab69425ec2c1"},{"name":"Delete website","id":"7e5885da-42c0-4483-8379-9fa8ec51255f","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/client-side-protection/v1/websites/{{website_id}}","description":"<p>Delete a website and all associated pages, scripts, and policies.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["client-side-protection","v1","websites","{{website_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"46f8f485-df7e-4929-a02d-056ed84a833b","name":"204 Website deleted successfully","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/client-side-protection/v1/websites/2Xk9JgPCkf1NzVsNmKrECp","description":"Delete a website and all associated pages, scripts, and policies.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 Website deleted successfully","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"7e5885da-42c0-4483-8379-9fa8ec51255f"},{"name":"Update website","id":"f5b51250-18e9-4c59-bda2-ab11553873d9","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/client-side-protection/v1/websites/{{website_id}}","description":"<p>Update a website's configuration.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["client-side-protection","v1","websites","{{website_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"499c8dab-93f8-4c3b-9e8c-338187a0b146","name":"200 Website details","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/client-side-protection/v1/websites/2Xk9JgPCkf1NzVsNmKrECp","description":"Update a website's configuration.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Website details","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"2Xk9JgPCkf1NzVsNmKrECp\",\"domain\":\"example.com\",\"page_ids\":[\"3Yl0KhQDlg2OaWtOnLsFDq\"],\"created_at\":\"2026-01-15T10:30:00Z\",\"updated_at\":\"2026-01-15T10:30:00Z\"}"}],"_postman_id":"f5b51250-18e9-4c59-bda2-ab11553873d9"},{"name":"List pages","id":"b221790e-b704-406b-8a24-2a25f4db7bc0","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/client-side-protection/v1/pages?limit&page&website_id","description":"<p>List all pages. Optionally filter by website.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["client-side-protection","v1","pages"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Limit how many results are returned.</p>\n","type":"text/plain"},"key":"limit"},{"description":{"content":"<p>Page number of the collection to request.</p>\n","type":"text/plain"},"key":"page"},{"description":{"content":"<p>Filter pages by website ID.</p>\n","type":"text/plain"},"key":"website_id"}],"variable":[]}},"response":[{"id":"bcee5e14-920c-4c36-9298-ed69138c1040","name":"200 List of pages","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/client-side-protection/v1/pages?limit=100&page=1?limit&page&website_id","protocol":"https","host":["api","fastly","com"],"path":["client-side-protection","v1","pages"],"query":[{"key":"limit","description":"Limit how many results are returned."},{"key":"page","description":"Page number of the collection to request."},{"key":"website_id","description":"Filter pages by website ID."}]},"description":"List all pages. Optionally filter by website.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 List of pages","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"id\":\"3Yl0KhQDlg2OaWtOnLsFDq\",\"website_id\":\"2Xk9JgPCkf1NzVsNmKrECp\",\"name\":\"Checkout Page\",\"description\":\"Payment checkout flow\",\"notifications\":[{\"type\":\"mailinglist\",\"config\":{\"address\":\"security@example.com\"}}],\"paths\":[\"/checkout\",\"/cart\"],\"created_at\":\"2026-01-15T10:35:00Z\",\"updated_at\":\"2026-01-15T10:35:00Z\"}],\"meta\":{\"limit\":20,\"total\":1,\"page\":1}}"}],"_postman_id":"b221790e-b704-406b-8a24-2a25f4db7bc0"},{"name":"Create page","id":"8a75ebbf-c264-4ac6-8d67-9aa7d666dd15","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"website_id\":\"2Xk9JgPCkf1NzVsNmKrECp\",\"name\":\"Checkout Page\",\"description\":\"Payment checkout flow\",\"notifications\":[{\"type\":\"mailinglist\",\"config\":{\"address\":\"security@example.com\"}}],\"paths\":[\"/checkout\",\"/cart\"]}"},"url":"https://api.fastly.com/client-side-protection/v1/pages","description":"<p>Create a new page for monitoring.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["client-side-protection","v1","pages"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"1d3ce1d8-6524-4c10-98a5-42052b866252","name":"201 Page created","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"website_id\":\"2Xk9JgPCkf1NzVsNmKrECp\",\"name\":\"Checkout Page\",\"description\":\"Payment checkout flow\",\"notifications\":[{\"type\":\"mailinglist\",\"config\":{\"address\":\"security@example.com\"}}],\"paths\":[\"/checkout\",\"/cart\"]}"},"url":"https://api.fastly.com/client-side-protection/v1/pages","description":"Create a new page for monitoring.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"201 Page created","code":201,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"3Yl0KhQDlg2OaWtOnLsFDq\",\"website_id\":\"2Xk9JgPCkf1NzVsNmKrECp\",\"name\":\"Checkout Page\",\"description\":\"Payment checkout flow\",\"notifications\":[{\"type\":\"mailinglist\",\"config\":{\"address\":\"security@example.com\"}}],\"paths\":[\"/checkout\",\"/cart\"],\"created_at\":\"2026-01-15T10:35:00Z\",\"updated_at\":\"2026-01-15T10:35:00Z\"}"}],"_postman_id":"8a75ebbf-c264-4ac6-8d67-9aa7d666dd15"},{"name":"Get page","id":"9045bd34-81c1-405c-98ff-005ae791ff5f","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/client-side-protection/v1/pages/{{page_id}}","description":"<p>Get details for a specific page.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["client-side-protection","v1","pages","{{page_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"139ba88b-daf2-46fc-9a68-240e63dadd0c","name":"200 Page details","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/client-side-protection/v1/pages/3Yl0KhQDlg2OaWtOnLsFDq","description":"Get details for a specific page.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Page details","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"3Yl0KhQDlg2OaWtOnLsFDq\",\"website_id\":\"2Xk9JgPCkf1NzVsNmKrECp\",\"name\":\"Checkout Page\",\"description\":\"Payment checkout flow\",\"notifications\":[{\"type\":\"mailinglist\",\"config\":{\"address\":\"security@example.com\"}}],\"paths\":[\"/checkout\",\"/cart\"],\"created_at\":\"2026-01-15T10:35:00Z\",\"updated_at\":\"2026-01-15T10:35:00Z\"}"}],"_postman_id":"9045bd34-81c1-405c-98ff-005ae791ff5f"},{"name":"Delete page","id":"19d87cd2-07a5-4c06-a033-2ef82d99ba59","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/client-side-protection/v1/pages/{{page_id}}","description":"<p>Delete a page and all associated scripts and policies.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["client-side-protection","v1","pages","{{page_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"5558562e-ea9a-4de8-a0f1-53738fa2d23d","name":"204 Page deleted successfully","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/client-side-protection/v1/pages/3Yl0KhQDlg2OaWtOnLsFDq","description":"Delete a page and all associated scripts and policies.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 Page deleted successfully","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"19d87cd2-07a5-4c06-a033-2ef82d99ba59"},{"name":"Update page","id":"3d8e83a0-0d05-4e1e-9c70-393cc8b2d066","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/client-side-protection/v1/pages/{{page_id}}","description":"<p>Update a page's configuration.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["client-side-protection","v1","pages","{{page_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"2b97fc3f-6157-4169-8248-ab04627c66e6","name":"200 Page details","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/client-side-protection/v1/pages/3Yl0KhQDlg2OaWtOnLsFDq","description":"Update a page's configuration.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Page details","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"3Yl0KhQDlg2OaWtOnLsFDq\",\"website_id\":\"2Xk9JgPCkf1NzVsNmKrECp\",\"name\":\"Checkout Page\",\"description\":\"Payment checkout flow\",\"notifications\":[{\"type\":\"mailinglist\",\"config\":{\"address\":\"security@example.com\"}}],\"paths\":[\"/checkout\",\"/cart\"],\"created_at\":\"2026-01-15T10:35:00Z\",\"updated_at\":\"2026-01-15T10:35:00Z\"}"}],"_postman_id":"3d8e83a0-0d05-4e1e-9c70-393cc8b2d066"},{"name":"List scripts","id":"3688998f-6070-4093-9a2b-2db20fa5d08b","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/client-side-protection/v1/pages/{{page_id}}/scripts?limit&page","description":"<p>List all scripts detected on a page.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["client-side-protection","v1","pages","{{page_id}}","scripts"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Limit how many results are returned.</p>\n","type":"text/plain"},"key":"limit"},{"description":{"content":"<p>Page number of the collection to request.</p>\n","type":"text/plain"},"key":"page"}],"variable":[]}},"response":[{"id":"3b5e3a8a-dd73-4d5d-8e18-aad5e2113aab","name":"200 List of scripts","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/client-side-protection/v1/pages/3Yl0KhQDlg2OaWtOnLsFDq/scripts?limit=100&page=1?limit&page","protocol":"https","host":["api","fastly","com"],"path":["client-side-protection","v1","pages","3Yl0KhQDlg2OaWtOnLsFDq","scripts"],"query":[{"key":"limit","description":"Limit how many results are returned."},{"key":"page","description":"Page number of the collection to request."}]},"description":"List all scripts detected on a page.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 List of scripts","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"id\":\"5An2MjSFoh4QcYvQpNuHFs\",\"page_id\":\"3Yl0KhQDlg2OaWtOnLsFDq\",\"source\":\"https://cdn.example.com/analytics.js\",\"urls\":[\"https://cdn.example.com/analytics.js\"],\"first_seen_at\":\"2026-01-15T11:00:00Z\",\"last_seen_at\":\"2026-01-20T08:30:00Z\",\"justification\":\"Analytics tracking script\",\"current_hash\":\"sha256-abc123def456\",\"authorized_hash\":\"sha256-abc123def456\",\"authorization_status\":\"authorized\",\"authorized_at\":\"2026-01-15T12:00:00Z\"},{\"id\":\"6Bo3NkTGpi5RdZwRqOvIGt\",\"page_id\":\"3Yl0KhQDlg2OaWtOnLsFDq\",\"source\":\"https://unknown-domain.com/suspicious.js\",\"urls\":[\"https://unknown-domain.com/suspicious.js\"],\"first_seen_at\":\"2026-01-18T09:15:00Z\",\"last_seen_at\":\"2026-01-20T08:30:00Z\",\"justification\":\"\",\"current_hash\":\"sha256-xyz789ghi012\",\"authorized_hash\":\"\",\"authorization_status\":\"unauthorized\"}],\"meta\":{\"limit\":20,\"total\":2,\"page\":1}}"}],"_postman_id":"3688998f-6070-4093-9a2b-2db20fa5d08b"},{"name":"Get script","id":"1e44481a-8d57-451d-9839-0c842d0e289c","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/client-side-protection/v1/pages/{{page_id}}/scripts/{{script_id}}","description":"<p>Get details for a specific script.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["client-side-protection","v1","pages","{{page_id}}","scripts","{{script_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"948ecc5d-8bfe-414b-a10b-b03a27a08b34","name":"200 Script details","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/client-side-protection/v1/pages/3Yl0KhQDlg2OaWtOnLsFDq/scripts/5An2MjSFoh4QcYvQpNuHFs","description":"Get details for a specific script.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Script details","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"5An2MjSFoh4QcYvQpNuHFs\",\"page_id\":\"3Yl0KhQDlg2OaWtOnLsFDq\",\"source\":\"https://cdn.example.com/analytics.js\",\"urls\":[\"https://cdn.example.com/analytics.js\"],\"first_seen_at\":\"2026-01-15T11:00:00Z\",\"last_seen_at\":\"2026-01-20T08:30:00Z\",\"justification\":\"Analytics tracking script\",\"current_hash\":\"sha256-abc123def456\",\"authorized_hash\":\"sha256-abc123def456\",\"authorization_status\":\"authorized\",\"authorized_at\":\"2026-01-15T12:00:00Z\"}"}],"_postman_id":"1e44481a-8d57-451d-9839-0c842d0e289c"},{"name":"Update script","id":"477c67d5-c43f-4c81-875c-9d1007206c80","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"authorization_status\":\"authorized\",\"justification\":\"Verified third-party analytics provider\"}"},"url":"https://api.fastly.com/client-side-protection/v1/pages/{{page_id}}/scripts/{{script_id}}","description":"<p>Update a script's authorization status or justification.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["client-side-protection","v1","pages","{{page_id}}","scripts","{{script_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"1165912d-7e61-4e97-b123-9f381f8e85ba","name":"200 Script details","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"authorization_status\":\"authorized\",\"justification\":\"Verified third-party analytics provider\"}"},"url":"https://api.fastly.com/client-side-protection/v1/pages/3Yl0KhQDlg2OaWtOnLsFDq/scripts/5An2MjSFoh4QcYvQpNuHFs","description":"Update a script's authorization status or justification.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Script details","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"5An2MjSFoh4QcYvQpNuHFs\",\"page_id\":\"3Yl0KhQDlg2OaWtOnLsFDq\",\"source\":\"https://cdn.example.com/analytics.js\",\"urls\":[\"https://cdn.example.com/analytics.js\"],\"first_seen_at\":\"2026-01-15T11:00:00Z\",\"last_seen_at\":\"2026-01-20T08:30:00Z\",\"justification\":\"Analytics tracking script\",\"current_hash\":\"sha256-abc123def456\",\"authorized_hash\":\"sha256-abc123def456\",\"authorization_status\":\"authorized\",\"authorized_at\":\"2026-01-15T12:00:00Z\"}"}],"_postman_id":"477c67d5-c43f-4c81-875c-9d1007206c80"},{"name":"List policies","id":"fa02b9fc-4aea-46a0-8dbe-00948a1dbc01","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/client-side-protection/v1/pages/{{page_id}}/policies?limit&page","description":"<p>List all Content Security Policies for a page.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["client-side-protection","v1","pages","{{page_id}}","policies"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Limit how many results are returned.</p>\n","type":"text/plain"},"key":"limit"},{"description":{"content":"<p>Page number of the collection to request.</p>\n","type":"text/plain"},"key":"page"}],"variable":[]}},"response":[{"id":"028c82be-e660-422e-a953-4f6e93dcf21f","name":"200 List of policies","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/client-side-protection/v1/pages/3Yl0KhQDlg2OaWtOnLsFDq/policies?limit=100&page=1?limit&page","protocol":"https","host":["api","fastly","com"],"path":["client-side-protection","v1","pages","3Yl0KhQDlg2OaWtOnLsFDq","policies"],"query":[{"key":"limit","description":"Limit how many results are returned."},{"key":"page","description":"Page number of the collection to request."}]},"description":"List all Content Security Policies for a page.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 List of policies","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"id\":\"7Cp4OlUHqj6SfAwSrQwJHu\",\"page_id\":\"3Yl0KhQDlg2OaWtOnLsFDq\",\"name\":\"Checkout CSP\",\"description\":\"Content Security Policy for checkout page\",\"mode\":\"report\",\"directives\":[{\"name\":\"script-src\",\"values\":[\"'self'\",\"https://cdn.example.com\"]}],\"created_at\":\"2026-01-15T12:00:00Z\",\"updated_at\":\"2026-01-15T12:00:00Z\"}],\"meta\":{\"limit\":20,\"total\":1,\"page\":1}}"}],"_postman_id":"fa02b9fc-4aea-46a0-8dbe-00948a1dbc01"},{"name":"Create policy","id":"87c13071-ce58-438f-a961-e24101f6f968","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/client-side-protection/v1/pages/{{page_id}}/policies","description":"<p>Create a new Content Security Policy for a page.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["client-side-protection","v1","pages","{{page_id}}","policies"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"fa6117b2-75cb-4b23-915f-d7a07766041b","name":"201 Policy created","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/client-side-protection/v1/pages/3Yl0KhQDlg2OaWtOnLsFDq/policies","description":"Create a new Content Security Policy for a page.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"201 Policy created","code":201,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"7Cp4OlUHqj6SfAwSrQwJHu\",\"page_id\":\"3Yl0KhQDlg2OaWtOnLsFDq\",\"name\":\"Checkout CSP\",\"description\":\"Content Security Policy for checkout page\",\"mode\":\"report\",\"directives\":[{\"name\":\"script-src\",\"values\":[\"'self'\",\"https://cdn.example.com\"]},{\"name\":\"style-src\",\"values\":[\"'self'\"]}],\"created_at\":\"2026-01-15T12:00:00Z\",\"updated_at\":\"2026-01-15T12:00:00Z\"}"}],"_postman_id":"87c13071-ce58-438f-a961-e24101f6f968"},{"name":"Get policy","id":"ffb5281b-cc66-419a-b0ac-5028181e378a","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/client-side-protection/v1/pages/{{page_id}}/policies/{{policy_id}}","description":"<p>Get details for a specific policy.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["client-side-protection","v1","pages","{{page_id}}","policies","{{policy_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"c7af5852-2979-4f46-827b-68f747504ffc","name":"200 Policy details","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/client-side-protection/v1/pages/3Yl0KhQDlg2OaWtOnLsFDq/policies/7Cp4OlUHqj6SfAwSrQwJHu","description":"Get details for a specific policy.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Policy details","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"7Cp4OlUHqj6SfAwSrQwJHu\",\"page_id\":\"3Yl0KhQDlg2OaWtOnLsFDq\",\"name\":\"Checkout CSP\",\"description\":\"Content Security Policy for checkout page\",\"mode\":\"report\",\"directives\":[{\"name\":\"script-src\",\"values\":[\"'self'\",\"https://cdn.example.com\"]},{\"name\":\"style-src\",\"values\":[\"'self'\"]}],\"created_at\":\"2026-01-15T12:00:00Z\",\"updated_at\":\"2026-01-15T12:00:00Z\"}"}],"_postman_id":"ffb5281b-cc66-419a-b0ac-5028181e378a"},{"name":"Update policy","id":"f15db0d6-3c4c-443c-a9b3-d9c8dc110302","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/client-side-protection/v1/pages/{{page_id}}/policies/{{policy_id}}","description":"<p>Update a policy's configuration.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["client-side-protection","v1","pages","{{page_id}}","policies","{{policy_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"4adf3b23-1f41-4d27-bd02-1ac1c03fff63","name":"200 Policy details","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/client-side-protection/v1/pages/3Yl0KhQDlg2OaWtOnLsFDq/policies/7Cp4OlUHqj6SfAwSrQwJHu","description":"Update a policy's configuration.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 Policy details","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"7Cp4OlUHqj6SfAwSrQwJHu\",\"page_id\":\"3Yl0KhQDlg2OaWtOnLsFDq\",\"name\":\"Checkout CSP\",\"description\":\"Content Security Policy for checkout page\",\"mode\":\"report\",\"directives\":[{\"name\":\"script-src\",\"values\":[\"'self'\",\"https://cdn.example.com\"]},{\"name\":\"style-src\",\"values\":[\"'self'\"]}],\"created_at\":\"2026-01-15T12:00:00Z\",\"updated_at\":\"2026-01-15T12:00:00Z\"}"}],"_postman_id":"f15db0d6-3c4c-443c-a9b3-d9c8dc110302"},{"name":"List policy reports","id":"9283b61b-7a94-4363-876c-d9ceaa0573aa","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/client-side-protection/v1/pages/{{page_id}}/policies/{{policy_id}}/reports?limit&page","description":"<p>List CSP violation reports for a policy.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["client-side-protection","v1","pages","{{page_id}}","policies","{{policy_id}}","reports"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Limit how many results are returned.</p>\n","type":"text/plain"},"key":"limit"},{"description":{"content":"<p>Page number of the collection to request.</p>\n","type":"text/plain"},"key":"page"}],"variable":[]}},"response":[{"id":"e9a07429-ef6b-4143-9960-831f1bbfb65a","name":"200 List of CSP violation reports","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/client-side-protection/v1/pages/3Yl0KhQDlg2OaWtOnLsFDq/policies/7Cp4OlUHqj6SfAwSrQwJHu/reports?limit=100&page=1?limit&page","protocol":"https","host":["api","fastly","com"],"path":["client-side-protection","v1","pages","3Yl0KhQDlg2OaWtOnLsFDq","policies","7Cp4OlUHqj6SfAwSrQwJHu","reports"],"query":[{"key":"limit","description":"Limit how many results are returned."},{"key":"page","description":"Page number of the collection to request."}]},"description":"List CSP violation reports for a policy.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 List of CSP violation reports","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"id\":\"8Dq5PmVIrk7TgBxTsRxKIv\",\"policy_id\":\"7Cp4OlUHqj6SfAwSrQwJHu\",\"blocked_uri\":\"https://malicious.com/script.js\",\"document_uri\":\"https://example.com/checkout\",\"violated_directive\":\"script-src\",\"created_at\":\"2026-01-20T09:15:00Z\"}],\"meta\":{\"limit\":20,\"total\":1,\"page\":1}}"}],"_postman_id":"9283b61b-7a94-4363-876c-d9ceaa0573aa"},{"name":"List security headers","id":"1032e4ad-63f0-48a0-a1d6-01ca2681ee4f","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/client-side-protection/v1/pages/{{page_id}}/headers?limit&page","description":"<p>List security headers detected on a page.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["client-side-protection","v1","pages","{{page_id}}","headers"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Limit how many results are returned.</p>\n","type":"text/plain"},"key":"limit"},{"description":{"content":"<p>Page number of the collection to request.</p>\n","type":"text/plain"},"key":"page"}],"variable":[]}},"response":[{"id":"b29e6802-e465-4cb1-a063-bb18d66bf879","name":"200 List of security headers","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/client-side-protection/v1/pages/3Yl0KhQDlg2OaWtOnLsFDq/headers?limit=100&page=1?limit&page","protocol":"https","host":["api","fastly","com"],"path":["client-side-protection","v1","pages","3Yl0KhQDlg2OaWtOnLsFDq","headers"],"query":[{"key":"limit","description":"Limit how many results are returned."},{"key":"page","description":"Page number of the collection to request."}]},"description":"List security headers detected on a page.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 List of security headers","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"name\":\"Content-Security-Policy\",\"value\":\"default-src 'self'\",\"observed_at\":\"2026-01-20T08:00:00Z\"},{\"name\":\"X-Frame-Options\",\"value\":\"DENY\",\"observed_at\":\"2026-01-20T08:00:00Z\"}],\"meta\":{\"limit\":20,\"total\":2,\"page\":1}}"}],"_postman_id":"1032e4ad-63f0-48a0-a1d6-01ca2681ee4f"},{"name":"List header events","id":"ff21101f-6ef8-43f0-98c7-8182ec848c2a","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/client-side-protection/v1/pages/{{page_id}}/events?limit&page","description":"<p>List security header change events for a page.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["client-side-protection","v1","pages","{{page_id}}","events"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Limit how many results are returned.</p>\n","type":"text/plain"},"key":"limit"},{"description":{"content":"<p>Page number of the collection to request.</p>\n","type":"text/plain"},"key":"page"}],"variable":[]}},"response":[{"id":"196e9b07-02e5-49e5-9679-b5bb016fdb44","name":"200 List of header change events","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/client-side-protection/v1/pages/3Yl0KhQDlg2OaWtOnLsFDq/events?limit=100&page=1?limit&page","protocol":"https","host":["api","fastly","com"],"path":["client-side-protection","v1","pages","3Yl0KhQDlg2OaWtOnLsFDq","events"],"query":[{"key":"limit","description":"Limit how many results are returned."},{"key":"page","description":"Page number of the collection to request."}]},"description":"List security header change events for a page.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 List of header change events","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"id\":\"9Er6QnWJsl8UhCyUsStLJw\",\"header_name\":\"Content-Security-Policy\",\"old_value\":\"default-src 'self'\",\"new_value\":\"default-src 'self'; script-src 'self' https://cdn.example.com\",\"changed_at\":\"2026-01-19T14:30:00Z\"}],\"meta\":{\"limit\":20,\"total\":1,\"page\":1}}"}],"_postman_id":"ff21101f-6ef8-43f0-98c7-8182ec848c2a"}],"id":"453720c9-e92c-4805-a6cb-599cd89e85b7","description":"<p>Client-Side Protection (CSP) provides visibility and control over third-party scripts running on your web pages. Monitor script behavior, manage authorization status, and configure security policies to protect against client-side attacks like Magecart and formjacking.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>CSP directive name (e.g., script-src, style-src).</td>\n</tr>\n<tr>\n<td>values</td>\n<td>array</td>\n<td>Directive values.</td>\n</tr>\n<tr>\n<td>config</td>\n<td>object</td>\n<td>Type-specific configuration.</td>\n</tr>\n<tr>\n<td>type</td>\n<td>string</td>\n<td>Notification type.</td>\n</tr>\n<tr>\n<td>description</td>\n<td>string</td>\n<td>Page description.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>Unique page identifier.</td>\n</tr>\n<tr>\n<td>notifications</td>\n<td>array</td>\n<td>Notification configurations for this page.</td>\n</tr>\n<tr>\n<td>paths</td>\n<td>array</td>\n<td>URL paths to monitor.</td>\n</tr>\n<tr>\n<td>website_id</td>\n<td>string</td>\n<td>Parent website ID.</td>\n</tr>\n<tr>\n<td>authorization_status</td>\n<td>string</td>\n<td>Script authorization status.</td>\n</tr>\n<tr>\n<td>authorized_hash</td>\n<td>string</td>\n<td>Hash of authorized script content.</td>\n</tr>\n<tr>\n<td>current_hash</td>\n<td>string</td>\n<td>Current script content hash.</td>\n</tr>\n<tr>\n<td>justification</td>\n<td>string</td>\n<td>Reason for authorization decision.</td>\n</tr>\n<tr>\n<td>page_id</td>\n<td>string</td>\n<td>Parent page ID.</td>\n</tr>\n<tr>\n<td>source</td>\n<td>string</td>\n<td>Script source (inline or external URL).</td>\n</tr>\n<tr>\n<td>urls</td>\n<td>array</td>\n<td>URLs where this script was observed.</td>\n</tr>\n<tr>\n<td>domain</td>\n<td>string</td>\n<td>Website domain.</td>\n</tr>\n<tr>\n<td>page_ids</td>\n<td>array</td>\n<td>IDs of pages associated with this website.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"453720c9-e92c-4805-a6cb-599cd89e85b7"}],"id":"9b4f0817-ca94-459b-9a31-ca73c8b81d1d","_postman_id":"9b4f0817-ca94-459b-9a31-ca73c8b81d1d","description":""},{"name":"Fastly DDoS Protection Events","item":[{"name":"Fastly DDoS Protection Events","item":[{"name":"Get a rule by ID","id":"21fb3fde-fa95-441f-9587-faea9846fc7a","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ddos-protection/v1/rules/{{rule_id}}","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/ddos-protection/#ddos-protection-rule-get\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["ddos-protection","v1","rules","{{rule_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"f279f32d-b3c8-4934-9561-f972f7db825b","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ddos-protection/v1/rules/54de69dcba53b02fbf000018","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/ddos-protection/#ddos-protection-rule-get)**\n\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"74de69dcba53b02fbf000909\",\"name\":\"my rule 001\",\"action\":\"default\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"customer_id\":\"x4xCwxxJxGCx123Rx5xTx\",\"source_ip\":null,\"country_code\":null,\"host\":\"example.com\",\"asn\":\"34154\",\"source_ip_prefix\":\"127.0.0.1/32\",\"additional_attributes\":[\"tls\"],\"created_at\":\"2025-01-22T00:00:00Z\",\"updated_at\":\"2025-01-22T00:00:00Z\"}"}],"_postman_id":"21fb3fde-fa95-441f-9587-faea9846fc7a"},{"name":"Update rule","id":"57735c53-c1ed-4565-a848-b8ba0d4b1778","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ddos-protection/v1/rules/{{rule_id}}","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/ddos-protection/#ddos-protection-rule-patch\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>, <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["ddos-protection","v1","rules","{{rule_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"37f0cde4-db8f-465a-a02c-926eb6571b13","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ddos-protection/v1/rules/54de69dcba53b02fbf000018","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/ddos-protection/#ddos-protection-rule-patch)**\n\n> **Authorization**: Requires [API token](/reference/api/auth-tokens), [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"74de69dcba53b02fbf000909\",\"name\":\"my rule 001\",\"action\":\"default\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"customer_id\":\"x4xCwxxJxGCx123Rx5xTx\",\"source_ip\":null,\"country_code\":null,\"host\":\"example.com\",\"asn\":\"34154\",\"source_ip_prefix\":\"127.0.0.1/32\",\"additional_attributes\":[\"tls\"],\"created_at\":\"2025-01-22T00:00:00Z\",\"updated_at\":\"2025-01-22T00:00:00Z\"}"}],"_postman_id":"57735c53-c1ed-4565-a848-b8ba0d4b1778"},{"name":"Get events","id":"23ae3fc6-cbc3-4a54-a7c0-1f3e5a88a746","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ddos-protection/v1/events?cursor&from&limit&name&service_id&to","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/ddos-protection/#ddos-protection-event-list\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["ddos-protection","v1","events"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Cursor value from the next_cursor field of a previous response, used to retrieve the next page. To request the first page, this should be empty.</p>\n","type":"text/plain"},"key":"cursor"},{"description":{"content":"<p>Represents the start of a date-time range expressed in RFC 3339 format.</p>\n","type":"text/plain"},"key":"from"},{"description":{"content":"<p>Limit how many results are returned.</p>\n","type":"text/plain"},"key":"limit"},{"description":{"content":"<p>Restrict results to items with names that match this prefix.</p>\n","type":"text/plain"},"key":"name"},{"description":{"content":"<p>Filter results based on a service_id.</p>\n","type":"text/plain"},"key":"service_id"},{"description":{"content":"<p>Represents the end of a date-time range expressed in RFC 3339 format.</p>\n","type":"text/plain"},"key":"to"}],"variable":[]}},"response":[{"id":"409aadbb-cae8-458b-9483-ff4da972ffed","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/ddos-protection/v1/events?from=2023-01-01T02%3A30%3A00Z&to=2023-01-01T02%3A30%3A00Z?cursor&from&limit&name&service_id&to","protocol":"https","host":["api","fastly","com"],"path":["ddos-protection","v1","events"],"query":[{"key":"cursor","description":"Cursor value from the next_cursor field of a previous response, used to retrieve the next page. To request the first page, this should be empty."},{"key":"from","description":"Represents the start of a date-time range expressed in RFC 3339 format."},{"key":"limit","description":"Limit how many results are returned."},{"key":"name","description":"Restrict results to items with names that match this prefix."},{"key":"service_id","description":"Filter results based on a service_id."},{"key":"to","description":"Represents the end of a date-time range expressed in RFC 3339 format."}]},"description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/ddos-protection/#ddos-protection-event-list)**\n\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"id\":\"fd9g33dcba53b02fbf00001s\",\"name\":\"event name 001\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"customer_id\":\"x4xCwxxJxGCx123Rx5xTx\",\"started_at\":\"2025-01-22T00:00:00Z\",\"ended_at\":null,\"created_at\":\"2025-01-22T00:00:00Z\",\"updated_at\":\"2025-01-22T00:00:00Z\"},{\"id\":\"7gfeb89dcba53b02fbf00008\",\"name\":\"rule name 002\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"customer_id\":\"x4xCwxxJxGCx123Rx5xTx\",\"started_at\":\"2025-01-22T00:00:00Z\",\"ended_at\":null,\"created_at\":\"2025-01-22T00:00:00Z\",\"updated_at\":\"2025-01-22T00:00:00Z\"},{\"id\":\"8valwi9dcba53b02fbf00003\",\"name\":\"rule name 003\",\"requests_allowed\":439,\"requests_detected\":56733,\"service_id\":\"DSR3Z0ilxP56zGVKXdv0zD\",\"customer_id\":\"x4xCwxxJxGCx123Rx5xTx\",\"started_at\":\"2025-01-22T00:00:00Z\",\"ended_at\":\"2025-01-22T00:00:00Z\",\"created_at\":\"2025-01-22T00:00:00Z\",\"updated_at\":\"2025-01-22T00:00:00Z\"}],\"meta\":{\"next_cursor\":\"dXNlcjpVMEc5V0ZYTlo=\",\"limit\":3}}"}],"_postman_id":"23ae3fc6-cbc3-4a54-a7c0-1f3e5a88a746"},{"name":"Get event by ID","id":"0b3ccfb6-cb06-4293-a794-cbb6a3a9e85f","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ddos-protection/v1/events/{{event_id}}","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/ddos-protection/#ddos-protection-event-get\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["ddos-protection","v1","events","{{event_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"db8bedab-58b8-41a4-af4d-4cce366d50e1","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ddos-protection/v1/events/54de69dcba53b02fbf000018","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/ddos-protection/#ddos-protection-event-get)**\n\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"8dpm39dcba53b02fbf000029\",\"name\":\"event name 001\",\"requests_allowed\":394,\"requests_detected\":67335,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"customer_id\":\"x4xCwxxJxGCx123Rx5xTx\",\"started_at\":\"2025-01-22T00:00:00Z\",\"ended_at\":null,\"created_at\":\"2025-01-22T00:00:00Z\",\"updated_at\":\"2025-01-22T00:00:00Z\"}"}],"_postman_id":"0b3ccfb6-cb06-4293-a794-cbb6a3a9e85f"},{"name":"Get all rules for an event","id":"8115ef18-6a71-4016-a5a1-d93533a80482","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ddos-protection/v1/events/{{event_id}}/rules?cursor&include&limit","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/ddos-protection/#ddos-protection-event-rule-list\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["ddos-protection","v1","events","{{event_id}}","rules"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Cursor value from the next_cursor field of a previous response, used to retrieve the next page. To request the first page, this should be empty.</p>\n","type":"text/plain"},"key":"cursor"},{"description":{"content":"<p>Include relationships. Optional. Comma-separated values.</p>\n","type":"text/plain"},"key":"include"},{"description":{"content":"<p>Limit how many results are returned.</p>\n","type":"text/plain"},"key":"limit"}],"variable":[]}},"response":[{"id":"73350433-3abf-4533-b4d5-4aa9735d8f26","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/ddos-protection/v1/events/54de69dcba53b02fbf000018/rules?cursor&include&limit","protocol":"https","host":["api","fastly","com"],"path":["ddos-protection","v1","events","54de69dcba53b02fbf000018","rules"],"query":[{"key":"cursor","description":"Cursor value from the next_cursor field of a previous response, used to retrieve the next page. To request the first page, this should be empty."},{"key":"include","description":"Include relationships. Optional. Comma-separated values."},{"key":"limit","description":"Limit how many results are returned."}]},"description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/ddos-protection/#ddos-protection-event-rule-list)**\n\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"id\":\"ash8nwdcba53b02fbf000018\",\"name\":\"rule name 001\",\"action\":\"default\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"customer_id\":\"x4xCwxxJxGCx123Rx5xTx\",\"source_ip\":\"127.0.0.1\",\"country_code\":\"(unknown)\",\"host\":\"example.com\",\"asn\":null,\"source_ip_prefix\":\"127.0.0.1/32\",\"additional_attributes\":[\"protocol\",\"tls\"],\"created_at\":\"2025-01-22T00:00:00Z\",\"updated_at\":\"2025-01-22T00:00:00Z\",\"traffic_stats\":{\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"customer_id\":\"x4xCwxxJxGCx123Rx5xTx\",\"created_at\":\"2025-01-22T00:00:00Z\",\"updated_at\":\"2025-01-22T00:00:00Z\",\"traffic_percentage\":20.5,\"attributes\":[{\"name\":\"method_path\",\"values\":[{\"value\":\"POST /hello.Hello/Ping\",\"percentage\":21},{\"value\":\"GET /api/v1/status\",\"percentage\":14}]},{\"name\":\"source_ip\",\"values\":[{\"value\":\"2001:db8:85a3::8a2e:370:7334\",\"percentage\":17},{\"value\":\"192.168.1.105\",\"percentage\":8}]}]}}],\"meta\":{\"next_cursor\":\"dXNlcjpVMEc5V0ZYTlo=\",\"limit\":1}}"}],"_postman_id":"8115ef18-6a71-4016-a5a1-d93533a80482"},{"name":"Get traffic stats for a rule","id":"8bf1b0da-74ac-4816-9d41-4da274044819","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ddos-protection/v1/events/{{event_id}}/rules/{{rule_id}}/traffic-stats","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/ddos-protection/#ddos-protection-traffic-stats-rule-get\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["ddos-protection","v1","events","{{event_id}}","rules","{{rule_id}}","traffic-stats"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"911e5be0-470b-4578-a682-3c4cb177955d","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/ddos-protection/v1/events/54de69dcba53b02fbf000018/rules/54de69dcba53b02fbf000018/traffic-stats","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/ddos-protection/#ddos-protection-traffic-stats-rule-get)**\n\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"customer_id\":\"x4xCwxxJxGCx123Rx5xTx\",\"created_at\":\"2025-01-22T00:00:00Z\",\"updated_at\":\"2025-01-22T00:00:00Z\",\"traffic_percentage\":20.5,\"attributes\":[{\"name\":\"method_path\",\"values\":[{\"value\":\"POST /hello.Hello/Ping\",\"percentage\":21},{\"value\":\"GET /api/v1/status\",\"percentage\":14}]},{\"name\":\"source_ip\",\"values\":[{\"value\":\"2001:db8:85a3::8a2e:370:7334\",\"percentage\":17},{\"value\":\"192.168.1.105\",\"percentage\":8}]},{\"name\":\"country_code\",\"values\":[{\"value\":\"US\",\"percentage\":56}]},{\"name\":\"host\",\"values\":[{\"value\":\"example.com\",\"percentage\":15},{\"value\":\"api.example.com\",\"percentage\":9}]},{\"name\":\"asn\",\"values\":[{\"value\":\"34154\",\"percentage\":15}]},{\"name\":\"source_ip_prefix\",\"values\":[{\"value\":\"127.0.0.1/32\",\"percentage\":33}]},{\"name\":\"user_agent\",\"values\":[{\"value\":\"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_3) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/56.0.2924.87 Safari/537.36\",\"percentage\":26}]}]}"}],"_postman_id":"8bf1b0da-74ac-4816-9d41-4da274044819"}],"id":"2a263f3f-f56c-4e8b-8978-8e06fc5dae55","description":"<p>The Fastly DDoS Protection Events API allows you to configure Fastly DDoS Protection and view attack insights including events, rules, and traffic statistics.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>Name of an attribute type used in traffic stats. Currently, supported values are source_ip, country_code, host, asn, source_ip_prefix, user_agent, method_path.</td>\n</tr>\n<tr>\n<td>values</td>\n<td>array</td>\n<td>Values for traffic attribute.</td>\n</tr>\n<tr>\n<td>percentage</td>\n<td>integer</td>\n<td>Percentage of traffic containing a value.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>customer_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the customer.</td>\n</tr>\n<tr>\n<td>ended_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>Unique ID of the event.</td>\n</tr>\n<tr>\n<td>requests_allowed</td>\n<td>integer</td>\n<td>Number of requests classified as non-attack traffic for an event.</td>\n</tr>\n<tr>\n<td>requests_detected</td>\n<td>integer</td>\n<td>Number of requests classified as DDoS attack traffic for an event.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>started_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>action</td>\n<td>string</td>\n<td>Action types for a rule. Supported action values are default, block, log, off. The default action value follows the current protection mode of the associated service.</td>\n</tr>\n<tr>\n<td>additional_attributes</td>\n<td>array</td>\n<td>Attribute category for additional, unlisted attributes used in a rule.</td>\n</tr>\n<tr>\n<td>asn</td>\n<td>string</td>\n<td>ASN attribute.</td>\n</tr>\n<tr>\n<td>country_code</td>\n<td>string</td>\n<td>Country code attribute.</td>\n</tr>\n<tr>\n<td>host</td>\n<td>string</td>\n<td>Host attribute.</td>\n</tr>\n<tr>\n<td>source_ip</td>\n<td>string</td>\n<td>Source IP address attribute.</td>\n</tr>\n<tr>\n<td>source_ip_prefix</td>\n<td>string</td>\n<td>Source IP prefix attribute.</td>\n</tr>\n<tr>\n<td>traffic_percentage</td>\n<td>number</td>\n<td>Rule traffic percentage for the event.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"2a263f3f-f56c-4e8b-8978-8e06fc5dae55"}],"id":"55bed556-bb71-4a62-9f0c-9078f9179839","_postman_id":"55bed556-bb71-4a62-9f0c-9078f9179839","description":""},{"name":"TSIG Keys","item":[{"name":"TSIG Keys","item":[{"name":"Get TSIG keys","id":"c7891063-05ef-4b34-9c2a-d8339afc17a9","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/dns/v1/tsig-keys?cursor&limit&name&sort","description":"<p>Retrieve a paginated list of all TSIG keys.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["dns","v1","tsig-keys"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Cursor value from the next_cursor field of a previous response, used to retrieve the next page. To request the first page, this should be empty.</p>\n","type":"text/plain"},"key":"cursor"},{"description":{"content":"<p>Limit how many results are returned.</p>\n","type":"text/plain"},"key":"limit"},{"description":{"content":"<p>Filters the list to return only TSIG keys that contain the provided name.</p>\n","type":"text/plain"},"key":"name"},{"description":{"content":"<p>The order in which to list the results.</p>\n","type":"text/plain"},"key":"sort"}],"variable":[]}},"response":[{"id":"4efdacf9-ae87-4ce3-b014-1420da733d8e","name":"200 A list of TSIG keys.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/dns/v1/tsig-keys?limit=2&name=fastly.com&sort=name?cursor&limit&name&sort","protocol":"https","host":["api","fastly","com"],"path":["dns","v1","tsig-keys"],"query":[{"key":"cursor","description":"Cursor value from the next_cursor field of a previous response, used to retrieve the next page. To request the first page, this should be empty."},{"key":"limit","description":"Limit how many results are returned."},{"key":"name","description":"Filters the list to return only TSIG keys that contain the provided name."},{"key":"sort","description":"The order in which to list the results."}]},"description":"Retrieve a paginated list of all TSIG keys.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 A list of TSIG keys.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"id\":\"5crTqOYfP1l9Ya3f7daLJ4\",\"name\":\"secondary-a.tsig.fastly.com.\",\"description\":\"TSIG key for zone transfers.\",\"algorithm\":\"hmac-sha256\",\"created_at\":\"2025-06-25T19:40:00.000Z\",\"updated_at\":\"2025-06-25T19:40:00.000Z\"},{\"id\":\"5crTqOYfP1l9Ya3f7daLJ4\",\"name\":\"secondary-b.tsig.fastly.com.\",\"description\":\"Another TSIG key for zone transfers.\",\"algorithm\":\"hmac-sha256\",\"created_at\":\"2025-07-22T17:23:00.000Z\",\"updated_at\":\"2025-07-22T17:23:00.000Z\"}],\"meta\":{\"next_cursor\":\"cZXT2dlwuVNYxjqC5oC\",\"limit\":2,\"sort\":\"name\",\"total\":15}}"}],"_postman_id":"c7891063-05ef-4b34-9c2a-d8339afc17a9"},{"name":"Create TSIG key","id":"4afe3ebf-0ab9-41f6-8a8e-4d53d730a192","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"secondary-a.tsig.fastly.com.\",\"description\":\"TSIG key for zone transfers.\",\"algorithm\":\"hmac-sha256\",\"secret\":\"lsdwzfG3Ap7HVg9SpNm7Djvjy4H61NQS7atr3nmxc9+jNLBfMeSPYSUHx/3X8jk1av8MH1OuB0fmPo5NA624VQ==\"}"},"url":"https://api.fastly.com/dns/v1/tsig-keys","description":"<p>Create a new TSIG key.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["dns","v1","tsig-keys"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"40841a59-2cda-47fe-bb0d-e190696ea550","name":"201 A TSIG key.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"secondary-a.tsig.fastly.com.\",\"description\":\"TSIG key for zone transfers.\",\"algorithm\":\"hmac-sha256\",\"secret\":\"lsdwzfG3Ap7HVg9SpNm7Djvjy4H61NQS7atr3nmxc9+jNLBfMeSPYSUHx/3X8jk1av8MH1OuB0fmPo5NA624VQ==\"}"},"url":"https://api.fastly.com/dns/v1/tsig-keys","description":"Create a new TSIG key.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"201 A TSIG key.","code":201,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":{\"id\":\"5crTqOYfP1l9Ya3f7daLJ4\",\"name\":\"secondary-a.tsig.fastly.com.\",\"description\":\"TSIG key for zone transfers.\",\"algorithm\":\"hmac-sha256\",\"created_at\":\"2025-06-25T19:40:00.000Z\",\"updated_at\":\"2025-06-25T19:40:00.000Z\"}}"}],"_postman_id":"4afe3ebf-0ab9-41f6-8a8e-4d53d730a192"},{"name":"Get TSIG key","id":"83b0743f-6d91-47f3-95d9-3fb3f4bdd8a5","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/dns/v1/tsig-keys/{{tsig_key_id}}","description":"<p>Retrieve a specific TSIG key.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["dns","v1","tsig-keys","{{tsig_key_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"b92a5a9f-f166-4dd6-aa58-375a0c3c69b1","name":"200 A TSIG key.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/dns/v1/tsig-keys/{{tsig_key_id}}","description":"Retrieve a specific TSIG key.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 A TSIG key.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":{\"id\":\"5crTqOYfP1l9Ya3f7daLJ4\",\"name\":\"secondary-a.tsig.fastly.com.\",\"description\":\"TSIG key for zone transfers.\",\"algorithm\":\"hmac-sha256\",\"created_at\":\"2025-06-25T19:40:00.000Z\",\"updated_at\":\"2025-06-25T19:40:00.000Z\"}}"}],"_postman_id":"83b0743f-6d91-47f3-95d9-3fb3f4bdd8a5"},{"name":"Delete TSIG key","id":"c5296c1f-883e-4dcb-bf8d-ef0b94aff01b","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/dns/v1/tsig-keys/{{tsig_key_id}}","description":"<p>Delete a specific TSIG key.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["dns","v1","tsig-keys","{{tsig_key_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"e7669bdf-fbb5-4ac3-b121-2abf419b29f9","name":"204 Success - No content","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/dns/v1/tsig-keys/{{tsig_key_id}}","description":"Delete a specific TSIG key.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 Success - No content","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"c5296c1f-883e-4dcb-bf8d-ef0b94aff01b"},{"name":"Update TSIG key","id":"d6549a15-11f6-43eb-bafe-9d23230d8c05","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"secondary-a.tsig.fastly.com.\",\"description\":\"TSIG key for zone transfers.\",\"algorithm\":\"hmac-sha256\",\"secret\":\"lsdwzfG3Ap7HVg9SpNm7Djvjy4H61NQS7atr3nmxc9+jNLBfMeSPYSUHx/3X8jk1av8MH1OuB0fmPo5NA624VQ==\"}"},"url":"https://api.fastly.com/dns/v1/tsig-keys/{{tsig_key_id}}","description":"<p>Update a specific TSIG key.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["dns","v1","tsig-keys","{{tsig_key_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"996100c1-8fa3-496f-8bf9-59d2724cd20a","name":"200 A TSIG key.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"secondary-a.tsig.fastly.com.\",\"description\":\"TSIG key for zone transfers.\",\"algorithm\":\"hmac-sha256\",\"secret\":\"lsdwzfG3Ap7HVg9SpNm7Djvjy4H61NQS7atr3nmxc9+jNLBfMeSPYSUHx/3X8jk1av8MH1OuB0fmPo5NA624VQ==\"}"},"url":"https://api.fastly.com/dns/v1/tsig-keys/{{tsig_key_id}}","description":"Update a specific TSIG key.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 A TSIG key.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":{\"id\":\"5crTqOYfP1l9Ya3f7daLJ4\",\"name\":\"secondary-a.tsig.fastly.com.\",\"description\":\"TSIG key for zone transfers.\",\"algorithm\":\"hmac-sha256\",\"created_at\":\"2025-06-25T19:40:00.000Z\",\"updated_at\":\"2025-06-25T19:40:00.000Z\"}}"}],"_postman_id":"d6549a15-11f6-43eb-bafe-9d23230d8c05"}],"id":"94727ab2-609e-4f9d-9497-b70c158cf3de","description":"<p>A TSIG (Transaction Signature) key is set of shared credentials used to secure zone transfers between DNS servers.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n</tbody>\n</table>\n</div><h2 id=\"data-model-1\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>algorithm</td>\n<td>string</td>\n<td>The algorithm of the TSIG key.</td>\n</tr>\n<tr>\n<td>description</td>\n<td>string</td>\n<td>A freeform descriptive note.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The name of the TSIG key.</td>\n</tr>\n<tr>\n<td>secret</td>\n<td>string</td>\n<td>The Base64 encoded secret key.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-2\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>algorithm</td>\n<td>string</td>\n<td>The algorithm of the TSIG key.</td>\n</tr>\n<tr>\n<td>description</td>\n<td>string</td>\n<td>A freeform descriptive note.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The name of the TSIG key.</td>\n</tr>\n<tr>\n<td>secret</td>\n<td>string</td>\n<td>The Base64 encoded secret key.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-3\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>algorithm</td>\n<td>string</td>\n<td>The algorithm of the TSIG key.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>description</td>\n<td>string</td>\n<td>A freeform descriptive note.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>TSIG Key Identifier (UUID).</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The name of the TSIG key.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"94727ab2-609e-4f9d-9497-b70c158cf3de"}],"id":"e12b5e5c-4ac2-4be1-94ee-8355c35236b6","_postman_id":"e12b5e5c-4ac2-4be1-94ee-8355c35236b6","description":""},{"name":"Zones","item":[{"name":"Zones","item":[{"name":"Get zones","id":"ffc40529-a0d4-4a21-89d7-78884e2e0b16","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/dns/v1/zones?cursor&limit&name&sort","description":"<p>Retrieve a paginated list of all zones.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["dns","v1","zones"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Cursor value from the next_cursor field of a previous response, used to retrieve the next page. To request the first page, this should be empty.</p>\n","type":"text/plain"},"key":"cursor"},{"description":{"content":"<p>Limit how many results are returned.</p>\n","type":"text/plain"},"key":"limit"},{"description":{"content":"<p>Filters the list to return only zones that contain the provided name.</p>\n","type":"text/plain"},"key":"name"},{"description":{"content":"<p>The order in which to list the results.</p>\n","type":"text/plain"},"key":"sort"}],"variable":[]}},"response":[{"id":"445b2f24-c7fd-4517-8557-31a774d3aff1","name":"200 A list of zones with basic details.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/dns/v1/zones?limit=2&name=example.com&sort=name?cursor&limit&name&sort","protocol":"https","host":["api","fastly","com"],"path":["dns","v1","zones"],"query":[{"key":"cursor","description":"Cursor value from the next_cursor field of a previous response, used to retrieve the next page. To request the first page, this should be empty."},{"key":"limit","description":"Limit how many results are returned."},{"key":"name","description":"Filters the list to return only zones that contain the provided name."},{"key":"sort","description":"The order in which to list the results."}]},"description":"Retrieve a paginated list of all zones.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 A list of zones with basic details.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":[{\"id\":\"TuVwXyZaBcDeFgHiJkLmNo\",\"name\":\"my-domain-example.com.\",\"description\":\"This is my new secondary zone\",\"type\":\"secondary\",\"created_at\":\"2025-09-12T17:30:00.000Z\",\"updated_at\":\"2025-09-12T17:30:00.000Z\"},{\"id\":\"aBcDeFgH1iJkLmN2oPqRs3\",\"name\":\"secondary-example.com.\",\"description\":\"A new description for the secondary zone\",\"type\":\"secondary\",\"created_at\":\"2025-06-25T19:40:00.000Z\",\"updated_at\":\"2025-06-25T19:40:00.000Z\"}],\"meta\":{\"next_cursor\":\"cZXT2dlwuVNYxjqC5oC\",\"limit\":2,\"sort\":\"name\",\"total\":15}}"}],"_postman_id":"ffc40529-a0d4-4a21-89d7-78884e2e0b16"},{"name":"Create zone","id":"e6fc34cd-4a3a-41d5-8903-243a4bb9a6e0","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"secondary-example.com.\",\"description\":\"A new description for the secondary zone\",\"type\":\"secondary\",\"xfr_config_inbound\":{\"primaries\":[{\"address\":\"203.0.113.10\",\"description\":\"My Primary DNS Server\"}],\"inbound_tsig_key_id\":\"8kFWbN3qP2g8Zc4h9edKM5\"}}"},"url":"https://api.fastly.com/dns/v1/zones","description":"<p>Create a new zone.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["dns","v1","zones"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"18afa915-f22d-41db-ae23-f617cd467384","name":"201 A zone with full details.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"secondary-example.com.\",\"description\":\"A new description for the secondary zone\",\"type\":\"secondary\",\"xfr_config_inbound\":{\"primaries\":[{\"address\":\"203.0.113.10\",\"description\":\"My Primary DNS Server\"}],\"inbound_tsig_key_id\":\"8kFWbN3qP2g8Zc4h9edKM5\"}}"},"url":"https://api.fastly.com/dns/v1/zones","description":"Create a new zone.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"201 A zone with full details.","code":201,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":{\"id\":\"aBcDeFgH1iJkLmN2oPqRs3\",\"name\":\"secondary-example.com.\",\"description\":\"A new description for the secondary zone\",\"type\":\"secondary\",\"created_at\":\"2025-06-25T19:40:00.000Z\",\"updated_at\":\"2025-06-25T19:40:00.000Z\",\"nameservers\":[\"alder.fastlydns.com.\",\"alder.fastlydns.dev.\",\"alder.fastlydns.org.\",\"alder.fastlydns.net.\"],\"xfr_config_inbound\":{\"primaries\":[{\"address\":\"203.0.113.10\",\"description\":\"My Primary DNS Server\"}],\"notify_ip_addresses\":{\"ipv4\":[\"157.52.78.1\",\"157.52.79.1\",\"167.82.228.1\"]},\"inbound_tsig_key_id\":\"8kFWbN3qP2g8Zc4h9edKM5\"},\"serial\":\"2025062403\"}}"}],"_postman_id":"e6fc34cd-4a3a-41d5-8903-243a4bb9a6e0"},{"name":"Get zone","id":"63840d62-b3c7-4213-8887-3d209156eb10","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/dns/v1/zones/{{zone_id}}","description":"<p>Retrieve a specific zone.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["dns","v1","zones","{{zone_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"1f3fee9e-b07d-4017-a88a-168ab5990256","name":"200 A zone with full details.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/dns/v1/zones/{{zone_id}}","description":"Retrieve a specific zone.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 A zone with full details.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":{\"id\":\"aBcDeFgH1iJkLmN2oPqRs3\",\"name\":\"secondary-example.com.\",\"description\":\"A new description for the secondary zone\",\"type\":\"secondary\",\"created_at\":\"2025-06-25T19:40:00.000Z\",\"updated_at\":\"2025-06-25T19:40:00.000Z\",\"nameservers\":[\"alder.fastlydns.com.\",\"alder.fastlydns.dev.\",\"alder.fastlydns.org.\",\"alder.fastlydns.net.\"],\"xfr_config_inbound\":{\"primaries\":[{\"address\":\"203.0.113.10\",\"description\":\"My Primary DNS Server\"}],\"notify_ip_addresses\":{\"ipv4\":[\"157.52.78.1\",\"157.52.79.1\",\"167.82.228.1\"]},\"inbound_tsig_key_id\":\"8kFWbN3qP2g8Zc4h9edKM5\"},\"serial\":\"2025062403\"}}"}],"_postman_id":"63840d62-b3c7-4213-8887-3d209156eb10"},{"name":"Delete zone","id":"4542bb6e-5b98-495b-9179-4ea0cd161292","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/dns/v1/zones/{{zone_id}}","description":"<p>Delete a specific zone.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["dns","v1","zones","{{zone_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"cb22e537-59e7-4eb6-982f-760f06d983b8","name":"204 Success - No content","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"}],"url":"https://api.fastly.com/dns/v1/zones/{{zone_id}}","description":"Delete a specific zone.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"204 Success - No content","code":204,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":null}],"_postman_id":"4542bb6e-5b98-495b-9179-4ea0cd161292"},{"name":"Update zone","id":"79f0052d-fc78-4c64-8c79-d375f6022f3b","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"description\":\"A new description for the secondary zone\",\"xfr_config_inbound\":{\"primaries\":[{\"address\":\"203.0.113.10\",\"description\":\"primary 2\"}],\"inbound_tsig_key_id\":\"8kFWbN3qP2g8Zc4h9edKM5\"}}"},"url":"https://api.fastly.com/dns/v1/zones/{{zone_id}}","description":"<p>Update a specific zone.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["dns","v1","zones","{{zone_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"a31dd05a-01de-4195-80d9-50c5ec03db8b","name":"200 A zone with full details.","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PATCH","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"description\":\"A new description for the secondary zone\",\"xfr_config_inbound\":{\"primaries\":[{\"address\":\"203.0.113.10\",\"description\":\"primary 2\"}],\"inbound_tsig_key_id\":\"8kFWbN3qP2g8Zc4h9edKM5\"}}"},"url":"https://api.fastly.com/dns/v1/zones/{{zone_id}}","description":"Update a specific zone.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 A zone with full details.","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"data\":{\"id\":\"aBcDeFgH1iJkLmN2oPqRs3\",\"name\":\"secondary-example.com.\",\"description\":\"A new description for the secondary zone\",\"type\":\"secondary\",\"created_at\":\"2025-06-25T19:40:00.000Z\",\"updated_at\":\"2025-06-25T19:40:00.000Z\",\"nameservers\":[\"alder.fastlydns.com.\",\"alder.fastlydns.dev.\",\"alder.fastlydns.org.\",\"alder.fastlydns.net.\"],\"xfr_config_inbound\":{\"primaries\":[{\"address\":\"203.0.113.10\",\"description\":\"My Primary DNS Server\"}],\"notify_ip_addresses\":{\"ipv4\":[\"157.52.78.1\",\"157.52.79.1\",\"167.82.228.1\"]},\"inbound_tsig_key_id\":\"8kFWbN3qP2g8Zc4h9edKM5\"},\"serial\":\"2025062403\"}}"}],"_postman_id":"79f0052d-fc78-4c64-8c79-d375f6022f3b"}],"id":"21d5cf01-ba47-4a1c-ae2c-1430c2caa801","description":"<p>A zone is a specific segment of the Domain Name System (DNS) namespace that can be managed and maintained on Fastly DNS.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n</tbody>\n</table>\n</div><h2 id=\"data-model-1\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>ipv4</td>\n<td>array</td>\n<td>IPv4 addresses where Primary DNS servers can send NOTIFY messages.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-2\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>address</td>\n<td>string</td>\n<td>An IPv4 address for the Primary DNS Server.</td>\n</tr>\n<tr>\n<td>description</td>\n<td>string</td>\n<td>A description of the Primary DNS server.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-3\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>description</td>\n<td>string</td>\n<td>A freeform descriptive note.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The domain name for your zone.</td>\n</tr>\n<tr>\n<td>type</td>\n<td>string</td>\n<td>The type of the zone.</td>\n</tr>\n<tr>\n<td>xfr_config_inbound</td>\n<td>object</td>\n<td>All attributes associated with inbound zone transfers.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-4\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>description</td>\n<td>string</td>\n<td>A freeform descriptive note.</td>\n</tr>\n<tr>\n<td>xfr_config_inbound</td>\n<td>object</td>\n<td>All attributes associated with inbound zone transfers.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-5\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>description</td>\n<td>string</td>\n<td>A freeform descriptive note.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>Zone Identifier (UUID).</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The domain name for your zone.</td>\n</tr>\n<tr>\n<td>type</td>\n<td>string</td>\n<td>The type of the zone.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-6\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>description</td>\n<td>string</td>\n<td>A freeform descriptive note.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>Zone Identifier (UUID).</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The domain name for your zone.</td>\n</tr>\n<tr>\n<td>nameservers</td>\n<td>array</td>\n<td>An array of the nameserver hostnames assigned to the zone.</td>\n</tr>\n<tr>\n<td>serial</td>\n<td>string</td>\n<td>The serial number of the zone's SOA record.</td>\n</tr>\n<tr>\n<td>type</td>\n<td>string</td>\n<td>The type of the zone.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>xfr_config_inbound</td>\n<td>object</td>\n<td>All attributes associated with inbound zone transfers.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-7\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>inbound_tsig_key_id</td>\n<td>string</td>\n<td>The ID of the TSIG key used to secure inbound zone transfers.</td>\n</tr>\n<tr>\n<td>primaries</td>\n<td>array</td>\n<td>An array of the primary DNS server objects associated with inbound zone transfers.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-8\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>inbound_tsig_key_id</td>\n<td>string</td>\n<td>The ID of the TSIG key used to secure inbound zone transfers.</td>\n</tr>\n<tr>\n<td>notify_ip_addresses</td>\n<td>object</td>\n<td>IP addresses where Primary DNS servers can send NOTIFY messages.</td>\n</tr>\n<tr>\n<td>primaries</td>\n<td>array</td>\n<td>An array of the primary DNS server objects associated with inbound zone transfers.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"21d5cf01-ba47-4a1c-ae2c-1430c2caa801"}],"id":"1775aca8-376a-4d5d-835c-cb0bbc9eac97","_postman_id":"1775aca8-376a-4d5d-835c-cb0bbc9eac97","description":""},{"name":"Publishing","item":[{"name":"Publishing","item":[{"name":"Send messages to Fanout subscribers","id":"08522d1d-9a65-4304-ab9d-97cde6a030b4","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"text/plain"}],"body":{"mode":"raw","raw":"{\"items\":[{\"channel\":\"mychannel\",\"formats\":{\"ws-message\":{\"content\":\"hello world\"}}}]}"},"url":"https://api.fastly.com/service/{{service_id}}/publish","description":"<p>Send one or more messages to Fanout subscribers. Each message specifies a channel, and Fanout will deliver the message to all subscribers of its channel.</p>\n<p>IMPORTANT: For compatibility with GRIP, this endpoint requires a trailing slash, and the API token may be provided in the Authorization header (instead of the Fastly-Key header) using the Bearer scheme.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","publish"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"c73146bb-93cd-42b5-814b-ae3eda3d11d3","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"text/plain"}],"body":{"mode":"raw","raw":"{\"items\":[{\"channel\":\"mychannel\",\"formats\":{\"ws-message\":{\"content\":\"hello world\"}}}]}"},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/publish","description":"Send one or more messages to Fanout subscribers. Each message specifies a channel, and Fanout will deliver the message to all subscribers of its channel.\n\nIMPORTANT: For compatibility with GRIP, this endpoint requires a trailing slash, and the API token may be provided in the Authorization header (instead of the Fastly-Key header) using the Bearer scheme.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"Published\n"}],"_postman_id":"08522d1d-9a65-4304-ab9d-97cde6a030b4"}],"id":"cf8a3ed4-4fc3-4ea1-9b40-ccd5641fe28f","description":"<p>Publishing sends messages to Fanout subscribers. Fanout is designed to be GRIP-compatible, such that <a href=\"https://api.fastly.com/service/%7Bservice_id%7D\">https://api.fastly.com/service/{service_id}</a> can be used as a GRIP URL in application configurations.</p>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>body</td>\n<td>string</td>\n<td>The response body as a string.</td>\n</tr>\n<tr>\n<td>body-bin</td>\n<td>string</td>\n<td>The response body as a base64-encoded binary blob.</td>\n</tr>\n<tr>\n<td>code</td>\n<td>integer</td>\n<td>The HTTP status code.</td>\n</tr>\n<tr>\n<td>headers</td>\n<td>object</td>\n<td>A map of arbitrary HTTP response headers to include in the response.</td>\n</tr>\n<tr>\n<td>reason</td>\n<td>string</td>\n<td>The HTTP status string. Defaults to a string appropriate for code.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-1\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>content</td>\n<td>string</td>\n<td>A fragment of body data as a string.</td>\n</tr>\n<tr>\n<td>content-bin</td>\n<td>string</td>\n<td>A fragment of body data as a base64-encoded binary blob.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-2\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>channel</td>\n<td>string</td>\n<td>The channel to publish the message on.</td>\n</tr>\n<tr>\n<td>formats</td>\n<td>object</td>\n<td>Transport-specific message payload representations to be used for delivery. At least one format (http-response, http-stream, and/or ws-message) must be specified. Messages are only delivered to subscribers interested in the provided formats. For example, the ws-message format will only be sent to WebSocket clients.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>The ID of the message.</td>\n</tr>\n<tr>\n<td>prev-id</td>\n<td>string</td>\n<td>The ID of the previous message published on the same channel.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-3\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>items</td>\n<td>array</td>\n<td>The messages to publish.</td>\n</tr>\n</tbody>\n</table>\n</div><h2 id=\"data-model-4\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>content</td>\n<td>string</td>\n<td>The content of a WebSocket TEXT message.</td>\n</tr>\n<tr>\n<td>content-bin</td>\n<td>string</td>\n<td>The base64-encoded content of a WebSocket BINARY message.</td>\n</tr>\n</tbody>\n</table>\n</div>","_postman_id":"cf8a3ed4-4fc3-4ea1-9b40-ccd5641fe28f"}],"id":"c6ebebe4-6bc9-468e-a4c0-306a330ae0eb","_postman_id":"c6ebebe4-6bc9-468e-a4c0-306a330ae0eb","description":""},{"name":"Purging","item":[{"name":"Purging","item":[{"name":"Purge a URL","id":"350f01ea-cd39-4c0f-a3c7-7f573d7b5efe","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/purge/{{cached_url}}","description":"<p>Instant Purge an individual URL.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["purge","{{cached_url}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"3bc9dbd2-878d-4b01-90c2-9b44db9eb028","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/purge/www.example.com/path/to/object-to-purge","description":"Instant Purge an individual URL.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\",\"id\":\"108-1391560174-974124\"}"}],"_postman_id":"350f01ea-cd39-4c0f-a3c7-7f573d7b5efe"},{"name":"Purge everything from a service","id":"8e4ba1c6-551f-4eb8-a772-5d5dfe5cd27d","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/purge_all","description":"<p>Instant Purge everything from a service.\nPurge-all requests cannot be done in soft mode and will always immediately invalidate all cached content associated with the service. To do a soft-purge-all, consider applying a constant surrogate key tag (e.g., \"all\") to all objects.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","purge_all"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"81fbf52d-771d-49db-b518-bb584a2bcf36","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/purge_all","description":"Instant Purge everything from a service.\nPurge-all requests cannot be done in soft mode and will always immediately invalidate all cached content associated with the service. To do a soft-purge-all, consider applying a constant surrogate key tag (e.g., \"all\") to all objects.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"8e4ba1c6-551f-4eb8-a772-5d5dfe5cd27d"},{"name":"Purge by surrogate key tag","id":"f58a0e81-3e10-49e1-8959-1d280b4e9483","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/purge/{{surrogate_key}}","description":"<p>Instant Purge a particular service of items tagged with a Surrogate Key. Only one surrogate key can be purged at a time. Multiple keys can be purged using a batch surrogate key purge request.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","purge","{{surrogate_key}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"62bd108a-01c0-49d6-a0ab-e1ad0e5a4ae0","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/purge/key_1","description":"Instant Purge a particular service of items tagged with a Surrogate Key. Only one surrogate key can be purged at a time. Multiple keys can be purged using a batch surrogate key purge request.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\",\"id\":\"108-1391560174-974124\"}"}],"_postman_id":"f58a0e81-3e10-49e1-8959-1d280b4e9483"},{"name":"Purge multiple surrogate key tags","id":"ca28067c-a09d-4072-82d9-116794f5eeb7","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"},{"key":"fastly-soft-purge","value":"1"},{"key":"surrogate-key","value":"key_1 key_2 key_3"}],"body":{"mode":"raw","raw":"{\"surrogate_keys\":[\"key_1\",\"key_2\",\"key_3\"]}"},"url":"https://api.fastly.com/service/{{service_id}}/purge","description":"<p>Instant Purge a particular service of items tagged with surrogate keys. Up to 256 surrogate keys can be purged in one batch request. As an alternative to sending the keys in a JSON object in the body of the request, this endpoint also supports listing keys in a Surrogate-Key request header, e.g. Surrogate-Key: key_1 key_2 key_3.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","purge"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"894e09a7-4de4-4874-ab55-8fb9636b5bba","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"},{"key":"fastly-soft-purge","value":"1"},{"key":"surrogate-key","value":"key_1 key_2 key_3"}],"body":{"mode":"raw","raw":"{\"surrogate_keys\":[\"key_1\",\"key_2\",\"key_3\"]}"},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/purge","description":"Instant Purge a particular service of items tagged with surrogate keys. Up to 256 surrogate keys can be purged in one batch request. As an alternative to sending the keys in a JSON object in the body of the request, this endpoint also supports listing keys in a Surrogate-Key request header, e.g. Surrogate-Key: key_1 key_2 key_3.\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"key_1\":\"108-1391560174-974124\",\"key_2\":\"108-1391560174-974125\",\"key_3\":\"108-1391560174-974126\"}"}],"_postman_id":"ca28067c-a09d-4072-82d9-116794f5eeb7"}],"id":"56f32793-7077-4384-8acc-bff63bd9e6a9","description":"<p>Instant Purging removes content from Fastly immediately so it can be refreshed from your origin servers. While the default approach for issuing an individual URL Instant Purge uses the Fastly API, <a href=\"https://api.fastly.com/\">https://api.fastly.com/</a>, it is not required.</p>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>Alphanumeric string identifying a Purging.</td>\n</tr>\n</tbody>\n</table>\n</div>","_postman_id":"56f32793-7077-4384-8acc-bff63bd9e6a9"}],"id":"2be38cd2-f152-49a4-b29a-40c09e10aeaf","_postman_id":"2be38cd2-f152-49a4-b29a-40c09e10aeaf","description":""},{"name":"VCL objects","item":[{"name":"Apex redirect","item":[{"name":"List apex redirects","id":"4d19baf5-e471-4fd6-9dcf-b693226e9331","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/apex-redirects","description":"<p>List all apex redirects for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","apex-redirects"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"dfbe4811-4872-428b-9b07-d8da9733cd46","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/apex-redirects","description":"List all apex redirects for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"feature_revision\":1,\"feature_update_available\":false,\"domains\":[\"example.com\",\"example.net\"],\"status_code\":301,\"id\":\"6QI9o6ZZrSP3y9gI0OhMwZ\",\"service_id\":\"1ry8Ui9rAiAsJEc6Ze99W1\",\"version\":1,\"created_at\":\"2021-01-25T18:24:38.000Z\",\"updated_at\":\"2021-01-25T18:24:38.000Z\"},{\"feature_revision\":1,\"feature_update_available\":false,\"domains\":[\"example.org\"],\"status_code\":308,\"id\":\"s7aqgcJjqqKhwiTRMaP11\",\"service_id\":\"1ry8Ui9rAiAsJEc6Ze99W1\",\"version\":1,\"created_at\":\"2021-01-25T18:43:32.000Z\",\"updated_at\":\"2021-01-25T18:43:33.000Z\"}]"}],"_postman_id":"4d19baf5-e471-4fd6-9dcf-b693226e9331"},{"name":"Create an apex redirect","id":"24731806-c180-4f97-afaa-554ab06cc0fa","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/apex-redirects","description":"<p>Create an apex redirect for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","apex-redirects"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"07b5e8aa-2f08-4ca7-9124-706795255c1b","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/apex-redirects","description":"Create an apex redirect for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"feature_revision\":1,\"feature_update_available\":false,\"domains\":[\"example.com\",\"example.net\"],\"status_code\":301,\"id\":\"6QI9o6ZZrSP3y9gI0OhMwZ\",\"service_id\":\"1ry8Ui9rAiAsJEc6Ze99W1\",\"version\":1,\"created_at\":\"2021-01-25T18:24:38.000Z\",\"updated_at\":\"2021-01-25T18:24:38.000Z\"}"}],"_postman_id":"24731806-c180-4f97-afaa-554ab06cc0fa"},{"name":"Get an apex redirect","id":"6055c244-f7d6-426b-96a1-6dec163b9b40","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/apex-redirects/{{apex_redirect_id}}","description":"<p>Get an apex redirect by its ID.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["apex-redirects","{{apex_redirect_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"5aade232-f2d4-44df-87c1-f14ce96de05a","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/apex-redirects/6QI9o6ZZrSP3y9gI0OhMwZ","description":"Get an apex redirect by its ID.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"feature_revision\":1,\"feature_update_available\":false,\"domains\":[\"example.com\",\"example.net\"],\"status_code\":301,\"id\":\"6QI9o6ZZrSP3y9gI0OhMwZ\",\"service_id\":\"1ry8Ui9rAiAsJEc6Ze99W1\",\"version\":1,\"created_at\":\"2021-01-25T18:24:38.000Z\",\"updated_at\":\"2021-01-25T18:24:38.000Z\"}"}],"_postman_id":"6055c244-f7d6-426b-96a1-6dec163b9b40"},{"name":"Update an apex redirect","id":"46c0161f-999f-4928-8897-c302aeef1cae","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/apex-redirects/{{apex_redirect_id}}","description":"<p>Update an apex redirect by its ID.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["apex-redirects","{{apex_redirect_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"cc9b935e-769d-4536-b894-189408312a04","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/apex-redirects/6QI9o6ZZrSP3y9gI0OhMwZ","description":"Update an apex redirect by its ID.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"feature_revision\":1,\"feature_update_available\":false,\"domains\":[\"example.org\"],\"status_code\":308,\"id\":\"s7aqgcJjqqKhwiTRMaP11\",\"service_id\":\"1ry8Ui9rAiAsJEc6Ze99W1\",\"version\":1,\"created_at\":\"2021-01-25T18:43:32.000Z\",\"updated_at\":\"2021-01-25T18:43:33.000Z\"}"}],"_postman_id":"46c0161f-999f-4928-8897-c302aeef1cae"},{"name":"Delete an apex redirect","id":"d377ebc7-3f74-4228-8e62-d6146ff2ce4e","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/apex-redirects/{{apex_redirect_id}}","description":"<p>Delete an apex redirect by its ID.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["apex-redirects","{{apex_redirect_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"4a2033ca-c28e-4e20-add4-2ef4c986dd65","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/apex-redirects/6QI9o6ZZrSP3y9gI0OhMwZ","description":"Delete an apex redirect by its ID.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"d377ebc7-3f74-4228-8e62-d6146ff2ce4e"}],"id":"9ff19b8a-50d0-4130-8592-d2d105ec61ab","description":"<p>Supports redirecting traffic for apex domains, subdomains, or wildcard domains to a WWW subdomain.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>domains</td>\n<td>array</td>\n<td>Array of apex domains that should redirect to their WWW subdomain.</td>\n</tr>\n<tr>\n<td>feature_revision</td>\n<td>integer</td>\n<td>Revision number of the apex redirect feature implementation. Defaults to the most recent revision.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>status_code</td>\n<td>integer</td>\n<td>HTTP status code used to redirect the client.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>integer</td>\n<td>Integer identifying a service version.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"9ff19b8a-50d0-4130-8592-d2d105ec61ab"},{"name":"Cache settings","item":[{"name":"List cache settings objects","id":"0c5c2cbc-bf64-4a09-b245-2ba24141d1a7","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/cache_settings","description":"<p>Get a list of all cache settings for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","cache_settings"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"683d0aea-45fe-4824-b05a-99e72d597ba3","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/cache_settings","description":"Get a list of all cache settings for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"action\":\"cache\",\"cache_condition\":\"\",\"name\":\"test-cache-setting\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"stale_ttl\":\"1200\",\"ttl\":\"3600\",\"version\":\"1\"}]"}],"_postman_id":"0c5c2cbc-bf64-4a09-b245-2ba24141d1a7"},{"name":"Create a cache settings object","id":"3bba95f1-3d16-41b8-9cc9-3aa5619ec240","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/cache_settings","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/vcl-services/cache-settings/#create-cache-settings\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","cache_settings"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"5e5ecce8-3404-4fec-994b-6347f8aef210","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/cache_settings","description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/vcl-services/cache-settings/#create-cache-settings)**\n\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"action\":\"cache\",\"cache_condition\":\"\",\"name\":\"test-cache-setting\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"stale_ttl\":\"1200\",\"ttl\":\"3600\",\"version\":\"1\"}"}],"_postman_id":"3bba95f1-3d16-41b8-9cc9-3aa5619ec240"},{"name":"Get a cache settings object","id":"323b3a48-a228-40df-b238-e4238880db27","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/cache_settings/{{cache_settings_name}}","description":"<p>Get a specific cache settings object.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","cache_settings","{{cache_settings_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"1484507a-a3f9-4909-a3c1-3e5cb8ef8320","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/cache_settings/test-cache-setting","description":"Get a specific cache settings object.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"action\":\"cache\",\"cache_condition\":\"\",\"name\":\"test-cache-setting\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"stale_ttl\":\"1200\",\"ttl\":\"3600\",\"version\":\"1\"}"}],"_postman_id":"323b3a48-a228-40df-b238-e4238880db27"},{"name":"Update a cache settings object","id":"9b354ba0-5e36-4645-b6e9-6cd5ed3cf4c2","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/cache_settings/{{cache_settings_name}}","description":"<p>Update a specific cache settings object.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","cache_settings","{{cache_settings_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"1c744252-1d60-41a7-a434-0237217ec6a6","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/cache_settings/test-cache-setting","description":"Update a specific cache settings object.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"action\":\"cache\",\"cache_condition\":\"\",\"name\":\"test-cache-setting\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"stale_ttl\":\"1200\",\"ttl\":\"3600\",\"version\":\"1\"}"}],"_postman_id":"9b354ba0-5e36-4645-b6e9-6cd5ed3cf4c2"},{"name":"Delete a cache settings object","id":"ce5bad6f-07cf-4638-9627-e2e99828a85f","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/cache_settings/{{cache_settings_name}}","description":"<p>Delete a specific cache settings object.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","cache_settings","{{cache_settings_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"76754a56-d793-4b96-9096-6595cafa1222","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/cache_settings/test-cache-setting","description":"Delete a specific cache settings object.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"ce5bad6f-07cf-4638-9627-e2e99828a85f"}],"id":"3c5e4809-ddf1-4d36-8af5-28ae7ff5531c","description":"<p>Configures cache lifetime for objects stored in the Fastly cache, overriding cache freshness information that would otherwise be determined from cache-related headers on the HTTP response. When used in conjunction with conditions, cache settings objects provide detailed control over how long content persists in the cache.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>action</td>\n<td>string</td>\n<td>If set, will cause vcl_fetch to terminate after processing this rule with the return state specified. If not set, other configuration logic in vcl_fetch with a lower priority will run after this rule.</td>\n</tr>\n<tr>\n<td></td>\n<td>pass</td>\n<td>Do not cache the response and do not apply request collapsing to subsequent requests for the period specified in the TTL.</td>\n</tr>\n<tr>\n<td></td>\n<td>cache</td>\n<td>Proceed to save the object and deliver the response.</td>\n</tr>\n<tr>\n<td></td>\n<td>restart</td>\n<td>Discard the response and restart VCL processing in vcl_recv.</td>\n</tr>\n<tr>\n<td>cache_condition</td>\n<td>string</td>\n<td>Name of the cache condition controlling when this configuration applies.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>Name for the cache settings object.</td>\n</tr>\n<tr>\n<td>stale_ttl</td>\n<td>string</td>\n<td>Maximum time in seconds to continue to use a stale version of the object if future requests to your backend server fail (also known as 'stale if error').</td>\n</tr>\n<tr>\n<td>ttl</td>\n<td>string</td>\n<td>Maximum time to consider the object fresh in the cache (the cache 'time to live').</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>string</td>\n<td>String identifying a service version.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"3c5e4809-ddf1-4d36-8af5-28ae7ff5531c"},{"name":"Condition","item":[{"name":"List conditions","id":"f714cf57-f86c-4d4b-8243-903e743072e0","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/condition","description":"<p>Gets all conditions for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","condition"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"40966a08-fda2-4a0e-be8d-d7cf6004f74a","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/condition","description":"Gets all conditions for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"created_at\":\"2020-04-09T18:14:30.000Z\",\"updated_at\":\"2020-04-09T18:14:30.000Z\",\"deleted_at\":null,\"name\":\"test-condition\",\"priority\":\"10\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"statement\":\"req.url.basename == \\\"index.html\\\"\",\"type\":\"CACHE\",\"version\":\"1\",\"comment\":\"\"}]"}],"_postman_id":"f714cf57-f86c-4d4b-8243-903e743072e0"},{"name":"Create a condition","id":"f1533f1f-abf4-47bb-b2b2-a7f4ec5e1b3d","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/condition","description":"<p>Creates a new condition.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","condition"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"5857d994-cb8e-46b7-8281-57f32859ed23","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/condition","description":"Creates a new condition.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"created_at\":\"2020-04-09T18:14:30.000Z\",\"updated_at\":\"2020-04-09T18:14:30.000Z\",\"deleted_at\":null,\"name\":\"test-condition\",\"priority\":\"10\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"statement\":\"req.url.basename == \\\"index.html\\\"\",\"type\":\"CACHE\",\"version\":\"1\",\"comment\":\"\"}"}],"_postman_id":"f1533f1f-abf4-47bb-b2b2-a7f4ec5e1b3d"},{"name":"Describe a condition","id":"718e7c30-aac3-4a9e-bf8a-2b592d9dc20c","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/condition/{{condition_name}}","description":"<p>Gets the specified condition.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","condition","{{condition_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"cec913e9-6e2e-48a8-b511-56ea1a21080e","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/condition/test-condition","description":"Gets the specified condition.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"created_at\":\"2020-04-09T18:14:30.000Z\",\"updated_at\":\"2020-04-09T18:14:30.000Z\",\"deleted_at\":null,\"name\":\"test-condition\",\"priority\":\"10\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"statement\":\"req.url.basename == \\\"index.html\\\"\",\"type\":\"CACHE\",\"version\":\"1\",\"comment\":\"\"}"}],"_postman_id":"718e7c30-aac3-4a9e-bf8a-2b592d9dc20c"},{"name":"Update a condition","id":"224f9518-5f3c-4a91-870a-e7c290b9f37d","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/condition/{{condition_name}}","description":"<p>Updates the specified condition.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","condition","{{condition_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"0a65ebd4-2eea-46f6-8222-e517436534a9","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/condition/test-condition","description":"Updates the specified condition.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"created_at\":\"2020-04-09T18:14:30.000Z\",\"updated_at\":\"2020-04-09T18:14:30.000Z\",\"deleted_at\":null,\"name\":\"test-condition\",\"priority\":\"10\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"statement\":\"req.url.basename == \\\"index.html\\\"\",\"type\":\"CACHE\",\"version\":\"1\",\"comment\":\"\"}"}],"_postman_id":"224f9518-5f3c-4a91-870a-e7c290b9f37d"},{"name":"Delete a condition","id":"47833f3b-5018-4e0b-80a1-fc89fe02959d","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/condition/{{condition_name}}","description":"<p>Deletes the specified condition.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","condition","{{condition_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"26102a2b-a05f-4dec-b367-cde87632d48d","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/condition/test-condition","description":"Deletes the specified condition.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"47833f3b-5018-4e0b-80a1-fc89fe02959d"}],"id":"acbfb72b-405d-49aa-a989-627d97d3bb90","description":"<p>Conditions are used to control whether logic defined in configured VCL objects is applied for a particular client request. A condition contains a VCL conditional expression that evaluates to either true or false and is used to determine whether the condition is met. The type of the condition determines where it is executed and the VCL variables that can be evaluated as part of the conditional logic.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>comment</td>\n<td>string</td>\n<td>A freeform descriptive note.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>Name of the condition. Required.</td>\n</tr>\n<tr>\n<td>priority</td>\n<td>string</td>\n<td>A numeric string. Priority determines execution order. Lower numbers execute first.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>statement</td>\n<td>string</td>\n<td>A conditional expression in VCL used to determine if the condition is met.</td>\n</tr>\n<tr>\n<td>type</td>\n<td>string</td>\n<td>Type of the condition.</td>\n</tr>\n<tr>\n<td></td>\n<td>REQUEST</td>\n<td>Make the condition available everywhere. This type of condition may only reference VCL variables that are accessible throughout the VCL flow.</td>\n</tr>\n<tr>\n<td></td>\n<td>CACHE</td>\n<td>Make the condition available in the vcl_fetch subroutine at the fetch phase of the VCL flow. This type of condition may access VCL variables in the beresp namespace.</td>\n</tr>\n<tr>\n<td></td>\n<td>RESPONSE</td>\n<td>Make the condition available in the vcl_deliver subroutine at the delivery phase of the VCL flow. This type of condition may access VCL variables in the resp namespace.</td>\n</tr>\n<tr>\n<td></td>\n<td>PREFETCH</td>\n<td>Make the condition available in the vcl_miss and vcl_pass subroutines at the prefetch phase of the VCL flow. This type of condition may access VCL variables in the bereq namespace.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>string</td>\n<td>A numeric string that represents the service version.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"acbfb72b-405d-49aa-a989-627d97d3bb90"},{"name":"VCL Diff","item":[{"name":"Get a comparison of the VCL changes between two service versions","id":"e761e73d-993c-4823-9afc-ef99ca5297da","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/vcl/diff/from/{{from_version_id}}/to/{{to_version_id}}?format","description":"<p><strong><a href=\"https://developer.fastly.com/reference/api/vcl-services/diff/#vcl-diff-service-versions\">🔗 latest documentation</a></strong></p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","vcl","diff","from","{{from_version_id}}","to","{{to_version_id}}"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Optional method to format the diff field.</p>\n","type":"text/plain"},"key":"format"}],"variable":[]}},"response":[{"id":"53d38f25-e6a8-49cc-997e-f1c3c19b5484","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/vcl/diff/from/1/to/2?format","protocol":"https","host":["api","fastly","com"],"path":["service","SU1Z0isxPaozGVKXdv0eY","vcl","diff","from","1","to","2"],"query":[{"key":"format","description":"Optional method to format the diff field."}]},"description":"**[🔗 latest documentation](https://developer.fastly.com/reference/api/vcl-services/diff/#vcl-diff-service-versions)**\n\n> **Authorization**: Requires [API token](/reference/api/auth-tokens).\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"from\":1,\"to\":2,\"format\":\"text\",\"diff\":\"pragma optional_param geoip_opt_in true;\\npragma optional_param fetchless_purge_all 1;\\npragma optional_param default_ssl_check_cert 1;\\npragma optional_param max_backends 5;\\npragma optional_param customer_id \\\"5d357e4d57a38c819912a\\\";\\nC!\\nW!\\n# Backends\\nbackend F_Host_1 {\\n    .between_bytes_timeout = 10s;\\n    .connect_timeout = 1s;\\n    .first_byte_timeout = 15s;\\n    .host = \\\"173.230.153.134\\\";\\n    .max_connections = 200;\\n    .port = \\\"80\\\";\\n}\\nsub vcl_recv {\\n#--FASTLY RECV BEGIN\\n  if (req.restarts == 0) {\\n    if (!req.http.X-Timer) {\\n      set req.http.X-Timer = \\\"S\\\" time.start.sec \\\".\\\" time.start.usec_frac;\\n    }\\n    set req.http.X-Timer = req.http.X-Timer \\\",VS0\\\";\\n  }\\n  declare local var.fastly_req_do_shield BOOL;\\n  set var.fastly_req_do_shield = (req.restarts == 0);\\n  # default conditions\\n  set req.backend = F_Host_1;\\n  # Header rewrite Test Header : 10\\n  set req.http.X-My-Test-Header = \\\"testing\\\";\\n  # end default conditions\\n#--FASTLY RECV END\\n    if (req.request != \\\"HEAD\\\" && req.request != \\\"GET\\\" && req.request != \\\"FASTLYPURGE\\\") {\\n      return(pass);\\n    }\\n    return(lookup);\\n}\\n\\n\\n...\\n\\n\\nsub vcl_fetch {\\n#--FASTLY FETCH BEGIN\\n-  if (beresp.status >= 500 && beresp.status < 600) {\\n-\\n-    if (stale.exists) {\\n-      return(deliver_stale);\\n-    }\\n-\\n-    if (req.restarts < 1 && (req.request == \\\"GET\\\" || req.request ==\\n\\\"HEAD\\\")) {\\n-      restart;\\n-    }\\n-\\n-  }\\n-  set beresp.stale_if_error = 43200s;\\n# record which cache ran vcl_fetch for this object and when\\n  set beresp.http.Fastly-Debug-Path = \\\"(F \\\" server.identity \\\" \\\"\\nnow.sec \\\") \\\" if(beresp.http.Fastly-Debug-Path,\\nberesp.http.Fastly-Debug-Path, \\\"\\\");\\n# generic mechanism to vary on something\\n  if (req.http.Fastly-Vary-String) {\\n    if (beresp.http.Vary) {\\n      set beresp.http.Vary = \\\"Fastly-Vary-String, \\\"  beresp.http.Vary;\\n    } else {\\n      set beresp.http.Vary = \\\"Fastly-Vary-String, \\\";\\n    }\\n  }\\n#--FASTLY FETCH END\\n  if ((beresp.status == 500 || beresp.status == 503) && req.restarts < 1\\n&& (req.request == \\\"GET\\\" || req.request == \\\"HEAD\\\")) {\\n    restart;\\n  }\\n  if(req.restarts > 0 ) {\\n    set beresp.http.Fastly-Restarts = req.restarts;\\n  }\\n  if (beresp.http.Set-Cookie) {\\n    set req.http.Fastly-Cachetype = \\\"SETCOOKIE\\\";\\n    return (pass);\\n  }\\n  if (beresp.http.Cache-Control ~ \\\"private\\\") {\\n    set req.http.Fastly-Cachetype = \\\"PRIVATE\\\";\\n    return (pass);\\n  }\\n  if (beresp.status == 500 || beresp.status == 503) {\\n    set req.http.Fastly-Cachetype = \\\"ERROR\\\";\\n    set beresp.ttl = 1s;\\n    set beresp.grace = 5s;\\n    return (deliver);\\n  }\\n  if (beresp.http.Expires || beresp.http.Surrogate-Control ~ \\\"max-age\\\"\\n|| beresp.http.Cache-Control ~\\\"(s-maxage|max-age)\\\") {\\n    # keep the ttl here\\n  } else {\\n        # apply the default ttl\\n    set beresp.ttl = 3600s;\\n  }\\n  return(deliver);\\n}\\n\\n\\n...\\n\\n\\nsub vcl_error {\\n#--FASTLY ERROR BEGIN\\n-  if (obj.status >= 500 && obj.status < 600) {\\n-    if (stale.exists) {\\n-      return(deliver_stale);\\n-    }\\n-  }\\n  if (obj.status == 801) {\\n     set obj.status = 301;\\n     set obj.response = \\\"Moved Permanently\\\";\\n     set obj.http.Location = \\\"https://\\\" req.http.host req.url;\\n     synthetic {\\\"\\\"};\\n     return (deliver);\\n  }\\n  if (req.http.Fastly-Restart-On-Error) {\\n    if (obj.status == 503 && req.restarts == 0) {\\n      restart;\\n    }\\n  }\\n  {\\n    if (obj.status == 550) {\\n      return(deliver);\\n    }\\n  }\\n#--FASTLY ERROR END\\n}\\n\\n\\n...\\n\\n\\nsub vcl_log {\\n#--FASTLY LOG BEGIN\\n  # default response conditions\\n#--FASTLY LOG END\\n}\\nsub vcl_hash {\\n#--FASTLY HASH BEGIN\\n  #if unspecified fall back to normal\\n  {\\n    set req.hash += req.url;\\n    set req.hash += req.http.host;\\n    set req.hash += req.vcl.generation;\\n    return (hash);\\n  }\\n#--FASTLY HASH END\\n}\\n\"}"}],"_postman_id":"e761e73d-993c-4823-9afc-ef99ca5297da"}],"id":"8f6e5774-598d-49d2-b4b3-88f665debd50","description":"<p>Compare the changes in generated VCL between two versions of a service. This is sometimes called a \"diff\" because the comparison may highlight \"differences\" between the versions. To compare the configuration changes between two versions of a service represented in YAML format instead, use the related diff endpoint.</p>\n<blockquote>\n<p><strong>Authorization</strong>: Requires <a href=\"/reference/api/auth-tokens\">API token</a>.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>diff</td>\n<td>string</td>\n<td>The differences between two specified versions.</td>\n</tr>\n<tr>\n<td>format</td>\n<td>string</td>\n<td>The format in which compared VCL changes are being returned in.</td>\n</tr>\n<tr>\n<td>from</td>\n<td>integer</td>\n<td>The version number of the service to which changes in the generated VCL are being compared.</td>\n</tr>\n<tr>\n<td>to</td>\n<td>integer</td>\n<td>The version number of the service from which changes in the generated VCL are being compared.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"8f6e5774-598d-49d2-b4b3-88f665debd50"},{"name":"Gzip","item":[{"name":"List gzip configurations","id":"cd2fb39b-eca3-4d8d-b136-d79c57971a5a","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/gzip","description":"<p>List all gzip configurations for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","gzip"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"12717ff5-3a92-4d90-975f-ac99f7433778","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/gzip","description":"List all gzip configurations for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"cache_condition\":\"\",\"content_types\":\"text/html text/css application/javascript\",\"extensions\":\"html css js\",\"name\":\"test-gzip\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\"}]"}],"_postman_id":"cd2fb39b-eca3-4d8d-b136-d79c57971a5a"},{"name":"Create a gzip configuration","id":"8546f355-b1ad-4ed2-8be3-00249bade38e","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/gzip","description":"<p>Create a named gzip configuration on a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","gzip"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"d6d92af6-9614-4fbd-b3d9-18e8119fc87f","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/gzip","description":"Create a named gzip configuration on a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"cache_condition\":\"\",\"content_types\":\"text/html text/css application/javascript\",\"extensions\":\"html css js\",\"name\":\"test-gzip\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\"}"}],"_postman_id":"8546f355-b1ad-4ed2-8be3-00249bade38e"},{"name":"Get a gzip configuration","id":"a6d28c10-6c4f-4da8-a2a7-2191b12711da","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/gzip/{{gzip_name}}","description":"<p>Get the gzip configuration for a particular service, version, and name.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","gzip","{{gzip_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"37f13055-cf8c-4320-83b4-08b23ec86f0e","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/gzip/test-gzip","description":"Get the gzip configuration for a particular service, version, and name.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"cache_condition\":\"\",\"content_types\":\"text/html text/css application/javascript\",\"extensions\":\"html css js\",\"name\":\"test-gzip\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\"}"}],"_postman_id":"a6d28c10-6c4f-4da8-a2a7-2191b12711da"},{"name":"Update a gzip configuration","id":"64641496-9e02-45a2-b958-14e65ad1e665","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/gzip/{{gzip_name}}","description":"<p>Update a named gzip configuration on a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","gzip","{{gzip_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"06d54abd-a25a-4bc3-81e0-dba28a67b15a","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/gzip/test-gzip","description":"Update a named gzip configuration on a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"cache_condition\":\"\",\"content_types\":\"text/html\",\"extensions\":\"html\",\"name\":\"test-gzip\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\"}"}],"_postman_id":"64641496-9e02-45a2-b958-14e65ad1e665"},{"name":"Delete a gzip configuration","id":"7eb7517d-ad9b-4be7-93ea-452a580c13b8","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/gzip/{{gzip_name}}","description":"<p>Delete a named gzip configuration on a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","gzip","{{gzip_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"6892cee5-def2-4f3a-a954-acc0e36726d6","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/gzip/test-gzip","description":"Delete a named gzip configuration on a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"7eb7517d-ad9b-4be7-93ea-452a580c13b8"}],"id":"184a44c4-825f-4b78-8123-a55079974673","description":"<p>Gzip configuration allows you to choose resources to automatically compress.  For more information about compressing and decompressing data with Fastly, check out our concept guide to compression.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>cache_condition</td>\n<td>string</td>\n<td>Name of the cache condition controlling when this configuration applies.</td>\n</tr>\n<tr>\n<td>content_types</td>\n<td>string</td>\n<td>Space-separated list of content types to compress. If you omit this field a default list will be used.</td>\n</tr>\n<tr>\n<td>extensions</td>\n<td>string</td>\n<td>Space-separated list of file extensions to compress. If you omit this field a default list will be used.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>Name of the gzip configuration.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>string</td>\n<td>String identifying a service version.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"184a44c4-825f-4b78-8123-a55079974673"},{"name":"Header","item":[{"name":"List Header objects","id":"37be7f05-fe5a-405e-a338-f3b7edd9bdd2","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/header","description":"<p>Retrieves all Header objects for a particular Version of a Service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","header"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"96a4760a-d6b5-4c9b-a330-792a0b985399","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/header","description":"Retrieves all Header objects for a particular Version of a Service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"action\":\"set\",\"cache_condition\":null,\"dst\":\"http.header-name\",\"ignore_if_set\":\"0\",\"name\":\"test-header\",\"priority\":\"100\",\"regex\":\"\",\"request_condition\":null,\"response_condition\":null,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"src\":\"client.ip\",\"substitution\":\"\",\"type\":\"request\",\"version\":\"1\"}]"}],"_postman_id":"37be7f05-fe5a-405e-a338-f3b7edd9bdd2"},{"name":"Create a Header object","id":"27f7fc1f-3833-4e7d-8bd2-3999e8bb2ba3","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/header","description":"<p>Creates a new Header object.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","header"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"647c53ad-8aa1-4deb-8652-dfe706ebbaed","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/header","description":"Creates a new Header object.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"action\":\"set\",\"cache_condition\":null,\"dst\":\"http.header-name\",\"ignore_if_set\":\"0\",\"name\":\"test-header\",\"priority\":\"100\",\"regex\":\"\",\"request_condition\":null,\"response_condition\":null,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"src\":\"client.ip\",\"substitution\":\"\",\"type\":\"request\",\"version\":\"1\"}"}],"_postman_id":"27f7fc1f-3833-4e7d-8bd2-3999e8bb2ba3"},{"name":"Get a Header object","id":"75eb1b8b-61ef-46b1-98c1-7265fad2c4f5","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/header/{{header_name}}","description":"<p>Retrieves a Header object by name.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","header","{{header_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"858703d3-043a-4542-80ce-52fb45fd0fb2","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/header/test-header","description":"Retrieves a Header object by name.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"action\":\"set\",\"cache_condition\":null,\"dst\":\"http.header-name\",\"ignore_if_set\":\"0\",\"name\":\"test-header\",\"priority\":\"100\",\"regex\":\"\",\"request_condition\":null,\"response_condition\":null,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"src\":\"client.ip\",\"substitution\":\"\",\"type\":\"request\",\"version\":\"1\"}"}],"_postman_id":"75eb1b8b-61ef-46b1-98c1-7265fad2c4f5"},{"name":"Update a Header object","id":"50701a54-e7d8-4b2e-9d87-ec722eaa4831","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/header/{{header_name}}","description":"<p>Modifies an existing Header object by name.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","header","{{header_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"989d2d5c-44be-48e7-a7b1-85684e308a14","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/header/test-header","description":"Modifies an existing Header object by name.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"action\":\"set\",\"cache_condition\":null,\"dst\":\"http.header-name\",\"ignore_if_set\":\"0\",\"name\":\"updated-test-header\",\"priority\":\"10\",\"regex\":\"\",\"request_condition\":null,\"response_condition\":null,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"src\":\"client.ip\",\"substitution\":\"\",\"type\":\"request\",\"version\":\"1\"}"}],"_postman_id":"50701a54-e7d8-4b2e-9d87-ec722eaa4831"},{"name":"Delete a Header object","id":"00b7020c-33cc-4210-9523-ecbe9cf545c2","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/header/{{header_name}}","description":"<p>Deletes a Header object by name.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","header","{{header_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"61ddfb41-4d51-4bea-985d-303e14a78f14","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/header/test-header","description":"Deletes a Header object by name.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"00b7020c-33cc-4210-9523-ecbe9cf545c2"}],"id":"b64dc0a3-43a1-485f-ace3-ce3fc6b19982","description":"<p>Header objects are used to add, modify, or delete headers from requests and responses. The header content can be simple strings or be derived from variables inside Varnish. Regular expressions can be used to customize the headers even further.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>action</td>\n<td>string</td>\n<td>Accepts a string value.</td>\n</tr>\n<tr>\n<td></td>\n<td>set</td>\n<td>Sets (or resets) a header.</td>\n</tr>\n<tr>\n<td></td>\n<td>append</td>\n<td>Appends to an existing header.</td>\n</tr>\n<tr>\n<td></td>\n<td>delete</td>\n<td>Delete a header.</td>\n</tr>\n<tr>\n<td></td>\n<td>regex</td>\n<td>Perform a single regex replacement on a header.</td>\n</tr>\n<tr>\n<td></td>\n<td>regex_repeat</td>\n<td>Perform a global regex replacement on a header.</td>\n</tr>\n<tr>\n<td>cache_condition</td>\n<td>string</td>\n<td>Name of the cache condition controlling when this configuration applies.</td>\n</tr>\n<tr>\n<td>dst</td>\n<td>string</td>\n<td>Header to set.</td>\n</tr>\n<tr>\n<td>ignore_if_set</td>\n<td>string</td>\n<td>Don't add the header if it is added already. Only applies to 'set' action. Numerical value (\"0\" = false, \"1\" = true).</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>A handle to refer to this Header object.</td>\n</tr>\n<tr>\n<td>priority</td>\n<td>string</td>\n<td>Priority determines execution order. Lower numbers execute first.</td>\n</tr>\n<tr>\n<td>regex</td>\n<td>string</td>\n<td>Regular expression to use. Only applies to regex and regex_repeat actions.</td>\n</tr>\n<tr>\n<td>request_condition</td>\n<td>string</td>\n<td>Condition which, if met, will select this configuration during a request. Optional.</td>\n</tr>\n<tr>\n<td>response_condition</td>\n<td>string</td>\n<td>Optional name of a response condition to apply.</td>\n</tr>\n<tr>\n<td>src</td>\n<td>string</td>\n<td>Variable to be used as a source for the header content. Does not apply to delete action.</td>\n</tr>\n<tr>\n<td>substitution</td>\n<td>string</td>\n<td>Value to substitute in place of regular expression. Only applies to regex and regex_repeat actions.</td>\n</tr>\n<tr>\n<td>type</td>\n<td>string</td>\n<td>Accepts a string value.</td>\n</tr>\n<tr>\n<td></td>\n<td>request</td>\n<td>Performs on the request before lookup occurs.</td>\n</tr>\n<tr>\n<td></td>\n<td>cache</td>\n<td>Performs on the response before it's stored in the cache.</td>\n</tr>\n<tr>\n<td></td>\n<td>response</td>\n<td>Performs on the response before delivering to the client.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>string</td>\n<td>String identifying a service version.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"b64dc0a3-43a1-485f-ace3-ce3fc6b19982"},{"name":"HTTP3/QUIC","item":[{"name":"Get HTTP/3 status","id":"c6efff98-7fdc-4950-8e31-21b4c820436f","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/http3","description":"<p>Get the status of HTTP/3 (QUIC) support for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","http3"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"b644b469-514b-47ac-a900-34dfa331cbf2","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/http3","description":"Get the status of HTTP/3 (QUIC) support for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"feature_revision\":1,\"feature_update_available\":false,\"id\":\"6QI9o6ZZrSP3y9gI0OhMwZ\",\"service_id\":\"1ry8Ui9rAiAsJEc6Ze99W1\",\"version\":1,\"created_at\":\"2021-01-25T18:24:38.000Z\",\"updated_at\":\"2021-01-25T18:24:38.000Z\"}"}],"_postman_id":"c6efff98-7fdc-4950-8e31-21b4c820436f"},{"name":"Enable support for HTTP/3","id":"ec88561e-424d-4fd1-be3b-bf5dd430602c","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/http3","description":"<p>Enable HTTP/3 (QUIC) support for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","http3"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"08e90ae8-0464-47ef-aa68-0866edef24ba","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/http3","description":"Enable HTTP/3 (QUIC) support for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"feature_revision\":1,\"feature_update_available\":false,\"id\":\"6QI9o6ZZrSP3y9gI0OhMwZ\",\"service_id\":\"1ry8Ui9rAiAsJEc6Ze99W1\",\"version\":1,\"created_at\":\"2021-01-25T18:24:38.000Z\",\"updated_at\":\"2021-01-25T18:24:38.000Z\"}"}],"_postman_id":"ec88561e-424d-4fd1-be3b-bf5dd430602c"},{"name":"Disable support for HTTP/3","id":"2fbe94c8-7e88-44fa-888a-47bc99bdaed2","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/http3","description":"<p>Disable HTTP/3 (QUIC) support for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","http3"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"5fd60210-d96c-41a1-9ac6-73eac30e695b","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/http3","description":"Disable HTTP/3 (QUIC) support for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"2fbe94c8-7e88-44fa-888a-47bc99bdaed2"}],"id":"5c8ef4d9-2a5e-4f59-ad3a-cb8356620bd8","description":"<p>Supports the use of the HTTP/3 (QUIC) protocol.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>feature_revision</td>\n<td>integer</td>\n<td>Revision number of the HTTP/3 feature implementation. Defaults to the most recent revision.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>integer</td>\n<td>Integer identifying a service version.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"5c8ef4d9-2a5e-4f59-ad3a-cb8356620bd8"},{"name":"Rate Limiter","item":[{"name":"List rate limiters","id":"744b0fae-09fe-42ef-bdf6-5e4604661ddc","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/rate-limiters","description":"<p>List all rate limiters for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","rate-limiters"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"c19f8ef0-6563-42de-9e0d-4bcd06754263","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/rate-limiters","description":"List all rate limiters for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"feature_revision\":1,\"feature_update_available\":false,\"name\":\"test-rate-limiter\",\"uri_dictionary_name\":null,\"http_methods\":[\"POST\",\"PUT\",\"PATCH\",\"DELETE\"],\"rps_limit\":10000,\"window_size\":10,\"client_key\":[\"req.http.Fastly-Client-IP\"],\"penalty_box_duration\":30,\"action\":\"response\",\"response\":{\"status\":429,\"content_type\":\"application/json\",\"content\":\"{\\\"reason\\\": \\\"Too many requests\\\"}\"},\"response_object_name\":null,\"id\":\"6QI9o6ZZrSP3y9gI0OhMwZ\",\"service_id\":\"1ry8Ui9rAiAsJEc6Ze99W1\",\"version\":1,\"created_at\":\"2021-01-25T18:24:38.000Z\",\"updated_at\":\"2021-01-25T18:24:38.000Z\"}]"}],"_postman_id":"744b0fae-09fe-42ef-bdf6-5e4604661ddc"},{"name":"Create a rate limiter","id":"029f78d8-fb7f-4257-9a5e-9063ccba6a46","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/rate-limiters","description":"<p>Create a rate limiter for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","rate-limiters"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"57e0909b-b911-43c7-aba4-ccb2c896105a","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/rate-limiters","description":"Create a rate limiter for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"feature_revision\":1,\"feature_update_available\":false,\"name\":\"test-rate-limiter\",\"uri_dictionary_name\":null,\"http_methods\":[\"POST\",\"PUT\",\"PATCH\",\"DELETE\"],\"rps_limit\":10000,\"window_size\":10,\"client_key\":[\"req.http.Fastly-Client-IP\"],\"penalty_box_duration\":30,\"action\":\"response\",\"response\":{\"status\":429,\"content_type\":\"application/json\",\"content\":\"{\\\"reason\\\": \\\"Too many requests\\\"}\"},\"response_object_name\":null,\"id\":\"6QI9o6ZZrSP3y9gI0OhMwZ\",\"service_id\":\"1ry8Ui9rAiAsJEc6Ze99W1\",\"version\":1,\"created_at\":\"2021-01-25T18:24:38.000Z\",\"updated_at\":\"2021-01-25T18:24:38.000Z\"}"}],"_postman_id":"029f78d8-fb7f-4257-9a5e-9063ccba6a46"},{"name":"Get a rate limiter","id":"860f9d8e-2277-4ad6-8a5d-123f6e843a42","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/rate-limiters/{{rate_limiter_id}}","description":"<p>Get a rate limiter by its ID.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["rate-limiters","{{rate_limiter_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"d4b41b13-17fa-4a33-85c7-c27c63818a8d","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/rate-limiters/s7aqgcJjqqKhwiTRMaP11","description":"Get a rate limiter by its ID.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"feature_revision\":1,\"feature_update_available\":false,\"name\":\"test-rate-limiter\",\"uri_dictionary_name\":null,\"http_methods\":[\"POST\",\"PUT\",\"PATCH\",\"DELETE\"],\"rps_limit\":10000,\"window_size\":10,\"client_key\":[\"req.http.Fastly-Client-IP\"],\"penalty_box_duration\":30,\"action\":\"response\",\"response\":{\"status\":429,\"content_type\":\"application/json\",\"content\":\"{\\\"reason\\\": \\\"Too many requests\\\"}\"},\"response_object_name\":null,\"id\":\"6QI9o6ZZrSP3y9gI0OhMwZ\",\"service_id\":\"1ry8Ui9rAiAsJEc6Ze99W1\",\"version\":1,\"created_at\":\"2021-01-25T18:24:38.000Z\",\"updated_at\":\"2021-01-25T18:24:38.000Z\"}"}],"_postman_id":"860f9d8e-2277-4ad6-8a5d-123f6e843a42"},{"name":"Update a rate limiter","id":"89b4fb47-c15c-4ddf-853f-0a872b32984f","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/rate-limiters/{{rate_limiter_id}}","description":"<p>Update a rate limiter by its ID.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["rate-limiters","{{rate_limiter_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"517392b8-2183-4bdc-bf84-0d4fd894f148","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/rate-limiters/s7aqgcJjqqKhwiTRMaP11","description":"Update a rate limiter by its ID.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"feature_revision\":1,\"feature_update_available\":false,\"name\":\"test-rate-limiter\",\"uri_dictionary_name\":null,\"http_methods\":[\"POST\",\"PUT\",\"PATCH\",\"DELETE\"],\"rps_limit\":10000,\"window_size\":10,\"client_key\":[\"req.http.Fastly-Client-IP\"],\"penalty_box_duration\":30,\"action\":\"response\",\"response\":{\"status\":429,\"content_type\":\"application/json\",\"content\":\"{\\\"reason\\\": \\\"Too many requests\\\"}\"},\"response_object_name\":null,\"id\":\"6QI9o6ZZrSP3y9gI0OhMwZ\",\"service_id\":\"1ry8Ui9rAiAsJEc6Ze99W1\",\"version\":1,\"created_at\":\"2021-01-25T18:24:38.000Z\",\"updated_at\":\"2021-01-25T18:24:38.000Z\"}"}],"_postman_id":"89b4fb47-c15c-4ddf-853f-0a872b32984f"},{"name":"Delete a rate limiter","id":"fdd88223-d6d1-4ebd-ac75-71cc1fb6f524","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/rate-limiters/{{rate_limiter_id}}","description":"<p>Delete a rate limiter by its ID.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["rate-limiters","{{rate_limiter_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"25eac743-7d2b-4f07-865e-741836925eed","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/rate-limiters/s7aqgcJjqqKhwiTRMaP11","description":"Delete a rate limiter by its ID.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"fdd88223-d6d1-4ebd-ac75-71cc1fb6f524"}],"id":"914db26e-5b5b-4a82-8ea2-99ae0372b656","description":"<p>Rate limiters add configurable origin request rate limiting to a service. This information is part of a limited availability release. For more information, see our product and feature lifecycle descriptions. To use this feature you must purchase a Professional or Premier Platform subscription for either Signal Sciences Cloud WAF or Signal Sciences Next-Gen WAF and have a paid account with a contract for full-site delivery.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>action</td>\n<td>string</td>\n<td>The action to take when a rate limiter violation is detected.</td>\n</tr>\n<tr>\n<td></td>\n<td>response</td>\n<td>Prevent an origin request.</td>\n</tr>\n<tr>\n<td></td>\n<td>response_object</td>\n<td>Prevent an origin request.</td>\n</tr>\n<tr>\n<td></td>\n<td>log_only</td>\n<td>Logs the violation, but allow the origin request to continue.</td>\n</tr>\n<tr>\n<td>client_key</td>\n<td>array</td>\n<td>Array of VCL variables used to generate a counter key to identify a client. Example variables include req.http.Fastly-Client-IP, req.http.User-Agent, or a custom header like req.http.API-Key.</td>\n</tr>\n<tr>\n<td>feature_revision</td>\n<td>integer</td>\n<td>Revision number of the rate limiting feature implementation. Defaults to the most recent revision.</td>\n</tr>\n<tr>\n<td>http_methods</td>\n<td>array</td>\n<td>Array of HTTP methods to apply rate limiting to.</td>\n</tr>\n<tr>\n<td>logger_type</td>\n<td>string</td>\n<td>Name of the type of logging endpoint to be used when action is log_only. The logging endpoint type is used to determine the appropriate log format to use when emitting log entries.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>A human readable name for the rate limiting rule.</td>\n</tr>\n<tr>\n<td>penalty_box_duration</td>\n<td>integer</td>\n<td>Length of time in minutes that the rate limiter is in effect after the initial violation is detected.</td>\n</tr>\n<tr>\n<td>response</td>\n<td>object</td>\n<td>Custom response to be sent when the rate limit is exceeded. Required if action is response.</td>\n</tr>\n<tr>\n<td>response_object_name</td>\n<td>string</td>\n<td>Name of existing response object. Required if action is response_object. Note that the rate limiter response is only updated to reflect the response object content when saving the rate limiter configuration.</td>\n</tr>\n<tr>\n<td>rps_limit</td>\n<td>integer</td>\n<td>Upper limit of requests per second allowed by the rate limiter.</td>\n</tr>\n<tr>\n<td>uri_dictionary_name</td>\n<td>string</td>\n<td>The name of a Dictionary containing URIs as keys. If not defined or null, all origin URIs will be rate limited.</td>\n</tr>\n<tr>\n<td>window_size</td>\n<td>integer</td>\n<td>Number of seconds during which the RPS limit must be exceeded in order to trigger a violation.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the rate limiter.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>integer</td>\n<td>Integer identifying a service version.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"914db26e-5b5b-4a82-8ea2-99ae0372b656"},{"name":"Request settings","item":[{"name":"List Request Settings objects","id":"d3d7cca1-cf4f-4975-a671-1deac3461030","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/request_settings","description":"<p>Returns a list of all Request Settings objects for the given service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","request_settings"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"99ebb3e4-edb6-41b5-a968-3a01c7039979","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/request_settings","description":"Returns a list of all Request Settings objects for the given service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"action\":\"lookup\",\"bypass_busy_wait\":\"0\",\"default_host\":null,\"force_miss\":\"0\",\"force_ssl\":\"1\",\"geo_headers\":\"1\",\"hash_keys\":null,\"max_stale_age\":\"60\",\"name\":\"test-request-setting\",\"request_condition\":\"\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"timer_support\":\"0\",\"version\":\"1\",\"xff\":\"append\"}]"}],"_postman_id":"d3d7cca1-cf4f-4975-a671-1deac3461030"},{"name":"Create a Request Settings object","id":"2bd5dd55-414f-4cc9-a314-fbd7ffb504f6","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/request_settings","description":"<p>Creates a new Request Settings object.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","request_settings"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"855600e6-2d6f-4b1c-9d6c-c472bff1d274","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/request_settings","description":"Creates a new Request Settings object.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"action\":\"lookup\",\"bypass_busy_wait\":\"0\",\"default_host\":null,\"force_miss\":\"0\",\"force_ssl\":\"1\",\"geo_headers\":\"1\",\"hash_keys\":null,\"max_stale_age\":\"60\",\"name\":\"test-request-setting\",\"request_condition\":\"\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"timer_support\":\"0\",\"version\":\"1\",\"xff\":\"append\"}"}],"_postman_id":"2bd5dd55-414f-4cc9-a314-fbd7ffb504f6"},{"name":"Get a Request Settings object","id":"7009d39a-960a-49be-ae4d-6891b80e14a2","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/request_settings/{{request_settings_name}}","description":"<p>Gets the specified Request Settings object.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","request_settings","{{request_settings_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"f2d9792b-4e3f-4c94-b23c-4545e407afc8","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/request_settings/test-request-setting","description":"Gets the specified Request Settings object.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"action\":\"lookup\",\"bypass_busy_wait\":\"0\",\"default_host\":null,\"force_miss\":\"0\",\"force_ssl\":\"1\",\"geo_headers\":\"1\",\"hash_keys\":null,\"max_stale_age\":\"60\",\"name\":\"test-request-setting\",\"request_condition\":\"\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"timer_support\":\"0\",\"version\":\"1\",\"xff\":\"append\"}"}],"_postman_id":"7009d39a-960a-49be-ae4d-6891b80e14a2"},{"name":"Update a Request Settings object","id":"1f37e80a-b340-4782-be9e-2458628c3d59","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/request_settings/{{request_settings_name}}","description":"<p>Updates the specified Request Settings object.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","request_settings","{{request_settings_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"012ba110-53eb-4cf0-92e7-c26f86de40f5","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/request_settings/test-request-setting","description":"Updates the specified Request Settings object.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"action\":\"lookup\",\"bypass_busy_wait\":\"0\",\"default_host\":null,\"force_miss\":\"0\",\"force_ssl\":\"1\",\"geo_headers\":\"1\",\"hash_keys\":null,\"max_stale_age\":\"120\",\"name\":\"updated-test-request-setting\",\"request_condition\":\"\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"timer_support\":\"0\",\"version\":\"1\",\"xff\":\"append\"}"}],"_postman_id":"1f37e80a-b340-4782-be9e-2458628c3d59"},{"name":"Delete a Request Settings object","id":"7234a4a0-fd68-472e-8820-ddfc1a39df23","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/request_settings/{{request_settings_name}}","description":"<p>Removes the specified Request Settings object.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","request_settings","{{request_settings_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"a45cec07-3fde-42be-8586-9652fa271ed5","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/request_settings/test-request-setting","description":"Removes the specified Request Settings object.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"7234a4a0-fd68-472e-8820-ddfc1a39df23"}],"id":"6deee4bb-eef8-4447-83dc-da22f074bc9c","description":"<p>Settings used to customize Fastly's request handling. When used with Conditions the Request Settings object allows you to fine tune how specific types of requests are handled.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>action</td>\n<td>string</td>\n<td>Allows you to terminate request handling and immediately perform an action.</td>\n</tr>\n<tr>\n<td></td>\n<td>lookup</td>\n<td>Perform a cache lookup.</td>\n</tr>\n<tr>\n<td></td>\n<td>pass</td>\n<td>Ignore the cache completely.</td>\n</tr>\n<tr>\n<td>default_host</td>\n<td>string</td>\n<td>Sets the host header.</td>\n</tr>\n<tr>\n<td>hash_keys</td>\n<td>string</td>\n<td>Comma separated list of varnish request object fields that should be in the hash key.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>Name for the request settings.</td>\n</tr>\n<tr>\n<td>request_condition</td>\n<td>string</td>\n<td>Condition which, if met, will select this configuration during a request. Optional.</td>\n</tr>\n<tr>\n<td>xff</td>\n<td>string</td>\n<td>Short for X-Forwarded-For.</td>\n</tr>\n<tr>\n<td>bypass_busy_wait</td>\n<td>integer</td>\n<td>Disable collapsed forwarding, so you don't wait for other objects to origin.</td>\n</tr>\n<tr>\n<td>force_miss</td>\n<td>integer</td>\n<td>Allows you to force a cache miss for the request. Replaces the item in the cache if the content is cacheable.</td>\n</tr>\n<tr>\n<td>force_ssl</td>\n<td>integer</td>\n<td>Forces the request use SSL (redirects a non-SSL to SSL).</td>\n</tr>\n<tr>\n<td>geo_headers</td>\n<td>integer</td>\n<td>Injects Fastly-Geo-Country, Fastly-Geo-City, and Fastly-Geo-Region into the request headers.</td>\n</tr>\n<tr>\n<td>max_stale_age</td>\n<td>integer</td>\n<td>How old an object is allowed to be to serve stale-if-error or stale-while-revalidate.</td>\n</tr>\n<tr>\n<td>timer_support</td>\n<td>integer</td>\n<td>Injects the X-Timer info into the request for viewing origin fetch durations.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>string</td>\n<td>String identifying a service version.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"6deee4bb-eef8-4447-83dc-da22f074bc9c"},{"name":"Response object","item":[{"name":"List Response objects","id":"27ea9e0d-6af5-4a57-a70c-64b18aa7a2a9","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/response_object","description":"<p>Returns all Response Objects for the specified service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","response_object"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"3aeb7512-d5e7-4da0-8b78-72c860d980ed","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/response_object","description":"Returns all Response Objects for the specified service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"cache_condition\":\"\",\"content\":\"This message means all is okay.\",\"content_type\":\"text/plain\",\"name\":\"test-response\",\"request_condition\":\"\",\"response\":\"Ok\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"status\":\"200\",\"version\":\"1\"}]"}],"_postman_id":"27ea9e0d-6af5-4a57-a70c-64b18aa7a2a9"},{"name":"Create a Response object","id":"308ef8bc-d13d-48f1-9399-92dbfdd9dada","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"My 404 Handler\",\"status\":\"404\",\"response\":\"Not Found\",\"content\":\"This page was not found.\",\"content_type\":\"text/html\",\"request_condition\":\"myRequestConditionName\",\"cache_condition\":\"myCacheConditionName\"}"},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/response_object","description":"<p>Creates a new Response Object.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","response_object"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"788995e1-ec38-4e35-b8fd-347364fd334f","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"My 404 Handler\",\"status\":\"404\",\"response\":\"Not Found\",\"content\":\"This page was not found.\",\"content_type\":\"text/html\",\"request_condition\":\"myRequestConditionName\",\"cache_condition\":\"myCacheConditionName\"}"},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/response_object","description":"Creates a new Response Object.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"cache_condition\":\"\",\"content\":\"This message means all is okay.\",\"content_type\":\"text/plain\",\"name\":\"test-response\",\"request_condition\":\"\",\"response\":\"Ok\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"status\":\"200\",\"version\":\"1\"}"}],"_postman_id":"308ef8bc-d13d-48f1-9399-92dbfdd9dada"},{"name":"Get a Response object","id":"081b8f2d-328f-4c2f-b3dc-8ed5aa738584","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/response_object/{{response_object_name}}","description":"<p>Gets the specified Response Object.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","response_object","{{response_object_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"4cfc1da3-e1d9-40eb-a686-840e5a487f25","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/response_object/test-response","description":"Gets the specified Response Object.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"cache_condition\":\"\",\"content\":\"This message means all is okay.\",\"content_type\":\"text/plain\",\"name\":\"test-response\",\"request_condition\":\"\",\"response\":\"Ok\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"status\":\"200\",\"version\":\"1\"}"}],"_postman_id":"081b8f2d-328f-4c2f-b3dc-8ed5aa738584"},{"name":"Update a Response object","id":"35b1f9b1-72eb-4a85-a0b0-0cd6b6bb916f","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"My 404 Handler\",\"status\":\"404\",\"response\":\"Not Found\",\"content\":\"This page was not found.\",\"content_type\":\"text/html\",\"request_condition\":\"myRequestConditionName\",\"cache_condition\":\"myCacheConditionName\"}"},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/response_object/{{response_object_name}}","description":"<p>Updates the specified Response Object.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","response_object","{{response_object_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"72d010b6-2110-429b-be18-7c49077558cf","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"{\"name\":\"My 404 Handler\",\"status\":\"404\",\"response\":\"Not Found\",\"content\":\"This page was not found.\",\"content_type\":\"text/html\",\"request_condition\":\"myRequestConditionName\",\"cache_condition\":\"myCacheConditionName\"}"},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/response_object/test-response","description":"Updates the specified Response Object.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"cache_condition\":\"\",\"content\":\"This message means all is okay.\",\"content_type\":\"text/plain\",\"name\":\"test-response\",\"request_condition\":\"\",\"response\":\"Ok\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"status\":\"200\",\"version\":\"1\"}"}],"_postman_id":"35b1f9b1-72eb-4a85-a0b0-0cd6b6bb916f"},{"name":"Delete a Response Object","id":"66cf8661-0c56-412f-b3f5-f3e5a14de25e","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/response_object/{{response_object_name}}","description":"<p>Deletes the specified Response Object.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","response_object","{{response_object_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"b4fdb4a7-c678-4811-a72b-f2a0b55e4456","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/response_object/test-response","description":"Deletes the specified Response Object.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"66cf8661-0c56-412f-b3f5-f3e5a14de25e"}],"id":"07c3248c-6fb3-4aff-b79f-1b8e13b03543","description":"<p>Allows you to create synthetic responses that exist entirely on the varnish machine. Useful for creating error or maintenance pages that exists outside the scope of your backend architecture. Best when used with Condition objects.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>cache_condition</td>\n<td>string</td>\n<td>Name of the cache condition controlling when this configuration applies.</td>\n</tr>\n<tr>\n<td>content</td>\n<td>string</td>\n<td>The content the response will deliver.</td>\n</tr>\n<tr>\n<td>content_type</td>\n<td>string</td>\n<td>The MIME type of your response content.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The name of the response object to create.</td>\n</tr>\n<tr>\n<td>request_condition</td>\n<td>string</td>\n<td>Condition which, if met, will select this configuration during a request. Optional.</td>\n</tr>\n<tr>\n<td>response</td>\n<td>string</td>\n<td>The status text the response will have. Defaults to 'OK'.</td>\n</tr>\n<tr>\n<td>status</td>\n<td>string</td>\n<td>The status code the response will have. Defaults to 200.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>string</td>\n<td>String identifying a service version.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"07c3248c-6fb3-4aff-b79f-1b8e13b03543"},{"name":"Settings","item":[{"name":"Get service settings","id":"01e62261-08a1-45d7-ab8f-c9efca744ff1","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/settings","description":"<p>Get the settings for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","settings"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"9b8f5c8c-b021-4b74-93f2-c5c8329a9bc2","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/settings","description":"Get the settings for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"general.default_host\":\"www.example.com\",\"general.default_ttl\":7200,\"general.stale_if_error\":false,\"general.stale_if_error_ttl\":43200,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":1}"}],"_postman_id":"01e62261-08a1-45d7-ab8f-c9efca744ff1"},{"name":"Update service settings","id":"ef44dc0d-4d54-4bb5-b44c-a133ea63d004","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/settings","description":"<p>Update the settings for a particular service and version. NOTE: If you override TTLs with custom VCL, any general.default_ttl value will not be honored and the expected behavior may change.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","settings"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"2177ec36-8099-4380-9a3d-fc4c6bbb3928","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/settings","description":"Update the settings for a particular service and version. NOTE: If you override TTLs with custom VCL, any general.default_ttl value will not be honored and the expected behavior may change.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"general.default_host\":\"www.example.com\",\"general.default_ttl\":4242,\"general.stale_if_error\":false,\"general.stale_if_error_ttl\":43200,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":1}"}],"_postman_id":"ef44dc0d-4d54-4bb5-b44c-a133ea63d004"}],"id":"a20b08d1-62e7-4132-a897-5535a7f702c7","description":"<p>Handles default settings for a particular version of a service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>general.default_host</td>\n<td>string</td>\n<td>The default host name for the version.</td>\n</tr>\n<tr>\n<td>general.default_ttl</td>\n<td>integer</td>\n<td>The default time-to-live (TTL) for the version.</td>\n</tr>\n<tr>\n<td>general.stale_if_error</td>\n<td>boolean</td>\n<td>Enables serving a stale object if there is an error.</td>\n</tr>\n<tr>\n<td>general.stale_if_error_ttl</td>\n<td>integer</td>\n<td>The default time-to-live (TTL) for serving the stale object for the version.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>integer</td>\n<td>Integer identifying a service version.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"a20b08d1-62e7-4132-a897-5535a7f702c7"},{"name":"VCL Snippets","item":[{"name":"Get a dynamic snippet","id":"e26989ca-74ab-4bba-ba6f-38c069c20708","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/snippet/{{id}}","description":"<p>Get a single dynamic snippet for a particular service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","snippet","{{id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"e75130d6-1396-42fb-bb6b-283c5a106bab","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/snippet/62Yd1WfiCBPENLloXfXmlO","description":"Get a single dynamic snippet for a particular service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"62Yd1WfiCBPENLloXfXmlO\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"name\":\"test-snippet\",\"priority\":\"100\",\"dynamic\":\"1\",\"type\":\"recv\",\"content\":\"set req.enable_segmented_caching = true;\",\"created_at\":\"2020-08-15T09:37:10.000Z\",\"updated_at\":\"2020-08-15T09:37:10.000Z\",\"deleted_at\":null}"}],"_postman_id":"e26989ca-74ab-4bba-ba6f-38c069c20708"},{"name":"Update a dynamic snippet","id":"e233b146-7e0e-4718-a9ab-e59314d56b4a","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/snippet/{{id}}","description":"<p>Update a dynamic snippet for a particular service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","snippet","{{id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"f8d10de9-bd9e-4d03-87b9-b4cac43f6f28","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/snippet/62Yd1WfiCBPENLloXfXmlO","description":"Update a dynamic snippet for a particular service.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"62Yd1WfiCBPENLloXfXmlO\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"name\":\"test-snippet\",\"priority\":\"100\",\"dynamic\":\"1\",\"type\":\"hit\",\"content\":\"set beresp.ttl = 60s;\",\"created_at\":\"2020-08-15T09:37:10.000Z\",\"updated_at\":\"2020-08-15T09:37:10.000Z\",\"deleted_at\":null}"}],"_postman_id":"e233b146-7e0e-4718-a9ab-e59314d56b4a"},{"name":"List snippets","id":"87b33858-c969-47e7-8fe2-8cf6ceb98b10","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/snippet","description":"<p>List all snippets for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","snippet"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"897369b9-7960-4e41-8e29-661b62e2c278","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/snippet","description":"List all snippets for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"id\":\"62Yd1WfiCBPENLloXfXmlO\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"name\":\"test-snippet\",\"priority\":\"100\",\"dynamic\":\"1\",\"type\":\"recv\",\"content\":\"set req.enable_segmented_caching = true;\",\"created_at\":\"2020-08-15T09:37:10.000Z\",\"updated_at\":\"2020-08-15T09:37:10.000Z\",\"deleted_at\":null}]"}],"_postman_id":"87b33858-c969-47e7-8fe2-8cf6ceb98b10"},{"name":"Create a snippet","id":"34bf3ce5-044e-47d1-8f4a-08bdca3e0faa","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/snippet","description":"<p>Create a snippet for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","snippet"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"f9817441-2271-4a40-9836-25f67b48390d","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/snippet","description":"Create a snippet for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"62Yd1WfiCBPENLloXfXmlO\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"name\":\"test-snippet\",\"priority\":\"100\",\"dynamic\":\"1\",\"type\":\"recv\",\"content\":\"set req.enable_segmented_caching = true;\",\"created_at\":\"2020-08-15T09:37:10.000Z\",\"updated_at\":\"2020-08-15T09:37:10.000Z\",\"deleted_at\":null}"}],"_postman_id":"34bf3ce5-044e-47d1-8f4a-08bdca3e0faa"},{"name":"Get a versioned snippet","id":"fc387e30-c536-4689-bb21-416774bbff0f","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/snippet/{{name}}","description":"<p>Get a single snippet for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","snippet","{{name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"c70cfff6-96ad-427d-8e8e-24413b3075ad","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/snippet/test-snippet","description":"Get a single snippet for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"62Yd1WfiCBPENLloXfXmlO\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"name\":\"test-snippet\",\"priority\":\"100\",\"dynamic\":\"1\",\"type\":\"recv\",\"content\":\"set req.enable_segmented_caching = true;\",\"created_at\":\"2020-08-15T09:37:10.000Z\",\"updated_at\":\"2020-08-15T09:37:10.000Z\",\"deleted_at\":null}"}],"_postman_id":"fc387e30-c536-4689-bb21-416774bbff0f"},{"name":"Update a versioned snippet","id":"7d3d5042-c6f9-436a-b2af-45d08be8535f","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/snippet/{{name}}","description":"<p>Update a specific snippet for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","snippet","{{name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"100ffecc-157b-460c-8881-6ea232d116f5","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/snippet/test-snippet","description":"Update a specific snippet for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"62Yd1WfiCBPENLloXfXmlO\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":\"1\",\"name\":\"updated-snippet-name\",\"priority\":\"100\",\"dynamic\":\"1\",\"type\":\"recv\",\"content\":\"set req.enable_segmented_caching = true;\",\"created_at\":\"2020-08-15T09:37:10.000Z\",\"updated_at\":\"2020-08-15T09:37:10.000Z\",\"deleted_at\":null}"}],"_postman_id":"7d3d5042-c6f9-436a-b2af-45d08be8535f"},{"name":"Delete a snippet","id":"22a433d6-2dfa-4039-a464-0a28702c253e","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/snippet/{{name}}","description":"<p>Delete a specific snippet for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","snippet","{{name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"75f6f126-e410-4d4a-8e1e-6f1d9b670bcb","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/snippet/test-snippet","description":"Delete a specific snippet for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"22a433d6-2dfa-4039-a464-0a28702c253e"}],"id":"5449b916-6c33-4d3c-afd6-08e370810e41","description":"<p>VCL Snippets are blocks of VCL logic inserted into your service's configuration that don't require custom VCL.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>content</td>\n<td>string</td>\n<td>The VCL code that specifies exactly what the snippet does.</td>\n</tr>\n<tr>\n<td>dynamic</td>\n<td>string</td>\n<td>Sets the snippet version.</td>\n</tr>\n<tr>\n<td></td>\n<td>0</td>\n<td>regular.</td>\n</tr>\n<tr>\n<td></td>\n<td>1</td>\n<td>dynamic.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The name for the snippet.</td>\n</tr>\n<tr>\n<td>priority</td>\n<td>string</td>\n<td>Priority determines execution order. Lower numbers execute first.</td>\n</tr>\n<tr>\n<td>type</td>\n<td>string</td>\n<td>The location in generated VCL where the snippet should be placed.</td>\n</tr>\n<tr>\n<td></td>\n<td>init</td>\n<td>Place the snippet above all subroutines.</td>\n</tr>\n<tr>\n<td></td>\n<td>recv</td>\n<td>Place the snippet within the vcl_recv subroutine but below the boilerplate VCL and above any objects.</td>\n</tr>\n<tr>\n<td></td>\n<td>hash</td>\n<td>Place the snippet within the vcl_hash subroutine.</td>\n</tr>\n<tr>\n<td></td>\n<td>hit</td>\n<td>Place the snippet within the vcl_hit subroutine.</td>\n</tr>\n<tr>\n<td></td>\n<td>miss</td>\n<td>Place the snippet within the vcl_miss subroutine.</td>\n</tr>\n<tr>\n<td></td>\n<td>pass</td>\n<td>Place the snippet within the vcl_pass subroutine.</td>\n</tr>\n<tr>\n<td></td>\n<td>fetch</td>\n<td>Place the snippet within the vcl_fetch subroutine.</td>\n</tr>\n<tr>\n<td></td>\n<td>error</td>\n<td>Place the snippet within the vcl_error subroutine.</td>\n</tr>\n<tr>\n<td></td>\n<td>deliver</td>\n<td>Place the snippet within the vcl_deliver subroutine.</td>\n</tr>\n<tr>\n<td></td>\n<td>log</td>\n<td>Place the snippet within the vcl_log subroutine.</td>\n</tr>\n<tr>\n<td></td>\n<td>none</td>\n<td>Don't render the snippet in VCL so it can be manually included in custom VCL.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>Alphanumeric string identifying a VCL Snippet.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>string</td>\n<td>String representing the number identifying a version of the service.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"5449b916-6c33-4d3c-afd6-08e370810e41"},{"name":"VCL","item":[{"name":"List custom VCL files","id":"78779730-665e-4c57-9193-279d97c1b502","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/vcl","description":"<p>List the uploaded VCLs for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","vcl"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"ac804013-7f1d-4912-87f6-66b8661e1287","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/vcl","description":"List the uploaded VCLs for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":1,\"content\":\"backend default {\\n  .host = \\\"127.0.0.1\\\";\\n  .port = \\\"9092\\\";\\n}\\n\\nsub vcl_recv {\\n    set req.backend = default;\\n}\\n\\nsub vcl_hash {\\n    set req.hash += req.url;\\n    set req.hash += req.http.host;\\n    set req.hash += \\\"0\\\";\\n}\\n\",\"main\":false,\"name\":\"test-vcl\"}]"}],"_postman_id":"78779730-665e-4c57-9193-279d97c1b502"},{"name":"Create a custom VCL file","id":"b4f82e60-75f3-4576-ba70-686ebfd02f59","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/vcl","description":"<p>Upload a VCL for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","vcl"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"8f0dd539-e5cc-47b6-8683-72f62b810512","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/vcl","description":"Upload a VCL for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":1,\"content\":\"backend default {\\n  .host = \\\"127.0.0.1\\\";\\n  .port = \\\"9092\\\";\\n}\\n\\nsub vcl_recv {\\n    set req.backend = default;\\n}\\n\\nsub vcl_hash {\\n    set req.hash += req.url;\\n    set req.hash += req.http.host;\\n    set req.hash += \\\"0\\\";\\n}\\n\",\"main\":false,\"name\":\"test-vcl\"}"}],"_postman_id":"b4f82e60-75f3-4576-ba70-686ebfd02f59"},{"name":"Get boilerplate VCL","id":"fa00f594-35df-47d7-a510-d06c50230ec1","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"text/plain"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/boilerplate","description":"<p>Return boilerplate VCL with the service's TTL from the settings.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","boilerplate"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"6701922f-9417-43c9-9ba2-20801d583c0d","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"text/plain"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/boilerplate","description":"Return boilerplate VCL with the service's TTL from the settings.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"*VCL*\n"}],"_postman_id":"fa00f594-35df-47d7-a510-d06c50230ec1"},{"name":"Get a custom VCL file","id":"a1d89a1b-ac7a-49ad-97ff-9b1401b40bb0","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/vcl/{{vcl_name}}?no_content","description":"<p>Get the uploaded VCL for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","vcl","{{vcl_name}}"],"host":["https://api.fastly.com"],"query":[{"description":{"content":"<p>Omit VCL content.</p>\n","type":"text/plain"},"key":"no_content"}],"variable":[]}},"response":[{"id":"8563237c-0cf9-45b6-b543-e538e7ebe174","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":{"raw":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/vcl/test-vcl?no_content","protocol":"https","host":["api","fastly","com"],"path":["service","SU1Z0isxPaozGVKXdv0eY","version","1","vcl","test-vcl"],"query":[{"key":"no_content","description":"Omit VCL content."}]},"description":"Get the uploaded VCL for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":1,\"content\":\"backend default {\\n  .host = \\\"127.0.0.1\\\";\\n  .port = \\\"9092\\\";\\n}\\n\\nsub vcl_recv {\\n    set req.backend = default;\\n}\\n\\nsub vcl_hash {\\n    set req.hash += req.url;\\n    set req.hash += req.http.host;\\n    set req.hash += \\\"0\\\";\\n}\\n\",\"main\":false,\"name\":\"test-vcl\"}"}],"_postman_id":"a1d89a1b-ac7a-49ad-97ff-9b1401b40bb0"},{"name":"Update a custom VCL file","id":"c26f629e-c96b-4574-8d96-86a6955a696a","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/vcl/{{vcl_name}}","description":"<p>Update the uploaded VCL for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","vcl","{{vcl_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"944d9140-f161-4a52-b54e-91f3d83a188d","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/vcl/test-vcl","description":"Update the uploaded VCL for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":1,\"content\":\"backend default {\\n  .host = \\\"127.0.0.1\\\";\\n  .port = \\\"9092\\\";\\n}\\n\\nsub vcl_recv {\\n    set req.backend = default;\\n}\\n\\nsub vcl_hash {\\n    set req.hash += req.url;\\n    set req.hash += req.http.host;\\n    set req.hash += \\\"0\\\";\\n}\\n\",\"main\":false,\"name\":\"test-vcl\"}"}],"_postman_id":"c26f629e-c96b-4574-8d96-86a6955a696a"},{"name":"Delete a custom VCL file","id":"0de05ab2-4d9d-47f6-92a3-485cdbad433e","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/vcl/{{vcl_name}}","description":"<p>Delete the uploaded VCL for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","vcl","{{vcl_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"cb724c0f-8abe-492f-8e5b-67a1fdd08b02","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/vcl/test-vcl","description":"Delete the uploaded VCL for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"0de05ab2-4d9d-47f6-92a3-485cdbad433e"},{"name":"Get a custom VCL file with syntax highlighting","id":"fe12ec72-e7e7-4ff0-8e85-8039f13d530a","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/vcl/{{vcl_name}}/content","description":"<p>Get the uploaded VCL for a particular service and version with HTML syntax highlighting. Include line numbers by sending lineno=true as a request parameter.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","vcl","{{vcl_name}}","content"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"cd33fd76-a3b1-4cd3-a2c8-1ba56c61e3c0","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/vcl/test-vcl/content","description":"Get the uploaded VCL for a particular service and version with HTML syntax highlighting. Include line numbers by sending lineno=true as a request parameter.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"content\":\"<div class=\\\"highlight\\\">\\n  <pre>  <span class=\\\"n\\\">backend</span> <span class=\\\"n\\\">default</span> <span class=\\\"p\\\">{</span>\\n  <span class=\\\"o\\\">.</span><span class=\\\"n\\\">host</span> <span class=\\\"o\\\">=</span> <span class=\\\"s\\\">&quot;127.0.0.1&quot;</span><span class=\\\"p\\\">;</span>\\n  <span class=\\\"o\\\">.</span><span class=\\\"n\\\">port</span> <span class=\\\"o\\\">=</span> <span class=\\\"s\\\">&quot;80&quot;</span><span class=\\\"p\\\">;</span>\\n<span class=\\\"p\\\">}</span>\\n<span class=\\\"k\\\">sub </span><span class=\\\"nf\\\">vcl_recv</span> <span class=\\\"p\\\">{</span>\\n    <span class=\\\"n\\\">set</span> <span class=\\\"n\\\">req</span><span class=\\\"o\\\">.</span><span class=\\\"n\\\">backend</span> <span class=\\\"o\\\">=</span> <span class=\\\"n\\\">default</span><span class=\\\"p\\\">;</span>\\n<span class=\\\"p\\\">}</span>\\n<span class=\\\"k\\\">sub </span><span class=\\\"nf\\\">vcl_hash</span> <span class=\\\"p\\\">{</span>\\n    <span class=\\\"n\\\">set</span> <span class=\\\"n\\\">req</span><span class=\\\"o\\\">.</span><span class=\\\"n\\\">hash</span> <span class=\\\"o\\\">+=</span> <span class=\\\"n\\\">req</span><span class=\\\"o\\\">.</span><span class=\\\"n\\\">url</span><span class=\\\"p\\\">;</span>\\n    <span class=\\\"n\\\">set</span> <span class=\\\"n\\\">req</span><span class=\\\"o\\\">.</span><span class=\\\"n\\\">hash</span> <span class=\\\"o\\\">+=</span> <span class=\\\"n\\\">req</span><span class=\\\"o\\\">.</span><span class=\\\"n\\\">http</span><span class=\\\"o\\\">.</span><span class=\\\"n\\\">host</span><span class=\\\"p\\\">;</span>\\n    <span class=\\\"n\\\">set</span> <span class=\\\"n\\\">req</span><span class=\\\"o\\\">.</span><span class=\\\"n\\\">hash</span> <span class=\\\"o\\\">+=</span> <span class=\\\"s\\\">&quot;0&quot;</span><span class=\\\"p\\\">;</span>\\n<span class=\\\"p\\\">}</span>\\n  </pre>\\n</div>\"}"}],"_postman_id":"fe12ec72-e7e7-4ff0-8e85-8039f13d530a"},{"name":"Download a custom VCL file","id":"f377c892-00c5-4d8d-a8dc-609448a878c0","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"text/plain"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/vcl/{{vcl_name}}/download","description":"<p>Download the specified VCL.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","vcl","{{vcl_name}}","download"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"91707d11-2b3b-4764-b546-57a3e85ed8a9","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"text/plain"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/vcl/test-vcl/download","description":"Download the specified VCL.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"*VCL*"}],"_postman_id":"f377c892-00c5-4d8d-a8dc-609448a878c0"},{"name":"Get the generated VCL for a service","id":"6c388c7d-70cc-40d8-b826-80638a3ac49d","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/generated_vcl","description":"<p>Display the generated VCL for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","generated_vcl"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"93a0282b-4302-458f-b490-c39d587fdd9b","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/generated_vcl","description":"Display the generated VCL for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":1,\"content\":\"backend default {\\n  .host = \\\"127.0.0.1\\\";\\n  .port = \\\"9092\\\";\\n}\\n\\nsub vcl_recv {\\n    set req.backend = default;\\n}\\n\\nsub vcl_hash {\\n    set req.hash += req.url;\\n    set req.hash += req.http.host;\\n    set req.hash += \\\"0\\\";\\n}\\n\",\"main\":false,\"name\":\"test-vcl\"}"}],"_postman_id":"6c388c7d-70cc-40d8-b826-80638a3ac49d"},{"name":"Get the generated VCL with syntax highlighting","id":"5a11c536-2a2d-41d9-941a-1e9cc393f65a","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/generated_vcl/content","description":"<p>Display the content of generated VCL with HTML syntax highlighting. Include line numbers by sending lineno=true as a request parameter.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","generated_vcl","content"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"fe1b8020-38b3-4fef-a44b-0de5d8f66d46","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/generated_vcl/content","description":"Display the content of generated VCL with HTML syntax highlighting. Include line numbers by sending lineno=true as a request parameter.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"content\":\"<div class=\\\"highlight\\\">\\n  <pre>  <span class=\\\"n\\\">backend</span> <span class=\\\"n\\\">default</span> <span class=\\\"p\\\">{</span>\\n  <span class=\\\"o\\\">.</span><span class=\\\"n\\\">host</span> <span class=\\\"o\\\">=</span> <span class=\\\"s\\\">&quot;127.0.0.1&quot;</span><span class=\\\"p\\\">;</span>\\n  <span class=\\\"o\\\">.</span><span class=\\\"n\\\">port</span> <span class=\\\"o\\\">=</span> <span class=\\\"s\\\">&quot;80&quot;</span><span class=\\\"p\\\">;</span>\\n<span class=\\\"p\\\">}</span>\\n<span class=\\\"k\\\">sub </span><span class=\\\"nf\\\">vcl_recv</span> <span class=\\\"p\\\">{</span>\\n    <span class=\\\"n\\\">set</span> <span class=\\\"n\\\">req</span><span class=\\\"o\\\">.</span><span class=\\\"n\\\">backend</span> <span class=\\\"o\\\">=</span> <span class=\\\"n\\\">default</span><span class=\\\"p\\\">;</span>\\n<span class=\\\"p\\\">}</span>\\n<span class=\\\"k\\\">sub </span><span class=\\\"nf\\\">vcl_hash</span> <span class=\\\"p\\\">{</span>\\n    <span class=\\\"n\\\">set</span> <span class=\\\"n\\\">req</span><span class=\\\"o\\\">.</span><span class=\\\"n\\\">hash</span> <span class=\\\"o\\\">+=</span> <span class=\\\"n\\\">req</span><span class=\\\"o\\\">.</span><span class=\\\"n\\\">url</span><span class=\\\"p\\\">;</span>\\n    <span class=\\\"n\\\">set</span> <span class=\\\"n\\\">req</span><span class=\\\"o\\\">.</span><span class=\\\"n\\\">hash</span> <span class=\\\"o\\\">+=</span> <span class=\\\"n\\\">req</span><span class=\\\"o\\\">.</span><span class=\\\"n\\\">http</span><span class=\\\"o\\\">.</span><span class=\\\"n\\\">host</span><span class=\\\"p\\\">;</span>\\n    <span class=\\\"n\\\">set</span> <span class=\\\"n\\\">req</span><span class=\\\"o\\\">.</span><span class=\\\"n\\\">hash</span> <span class=\\\"o\\\">+=</span> <span class=\\\"s\\\">&quot;0&quot;</span><span class=\\\"p\\\">;</span>\\n<span class=\\\"p\\\">}</span>\\n  </pre>\\n</div>\"}"}],"_postman_id":"5a11c536-2a2d-41d9-941a-1e9cc393f65a"},{"name":"Set a custom VCL file as main","id":"27edfa7d-f4a2-4209-9a65-d9dbec9e2127","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/vcl/{{vcl_name}}/main","description":"<p>Set the specified VCL as the main.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","vcl","{{vcl_name}}","main"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"9dbb9da2-4488-4794-a1bf-c21c653a57fd","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/vcl/test-vcl/main","description":"Set the specified VCL as the main.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":1,\"content\":\"backend default {\\n  .host = \\\"127.0.0.1\\\";\\n  .port = \\\"9092\\\";\\n}\\n\\nsub vcl_recv {\\n    set req.backend = default;\\n}\\n\\nsub vcl_hash {\\n    set req.hash += req.url;\\n    set req.hash += req.http.host;\\n    set req.hash += \\\"0\\\";\\n}\\n\",\"main\":true,\"name\":\"test-vcl\"}"}],"_postman_id":"27edfa7d-f4a2-4209-9a65-d9dbec9e2127"},{"name":"Lint (validate) VCL using flags set for the service","id":"0906bdd8-8712-46e0-a827-a9e6ecb59fb4","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[],"url":"https://api.fastly.com/service/{{service_id}}/lint","description":"<p>Services may have flags set by a Fastly employee or by the purchase of products as addons to the service, which modify the way VCL is interpreted by that service.  This endpoint validates the submitted VCL in the context of the specified service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","lint"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"0906bdd8-8712-46e0-a827-a9e6ecb59fb4"},{"name":"Lint (validate) VCL using a default set of flags","id":"367f26d1-80e9-4f09-9dc1-dc7fb0bf997e","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[],"url":"https://api.fastly.com/vcl_lint","description":"<p>This endpoint validates the submitted VCL against a default set of enabled flags. Consider using the /service/{service_id}/lint operation to validate VCL in the context of a specific service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["vcl_lint"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"367f26d1-80e9-4f09-9dc1-dc7fb0bf997e"}],"id":"838c772a-69d6-478a-bf03-66d6deb1000c","description":"<p>A VCL is a Varnish configuration file used to customize the configuration for a Service.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>content</td>\n<td>string</td>\n<td>The VCL code to be included.</td>\n</tr>\n<tr>\n<td>main</td>\n<td>boolean</td>\n<td>Set to true when this is the main VCL, otherwise false.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>The name of this VCL.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>integer</td>\n<td>Integer identifying a service version.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"838c772a-69d6-478a-bf03-66d6deb1000c"}],"id":"f6d20fe3-fe4b-4a4e-b5f4-74dee6d50bf4","_postman_id":"f6d20fe3-fe4b-4a4e-b5f4-74dee6d50bf4","description":""},{"name":"Load balancing","item":[{"name":"Directors","item":[{"name":"Director backend","item":[{"name":"Get a director-backend relationship","id":"e40b200b-2b37-486e-a766-1ab2473af356","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/director/{{director_name}}/backend/{{backend_name}}","description":"<p>Returns the relationship between a Backend and a Director. If the Backend has been associated with the Director, it returns a simple record indicating this. Otherwise, returns a 404.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","director","{{director_name}}","backend","{{backend_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"f3ce7d08-50b7-4ada-96bb-2269ca6e3679","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/director/test-director/backend/test-backend","description":"Returns the relationship between a Backend and a Director. If the Backend has been associated with the Director, it returns a simple record indicating this. Otherwise, returns a 404.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"backend_name\":\"test-backend\",\"created_at\":\"2020-05-05T20:26:56.000Z\",\"deleted_at\":null,\"director_name\":\"test-director\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"updated_at\":\"2020-05-05T20:26:56.000Z\",\"version\":1}"}],"_postman_id":"e40b200b-2b37-486e-a766-1ab2473af356"},{"name":"Create a director-backend relationship","id":"d13b2692-efe9-4733-943b-d3c53e622a21","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/director/{{director_name}}/backend/{{backend_name}}","description":"<p>Establishes a relationship between a Backend and a Director. The Backend is then considered a member of the Director and can be used to balance traffic onto.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","director","{{director_name}}","backend","{{backend_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"b716dcdc-85e5-4394-8dfd-8676055c9f99","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/director/test-director/backend/test-backend","description":"Establishes a relationship between a Backend and a Director. The Backend is then considered a member of the Director and can be used to balance traffic onto.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"backend_name\":\"test-backend\",\"created_at\":\"2020-05-05T20:26:56.000Z\",\"deleted_at\":null,\"director_name\":\"test-director\",\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"updated_at\":\"2020-05-05T20:26:56.000Z\",\"version\":1}"}],"_postman_id":"d13b2692-efe9-4733-943b-d3c53e622a21"},{"name":"Delete a director-backend relationship","id":"47dc4ff7-2962-4c8b-a40e-c04d2f1dbc26","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/director/{{director_name}}/backend/{{backend_name}}","description":"<p>Deletes the relationship between a Backend and a Director. The Backend is no longer considered a member of the Director and thus will not have traffic balanced onto it from this Director.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","director","{{director_name}}","backend","{{backend_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"361ed51a-f0af-4fc4-a61b-6656f90bb8b7","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/director/test-director/backend/test-backend","description":"Deletes the relationship between a Backend and a Director. The Backend is no longer considered a member of the Director and thus will not have traffic balanced onto it from this Director.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"47dc4ff7-2962-4c8b-a40e-c04d2f1dbc26"}],"id":"d9796570-8112-4264-aef7-ea672176d657","description":"<p>Maps and relates backends as belonging to directors. Backends can belong to any number of directors but directors can only hold one reference to a specific backend.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>backend_name</td>\n<td>string</td>\n<td>The name of the backend.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>director</td>\n<td>string</td>\n<td>Name for the Director.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>integer</td>\n<td>Integer identifying a service version.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"d9796570-8112-4264-aef7-ea672176d657"},{"name":"Director","item":[{"name":"List directors","id":"588c4236-0e82-4cd7-a63b-77cd62214617","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/director","description":"<p>List the directors for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","director"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"b1e4c9b6-8301-47ae-b2c2-aa36f23df468","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/director","description":"List the directors for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"backends\":[],\"capacity\":100,\"comment\":\"\",\"name\":\"test-director\",\"quorum\":75,\"retries\":10,\"shield\":null,\"type\":1,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":1,\"created_at\":\"2020-05-04T21:19:41.000Z\",\"updated_at\":\"2020-05-04T21:29:15.000Z\",\"deleted_at\":null}]"}],"_postman_id":"588c4236-0e82-4cd7-a63b-77cd62214617"},{"name":"Create a director","id":"091905b3-b551-41f2-95f9-125db11dae52","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/director","description":"<p>Create a director for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","director"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"0069b1be-2759-4ff0-b414-b88866494cc0","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/director","description":"Create a director for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"backends\":[],\"capacity\":100,\"comment\":\"\",\"name\":\"test-director\",\"quorum\":75,\"retries\":10,\"shield\":null,\"type\":1,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":1,\"created_at\":\"2020-05-04T21:19:41.000Z\",\"updated_at\":\"2020-05-04T21:29:15.000Z\",\"deleted_at\":null}"}],"_postman_id":"091905b3-b551-41f2-95f9-125db11dae52"},{"name":"Get a director","id":"afebf292-da0d-47f4-9c0d-3126eeff463c","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/director/{{director_name}}","description":"<p>Get the director for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","director","{{director_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"0a8dfeb8-4627-4026-914b-1e667e9f5f15","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/director/test-director","description":"Get the director for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"backends\":[],\"capacity\":100,\"comment\":\"\",\"name\":\"test-director\",\"quorum\":75,\"retries\":10,\"shield\":null,\"type\":1,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":1,\"created_at\":\"2020-05-04T21:19:41.000Z\",\"updated_at\":\"2020-05-04T21:29:15.000Z\",\"deleted_at\":null}"}],"_postman_id":"afebf292-da0d-47f4-9c0d-3126eeff463c"},{"name":"Update a director","id":"e03eedc3-169f-409a-8221-73f5282df3f8","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/director/{{director_name}}","description":"<p>Update the director for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","director","{{director_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"8ce9b696-266a-4826-9d61-c6aab4fa27b6","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/director/test-director","description":"Update the director for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"backends\":[],\"capacity\":100,\"comment\":\"\",\"name\":\"updated-test-director\",\"quorum\":75,\"retries\":20,\"shield\":null,\"type\":1,\"service_id\":\"SU1Z0isxPaozGVKXdv0eY\",\"version\":1,\"created_at\":\"2020-05-04T21:19:41.000Z\",\"updated_at\":\"2020-05-04T21:29:15.000Z\",\"deleted_at\":null}"}],"_postman_id":"e03eedc3-169f-409a-8221-73f5282df3f8"},{"name":"Delete a director","id":"7b17cd10-2ce5-4784-b5f0-dae07851b0a8","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/director/{{director_name}}","description":"<p>Delete the director for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","director","{{director_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"1ef9d7ab-8127-43a3-a398-081456a47f20","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/director/test-director","description":"Delete the director for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"7b17cd10-2ce5-4784-b5f0-dae07851b0a8"}],"id":"529a3ec5-9936-4da8-9428-f7eb1d8d4662","description":"<p>A Director is responsible for balancing requests among a group of Backends. In addition to simply balancing, Directors can be configured to attempt retrying failed requests. Additionally, Directors have a quorum setting which can be used to determine when the Director as a whole is considered \"up\", in order to prevent \"server whack-a-mole\" following an outage as servers come back up. Only directors created via the API can be modified via the API. Directors known as \"autodirectors\" that are created automatically when load balancing groups of servers together cannot be modified or retrieved via the API.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>backends</td>\n<td>array</td>\n<td>List of backends associated to a director.</td>\n</tr>\n<tr>\n<td>capacity</td>\n<td>integer</td>\n<td>Unused.</td>\n</tr>\n<tr>\n<td>comment</td>\n<td>string</td>\n<td>A freeform descriptive note.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>Name for the Director.</td>\n</tr>\n<tr>\n<td>quorum</td>\n<td>integer</td>\n<td>The percentage of capacity that needs to be up for a director to be considered up. 0 to 100.</td>\n</tr>\n<tr>\n<td>retries</td>\n<td>integer</td>\n<td>How many backends to search if it fails.</td>\n</tr>\n<tr>\n<td>shield</td>\n<td>string</td>\n<td>Selected POP to serve as a shield for the backends. Defaults to null meaning no origin shielding if not set. Refer to the POPs API endpoint to get a list of available POPs used for shielding.</td>\n</tr>\n<tr>\n<td>type</td>\n<td>integer</td>\n<td>What type of load balance group to use.</td>\n</tr>\n<tr>\n<td></td>\n<td>1</td>\n<td>Random.</td>\n</tr>\n<tr>\n<td></td>\n<td>3</td>\n<td>Hash.</td>\n</tr>\n<tr>\n<td></td>\n<td>4</td>\n<td>Client.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>integer</td>\n<td>Integer identifying a service version.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"529a3ec5-9936-4da8-9428-f7eb1d8d4662"}],"id":"586cc202-6815-4724-9338-53ce6cb5be2b","_postman_id":"586cc202-6815-4724-9338-53ce6cb5be2b","description":""},{"name":"Dynamic server pools","item":[{"name":"Pool","item":[{"name":"List server pools","id":"f72eaed6-598d-4d91-90c2-18378626dd35","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/pool","description":"<p>Lists all pools for a particular service and pool.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","pool"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"b616fdd8-d7df-43e4-8012-2f4e22208b23","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/pool","description":"Lists all pools for a particular service and pool.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"between_bytes_timeout\":\"10000\",\"id\":\"2Yd1WfiCBPENLloXfXmlO\",\"service_id\":\"62SNBYLi10xp1iixmsAcXy\",\"version\":\"1\",\"name\":\"test-pool\",\"shield\":null,\"override_host\":null,\"use_tls\":\"0\",\"type\":\"random\",\"request_condition\":null,\"max_conn_default\":\"200\",\"connect_timeout\":\"1000\",\"first_byte_timeout\":\"15000\",\"quorum\":\"75\",\"tls_ca_cert\":null,\"tls_ciphers\":null,\"tls_client_key\":null,\"tls_client_cert\":null,\"tls_sni_hostname\":null,\"tls_check_cert\":\"1\",\"tls_cert_hostname\":null,\"min_tls_version\":null,\"max_tls_version\":null,\"healthcheck\":null,\"comment\":\"\",\"created_at\":\"2020-06-20T03:55:06.000Z\",\"updated_at\":\"2020-06-20T03:55:06.000Z\",\"deleted_at\":null}]"}],"_postman_id":"f72eaed6-598d-4d91-90c2-18378626dd35"},{"name":"Create a server pool","id":"e94d05a9-f44b-4a41-813b-0a75421c3424","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/pool","description":"<p>Creates a pool for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","pool"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"bd990e4b-e86e-4867-b72a-0ce63b48005d","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/pool","description":"Creates a pool for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"between_bytes_timeout\":\"10000\",\"id\":\"2Yd1WfiCBPENLloXfXmlO\",\"service_id\":\"62SNBYLi10xp1iixmsAcXy\",\"version\":\"1\",\"name\":\"test-pool\",\"shield\":null,\"override_host\":null,\"use_tls\":\"0\",\"type\":\"random\",\"request_condition\":null,\"max_conn_default\":\"200\",\"connect_timeout\":\"1000\",\"first_byte_timeout\":\"15000\",\"quorum\":75,\"tls_ca_cert\":null,\"tls_ciphers\":null,\"tls_client_key\":null,\"tls_client_cert\":null,\"tls_sni_hostname\":null,\"tls_check_cert\":\"1\",\"tls_cert_hostname\":null,\"min_tls_version\":null,\"max_tls_version\":null,\"healthcheck\":null,\"comment\":\"\",\"created_at\":\"2020-06-20T03:55:06.000Z\",\"updated_at\":\"2020-06-20T03:55:06.000Z\",\"deleted_at\":null}"}],"_postman_id":"e94d05a9-f44b-4a41-813b-0a75421c3424"},{"name":"Get a server pool","id":"38fab6cc-6246-4d46-aee1-e4f1db7bc189","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/pool/{{pool_name}}","description":"<p>Gets a single pool for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","pool","{{pool_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"70ff13fb-b3ae-44b4-9897-dffc7730e65e","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/pool/my-pool","description":"Gets a single pool for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"between_bytes_timeout\":\"10000\",\"id\":\"2Yd1WfiCBPENLloXfXmlO\",\"service_id\":\"62SNBYLi10xp1iixmsAcXy\",\"version\":\"1\",\"name\":\"test-pool\",\"shield\":null,\"override_host\":null,\"use_tls\":\"0\",\"type\":\"random\",\"request_condition\":null,\"max_conn_default\":\"200\",\"connect_timeout\":\"1000\",\"first_byte_timeout\":\"15000\",\"quorum\":\"75\",\"tls_ca_cert\":null,\"tls_ciphers\":null,\"tls_client_key\":null,\"tls_client_cert\":null,\"tls_sni_hostname\":null,\"tls_check_cert\":\"1\",\"tls_cert_hostname\":null,\"min_tls_version\":null,\"max_tls_version\":null,\"healthcheck\":null,\"comment\":\"\",\"created_at\":\"2020-06-20T03:55:06.000Z\",\"updated_at\":\"2020-06-20T03:55:06.000Z\",\"deleted_at\":null}"}],"_postman_id":"38fab6cc-6246-4d46-aee1-e4f1db7bc189"},{"name":"Update a server pool","id":"b79f49e0-b88f-4fca-af25-4d21dba6bcbb","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/pool/{{pool_name}}","description":"<p>Updates a specific pool for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","pool","{{pool_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"541de952-b072-42de-872f-51d1c6fed6ce","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/pool/my-pool","description":"Updates a specific pool for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"between_bytes_timeout\":\"10000\",\"id\":\"2Yd1WfiCBPENLloXfXmlO\",\"service_id\":\"62SNBYLi10xp1iixmsAcXy\",\"version\":\"1\",\"name\":\"test-pool\",\"shield\":null,\"override_host\":null,\"use_tls\":\"0\",\"type\":\"random\",\"request_condition\":null,\"max_conn_default\":\"300\",\"connect_timeout\":\"1000\",\"first_byte_timeout\":\"15000\",\"quorum\":\"75\",\"tls_ca_cert\":null,\"tls_ciphers\":null,\"tls_client_key\":null,\"tls_client_cert\":null,\"tls_sni_hostname\":null,\"tls_check_cert\":\"1\",\"tls_cert_hostname\":null,\"min_tls_version\":null,\"max_tls_version\":null,\"healthcheck\":null,\"comment\":\"\",\"created_at\":\"2020-06-20T03:55:06.000Z\",\"updated_at\":\"2020-06-20T03:55:06.000Z\",\"deleted_at\":null}"}],"_postman_id":"b79f49e0-b88f-4fca-af25-4d21dba6bcbb"},{"name":"Delete a server pool","id":"df54abb3-3ed7-4da2-bf35-c79961dcd169","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/version/{{version_id}}/pool/{{pool_name}}","description":"<p>Deletes a specific pool for a particular service and version.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","version","{{version_id}}","pool","{{pool_name}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"f97b98ff-5470-422b-b342-ffcb823c230f","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/version/1/pool/my-pool","description":"Deletes a specific pool for a particular service and version.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"df54abb3-3ed7-4da2-bf35-c79961dcd169"}],"id":"904927af-4fd0-451c-b116-8624cfd23c03","description":"<p>A pool is responsible for balancing requests among a group of servers. In addition to balancing, pools can be configured to attempt retrying failed requests. Pools have a quorum setting that can be used to determine when the pool as a whole is considered up, in order to prevent problems following an outage as servers come back up.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>comment</td>\n<td>string</td>\n<td>A freeform descriptive note.</td>\n</tr>\n<tr>\n<td>healthcheck</td>\n<td>string</td>\n<td>Name of the healthcheck to use with this pool. Can be empty and could be reused across multiple backend and pools.</td>\n</tr>\n<tr>\n<td>max_tls_version</td>\n<td>integer</td>\n<td>Maximum allowed TLS version on connections to this server. Optional.</td>\n</tr>\n<tr>\n<td>min_tls_version</td>\n<td>integer</td>\n<td>Minimum allowed TLS version on connections to this server. Optional.</td>\n</tr>\n<tr>\n<td>name</td>\n<td>string</td>\n<td>Name for the Pool.</td>\n</tr>\n<tr>\n<td>override_host</td>\n<td>string</td>\n<td>The hostname to override the Host header. Defaults to null meaning no override of the Host header will occur. This setting can also be added to a Server definition. If the field is set on a Server definition it will override the Pool setting.</td>\n</tr>\n<tr>\n<td>request_condition</td>\n<td>string</td>\n<td>Condition which, if met, will select this configuration during a request. Optional.</td>\n</tr>\n<tr>\n<td>shield</td>\n<td>string</td>\n<td>Selected POP to serve as a shield for the servers. Defaults to null meaning no origin shielding if not set. Refer to the POPs API endpoint to get a list of available POPs used for shielding.</td>\n</tr>\n<tr>\n<td>tls_ciphers</td>\n<td>string</td>\n<td>List of OpenSSL ciphers (see the openssl.org manpages for details). Optional.</td>\n</tr>\n<tr>\n<td>tls_sni_hostname</td>\n<td>string</td>\n<td>SNI hostname. Optional.</td>\n</tr>\n<tr>\n<td>type</td>\n<td>string</td>\n<td>What type of load balance group to use.</td>\n</tr>\n<tr>\n<td>between_bytes_timeout</td>\n<td>integer</td>\n<td>Maximum duration in milliseconds that Fastly will wait while receiving no data on a download from a backend. If exceeded, for Delivery services, the response received so far will be considered complete and the fetch will end. For Compute services, timeout expiration is treated as a failure of the backend connection, and an error is generated. May be set at runtime using bereq.between_bytes_timeout.</td>\n</tr>\n<tr>\n<td>connect_timeout</td>\n<td>integer</td>\n<td>How long to wait for a timeout in milliseconds. Optional.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>first_byte_timeout</td>\n<td>integer</td>\n<td>How long to wait for the first byte in milliseconds. Optional.</td>\n</tr>\n<tr>\n<td>max_conn_default</td>\n<td>integer</td>\n<td>Maximum number of connections. Optional.</td>\n</tr>\n<tr>\n<td>quorum</td>\n<td>integer</td>\n<td>Percentage of capacity (0-100) that needs to be operationally available for a pool to be considered up.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>tls_ca_cert</td>\n<td>string</td>\n<td>A secure certificate to authenticate a server with. Must be in PEM format.</td>\n</tr>\n<tr>\n<td>tls_cert_hostname</td>\n<td>string</td>\n<td>The hostname used to verify a server's certificate. It can either be the Common Name (CN) or a Subject Alternative Name (SAN).</td>\n</tr>\n<tr>\n<td>tls_check_cert</td>\n<td>integer</td>\n<td>Be strict on checking TLS certs. Optional.</td>\n</tr>\n<tr>\n<td>tls_client_cert</td>\n<td>string</td>\n<td>The client certificate used to make authenticated requests. Must be in PEM format.</td>\n</tr>\n<tr>\n<td>tls_client_key</td>\n<td>string</td>\n<td>The client private key used to make authenticated requests. Must be in PEM format.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>use_tls</td>\n<td>integer</td>\n<td>Whether to use TLS.</td>\n</tr>\n<tr>\n<td></td>\n<td>0</td>\n<td>Do not use TLS.</td>\n</tr>\n<tr>\n<td></td>\n<td>1</td>\n<td>Use TLS.</td>\n</tr>\n<tr>\n<td>version</td>\n<td>string</td>\n<td>String identifying a service version.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>Alphanumeric string identifying a Pool.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"904927af-4fd0-451c-b116-8624cfd23c03"},{"name":"Server","item":[{"name":"List servers in a pool","id":"eef5153a-4737-4186-8cf5-646c2a036bd1","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/pool/{{pool_id}}/servers","description":"<p>Lists all servers for a particular service and pool.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","pool","{{pool_id}}","servers"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"8d045717-fc7c-40a3-9702-ff4891ecd7e9","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/pool/2Yd1WfiCBPENLloXfXmlO/servers","description":"Lists all servers for a particular service and pool.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"[{\"id\":\"6kEuoknxiaDBCLiAjKqyXq\",\"service_id\":\"6k2He0IyVFUTO6RNO1BNDe\",\"pool_id\":\"6kAX81nQ1jsNWZGnXvFSKY\",\"weight\":100,\"max_conn\":200,\"port\":80,\"override_host\":null,\"address\":\"example.com\",\"comment\":\"\",\"disabled\":false,\"created_at\":\"2020-06-20T08:20:36.000Z\",\"updated_at\":\"2020-06-20T08:20:36.000Z\",\"deleted_at\":null}]"}],"_postman_id":"eef5153a-4737-4186-8cf5-646c2a036bd1"},{"name":"Get a pool server","id":"d3548cda-f427-4590-aeea-b6d5b7dd6c3d","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/pool/{{pool_id}}/server/{{server_id}}","description":"<p>Gets a single server for a particular service and pool.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","pool","{{pool_id}}","server","{{server_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"28bf2f72-3b53-43be-aba4-8a8f1b23c133","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"GET","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/pool/2Yd1WfiCBPENLloXfXmlO/server/6kEuoknxiaDBCLiAjKqyXq","description":"Gets a single server for a particular service and pool.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"6kEuoknxiaDBCLiAjKqyXq\",\"service_id\":\"6k2He0IyVFUTO6RNO1BNDe\",\"pool_id\":\"6kAX81nQ1jsNWZGnXvFSKY\",\"weight\":100,\"max_conn\":200,\"port\":80,\"override_host\":null,\"address\":\"example.com\",\"comment\":\"\",\"disabled\":false,\"created_at\":\"2020-06-20T08:20:36.000Z\",\"updated_at\":\"2020-06-20T08:20:36.000Z\",\"deleted_at\":null}"}],"_postman_id":"d3548cda-f427-4590-aeea-b6d5b7dd6c3d"},{"name":"Update a server","id":"3e53257e-f245-4faa-a83a-f3d9fe2c04d5","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/pool/{{pool_id}}/server/{{server_id}}","description":"<p>Updates a single server for a particular service and pool.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","pool","{{pool_id}}","server","{{server_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"450a3c6b-d5a9-4a75-9698-f5f71d81f4a9","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"PUT","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/pool/2Yd1WfiCBPENLloXfXmlO/server/6kEuoknxiaDBCLiAjKqyXq","description":"Updates a single server for a particular service and pool.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"6kEuoknxiaDBCLiAjKqyXq\",\"service_id\":\"6k2He0IyVFUTO6RNO1BNDe\",\"pool_id\":\"6kAX81nQ1jsNWZGnXvFSKY\",\"weight\":100,\"max_conn\":300,\"port\":80,\"override_host\":null,\"address\":\"example.com\",\"comment\":\"\",\"disabled\":false,\"created_at\":\"2020-06-20T08:20:36.000Z\",\"updated_at\":\"2020-06-20T08:20:36.000Z\",\"deleted_at\":null}"}],"_postman_id":"3e53257e-f245-4faa-a83a-f3d9fe2c04d5"},{"name":"Delete a server from a pool","id":"456a3c9c-9827-4f41-99f2-c7e78cb46aa6","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/{{service_id}}/pool/{{pool_id}}/server/{{server_id}}","description":"<p>Deletes a single server for a particular service and pool.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","pool","{{pool_id}}","server","{{server_id}}"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"0dd14635-a054-4634-9251-1ab95c49d917","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"DELETE","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Accept","value":"application/json"}],"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/pool/2Yd1WfiCBPENLloXfXmlO/server/6kEuoknxiaDBCLiAjKqyXq","description":"Deletes a single server for a particular service and pool.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"status\":\"ok\"}"}],"_postman_id":"456a3c9c-9827-4f41-99f2-c7e78cb46aa6"},{"name":"Add a server to a pool","id":"dc7ace35-0a7e-4c7c-84ed-ff6108e99935","request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/{{service_id}}/pool/{{pool_id}}/server","description":"<p>Creates a single server for a particular service and pool.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n","urlObject":{"path":["service","{{service_id}}","pool","{{pool_id}}","server"],"host":["https://api.fastly.com"],"query":[],"variable":[]}},"response":[{"id":"9db0e2e1-84cc-4d7d-920b-f7bec48e4784","name":"200 OK","originalRequest":{"auth":{"type":"apikey","apikey":{"value":"{{fastly_key}}","key":"Fastly-Key"}},"method":"POST","header":[{"key":"Host","value":"api.fastly.com"},{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[]},"url":"https://api.fastly.com/service/SU1Z0isxPaozGVKXdv0eY/pool/2Yd1WfiCBPENLloXfXmlO/server","description":"Creates a single server for a particular service and pool.\n> **Authorization**: [API token](/reference/api/auth-tokens) with at least [Engineer](/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions\") permissions.\n"},"status":"200 OK","code":200,"_postman_previewlanguage":"Text","header":[],"cookie":[],"responseTime":null,"body":"{\"id\":\"6kEuoknxiaDBCLiAjKqyXq\",\"service_id\":\"6k2He0IyVFUTO6RNO1BNDe\",\"pool_id\":\"6kAX81nQ1jsNWZGnXvFSKY\",\"weight\":100,\"max_conn\":200,\"port\":80,\"override_host\":null,\"address\":\"new-example.com\",\"comment\":\"\",\"disabled\":false,\"created_at\":\"2020-06-20T08:20:36.000Z\",\"updated_at\":\"2020-06-20T08:20:36.000Z\",\"deleted_at\":null}"}],"_postman_id":"dc7ace35-0a7e-4c7c-84ed-ff6108e99935"}],"id":"8f70f797-1f16-498e-8f2f-c2c82e5550d6","description":"<p>A server is an address (IP address or hostname) to which the Fastly Load Balancer service can forward requests. This service can define multiple servers and assign it to a pool. Fastly can then select any one of these servers based on a selection policy defined for the pool.</p>\n<blockquote>\n<p><strong>Authorization</strong>: <a href=\"/reference/api/auth-tokens\">API token</a> with at least <a href=\"/guides/account-info/user-access-and-control/configuring-user-roles-and-permissions%22\">Engineer</a> permissions.</p>\n</blockquote>\n<h2 id=\"data-model\">Data model</h2>\n<div class=\"click-to-expand-wrapper is-table-wrapper\"><table>\n<thead>\n<tr>\n<th>Name</th>\n<th>Type</th>\n<th>Description</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td>address</td>\n<td>string</td>\n<td>A hostname, IPv4, or IPv6 address for the server. Required.</td>\n</tr>\n<tr>\n<td>comment</td>\n<td>string</td>\n<td>A freeform descriptive note.</td>\n</tr>\n<tr>\n<td>disabled</td>\n<td>boolean</td>\n<td>Allows servers to be enabled and disabled in a pool.</td>\n</tr>\n<tr>\n<td>max_conn</td>\n<td>integer</td>\n<td>Maximum number of connections. If the value is 0, it inherits the value from pool's max_conn_default.</td>\n</tr>\n<tr>\n<td>override_host</td>\n<td>string</td>\n<td>The hostname to override the Host header. Defaults to null meaning no override of the Host header if not set. This setting can also be added to a Pool definition. However, the server setting will override the Pool setting.</td>\n</tr>\n<tr>\n<td>port</td>\n<td>integer</td>\n<td>Port number. Setting port 443 does not force TLS. Set use_tls in pool to force TLS.</td>\n</tr>\n<tr>\n<td>weight</td>\n<td>integer</td>\n<td>Weight (1-100) used to load balance this server against others.</td>\n</tr>\n<tr>\n<td>created_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>deleted_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n<tr>\n<td>id</td>\n<td>string</td>\n<td>Alphanumeric string identifying a Server.</td>\n</tr>\n<tr>\n<td>pool_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying a Pool.</td>\n</tr>\n<tr>\n<td>service_id</td>\n<td>string</td>\n<td>Alphanumeric string identifying the service.</td>\n</tr>\n<tr>\n<td>updated_at</td>\n<td>string</td>\n<td>Date and time in ISO 8601 format.</td>\n</tr>\n</tbody>\n</table>\n</div>","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Fastly-Key"},{"key":"value","value":"{{fastly_key}}"}]},"isInherited":false},"_postman_id":"8f70f797-1f16-498e-8f2f-c2c82e5550d6"}],"id":"748154af-fcf3-458a-9eff-c70df291181b","_postman_id":"748154af-fcf3-458a-9eff-c70df291181b","description":""}],"id":"dc895904-e288-4ad7-958f-f52d15211067","_postman_id":"dc895904-e288-4ad7-958f-f52d15211067","description":""}],"variable":[{"key":"fastly_url","value":"https://api.fastly.com"},{"key":"customer_id","description":"Alphanumeric string identifying the customer."},{"key":"contact_id","description":"An alphanumeric string identifying the customer contact."},{"key":"event_id","description":"Alphanumeric string identifying an event."},{"key":"invitation_id","description":"Alphanumeric string identifying an invitation."},{"key":"invoice_id"},{"key":"role_id","description":"Alphanumeric string identifying the role."},{"key":"service_authorization_id","description":"Alphanumeric string identifying a service authorization."},{"key":"star_id","description":"Alphanumeric string identifying a star."},{"key":"user_id","description":"Alphanumeric string identifying the user."},{"key":"user_login","description":"The login associated with the user (typically, an email address)."},{"key":"acl_id","description":"Alphanumeric string identifying a ACL."},{"key":"service_id","description":"Alphanumeric string identifying the service."},{"key":"acl_entry_id","description":"Alphanumeric string identifying an ACL Entry."},{"key":"version_id","description":"Integer identifying a service version."},{"key":"acl_name","description":"Name for the ACL. Must start with an alphanumeric character and contain only alphanumeric characters, underscores, and whitespace."},{"key":"acl_ip","description":"valid IPv4 or IPv6 address."},{"key":"operation_id","description":"The unique identifier of the operation."},{"key":"tag_id","description":"The unique identifier of the operation tag."},{"key":"id"},{"key":"token_id","description":"Alphanumeric string identifying a token."},{"key":"dictionary_id","description":"Alphanumeric string identifying a Dictionary."},{"key":"dictionary_item_key","description":"Item key, maximum 256 characters."},{"key":"dictionary_name","description":"Name for the Dictionary (must start with an alphabetic character and can contain only alphanumeric characters, underscores, and whitespace)."},{"key":"domain_id","description":"The Domain Identifier (UUID)."},{"key":"dns_configuration_id","description":"The ID for a DNS configuration (UUID)."},{"key":"tls_configuration_id","description":"TLS Configuration ID (UUID)."},{"key":"backend_name","description":"The name of the backend."},{"key":"director_name","description":"Name for the Director."},{"key":"pool_name","description":"Name for the Pool."},{"key":"pool_id","description":"Alphanumeric string identifying a Pool."},{"key":"server_id","description":"Alphanumeric string identifying a Server."},{"key":"logging_azureblob_name","description":"The name for the real-time logging configuration."},{"key":"logging_bigquery_name","description":"The name for the real-time logging configuration."},{"key":"logging_cloudfiles_name","description":"The name for the real-time logging configuration."},{"key":"logging_datadog_name","description":"The name for the real-time logging configuration."},{"key":"logging_digitalocean_name","description":"The name for the real-time logging configuration."},{"key":"logging_elasticsearch_name","description":"The name for the real-time logging configuration."},{"key":"logging_ftp_name","description":"The name for the real-time logging configuration."},{"key":"logging_gcs_name","description":"The name for the real-time logging configuration."},{"key":"logging_google_pubsub_name","description":"The name for the real-time logging configuration."},{"key":"logging_grafanacloudlogs_name","description":"The name for the real-time logging configuration."},{"key":"logging_heroku_name","description":"The name for the real-time logging configuration."},{"key":"logging_honeycomb_name","description":"The name for the real-time logging configuration."},{"key":"logging_https_name","description":"The name for the real-time logging configuration."},{"key":"logging_kafka_name","description":"The name for the real-time logging configuration."},{"key":"logging_kinesis_name","description":"The name for the real-time logging configuration."},{"key":"logging_loggly_name","description":"The name for the real-time logging configuration."},{"key":"logging_logshuttle_name","description":"The name for the real-time logging configuration."},{"key":"logging_newrelic_name","description":"The name for the real-time logging configuration."},{"key":"logging_newrelicotlp_name","description":"The name for the real-time logging configuration."},{"key":"logging_openstack_name","description":"The name for the real-time logging configuration."},{"key":"logging_papertrail_name","description":"The name for the real-time logging configuration."},{"key":"logging_s3_name","description":"The name for the real-time logging configuration."},{"key":"logging_scalyr_name","description":"The name for the real-time logging configuration."},{"key":"logging_sftp_name","description":"The name for the real-time logging configuration."},{"key":"logging_splunk_name","description":"The name for the real-time logging configuration."},{"key":"logging_sumologic_name","description":"The name for the real-time logging configuration."},{"key":"logging_syslog_name","description":"The name for the real-time logging configuration."},{"key":"start_timestamp","description":"Timestamp in seconds (Unix epoch time)."},{"key":"max_entries","description":"Maximum number of results to show."},{"key":"field","description":"Name of the stats field."},{"key":"timestamp_in_seconds","description":"Timestamp in seconds (Unix epoch time)."},{"key":"workspace_id","description":"The ID of the workspace."},{"key":"agent_id","description":"The ID of the agent."},{"key":"dashboard_id","description":"Unique identifier for the dashboard."},{"key":"header_link_id","description":"Header link identifier."},{"key":"listId","description":"The ID of the list to update."},{"key":"workspaceId","description":"The ID of the workspace the list belongs to."},{"key":"source_id","description":"The ID of the rate limited source."},{"key":"redaction_id","description":"The ID of the redaction."},{"key":"request_id","description":"The ID of the request."},{"key":"rule_id","description":"The ID of the rule."},{"key":"signal_id","description":"The ID of the custom signal."},{"key":"threshold_id","description":"The ID of the threshold."},{"key":"virtual_patch_id","description":"The ID of the virtual patch."},{"key":"alert_id","description":"The ID of the workspace alert."},{"key":"definition_id","description":"The ID of the definition that is requested."},{"key":"integration_id","description":"The ID of the integration."},{"key":"domain_name","description":"The name of the domain or domains associated with this service."},{"key":"healthcheck_name","description":"The name of the health check."},{"key":"config_store_id","description":"An alphanumeric string identifying the config store."},{"key":"config_store_item_key","description":"Item key, maximum 256 characters."},{"key":"store_id","description":"ID of the store."},{"key":"key","description":"The key of the item to be added, updated, retrieved, or deleted. Refer to https://docs.fastly.com/products/compute-resource-limits#kv-store for limitations on the key."},{"key":"access_key","description":"access key to lookup or delete."},{"key":"secret_name","description":"Named identifier for the new secret store value."},{"key":"environment_name"},{"key":"tls_activation_id","description":"Alphanumeric string identifying a TLS activation."},{"key":"tls_certificate_id","description":"Alphanumeric string identifying a TLS certificate."},{"key":"tls_private_key_id","description":"Alphanumeric string identifying a private Key."},{"key":"mutual_authentication_id","description":"Alphanumeric string identifying a mutual authentication."},{"key":"certificate_id","description":"Alphanumeric string identifying a TLS bulk certificate."},{"key":"tls_subscription_id","description":"Alphanumeric string identifying a TLS subscription."},{"key":"tls_authorization_id","description":"Alphanumeric string identifying a TLS subscription."},{"key":"globalsign_email_challenge_id","description":"Alphanumeric string identifying a GlobalSign email challenge."},{"key":"from_version_id","description":"The version number of the service to which changes in the generated VCL are being compared. Can either be a positive number from 1 to your maximum version or a negative number from -1 down (-1 is latest version etc)."},{"key":"to_version_id","description":"The version number of the service from which changes in the generated VCL are being compared. Uses same numbering scheme as from."},{"key":"subject","description":"The subject to search for. Supports regular expressions."},{"key":"section","description":"The section to search for. Supports regular expressions."},{"key":"website_id","description":"Website identifier."},{"key":"page_id","description":"Page identifier."},{"key":"script_id","description":"Script identifier."},{"key":"policy_id","description":"Policy identifier."},{"key":"tsig_key_id","description":"The TSIG Key Identifier (UUID)."},{"key":"zone_id","description":"The Zone Identifier (UUID)."},{"key":"cached_url","description":"URL of object in cache to be purged."},{"key":"surrogate_key","description":"Surrogate keys are used to efficiently purge content from cache. Instead of purging your entire site or individual URLs, you can tag related assets (like all images and descriptions associated with a single product) with surrogate keys, and these grouped URLs can be purged in a single request."},{"key":"apex_redirect_id"},{"key":"cache_settings_name","description":"Name for the cache settings object."},{"key":"condition_name","description":"Name of the condition. Required."},{"key":"gzip_name","description":"Name of the gzip configuration."},{"key":"header_name","description":"A handle to refer to this Header object."},{"key":"rate_limiter_id","description":"Alphanumeric string identifying the rate limiter."},{"key":"request_settings_name","description":"Name for the request settings."},{"key":"response_object_name","description":"Name for the request settings."},{"key":"name","description":"The name for the snippet."},{"key":"vcl_name","description":"The name of this VCL."}]}