Links

Get all links

Endpoint

GET /v1/cdn/links

Parameters

Name Description
token required Public token for published or private token for draft version
starts_with Starts with slug
version Published or draft version

Request

Query Parameters

token=wANpEQEsMYGOwLxwXQ76Ggtt

cURL

curl "https://api.storyblok.com/v1/cdn/links?token=wANpEQEsMYGOwLxwXQ76Ggtt" -X GET \
	-H "Accept: application/json" \
	-H "Content-Type: application/json"

Response

Body

{
  "links": {
    "ce2fcdfc-b4af-42a6-b4d3-9b0019064370": {
      "id": 971,
      "slug": "home2",
      "name": "Home2",
      "is_folder": false,
      "parent_id": 0,
      "published": true,
      "position": -10,
      "uuid": "ce2fcdfc-b4af-42a6-b4d3-9b0019064370",
      "is_startpage": false
    },
    "a8afab95-7c8c-4735-a7b8-88ef7ddf6f44": {
      "id": 970,
      "slug": "de/home1",
      "name": "Home1",
      "is_folder": false,
      "parent_id": 969,
      "published": false,
      "position": 0,
      "uuid": "a8afab95-7c8c-4735-a7b8-88ef7ddf6f44",
      "is_startpage": false
    },
    "7671207c-d4f1-44e6-9829-412e85176641": {
      "id": 969,
      "slug": "de",
      "name": "de",
      "is_folder": true,
      "parent_id": 0,
      "published": false,
      "position": 0,
      "uuid": "7671207c-d4f1-44e6-9829-412e85176641",
      "is_startpage": false
    }
  }
}

Get all links that start with de slug

Endpoint

GET /v1/cdn/links

Parameters

Name Description
token required Public token for published or private token for draft version
starts_with Starts with slug
version Published or draft version

Request

Query Parameters

token=wANpEQEsMYGOwLxwXQ76Ggtt
starts_with=de

cURL

curl "https://api.storyblok.com/v1/cdn/links?token=wANpEQEsMYGOwLxwXQ76Ggtt&starts_with=de" -X GET \
	-H "Accept: application/json" \
	-H "Content-Type: application/json"

Response

Body

{
  "links": {
    "f695b48c-bded-4296-a4e5-d3dedb2d3a15": {
      "id": 973,
      "slug": "de/home1",
      "name": "Home1",
      "is_folder": false,
      "parent_id": 972,
      "published": false,
      "position": 0,
      "uuid": "f695b48c-bded-4296-a4e5-d3dedb2d3a15",
      "is_startpage": false
    },
    "ffc461bb-93f2-48b7-8cfc-6b25c247ec57": {
      "id": 972,
      "slug": "de",
      "name": "de",
      "is_folder": true,
      "parent_id": 0,
      "published": false,
      "position": 0,
      "uuid": "ffc461bb-93f2-48b7-8cfc-6b25c247ec57",
      "is_startpage": false
    }
  }
}

Get a single link

Endpoint

GET /v1/cdn/links/:id

Parameters

Name Description
token required Public token for published or private token for draft version
id required Uuid of the link

Request

Query Parameters

token=wANpEQEsMYGOwLxwXQ76Ggtt

cURL

curl "https://api.storyblok.com/v1/cdn/links/22556cec-30c2-45d0-9025-86296f87b134?token=wANpEQEsMYGOwLxwXQ76Ggtt" -X GET \
	-H "Accept: application/json" \
	-H "Content-Type: application/json"

Response

Body

{
  "link": {
    "id": 978,
    "slug": "test",
    "name": "Test",
    "is_folder": false,
    "parent_id": 0,
    "published": true,
    "position": -20,
    "uuid": "22556cec-30c2-45d0-9025-86296f87b134",
    "is_startpage": false
  }
}

Documentation