DatoCMS

App · 29 actions

Manage your DatoCMS content: create, search, update, publish and schedule records, set up models and fields, organise assets and start website deploys.

Actions

ActionWhat it does
Cancel scheduled publicationCancel a record's scheduled publication.
Cancel scheduled unpublishingCancel a record's scheduled unpublishing.
Create fieldAdd a field to a model: text, number, yes or no, date, date and time, JSON or color.
Create modelCreate a model (a content type such as Blog post).
Create recordCreate a record of a model from values keyed by field API key.
Delete assetDelete an asset from the media area.
Delete fieldDelete a field and its values in every record of the model.
Delete modelDelete a model together with all its fields and every record made from it.
Delete recordDelete a record, including its published version.
Get assetGet one asset with its link, size, type, tags, credits and collection.
Get modelGet one model with its settings and the ids of its fields.
Get projectGet the connected DatoCMS project: its name, languages, time zone, domain and when its content last changed.
Get recordGet one record with its values and publication state.
List asset collectionsList the collections (folders) the media area is organised in.
List assetsList or search the files in the media area by name, tag or text.
List build triggersList the project's build triggers (deploy hooks) with their last build status.
List fieldsList the fields of a model with their types and API keys.
List modelsList every model and block model in the project.
List record versionsList a record's saved versions, newest first, with the values each had and which one is published.
List recordsList or search records, filtered by model, text, publication status or when they last changed.
Publish recordPublish a record's current version so it is served to your website.
Schedule publicationPublish a record automatically at a future date and time.
Schedule unpublishingTake a published record off your website automatically at a future date and time.
Trigger deployStart a deploy of your website through one of the project's build triggers.
Unpublish recordTake a record off your website.
Update assetChange an asset's file name, author, copyright, notes, tags or collection.
Update fieldChange a field's label, API key, hint or whether it is required.
Update modelChange a model's name, API key, hint or settings.
Update recordChange some values of a record.

Cancel scheduled publication

Cancel a record's scheduled publication.

Inputs

Record IDrecord_idtextRequired
The record's id, from 'List records' or an earlier step.

Outputs

recordobject
The record
Example output
{
  "record": {
    "created_at": "2026-11-03T09:00:00.000Z",
    "current_version": "Hk2nQ8vXRD-LmN4pOa7bcA",
    "fields": {
      "title": "My first blog post"
    },
    "first_published_at": "",
    "id": "A4gkL_8pTZmcyJ-IlIEd2w",
    "is_valid": true,
    "model_id": "Wg5eKcLZQ7yYb-3dUx2p0A",
    "publication_scheduled_at": "",
    "published_at": "",
    "status": "draft",
    "unpublishing_scheduled_at": "",
    "updated_at": "2026-11-03T09:00:00.000Z"
  }
}

Cancel scheduled unpublishing

Cancel a record's scheduled unpublishing.

Inputs

Record IDrecord_idtextRequired
The record's id, from 'List records' or an earlier step.

Outputs

recordobject
The record
Example output
{
  "record": {
    "created_at": "2026-11-03T09:00:00.000Z",
    "current_version": "Hk2nQ8vXRD-LmN4pOa7bcA",
    "fields": {
      "title": "My first blog post"
    },
    "first_published_at": "",
    "id": "A4gkL_8pTZmcyJ-IlIEd2w",
    "is_valid": true,
    "model_id": "Wg5eKcLZQ7yYb-3dUx2p0A",
    "publication_scheduled_at": "",
    "published_at": "",
    "status": "draft",
    "unpublishing_scheduled_at": "",
    "updated_at": "2026-11-03T09:00:00.000Z"
  }
}

Create field

Add a field to a model: text, number, yes or no, date, date and time, JSON or color. Other types are added in DatoCMS.

Inputs

Modelmodel_idtextRequired
The model or block model. Pick one, or give its id or API key from an earlier step.
LabellabeltextRequired
The field's name as editors see it.
API keyapi_keytextRequired
The key records use for this field: lowercase letters, digits and underscores, starting with a letter.
Typefield_typetextRequired
What kind of value the field holds.One of: string (Single-line text), text (Multi-line text), integer (Integer number), float (Decimal number), boolean (Yes or no), date, date_time (Date and time), json, color.
Requiredrequiredtrue/false
Editors must fill the field in to save a record.
Translatedlocalizedtrue/false
Keep a separate value for each of the project's languages.
Hinthinttext
Help text shown to editors under the field.

Outputs

fieldobject
The field
Example output
{
  "field": {
    "api_key": "title",
    "field_type": "string",
    "hint": "",
    "id": "Dk3mP9sRTQ-AaB7cZ1x2yw",
    "label": "Title",
    "localized": false,
    "model_id": "Wg5eKcLZQ7yYb-3dUx2p0A",
    "position": 1,
    "required": true,
    "validators": {
      "required": {}
    }
  }
}

Create model

Create a model (a content type such as Blog post). Add its fields with 'Create field'.

Inputs

NamenametextRequired
The model's name as editors see it.
API keyapi_keytextRequired
The key used to address the model: lowercase letters, digits and underscores, starting with a letter.
Drafts and publishingdraft_mode_activetrue/false
Records start as drafts and go live when published. Needed to schedule publication. Leave unset for DatoCMS's default.
Single record onlysingletontrue/false
The model holds exactly one record, like a settings page.
Editors can reordersortabletrue/false
Let editors drag records into an order.
Hinthinttext
Help text for editors about what the model is for.

Outputs

modelobject
The model
Example output
{
  "model": {
    "api_key": "blog_post",
    "draft_mode_active": true,
    "field_ids": [
      "Dk3mP9sRTQ-AaB7cZ1x2yw"
    ],
    "hint": "",
    "id": "Wg5eKcLZQ7yYb-3dUx2p0A",
    "is_block": false,
    "name": "Blog post",
    "singleton": false,
    "sortable": false,
    "tree": false
  }
}

Create record

Create a record of a model from values keyed by field API key. In a model with drafts it starts as a draft; use 'Publish record' to make it live.

Inputs

Modelmodel_idtextRequired
The model (content type) of the records. Pick one, or give its id or API key from an earlier step.
ValuesdataobjectRequired
The values to set, keyed by each field's API key, for example {"title": "Hello"}. Use the same shapes DatoCMS shows for each field type: dates as 2026-11-03, localized fields as an object per locale.

Outputs

recordobject
The record
Example output
{
  "record": {
    "created_at": "2026-11-03T09:00:00.000Z",
    "current_version": "Hk2nQ8vXRD-LmN4pOa7bcA",
    "fields": {
      "title": "My first blog post"
    },
    "first_published_at": "",
    "id": "A4gkL_8pTZmcyJ-IlIEd2w",
    "is_valid": true,
    "model_id": "Wg5eKcLZQ7yYb-3dUx2p0A",
    "publication_scheduled_at": "",
    "published_at": "",
    "status": "draft",
    "unpublishing_scheduled_at": "",
    "updated_at": "2026-11-03T09:00:00.000Z"
  }
}

Delete asset

Delete an asset from the media area. DatoCMS refuses if a record still uses it.

Inputs

Asset IDupload_idtextRequired
The asset's id, from 'List assets' or an earlier step.

Outputs

deletedtrue/false
Always true once deleted
upload_idtext
The asset deleted
Example output
{
  "deleted": true,
  "upload_id": "dLJdPzC3TW-mJXGo7K73Gg"
}

Delete field

Delete a field and its values in every record of the model. This cannot be undone.

Inputs

Field IDfield_idtextRequired
The field's id, from 'List fields' or 'Create field'.

Outputs

deletedtrue/false
Always true once deleted
field_idtext
The field deleted
Example output
{
  "deleted": true,
  "field_id": "Dk3mP9sRTQ-AaB7cZ1x2yw"
}

Delete model

Delete a model together with all its fields and every record made from it. This cannot be undone.

Inputs

Modelmodel_idtextRequired
The model or block model. Pick one, or give its id or API key from an earlier step.

Outputs

deletedtrue/false
Always true once deleted
model_idtext
The model deleted
Example output
{
  "deleted": true,
  "model_id": "Wg5eKcLZQ7yYb-3dUx2p0A"
}

Delete record

Delete a record, including its published version.

Inputs

Record IDrecord_idtextRequired
The record's id, from 'List records' or an earlier step.

Outputs

deletedtrue/false
Always true once deleted
record_idtext
The record deleted
Example output
{
  "deleted": true,
  "record_id": "A4gkL_8pTZmcyJ-IlIEd2w"
}

Get asset

Get one asset with its link, size, type, tags, credits and collection.

Inputs

Asset IDupload_idtextRequired
The asset's id, from 'List assets' or an earlier step.

Outputs

