---
title: "Get presets list"
method: GET
path: "/cdn/presets"
tags: ["Presets"]
---

# Get presets list

`GET /cdn/presets`

## Request

- Base URL: `https://api.gcore.com`
- URL: `https://api.gcore.com/cdn/presets`
- Auth: HTTP apikey

Get the list of presets available to your account.

A preset is a predefined set of CDN resource or rule settings that can be applied to an object in one request.

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Successful.

- union
  - PresetResponse[]
    - `id` integer: Preset ID.
    - `name` string: Preset name.
    - `service` 'cdn': Service the preset belongs to.
    - `object_type` 'CDNResource' | 'Rule': Type of object the preset can be applied to. Possible values: - **CDNResource** - Preset is applied to a CDN resource. - **Rule** - Preset is applied to a rule.
    - `preset_settings` PresetSettings: CDN resource or rule settings that the preset applies to the target object, including the **options** object. The available keys match the writable fields of the object type the preset targets (`object_type`). Options included in the preset cannot be edited on the object while the preset is applied.
  - object
    - `count` integer, required: Total number of items.
    - `next` string, nullable, required: URL to the next page of results. Null if current page is the last one.
    - `previous` string, nullable, required: URL to the previous page of results. Null if current page is the first one.
    - `results` PresetResponse[], required: List of items on the current page.
      - `id` integer: Preset ID.
      - `name` string: Preset name.
      - `service` 'cdn': Service the preset belongs to.
      - `object_type` 'CDNResource' | 'Rule': Type of object the preset can be applied to. Possible values: - **CDNResource** - Preset is applied to a CDN resource. - **Rule** - Preset is applied to a rule.
      - `preset_settings` PresetSettings: CDN resource or rule settings that the preset applies to the target object, including the **options** object. The available keys match the writable fields of the object type the preset targets (`object_type`). Options included in the preset cannot be edited on the object while the preset is applied.

## Changes

- **2026-09-04** `796429501557`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/g-core/apis/gcore-openapi/changes/cdn/presets/get.md)

---

[API](https://skmtc.dev/g-core/apis/gcore-openapi.md) - [All operations](https://skmtc.dev/g-core/apis/gcore-openapi/llms.txt) - [OpenAPI document](https://skmtc.dev/g-core/apis/gcore-openapi/revisions/a2b772345f3a?raw)