Content Management API > Fieldset

Create a new fieldset

Body parameters

id string Optional

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

Example:

"93Y1C2sySkG4Eg0atBRIwg"

type string Required

Must be exactly "fieldset".

attributes.title string Required

The title of the fieldset

Example:

"SEO-related fields"

attributes.hint string, null Optional

Description/contextual hint for the fieldset

Example:

"Please fill in these fields!"

attributes.position integer Optional

Ordering index

Example:

attributes.collapsible boolean Optional

Whether the fieldset can be collapsed or not

attributes.start_collapsed boolean Optional

When fieldset is collapsible, determines if the default is to start collapsed or not

Returns

Returns a resource object of type fieldset.

Examples

1
POST https://site-api.datocms.com/item-types/:model_id_or_api_key/fieldsets 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
    "type": "fieldset",
10
    "attributes": {
11
      "title": "SEO-related fields"
12
    }
13
  }
14
}

1
curl -g 'https://site-api.datocms.com/item-types/:model_id_or_api_key/fieldsets' \
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":{"type":"fieldset","attributes":{"title":"SEO-related fields"}}}'

1
await fetch(
2
  "https://site-api.datocms.com/item-types/:model_id_or_api_key/fieldsets",
3
  {
4
    method: "POST",
5
    headers: {
6
      Authorization: "Bearer YOUR-API-TOKEN",
7
      Accept: "application/json",
8
      "X-Api-Version": "3",
9
      "Content-Type": "application/vnd.api+json",
10
    },
11
    body: JSON.stringify({
12
      data: { type: "fieldset", attributes: { title: "SEO-related fields" } },
13
    }),
14
  },
15
);

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
    "type": "fieldset",
10
    "id": "93Y1C2sySkG4Eg0atBRIwg",
11
    "attributes": {
12
      "title": "SEO-related fields",
13
      "hint": "Please fill in these fields!",
14
      "position": 1,
15
      "collapsible": true,
16
      "start_collapsed": false
17
    },
18
    "relationships": {
19
      "item_type": {
20
        "data": {
21
          "type": "item_type",
22
          "id": "DxMaW10UQiCmZcuuA-IkkA"
23
        }
24
      }
25
    }
26
  }
27
}

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.