uploadobject
The asset
Example output
{
  "upload": {
    "author": "Jo Bloggs",
    "basename": "hero",
    "collection_id": "",
    "copyright": "",
    "created_at": "2026-11-01T09:00:00.000Z",
    "filename": "hero.png",
    "format": "png",
    "height": 900,
    "id": "dLJdPzC3TW-mJXGo7K73Gg",
    "is_image": true,
    "mime_type": "image/png",
    "notes": "",
    "path": "/45/1496845848-hero.png",
    "size": 104857,
    "smart_tags": [
      "sky"
    ],
    "tags": [
      "hero"
    ],
    "updated_at": "2026-11-01T09:00:00.000Z",
    "url": "https://www.datocms-assets.com/45/1496845848-hero.png",
    "width": 1600
  }
}

Get model

Get one model with its settings and the ids of its fields.

Inputs

Modelmodel_idtextRequired
The model or block model. Pick one, or give its id or API key from an earlier step.

Outputs

modelobject
The model
Example output
{
  "model": {
    "api_key": "blog_post",
    "draft_mode_active": true,
    "field_ids": [
      "Dk3mP9sRTQ-AaB7cZ1x2yw"
    ],
    "hint": "",
    "id": "Wg5eKcLZQ7yYb-3dUx2p0A",
    "is_block": false,
    "name": "Blog post",
    "singleton": false,
    "sortable": false,
    "tree": false
  }
}

Get project

Get the connected DatoCMS project: its name, languages, time zone, domain and when its content last changed.

Inputs

None.

Outputs

siteobject
The project
Example output
{
  "site": {
    "domain": "",
    "id": "12345",
    "internal_domain": "acme.admin.datocms.com",
    "last_data_change_at": "2026-11-03T09:00:00.000Z",
    "locales": [
      "en",
      "it"
    ],
    "name": "Acme Website",
    "no_index": false,
    "timezone": "Europe/Rome"
  }
}

Get record

Get one record with its values and publication state.

Inputs

Record IDrecord_idtextRequired
The record's id, from 'List records' or an earlier step.

Outputs

recordobject
The record
Example output
{
  "record": {
    "created_at": "2026-11-03T09:00:00.000Z",
    "current_version": "Hk2nQ8vXRD-LmN4pOa7bcA",
    "fields": {
      "title": "My first blog post"
    },
    "first_published_at": "",
    "id": "A4gkL_8pTZmcyJ-IlIEd2w",
    "is_valid": true,
    "model_id": "Wg5eKcLZQ7yYb-3dUx2p0A",
    "publication_scheduled_at": "",
    "published_at": "",
    "status": "draft",
    "unpublishing_scheduled_at": "",
    "updated_at": "2026-11-03T09:00:00.000Z"
  }
}

List asset collections

List the collections (folders) the media area is organised in.

Inputs

None.

Outputs

collectionslist
The collections
countnumber
How many
Example output
{
  "collections": [
    {
      "id": "9Zt1",
      "label": "Blog images",
      "parent_id": "",
      "position": 1
    }
  ],
  "count": 1
}

List assets

List or search the files in the media area by name, tag or text. Gets one page; to see more, run it again with the next offset it gives.

Inputs

Search textsearchtext
Only assets whose name, tags or notes match this.
Orderorder_bytext
How to sort. Defaults to newest first.One of: _created_at_DESC (Newest first (default)), _created_at_ASC (Oldest first), _updated_at_DESC (Recently updated first), size_DESC (Largest first), size_ASC (Smallest first), basename_ASC (Name, A to Z).
Page sizelimitnumber
How many to return, 1 to 500. DatoCMS's default is 30.From 1 to 500.
Skipoffsetnumber
How many to skip, to get a later page. Use the 'next_offset' of the earlier page.At least 0.

Outputs

countnumber
How many came back on this page
has_moretrue/false
True if there are more after this page
next_offsetnumber
The offset to give for the page after this one
total_countnumber
How many there are in all, across every page
uploadslist
The assets
Example output
{
  "count": 1,
  "has_more": false,
  "next_offset": 1,
  "total_count": 1,
  "uploads": [
    {
      "author": "Jo Bloggs",
      "basename": "hero",
      "collection_id": "",
      "copyright": "",
      "created_at": "2026-11-01T09:00:00.000Z",
      "filename": "hero.png",
      "format": "png",
      "height": 900,
      "id": "dLJdPzC3TW-mJXGo7K73Gg",
      "is_image": true,
      "mime_type": "image/png",
      "notes": "",
      "path": "/45/1496845848-hero.png",
      "size": 104857,
      "smart_tags": [
        "sky"
      ],
      "tags": [
        "hero"
      ],
      "updated_at": "2026-11-01T09:00:00.000Z",
      "url": "https://www.datocms-assets.com/45/1496845848-hero.png",
      "width": 1600
    }
  ]
}

