List a site's fragments

curl

curl -sS "https://api.shftd2.com/v1/sites/news-site.example/fragments" \
  -H "Authorization: Bearer $DS_MANAGEMENT_TOKEN"

{
  "items": [
    {
      "id": "frg_examplefr1",
      "site_id": "sit_examplesite1",
      "domain": "news-site.example",
      "ref": "/1234567/news-site/organic/politics",
      "name": "Politics",
      "description": null,
      "lang": "en",
      "key_values": {
        "section": [
          "politics"
        ]
      },
      "status": "active",
      "created_at": "2026-09-26T09:00:00.000Z"
    },
    {
      "id": "frg_examplefr2",
      "site_id": "sit_examplesite1",
      "domain": "news-site.example",
      "ref": "/1234567/news-site/organic/sports",
      "name": "Sports",
      "description": "Sports section",
      "lang": "en",
      "key_values": {},
      "status": "paused",
      "created_at": "2026-09-26T09:00:00.000Z"
    }
  ]
}

Authorizations

Authorization

string

header

required

A management token: ds_mgmt_ followed by 40 lowercase hexadecimal characters, created by an owner in Settings → Management tokens. Opaque: send it as is, in the Authorization header only.

Path Parameters

domain

string

required

The site's bare domain, normalized like the console form (trimmed, lowercase). www.news-site.example and news-site.example are two different sites. A domain that is not a site of this organisation — absent, another organisation's, or not a valid domain — is 404, except on PUT /v1/sites/{domain}, which creates the site and answers 422 for an invalid domain.

Response

The fragments.

items

object[]

required

Show child attributes

curl

curl -sS "https://api.shftd2.com/v1/sites/news-site.example/fragments" \
  -H "Authorization: Bearer $DS_MANAGEMENT_TOKEN"

{
  "items": [
    {
      "id": "frg_examplefr1",
      "site_id": "sit_examplesite1",
      "domain": "news-site.example",
      "ref": "/1234567/news-site/organic/politics",
      "name": "Politics",
      "description": null,
      "lang": "en",
      "key_values": {
        "section": [
          "politics"
        ]
      },
      "status": "active",
      "created_at": "2026-09-26T09:00:00.000Z"
    },
    {
      "id": "frg_examplefr2",
      "site_id": "sit_examplesite1",
      "domain": "news-site.example",
      "ref": "/1234567/news-site/organic/sports",
      "name": "Sports",
      "description": "Sports section",
      "lang": "en",
      "key_values": {},
      "status": "paused",
      "created_at": "2026-09-26T09:00:00.000Z"
    }
  ]
}

Start here

Configure

Integrate

Management API

Reference

List a site's fragments

Authorizations

Path Parameters

Response