Skip to main content
MUTATION
automationsEdit(_id: String, name: String, status: String, draftOf: String, triggers: [String], nodes: [String], startNodeNs: String, tagIds: [String]): Automation

Arguments

_id
String
name
String

Display name.

status
String

Initial status. Almost always omit — new automations start as draft.

draftOf
String

Do not set on create — reserved for internal draft-of-live linkage.

triggers
[String]

Existing trigger ids to attach. Usually omitted — add triggers after creation with triggersAdd.

nodes
[String]

Existing node ids to attach. Usually omitted — add nodes after creation with nodesAdd.

startNodeNs
String

Namespace of the first node to run. Set once nodes exist.

tagIds
[String]

Initial tag ids.

Returns

Automation
_id
String!

Unique identifier for this automation document (one per version/draft).

ns
String

Stable namespace shared by the live automation, its versions, and its draft. Use this — not _id — to address "the automation" across edits with automationByNs / automationDetailByNs.

name
String

Display name shown in the automation list and builder.

status
String

One of draft, live, offline, archived, template, or version (a past published snapshot). automations / automationsMain exclude version, archived, and template by default unless status is passed explicitly.

draftOf
String

Set only on draft copies of a live automation — the _id of that live automation. Absent on brand-new (never-published) drafts.

hasDraft
Boolean

Whether a live/offline automation currently has an in-progress draft. Populated by automationsMain only.

createdAt
Date

When this document was created.

updatedAt
Date

When this document was last modified.

createdBy
String

User id who created this document.

updatedBy
String

User id who last modified this document.

createdUser
User

Resolved creator — see createdBy.

updatedUser
User

Resolved last editor — see updatedBy.

triggers
[Trigger]

Entry-point Triggers wired into this automation.

nodes
[Node]

Step Nodes wired into this automation.

startNodeNs
String

Namespace of the first node executed after a trigger fires.

tagIds
[String]

Tag ids on this automation family. Set via automationsSetTags.

tags
[Tag]

Resolved tags — see tagIds.

templateDescription
String

Description shown in the templates gallery. Set by automationsSaveAsTemplate.

templateCategory
String

Category shown in the templates gallery. Set by automationsSaveAsTemplate.

version
Int

Version number, incremented on every automationsPublish. 1 on first publish; absent on drafts that have never gone live.

publishedAt
Date

Timestamp of the most recent publish.

publishedBy
String

User id who most recently published this automation.

archivedAt
Date

Timestamp this document was archived — set both when a past version is superseded by a new publish, and when archiveAutomations archives the whole automation.

previousStatus
String

Status to restore to via archiveAutomations(isRestore: true). Only set while status is archived.

Mutation
Response
آخر تعديل في ١١ أغسطس ٢٠٢٦