---
title: Settings
summary: Handles default settings for a particular version of a service.
url: https://www.fastly.com/documentation/reference/api/vcl-services/settings
---

Handles default settings for a particular version of a service.

## Data model

| Field | Type | Description |
|-------|------|-------------|
| `general.default_host` | string | The default host name for the version. |
| `general.default_ttl` | integer | The default time-to-live (TTL) for the version. |
| `general.stale_if_error` | boolean | Enables serving a stale object if there is an error. |
| `general.stale_if_error_ttl` | integer | The default time-to-live (TTL) for serving the stale object for the version. |
| `service_id` | string | Alphanumeric string identifying the service. (Read-only) |
| `version` | integer | Integer identifying a service version. (Read-only) |

## API endpoints

### Get service settings

**GET** `/service/{service_id}/version/{version_id}/settings`

Get the settings for a particular service and version.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `service_id` | string | path | Yes | Alphanumeric string identifying the service. |
| `version_id` | integer | path | Yes | Integer identifying a service version. |

### Update service settings

**PUT** `/service/{service_id}/version/{version_id}/settings`

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.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `service_id` | string | path | Yes | Alphanumeric string identifying the service. |
| `version_id` | integer | path | Yes | Integer identifying a service version. |