Content

ScopeCONTENT_MANAGE

Flip to ARCHIVED - hides from the visitor feed but preserves the row. Distinct from delete (hard-delete) and unpublish (back to drafts). Re-publish to undo.

mutation {
  archiveNewsPost(id: "…") { _id organisationId integrationIds title slug }
}

ScopeCONTENT_MANAGE

Create a draft help article. Articles always land as DRAFT - use publishHelpArticle to make them visible to visitors.

mutation {
  createHelpArticle(input: { … }) { _id organisationId integrationIds folder ancestors }
}

ScopeCONTENT_MANAGE

Create a locale variant linked to an existing article (one logical article, grouped by translationGroupId). Mints the group on the source the first time; rejects a duplicate locale. Lands as DRAFT.

mutation {
  createHelpArticleTranslation(sourceArticleId: "…", input: { … }) { _id organisationId integrationIds folder ancestors }
}

ScopeCONTENT_MANAGE

Create a help folder. Pass `parentId` to nest it under another folder, or omit / send null for a root-level folder. Slug must be unique per parent.

mutation {
  createHelpFolder(input: { … }) { _id organisationId integrationIds name slug }
}

ScopeCONTENT_MANAGE

Create a help tag.

mutation {
  createHelpTag(input: { … }) { _id organisationId slug label labelI18n }
}

ScopeCONTENT_MANAGE

Create a news category. Slug must be unique per integration; auto-derive from label on the FE then operator can edit.

mutation {
  createNewsCategory(input: { … }) { _id organisationId slug label labelI18n }
}

ScopeCONTENT_MANAGE

Create a draft news post. Always lands as DRAFT - use publishNewsPost to make it visitor-visible.

mutation {
  createNewsPost(input: { … }) { _id organisationId integrationIds title slug }
}

ScopeCONTENT_MANAGE

Create a locale variant linked to an existing post (one logical article, grouped by translationGroupId). Mints the group on the source the first time; rejects a duplicate locale in the group. Lands as DRAFT.

mutation {
  createNewsPostTranslation(sourcePostId: "…", input: { … }) { _id organisationId integrationIds title slug }
}

ScopeCONTENT_MANAGE

Create a news tag.

mutation {
  createNewsTag(input: { … }) { _id organisationId slug label labelI18n }
}

ScopeCONTENT_MANAGE

Hard-delete an article. No soft-delete in v1.

mutation {
  deleteHelpArticle(id: "…")
}

ScopeCONTENT_MANAGE

Delete a folder. Refuses when the folder has any direct child (folder OR article) - operator re-parents / deletes the children first. No cascade.

mutation {
  deleteHelpFolder(id: "…")
}

ScopeCONTENT_MANAGE

Delete a help tag. Linked articles survive - the tag ref is detached via $pull, no cascade-delete of articles.

mutation {
  deleteHelpTag(id: "…")
}

ScopeCONTENT_MANAGE

Delete a news category. Posts referencing it survive - the ref is detached via $pull, no cascade-delete of posts.

mutation {
  deleteNewsCategory(id: "…")
}

ScopeCONTENT_MANAGE

Hard-delete a news post.

mutation {
  deleteNewsPost(id: "…")
}

ScopeCONTENT_MANAGE

Delete a news tag. Posts referencing it survive (refs detached).

mutation {
  deleteNewsTag(id: "…")
}

ScopeCONTENT_READ

Fetch a single article by id (operator view).

query {
  helpArticle(id: "…") { _id organisationId integrationIds folder ancestors }
}

ScopeCONTENT_READ

List articles for an integration (operator view). Returns `\{ items, meta \}`. Defaults to all statuses + folders, newest-created first, unbounded. Pass search / status / folderId / recursive / tagIds / sort / limit / offset to scope. `folderId: null` = root-level articles; `folderId` + `recursive: true` walks the entire subtree.

query {
  helpArticles(integrationId: "…", status: DRAFT, locale: "…", search: "…", folderId: "…", recursive: false, tagIds: "…", sort: CREATED_DESC, limit: 0, offset: 0) { items meta }
}

ScopeCONTENT_READ

Fetch a folder by id.

query {
  helpFolder(id: "…") { _id organisationId integrationIds name slug }
}

ScopeCONTENT_READ

Recursive subtree counts - `\{ folders, articles \}` below this folder. Powers the badge on each folder card in the operator UI.

query {
  helpFolderCounts(id: "…") { folders articles }
}

ScopeCONTENT_READ

Batched subtree counts for many folders in one round-trip. Returns one row per requested id (unknown / cross-org ids return zeros). Use this instead of N×`helpFolderCounts` when rendering a tree.

query {
  helpFolderCountsBatch(ids: "…") { folderId folders articles }
}

ScopeCONTENT_READ

Every folder for an integration in one call. Sorted by ancestors then order - operator dashboard hydrates the whole tree without per-click round-trips.

query {
  helpFolderTree(integrationId: "…") { _id organisationId integrationIds name slug }
}

ScopeCONTENT_READ

