updateMetafield

Example Query

mutation ExampleMutation($input: UpdateMetafieldInput!) {
  metafield {
    updateMetafield(input: $input) {
      metafield {
        id
        description
        key
        namespace
        permissionSet
        resourceId
        value
        ownerClientId
        createdAt
        updatedAt
      }
      errors
    }
  }
}

Variables

{
  "input": {
    "id": "example",
    "data": {
      "namespace": "example",
      "key": "example",
      "value": "example",
      "description": "example",
      "permissionSet": "APP_ONLY"
    }
  }
}

Example response

{
  "data": {
    "metafield": {
      "updateMetafield": {
        "metafield": {
          "id": "example",
          "description": "example",
          "key": "example",
          "namespace": "example",
          "permissionSet": "APP_ONLY",
          "resourceId": "example",
          "value": "example",
          "ownerClientId": "example",
          "createdAt": "2026-10-30T22:30:42.678Z",
          "updatedAt": "2026-10-30T22:30:42.678Z"
        },
        "errors": [
          {
            "message": "example"
          }
        ]
      }
    }
  }
}

Update Metafield.

Arguments

inputUpdateMetafieldInputRequired

Returns

an optional UpdateMetafieldResult

errorslist of UpdateMetafieldErrorses

The list of errors that occurred while updating a metafield.

metafieldMetafieldOptional

Updated metafield.