> For the complete documentation index, see [llms.txt](https://docs.ebbot.ai/ebbot-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/easit-integration-in-automations/actions/update-item-graphql.md).

# 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:

```json
{
  "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**](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/easit-integration-in-automations/actions/list-fields.md) or [**List Easit Field Values**](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/easit-integration-in-automations/actions/list-field-values.md).

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](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/easit-integration-in-automations/troubleshooting.md), or return to the [action catalog](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/easit-integration-in-automations/actions.md).
