For the complete documentation index, see llms.txt. This page is also available as Markdown.

Update Easit Item (GraphQL)

Update an existing Easit GO item via the GraphQL API (updateItems).

Action identifier: update_item_graphql.

Inputs

Field
Type
Required/default
Meaning

item_id

integer

Required

Internal Easit item id (Item.id)

fields

object

Optional

Field name/id -> value map to set on the item

external_id

string | null

null

Optional external id to set

tags

array of strings | null

null

Optional list of tags to set

Example input:

{
  "external_id": null,
  "fields": {
    "sys_subject": "Updated from workflow"
  },
  "item_id": 8708,
  "tags": []
}

Output

Paths are relative to this action's output. Select them from the builder's variable picker rather than typing them. A field that is null or empty was not returned by Easit; it is not proof that the value is empty in Easit.

Path
Type
Meaning

success

boolean

Whether the requested operation completed successfully.

updated_ids

array of integers

Internal item ids reported updated by Easit; a verified no-op can succeed with an empty list.

item_id

integer

Internal numeric Easit Item.id used by GraphQL actions.

sequence_id

integer | null

Visible ticket number (Item.sequenceId), when available; not the GraphQL item id.

error

string | null

Failure details when the operation did not succeed; otherwise null.

Behavior and limits

Updates one item by internal numeric item_id. Set fields to a map of exact Easit field system names to values, for example {"item_id": 8708, "fields": {"sys_subject": "Follow-up needed"}}. Optional external_id and tags update those attributes when supplied.

For fixed-choice fields, supply data-source ids rather than display labels. Discover them with List Easit Fields or List Easit Field Values.

Returns success, item_id, updated_ids, a best-effort sequence_id, and error on failure. Easit may omit an id when a write changes nothing; the action reads the item back before classifying it as failed. Requires write access to the target fields.

See Troubleshooting, or return to the action catalog.

Was this helpful?