Skip to main content
Version: 2024.2

DataObject Mutations

TODO: Align this with the new demo as soon as reasonable content is available.

  • Create Objects
  • Update Objects
  • Delete Objects

In addition, you can turn on mutations to modify assets, create object folders and on on.

Mutation gridMutation gridMutation grid

Note that for Create and Update operate you can query the updated data using the same request. Keep in mind that for all kinds of mutations you need the Write permission.

Supported Mutation Datatypes

Mutation gridMutation gridMutation grid

Also check out the Pimcore's data type documentation.

  • Boolean Select
  • Checkbox
  • Country
  • Countries (Multiselect)
  • Date
  • DateTime
  • Email
  • External Image
  • Field Collections
  • Firstname
  • Gender
  • Geopoint
  • Image
  • ImageGallery
  • Input
  • Input Quantity Value
  • Language
  • Lastname
  • Link
  • Many-to-One Relation
  • Many-to-Many Relation
  • Many-to-Many Object Relation
  • Advanced Many-to-Many Relation
  • Advanced Many-to-Many Object Relation
  • Multiselect
  • Newsletter Active
  • Newsletter Confirmed
  • Numeric
  • Quantity Value
  • Select
  • Slider
  • Table
  • Textarea
  • Time
  • Wysiwyg

Supported Mutation Operators

  • IfEmpty
  • Locale Switcher
  • ...

See the overview page for more details.

Create Object

TBD: do we need an extra workspace permission for that ? (in addition to write which would be only used for updates)

Request:

mutation {
createNews(parentId: 66, key: "testcreate27", published: false) {
success
message
output(defaultLanguage: "de") {
id
creationDate
fullpath
title(language: "en")
}
}
}

Response:

{
"data": {
"createNews": {
"success": true,
"message": "object created: 98",
"output": {
"id": "98",
"creationDate": 1559642310,
"fullpath": "/tests/testcreate2/testcreate27",
"title": null
}
}
}
}

Update Object

Updates german title and short text and returns the modification date.

Request:

mutation {
updateNews(id: 773, defaultLanguage: "de", input: {title: "german TITLE", shortText: "new short text"}) {
success
output {
modificationDate
}
}
}

Response:

{
"data": {
"updateNews": {
"success": true,
"output": {
"modificationDate": 1559746654
}
}
}
}

Delete Object

Request:

mutation {
deleteBlogCategory(id: 37) {
success
message
}
}

Response:

{
"data": {
"deleteBlogCategory": {
"success": true,
"message": ""
}
}
}

Extend Data Object Mutations

It is possible to add custom mutation data types and mutation operators. For details see detail documentation pages:

More Examples

See following list for more examples with data object mutations: