Update a model/block model
Body parameters
Name of the model/block model
"Blog post"
API key of the model/block model
"post"
The way the model/block model collection should be presented to the editors
"compact"
Compact view
Tabular view
Whether the model is single-instance or not. This property only applies to models, not block models
Whether we require all the project locales to be present for each localized field or not
Whether editors can sort records via drag & drop or not. Must be false for block models
Whether this is a block model or not. Block models define structures that can be embedded inside records, while regular models create standalone records
Whether draft/published mode is active or not. Must be false for block models
Whether draft records can be saved without satisfying the validations or not. Must be false for block models
Whether editors can organize records in a tree or not. Must be false for block models
If an ordering field is set, this field specifies the sorting direction. This property does not apply to block models
Ascending order
Descending order
Specifies the model's sorting method. Cannot be set in concurrency with ordering_field. This property does not apply to block models
"created_at"
Order by date of creation
Order by date of last update
Order by date of first publication
Order by date of last publication
A hint shown to editors to help them understand the purpose of this model/block model
"Blog posts will be shown in our website under the Blog section"
Whether inverse relationships fields are expressed in GraphQL or not. Must be false for block models
If this model is single-instance, this tells whether the single-instance record has already been created or not. This property only applies to models, not block models
The field upon which the collection is sorted. This relationship does not apply to block models
The field to use as presentation title
The field to use as presentation image
The field to use as fallback title for SEO purposes. This relationship does not apply to block models
The field to use as fallback image for SEO purposes. This relationship does not apply to block models
The field to use as fallback description for SEO purposes. This relationship does not apply to block models
The way the model collection should be presented to the editors
This field contains a typo and will be removed in future versions: use collection_appearance instead
"compact"
Compact view
Tabular view
Returns
Returns a resource object of type item_type
Examples
import { buildClient } from "@datocms/cma-client-node";
async function run() { const client = buildClient({ apiToken: process.env.DATOCMS_API_TOKEN });
const modelIdOrApiKey = "blog_post";
const itemType = await client.itemTypes.update(modelIdOrApiKey, { id: "DxMaW10UQiCmZcuuA-IkkA", });
// Check the 'Returned output' tab for the result ☝️ console.log(itemType);}
run();{ id: "DxMaW10UQiCmZcuuA-IkkA", name: "Blog post", api_key: "post", singleton: false, sortable: true, modular_block: false, tree: false, ordering_direction: null, ordering_meta: "created_at", draft_mode_active: false, all_locales_required: false, collection_appearance: "compact", hint: "Blog posts will be shown in our website under the Blog section", inverse_relationships_enabled: false, draft_saving_active: false, meta: { has_singleton_item: false }, singleton_item: null, fields: [{ type: "field", id: "Pkg-oztERp6o-Rj76nYKJg" }], fieldsets: [{ type: "fieldset", id: "93Y1C2sySkG4Eg0atBRIwg" }], presentation_title_field: null, presentation_image_field: null, title_field: null, image_preview_field: null, excerpt_field: null, ordering_field: null, workflow: null,}