What is the difference between the id, uuid, and _uid?

Difference between id and uuid

The story id is the legacy default ID. It is included in the API response to not introduce any breaking changes. It is strongly recommended to use the uuid in your projects. A story's uuid is unique throughout a Storyblok space.

        
      {
  "story": {
    "name": "Home",
    "created_at": "2024-12-12T12:26:45.709Z",
    "published_at": "2024-12-12T16:58:56.117Z",
    "updated_at": "2024-12-12T16:58:56.131Z",
+    "id": 594732881,
+    "uuid": "1de2df45-6c23-4e86-b9c4-508a27f17df7",
    "content": {
    }
  },
  "cv": 1734022736,
  "rels": [],
  "links": []
}

What is the _uid?

The _uid constitutes the ID of each individual component within a story. It is required for certain functionality of the Visual Editor, i.e., opening components in the editor upon clicking on them in the preview environment. A component's _uid is only unique within the scope of a particular story.

        
      {
  "story": {
    "name": "Home",
    "created_at": "2024-12-12T12:26:45.709Z",
    "published_at": "2024-12-12T16:58:56.117Z",
    "updated_at": "2024-12-12T16:58:56.131Z",
    "id": 594732881,
    "uuid": "1de2df45-6c23-4e86-b9c4-508a27f17df7",
    "content": {
+      "_uid": "efe14cd9-4023-44dd-b221-d2b63a5d3597",
      "body": [
        {
+          "_uid": "46dc611d-5f23-44fc-b4d8-36b28a82d1c2",
          "headline": "Hello world!",
          "component": "teaser"
        },
        {
+          "_uid": "e4a50a8c-3591-4a4c-a0d5-b81d10e0d8b7",
          "columns": [
            {
+              "_uid": "36061262-f935-44cd-b3ee-771957f2d91e",
              "name": "Feature 1",
              "component": "feature"
            },
            {
+              "_uid": "7577e22f-754e-4112-b42b-cb7d38ea64ac",
              "name": "Feature 2",
              "component": "feature"
            },
            {
+              "_uid": "7e6d281f-3fc8-46d1-87ce-6f9fd889a3b3",
              "name": "Feature 3",
              "component": "feature"
            }
          ],
          "component": "grid"
        }
      ],
      "component": "page"
    }
  },
  "cv": 1734022736,
  "rels": [],
  "links": []
}