Content Management API > Fieldset

Retrieve a fieldset

Query parameters

fields object

Sparse fieldsets: for each entity type, the attributes and the relationships to return, separated by commas. Each entity declares its attributes and its relationships in its own schema.

fieldset string

Attributes and relationships to return for each fieldset that this endpoint returns.

Example:

"title,hint,collapsible,item_type"

Returns

Returns a resource object of type fieldset.

Examples

1
GET https://site-api.datocms.com/fieldsets/:fieldset_id 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/fieldsets/:fieldset_id' \
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/fieldsets/:fieldset_id", {
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
    "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
}