Home
Content Management API
Main resources
Upload-related
Site Search
Environments
UI
Workflows
Async jobs
Roles & permissions
Webhooks
Hosting & CI integrations
Subscription
Enterprise
    Show examples in:
    Create a new fieldset

    Parameters

    title  string  Required

    The title of the fieldset

    hint  string, null  Optional

    Description/contextual hint for the fieldset

    position  integer  Optional

    Ordering index

    collapsible  boolean  Optional

    Whether the fieldset can be collapsed or not

    start_collapsed  boolean  Optional

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

    Returns

    Returns a fieldset resource object.

    Examples

    Example code:
    import { buildClient } from '@datocms/cma-client-node';
    async function run() {
      const client = buildClient({ apiToken: '<YOUR_API_TOKEN>' });
      
      const modelIdOrApiKey = 'blog_post';
      
      const fieldset = await client.fieldsets.create(modelIdOrApiKey, {
        title: 'SEO-related fields',
        hint: 'Please fill in these fields!',
        position: 1,
        collapsible: true,
        start_collapsed: false
      });
      
      console.log(fieldset);
    }
    run();
    Returned output:
    {
      id: '124',
      title: 'SEO-related fields',
      hint: 'Please fill in these fields!',
      collapsible: true,
      start_collapsed: false,
      position: 1,
      item_type: {
        type: 'item_type',
        id: '44'
      }
    }
    Questions?
    We're always happy to help with code or other questions you might have. Search our documentation, forum, contact support, or connect with our sales team. You can chat live with other developers in our Slack channel.