List build triggers

List the project's build triggers (deploy hooks) with their last build status.

Inputs

None.

Outputs

build_triggerslist
The build triggers
countnumber
How many
Example output
{
  "build_triggers": [
    {
      "adapter": "netlify",
      "build_status": "success",
      "enabled": true,
      "frontend_url": "https://www.acme.com",
      "id": "4821",
      "last_build_completed_at": "2026-11-02T09:00:00.000Z",
      "name": "Production"
    }
  ],
  "count": 1
}

List fields

List the fields of a model with their types and API keys.

Inputs

Modelmodel_idtextRequired
The model or block model. Pick one, or give its id or API key from an earlier step.

Outputs

countnumber
How many
fieldslist
The fields
Example output
{
  "count": 1,
  "fields": [
    {
      "api_key": "title",
      "field_type": "string",
      "hint": "",
      "id": "Dk3mP9sRTQ-AaB7cZ1x2yw",
      "label": "Title",
      "localized": false,
      "model_id": "Wg5eKcLZQ7yYb-3dUx2p0A",
      "position": 1,
      "required": true,
      "validators": {
        "required": {}
      }
    }
  ]
}

List models

List every model and block model in the project.

Inputs

None.

Outputs

countnumber
How many
modelslist
The models
Example output
{
  "count": 1,
  "models": [
    {
      "api_key": "blog_post",
      "draft_mode_active": true,
      "field_ids": [
        "Dk3mP9sRTQ-AaB7cZ1x2yw"
      ],
      "hint": "",
      "id": "Wg5eKcLZQ7yYb-3dUx2p0A",
      "is_block": false,
      "name": "Blog post",
      "singleton": false,
      "sortable": false,
      "tree": false
    }
  ]
}

List record versions

List a record's saved versions, newest first, with the values each had and which one is published. Gets one page; to see more, run it again with the next offset it gives.

Inputs

Record IDrecord_idtextRequired
The record's id, from 'List records' or an earlier step.
Page sizelimitnumber
How many to return, 1 to 50. DatoCMS's default is 15.From 1 to 50.
Skipoffsetnumber
How many to skip, to get a later page. Use the 'next_offset' of the earlier page.At least 0.

Outputs

countnumber
How many came back on this page
has_moretrue/false
True if there are more after this page
next_offsetnumber
The offset to give for the page after this one
total_countnumber
How many there are in all, across every page
versionslist
The versions
Example output
{
  "count": 1,
  "has_more": false,
  "next_offset": 1,
  "total_count": 1,
  "versions": [
    {
      "created_at": "2026-11-03T09:00:00.000Z",
      "editor_id": "12345",
      "fields": {
        "title": "My first blog post"
      },
      "id": "Hk2nQ8vXRD-LmN4pOa7bcA",
      "is_current": true,
      "is_published": false,
      "model_id": "Wg5eKcLZQ7yYb-3dUx2p0A",
      "published_from": "",
      "published_until": "",
      "record_id": "A4gkL_8pTZmcyJ-IlIEd2w"
    }
  ]
}

List records

List or search records, filtered by model, text, publication status or when they last changed. Gets one page; to see more, run it again with the next offset it gives.

Inputs

Modelmodel_idtext
Only records of this model. Leave empty for every model.
Search textsearchtext
Only records whose text fields match this. DatoCMS indexes text in the background, so a new or changed record can take about a minute to turn up in a search.
Statusstatustext
Only records in this publication state.One of: draft (Draft (never published)), updated (Published with unpublished changes), published.
Updated afterupdated_afterdate and time
Only records changed after this date and time.
Orderorder_bytext
How to sort. Needs a model to be picked above.One of: _updated_at_DESC (Recently updated first), _updated_at_ASC (Least recently updated first), _created_at_DESC (Newest first), _created_at_ASC (Oldest first), _published_at_DESC (Recently published first).
Versionversiontext
Whether to read the latest drafts or the published versions.One of: current (Latest, including drafts (default)), published (Published versions only).
Page sizelimitnumber
How many to return, 1 to 500. DatoCMS's default is 30.From 1 to 500.
Skipoffsetnumber
How many to skip, to get a later page. Use the 'next_offset' of the earlier page.At least 0.

