Content Management API > Record version

List all record versions

Query parameters

nested boolean

For Modular Content, Structured Text and Single Block fields. If set, returns full payload for nested blocks instead of IDs

page object

Parameters to control offset-based pagination

offset integer

The (zero-based) offset of the first entity returned in the collection (defaults to 0)

Example:

limit integer

The maximum number of entities to return (defaults to 15, maximum is 50)

Returns

Returns an array of resource objects of type item_version.

Examples

1
GET https://site-api.datocms.com/items/:item_id/versions HTTP/1.1
2
Authorization: Bearer YOUR-API-TOKEN
3
Accept: application/json
4
X-Api-Version: 3

1
curl -g 'https://site-api.datocms.com/items/:item_id/versions' \
2
   \
3
  -H "Authorization: Bearer YOUR-API-TOKEN" \
4
  -H "Accept: application/json" \
5
  -H "X-Api-Version: 3"

1
await fetch("https://site-api.datocms.com/items/:item_id/versions", {
2
  headers: {
3
    Authorization: "Bearer YOUR-API-TOKEN",
4
    Accept: "application/json",
5
    "X-Api-Version": "3",
6
  },
7
});

1
HTTP/1.1 200 OK
2
Content-Type: application/json
3
Cache-Control: cache-control: max-age=0, private, must-revalidate
4
X-RateLimit-Limit: 30
5
X-RateLimit-Remaining: 28
6

7
{
8
  "data": [
9
    {
10
      "type": "item_version",
11
      "id": "59JSonvYTCOUDz_b7_6hvA",
12
      "attributes": {
13
        "title": "My first blog post!",
14
        "content": "Lorem ipsum dolor sit amet...",
15
        "category": "24",
16
        "image": {
17
          "alt": "Alt text",
18
          "title": "Image title",
19
          "custom_data": {},
20
          "focal_point": null,
21
          "upload_id": "20042921"
22
        }
23
      },
24
      "relationships": {
25
        "item_type": {
26
          "data": {
27
            "type": "item_type",
28
            "id": "DxMaW10UQiCmZcuuA-IkkA"
29
          }
30
        },
31
        "item": {
32
          "data": {
33
            "type": "item",
34
            "id": "hWl-mnkWRYmMCSTq4z_piQ"
35
          }
36
        },
37
        "editor": {
38
          "data": {
39
            "type": "account",
40
            "id": "312"
41
          }
42
        }
43
      },
44
      "meta": {
45
        "created_at": "2020-04-21T07:57:11.124Z",
46
        "is_published": true,
47
        "is_current": true
48
      }
49
    }
50
  ],
51
  "meta": {
52
    "total_count": 20
53
  }
54
}

Did this doc help you?

Need help?

Explore our forum, contact support, or connect with our sales team . You can also chat live with other users in our Slack channel.