Content Management API > Record

Validates an existing record field

Body parameters

id string Required

RFC 4122 UUID of record expressed in URL-safe base64 format

Example:

"hWl-mnkWRYmMCSTq4z_piQ"

type string Required

Must be exactly "item".

relationships.item_type.data Required

The record's model

Type: ResourceLinkage<"item_type">

relationships.creator.data Optional

The entity (account/collaborator/access token/sso user) who created the record

Type: ResourceLinkage<"account">, ResourceLinkage<"access_token">, ResourceLinkage<"user">, ResourceLinkage<"sso_user">, ResourceLinkage<"organization">

Examples

1
POST https://site-api.datocms.com/items/:item_id/validate HTTP/1.1
2
Authorization: Bearer YOUR-API-TOKEN
3
Accept: application/json
4
X-Api-Version: 3
5
Content-Type: application/vnd.api+json
6

7
{
8
  "data": {
9
    "id": "hWl-mnkWRYmMCSTq4z_piQ",
10
    "type": "item",
11
    "attributes": {
12
      "title": "My first blog post!",
13
      "content": "Lorem ipsum dolor sit amet...",
14
      "category": "24",
15
      "image": {
16
        "upload_id": "1235",
17
        "alt": "Alt text",
18
        "title": "Image title",
19
        "custom_data": {}
20
      }
21
    },
22
    "relationships": {
23
      "item_type": {
24
        "data": {
25
          "type": "item_type",
26
          "id": "DxMaW10UQiCmZcuuA-IkkA"
27
        }
28
      }
29
    }
30
  }
31
}

1
curl -g 'https://site-api.datocms.com/items/:item_id/validate' \
2
  -X POST \
3
  -H "Authorization: Bearer YOUR-API-TOKEN" \
4
  -H "Accept: application/json" \
5
  -H "X-Api-Version: 3" \
6
  -H "Content-Type: application/vnd.api+json" \
7
  --data-binary '{"data":{"id":"hWl-mnkWRYmMCSTq4z_piQ","type":"item","attributes":{"title":"My first blog post!","content":"Lorem ipsum dolor sit amet...","category":"24","image":{"upload_id":"1235","alt":"Alt text","title":"Image title","custom_data":{}}},"relationships":{"item_type":{"data":{"type":"item_type","id":"DxMaW10UQiCmZcuuA-IkkA"}}}}}'

1
await fetch("https://site-api.datocms.com/items/:item_id/validate", {
2
  method: "POST",
3
  headers: {
4
    Authorization: "Bearer YOUR-API-TOKEN",
5
    Accept: "application/json",
6
    "X-Api-Version": "3",
7
    "Content-Type": "application/vnd.api+json",
8
  },
9
  body: JSON.stringify({
10
    data: {
11
      id: "hWl-mnkWRYmMCSTq4z_piQ",
12
      type: "item",
13
      attributes: {
14
        title: "My first blog post!",
15
        content: "Lorem ipsum dolor sit amet...",
16
        category: "24",
17
        image: {
18
          upload_id: "1235",
19
          alt: "Alt text",
20
          title: "Image title",
21
          custom_data: {},
22
        },
23
      },
24
      relationships: {
25
        item_type: {
26
          data: { type: "item_type", id: "DxMaW10UQiCmZcuuA-IkkA" },
27
        },
28
      },
29
    },
30
  }),
31
});

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.