Outputs

countnumber
How many came back on this page
has_moretrue/false
True if there are more after this page
next_offsetnumber
The offset to give for the page after this one
recordslist
The records
total_countnumber
How many there are in all, across every page
Example output
{
  "count": 1,
  "has_more": false,
  "next_offset": 1,
  "records": [
    {
      "created_at": "2026-11-03T09:00:00.000Z",
      "current_version": "Hk2nQ8vXRD-LmN4pOa7bcA",
      "fields": {
        "title": "My first blog post"
      },
      "first_published_at": "",
      "id": "A4gkL_8pTZmcyJ-IlIEd2w",
      "is_valid": true,
      "model_id": "Wg5eKcLZQ7yYb-3dUx2p0A",
      "publication_scheduled_at": "",
      "published_at": "",
      "status": "draft",
      "unpublishing_scheduled_at": "",
      "updated_at": "2026-11-03T09:00:00.000Z"
    }
  ],
  "total_count": 1
}

Publish record

Publish a record's current version so it is served to your website. The record must be valid.

Inputs

Record IDrecord_idtextRequired
The record's id, from 'List records' or an earlier step.

Outputs

recordobject
The record
Example output
{
  "record": {
    "created_at": "2026-11-03T09:00:00.000Z",
    "current_version": "Hk2nQ8vXRD-LmN4pOa7bcA",
    "fields": {
      "title": "My first blog post"
    },
    "first_published_at": "",
    "id": "A4gkL_8pTZmcyJ-IlIEd2w",
    "is_valid": true,
    "model_id": "Wg5eKcLZQ7yYb-3dUx2p0A",
    "publication_scheduled_at": "",
    "published_at": "2026-11-03T10:00:00.000Z",
    "status": "published",
    "unpublishing_scheduled_at": "",
    "updated_at": "2026-11-03T09:00:00.000Z"
  }
}

Schedule publication

Publish a record automatically at a future date and time. The model must have drafts and publishing turned on.

Inputs

Record IDrecord_idtextRequired
The record's id, from 'List records' or an earlier step.
Publish atpublish_atdate and timeRequired
When to publish. It must be in the future.

Outputs

publication_scheduled_attext
When it will be published (UTC)
record_idtext
The record scheduled
Example output
{
  "publication_scheduled_at": "2026-12-01T09:00:00.000Z",
  "record_id": "A4gkL_8pTZmcyJ-IlIEd2w"
}

Schedule unpublishing

Take a published record off your website automatically at a future date and time.

Inputs

Record IDrecord_idtextRequired
The record's id, from 'List records' or an earlier step.
Unpublish atunpublish_atdate and timeRequired
When to unpublish. It must be in the future.

Outputs

record_idtext
The record scheduled
unpublishing_scheduled_attext
When it will be unpublished (UTC)
Example output
{
  "record_id": "A4gkL_8pTZmcyJ-IlIEd2w",
  "unpublishing_scheduled_at": "2026-12-31T09:00:00.000Z"
}

Trigger deploy

Start a deploy of your website through one of the project's build triggers.

Inputs

Build triggerbuild_trigger_idtextRequired
The build trigger to run. Pick one, or give its id from 'List build triggers'.

Outputs

build_trigger_idtext
The build trigger that was run
triggeredtrue/false
Always true once started
Example output
{
  "build_trigger_id": "4821",
  "triggered": true
}

Unpublish record

Take a record off your website. It stays in DatoCMS as a draft.

Inputs

Record IDrecord_idtextRequired
The record's id, from 'List records' or an earlier step.

Outputs

recordobject
The record
Example output
{
  "record": {
    "created_at": "2026-11-03T09:00:00.000Z",
    "current_version": "Hk2nQ8vXRD-LmN4pOa7bcA",
    "fields": {
      "title": "My first blog post"
    },
    "first_published_at": "",
    "id": "A4gkL_8pTZmcyJ-IlIEd2w",
    "is_valid": true,
    "model_id": "Wg5eKcLZQ7yYb-3dUx2p0A",
    "publication_scheduled_at": "",
    "published_at": "",
    "status": "draft",
    "unpublishing_scheduled_at": "",
    "updated_at": "2026-11-03T09:00:00.000Z"
  }
}

Update asset

Change an asset's file name, author, copyright, notes, tags or collection. Only the fields given change.

Inputs

