Create a new filter - Model filter - Content Management API

The ordering to apply with this filter, or null for the default model ordering. It follows the form of the order_by query parameter of the List all records endpoint.

shared boolean Optional

Whether it's a shared filter or not

item_type { type: "item_type", id: item_type.id } Required

Model associated with the filter

Returns

Returns a item_type_filter resource object.

Examples

Example code:

import { buildClient } from '@datocms/cma-client-node';
async function run() {
  const client = buildClient({ apiToken: '<YOUR_API_TOKEN>' });
  
  const itemTypeFilter = await client.itemTypeFilters.create({
    name: 'Draft posts',
    filter: {
      query: 'foo bar',
      fields: {
        _status: {
          eq: 'draft'
        },
        title: {
          matches: {
            pattern: 'qux',
            case_sensitive: 'false',
            regexp: 'false'
          }
        }
      }
    },
    columns: [
      {
        name: '_preview',
        width: 0.6
      },
      {
        name: 'slug',
        width: 0.1
      },
      {
        name: '_status',
        width: 0.1
      },
      {
        name: '_updated_at',
        width: 0.2
      }
    ],
    order_by: '_updated_at_ASC',
    shared: true,
    item_type: {
      type: 'item_type',
      id: '44'
    }
  });
  
  console.log(itemTypeFilter);
}
run();

Returned output:

{
  id: '34',
  name: 'Draft posts',
  filter: {
    query: 'foo bar',
    fields: {
      _status: {
        eq: 'draft'
      },
      title: {
        matches: {
          pattern: 'qux',
          case_sensitive: 'false',
          regexp: 'false'
        }
      }
    }
  },
  columns: [
    {
      name: '_preview',
      width: 0.6
    },
    {
      name: 'slug',
      width: 0.1
    },
    {
      name: '_status',
      width: 0.1
    },
    {
      name: '_updated_at',
      width: 0.2
    }
  ],
  order_by: '_updated_at_ASC',
  shared: true,
  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.