List child folders of `parentId` (or root-level when null/omitted). Use this for the operator dashboard's lazy-load tree view.

query {
  helpFolders(integrationId: "…", parentId: "…") { _id organisationId integrationIds name slug }
}

ScopeCONTENT_READ

Fetch a help tag by id.

query {
  helpTag(id: "…") { _id organisationId slug label labelI18n }
}

ScopeCONTENT_READ

List help tags for the organisation.

query {
  helpTags { _id organisationId slug label labelI18n }
}

ScopeCONTENT_MANAGE

Move a folder to a new parent (or to root via `newParentId: null`). Refuses to move a folder into its own subtree (cycle). Recomputes ancestors for the folder + every descendant folder + every article in the moved subtree.

mutation {
  moveHelpFolder(id: "…", newParentId: "…") { _id organisationId integrationIds name slug }
}

ScopeCONTENT_READ

List news categories for the organisation.

query {
  newsCategories { _id organisationId slug label labelI18n }
}

ScopeCONTENT_READ

Fetch a news category by id.

query {
  newsCategory(id: "…") { _id organisationId slug label labelI18n }
}

ScopeCONTENT_READ

Fetch a single news post by id (operator view).

query {
  newsPost(id: "…") { _id organisationId integrationIds title slug }
}

ScopeCONTENT_READ

List news posts for an integration (operator view). Returns `\{ items, meta \}`. Defaults to all statuses, updatedAt-desc, unbounded. Pass status / search / categoryIds / tagIds / sort / limit / offset to scope.

query {
  newsPosts(integrationId: "…", status: DRAFT, locale: "…", search: "…", categoryIds: "…", tagIds: "…", sort: CREATED_DESC, limit: 0, offset: 0) { items meta }
}

ScopeCONTENT_READ

Fetch a news tag by id.

query {
  newsTag(id: "…") { _id organisationId slug label labelI18n }
}

ScopeCONTENT_READ

List news tags for the organisation.

query {
  newsTags { _id organisationId slug label labelI18n }
}

ScopeCONTENT_MANAGE

Flip an article to PUBLISHED. Stamps publishedAt (drives visitor sort) + publishedBy. Re-publishing refreshes publishedAt - useful for surfacing tweaks at the top of the list.

mutation {
  publishHelpArticle(id: "…") { _id organisationId integrationIds folder ancestors }
}

ScopeCONTENT_MANAGE

Flip to PUBLISHED. Stamps publishedAt (drives visitor sort) + publishedBy. Re-publishing refreshes publishedAt - useful for surfacing tweaks at the top of the feed. Re-publishing an archived post clears archivedAt.

mutation {
  publishNewsPost(id: "…") { _id organisationId integrationIds title slug }
}

ScopeCONTENT_MANAGE

Stage a post for future publish at `scheduledFor`. Status flips to SCHEDULED; the scheduler tick promotes the row to PUBLISHED when scheduledFor \<= now. Refuses past-dated timestamps - use publishNewsPost for "publish now". Re-scheduling overwrites the timestamp.

mutation {
  scheduleNewsPost(id: "…", scheduledFor: { … }) { _id organisationId integrationIds title slug }
}

ScopeCONTENT_MANAGE

Flip an article back to DRAFT. Visitors stop seeing it; operator-side "last published" timestamp is preserved.

mutation {
  unpublishHelpArticle(id: "…") { _id organisationId integrationIds folder ancestors }
}

ScopeCONTENT_MANAGE

Flip back to DRAFT (for further edits). Preserves publishedAt so the operator UI can show "last published" history. Distinct from archiveNewsPost (which is a "final, retired" state).

mutation {
  unpublishNewsPost(id: "…") { _id organisationId integrationIds title slug }
}

ScopeCONTENT_MANAGE

Patch operator-mutable fields on a draft / published article. Pass `folderId` to move the article between folders; the service recomputes ancestors so descendant queries stay accurate.

mutation {
  updateHelpArticle(id: "…", input: { … }) { _id organisationId integrationIds folder ancestors }
}

ScopeCONTENT_MANAGE

Patch operator-mutable fields. `parentId` is NOT here - use moveHelpFolder so the service can recompute ancestors atomically.

mutation {
  updateHelpFolder(id: "…", input: { … }) { _id organisationId integrationIds name slug }
}

ScopeCONTENT_MANAGE

Patch a help tag.

mutation {
  updateHelpTag(id: "…", input: { … }) { _id organisationId slug label labelI18n }
}

ScopeCONTENT_MANAGE

Patch a news category. Slug-collision returns 400.

mutation {
  updateNewsCategory(id: "…", input: { … }) { _id organisationId slug label labelI18n }
}

ScopeCONTENT_MANAGE

Patch operator-mutable fields on a news post. Status flips go via dedicated mutations.

mutation {
  updateNewsPost(id: "…", input: { … }) { _id organisationId integrationIds title slug }
}

ScopeCONTENT_MANAGE

Patch a news tag.

mutation {
  updateNewsTag(id: "…", input: { … }) { _id organisationId slug label labelI18n }
}