Model Update

Type key: model_update_node
Group: Data
Category: data
Tier: CORE

The Model Update node creates, updates, or upserts Eloquent model records. Field values can be static or dynamically derived from upstream node data using {{tag}} syntax.

Handles

Handle	Direction	Description
`input`	Input	Receives data from the preceding node
`output`	Output	Emits the affected record(s)

Configuration

Field	Type	Default	Description
`model`	string	`""`	Fully-qualified Eloquent model class
`operation`	enum	`update`	Operation to perform: `create`, `update`, `upsert`
`identifier_field`	string	`id`	Column used to find the record (for `update`/`upsert`)
`identifier_value`	string	`{{id}}`	Value of the identifier column; supports `{{tags}}`
`field_mapping`	array	`[]`	Array of field assignment objects

Field Mapping Object

{
    "field": "status",
    "value": "published"
}

Both field and value support {{tags}}:

{
    "field": "content",
    "value": "{{ai_response.translated_content}}"
}

Operations

`create`

Creates a new record with the configured field mapping. The identifier_field and identifier_value are not used.

Operation: create
Field Mapping:
  - field: name,    value: {{input.name}}
  - field: email,   value: {{input.email}}
  - field: status,  value: active

`update`

Finds an existing record by identifier_field = identifier_value and updates it.

Operation: update
Identifier Field: id
Identifier Value: {{input.id}}
Field Mapping:
  - field: status,     value: reviewed
  - field: reviewed_at, value: {{now}}

`upsert`

Creates the record if it does not exist; updates it if it does. Uses identifier_field as the uniqueness constraint.

Operation: upsert
Identifier Field: email
Identifier Value: {{input.email}}
Field Mapping:
  - field: name,       value: {{input.name}}
  - field: last_seen,  value: {{now}}

Output

The node emits the affected record as a flat array:

{
    "id": 42,
    "name": "Alice",
    "status": "published",
    "updated_at": "2025-03-16T10:00:00Z"
}

Example: AI Content Pipeline

[Schedule Trigger]
       │
       ▼
[Data Model]  ←── fetch articles WHERE status = 'draft'
       │
       ▼
[For Each]
       │
       ▼
[HTTP Request]  ←── POST to OpenAI: review and improve content
       │
       ▼
[Transform]  ←── extract { improved_content } from AI response
       │
       ▼
[Model Update]
  Operation:         update
  Identifier Field:  id
  Identifier Value:  {{input.id}}
  Field Mapping:
    - content:    {{improved_content}}
    - status:     published
    - reviewed_at: {{now}}

Notes

The model must be registered in Model Integrations to appear in the selector
{{tags}} in identifier_value are resolved against the full execution context before the query runs
For bulk updates (updating many records at once), use the PHP Code node with Eloquent's whereIn for efficiency
The upsert operation uses Laravel's updateOrCreate() method under the hood