Asset IDupload_idtextRequired
The asset's id, from 'List assets' or an earlier step.
File namebasenametext
A new file name, without the extension. Leave empty to keep it.
Authorauthortext
Who made it. Leave empty to keep it.
Copyrightcopyrighttext
The copyright notice. Leave empty to keep it.
Notesnotestext
Internal notes about the asset. Leave empty to keep them.
Tagstagslist
The asset's tags. They replace its current tags.
Collectioncollection_idtext
Move the asset into this collection. Leave empty to keep it.

Outputs

uploadobject
The asset
Example output
{
  "upload": {
    "author": "Alex Doe",
    "basename": "hero",
    "collection_id": "",
    "copyright": "",
    "created_at": "2026-11-01T09:00:00.000Z",
    "filename": "hero.png",
    "format": "png",
    "height": 900,
    "id": "dLJdPzC3TW-mJXGo7K73Gg",
    "is_image": true,
    "mime_type": "image/png",
    "notes": "",
    "path": "/45/1496845848-hero.png",
    "size": 104857,
    "smart_tags": [
      "sky"
    ],
    "tags": [
      "hero"
    ],
    "updated_at": "2026-11-01T09:00:00.000Z",
    "url": "https://www.datocms-assets.com/45/1496845848-hero.png",
    "width": 1600
  }
}

Update field

Change a field's label, API key, hint or whether it is required. Only the fields given change.

Inputs

Field IDfield_idtextRequired
The field's id, from 'List fields' or 'Create field'.
Labellabeltext
A new label. Leave empty to keep it.
API keyapi_keytext
A new API key. Records and apps using the old key stop finding it. Leave empty to keep it.
Hinthinttext
New help text. Leave empty to keep it.
Requiredrequiredtrue/false
Turn on or off whether the field must be filled in. Leave unset to keep it. The field's other checks are kept.

Outputs

fieldobject
The field
Example output
{
  "field": {
    "api_key": "title",
    "field_type": "string",
    "hint": "",
    "id": "Dk3mP9sRTQ-AaB7cZ1x2yw",
    "label": "Headline",
    "localized": false,
    "model_id": "Wg5eKcLZQ7yYb-3dUx2p0A",
    "position": 1,
    "required": true,
    "validators": {
      "required": {}
    }
  }
}

Update model

Change a model's name, API key, hint or settings. Only the fields given change.

Inputs

Modelmodel_idtextRequired
The model or block model. Pick one, or give its id or API key from an earlier step.
Namenametext
A new name. Leave empty to keep it.
API keyapi_keytext
A new API key. Apps that address the model by its old key stop finding it. Leave empty to keep it.
Hinthinttext
New help text. Leave empty to keep it.
Drafts and publishingdraft_mode_activetrue/false
Turn drafts and publishing on or off. Leave unset to keep it.
Editors can reordersortabletrue/false
Let editors drag records into an order. Leave unset to keep it.

Outputs

modelobject
The model
Example output
{
  "model": {
    "api_key": "blog_post",
    "draft_mode_active": true,
    "field_ids": [
      "Dk3mP9sRTQ-AaB7cZ1x2yw"
    ],
    "hint": "",
    "id": "Wg5eKcLZQ7yYb-3dUx2p0A",
    "is_block": false,
    "name": "Article",
    "singleton": false,
    "sortable": false,
    "tree": false
  }
}

Update record

Change some values of a record. Fields not given keep their value. A published record becomes updated until published again.

Inputs

Record IDrecord_idtextRequired
The record's id, from 'List records' or an earlier step.
ValuesdataobjectRequired
The values to set, keyed by each field's API key, for example {"title": "Hello"}. Use the same shapes DatoCMS shows for each field type: dates as 2026-11-03, localized fields as an object per locale.

Outputs

recordobject
The record
Example output
{
  "record": {
    "created_at": "2026-11-03T09:00:00.000Z",
    "current_version": "Hk2nQ8vXRD-LmN4pOa7bcA",
    "fields": {
      "title": "My updated blog post"
    },
    "first_published_at": "",
    "id": "A4gkL_8pTZmcyJ-IlIEd2w",
    "is_valid": true,
    "model_id": "Wg5eKcLZQ7yYb-3dUx2p0A",
    "publication_scheduled_at": "",
    "published_at": "",
    "status": "draft",
    "unpublishing_scheduled_at": "",
    "updated_at": "2026-11-03T09:00:00.000Z"
  }
}

On this page