Mutation

addViewToGroup

Add a saved view to one view group. Its other groups stay; adding a current member changes nothing.

MCP: addViewToGroup

Arguments

groupId ID! required: UUID of the ViewGroup to add the view to.
viewId ID! required: FilterPreset UUID of the Content View, Social Profile View, or Creator View to add.

Returns

Object, input and enum types open in place — use + to reveal their fields. A type that is already open above the row stops at a ↻ circular marker, and anything nested past the depth limit links out to its own page instead.

changed Boolean: True when the call added the view. False when the view already was a member. Null on failure.
userErrors [UserError!]!: List of user-facing errors. Empty on success.
field [String!]: Path to the input field that caused the error.
message String!: The error message.
viewGroup ViewGroup: The ViewGroup with its members after the call. Null when the group or view was not found, or the write failed.
collections [Collection!]!: Collections that belong to this group, ordered by their position within the group.
createdAt DateTimeWithZone!: When the Collection was created.
customAttributeOptionId ID: Id of the option that represents this Collection in the ITEM collections custom attribute schema (customAttributeSchemas(entity: ITEM)). It differs from id: use it as the value of a collections custom-attribute condition and to match values in an item's customAttributes. Null for workspaces whose Collections use the older storage.
group ViewGroup ↻ circular view ViewGroup →: Group this Collection belongs to, or null when ungrouped. Populated by moveCollectionToGroup. Always null for workspaces whose Collections use the older storage.
id ID!: Unique identifier of the Collection in this workspace. Pass it to addItemToCollections / removeItemFromCollections and to collection(id:).
itemCount Int!: Number of items in this workspace tagged with the Collection.
name String!: Display name of the Collection.
updatedAt DateTimeWithZone!: When the Collection was last updated.
contentViews [ContentView!]!: Content Views that belong to this group, ordered by their position within the group.
createdAt DateTimeWithZone!: When the view was created.
customAttributeConditions JSON!: Custom-attribute conditions narrowing the filter set, as stored: operator and type hold the lowercase stored values (e.g. "is_not_empty", "text_list"), not the FilterOperator / CustomAttributeType names. The view create and update mutations accept these stored values when the list is passed back as customAttributeConditions through variables, but they validate it as they would any other input: a list the app saved can be refused (for example a list condition with no values, more conditions or values than the limits allow, or a condition on an attribute the workspace no longer has or whose type no longer matches), so check the userErrors when cloning a view this way.
displaySettings ContentViewDisplaySettings!: Which columns the Archive app shows for this view. Set with displaySettings on create or update.
showComments Boolean!: Show the comments column.
showCreatorLabels Boolean!: Show the creator labels column.
showEmv Boolean!: Show the EMV (earned media value) column.
showFollowers Boolean!: Show the followers count column.
showLikes Boolean!: Show the likes column.
showPostDate Boolean!: Show the post date column.
showShares Boolean!: Show the shares column.
showSocialProfile Boolean!: Show the social profile column.
showViews Boolean!: Show the views column: views and plays, the count the API returns as impressions.
filters JSON!: Opaque filter blob defining which items belong to the view.
group ViewGroup ↻ circular view ViewGroup →: The primary group of this view: the first entry of groups, which is the oldest group it belongs to. Null when the view is ungrouped.
groups [ViewGroup!]! ↻ circular view ViewGroup →: Every view group this view belongs to, oldest group first. The app lets a view sit in several groups; addViewToGroup and removeViewFromGroup change one membership. Empty when the view is ungrouped.
id ID!: Unique identifier (FilterPreset UUID). Use this with items(presetId:).
name String!: Display name of the view.
position Int: Display slot of this view; lower values come first. Inside a ViewGroup member list, or a list filtered by groupId, it is the slot within that group. Elsewhere it is the slot in the default list of this view kind, set by reorderDefaultViewList. Null when the slot is unset. Hidden views are not exposed through the public API.
showReportingStats Boolean!: Whether reporting stats are surfaced in the UI for this view.
sort JSON!: Sort directives applied when listing items via this view. Each entry is { field, direction }: field is one of taken_at, merged_view_play_count, like_count, comment_count, share_count, earned_media_value, linear_virality, exponential_virality, resolved_virality, account_name, followers_count; direction is ASC or DESC (case-insensitive).
updatedAt DateTimeWithZone!: When the view was last updated.
createdAt DateTimeWithZone!: When the group was created.
creatorViews [CreatorView!]!: Creator Views that belong to this group, ordered by their position within the group.
createdAt DateTimeWithZone!: When the view was created.
customAttributeConditions JSON!: Custom-attribute conditions narrowing the filter set, as stored: operator and type hold the lowercase stored values (e.g. "is_not_empty", "text_list"), not the FilterOperator / CustomAttributeType names. The view create and update mutations accept these stored values when the list is passed back as customAttributeConditions through variables, but they validate it as they would any other input: a list the app saved can be refused (for example a list condition with no values, more conditions or values than the limits allow, or a condition on an attribute the workspace no longer has or whose type no longer matches), so check the userErrors when cloning a view this way.
filters JSON!: Opaque filter blob, stored and echoed back. creators(presetId:) applies it only with applyViewFilters: true; otherwise it narrows only by this view's customAttributeConditions and sort. Use customAttributeConditions to filter which creators the view returns.
group ViewGroup ↻ circular view ViewGroup →: The primary group of this view: the first entry of groups, which is the oldest group it belongs to. Null when the view is ungrouped.
groups [ViewGroup!]! ↻ circular view ViewGroup →: Every view group this view belongs to, oldest group first. The app lets a view sit in several groups; addViewToGroup and removeViewFromGroup change one membership. Empty when the view is ungrouped.
id ID!: Unique identifier of this saved view. Use the returned id with creators(presetId:) to fetch the view's creators.
name String!: Display name of the view.
position Int: Display slot of this view; lower values come first. Inside a ViewGroup member list, or a list filtered by groupId, it is the slot within that group. Elsewhere it is the slot in the default list of this view kind, set by reorderDefaultViewList. Null when the slot is unset. Hidden views are not exposed through the public API.
showReportingStats Boolean!: Whether reporting stats are surfaced in the UI for this view.
sort JSON!: Sort directives applied when listing creators via this view.
updatedAt DateTimeWithZone!: When the view was last updated.
id ID!: Unique identifier.
memberIds [ID!]!: Ids of every member of this group in group order, across all kinds. It includes app view kinds the API does not model, such as Manage Rights views, and omits hidden views the app never lists. Pass it, reordered, to reorderViewsInGroup to rewrite the full order.
name String!: Display name of the group.
socialProfileViews [SocialProfileView!]!: Social Profile Views that belong to this group, ordered by their position within the group.
createdAt DateTimeWithZone!: When the view was created.
customAttributeConditions JSON!: Custom-attribute conditions narrowing the filter set, as stored: operator and type hold the lowercase stored values (e.g. "is_not_empty", "text_list"), not the FilterOperator / CustomAttributeType names. The view create and update mutations accept these stored values when the list is passed back as customAttributeConditions through variables, but they validate it as they would any other input: a list the app saved can be refused (for example a list condition with no values, more conditions or values than the limits allow, or a condition on an attribute the workspace no longer has or whose type no longer matches), so check the userErrors when cloning a view this way.
displaySettings SocialProfileViewDisplaySettings!: Which columns the Archive app shows for this view. Set with displaySettings on create or update.
showCommentsTotal Boolean!: Show the total comments column.
showContent Boolean!: Show the content column.
showEmvTotal Boolean!: Show the total EMV (earned media value) column.
showFollowersSocial Boolean!: Show the followers column.
showFullName Boolean!: Show the full name column.
showIgPosts Boolean!: Show the Instagram posts column.
showIgReels Boolean!: Show the Instagram Reels column.
showIgStories Boolean!: Show the Instagram Stories column.
showLabels Boolean!: Show the labels column.
showLastPost Boolean!: Show the last post column.
showLastPulledAt Boolean!: Show the last refresh time column.
showLikesTotal Boolean!: Show the total likes column.
showPostsTotal Boolean!: Show the total posts column.
showSharesTotal Boolean!: Show the total shares column.
showTracking Boolean!: Show the tracking column.
showTrackingUntil Boolean!: Show the tracking end date column.
showTtStories Boolean!: Show the TikTok Stories column.
showTtVideos Boolean!: Show the TikTok videos column.
showViewsTotal Boolean!: Show the total views column.
showYtShorts Boolean!: Show the YouTube Shorts column.
showYtVideos Boolean!: Show the YouTube videos column.
filters JSON!: Opaque filter blob, stored and echoed back. socialProfiles(presetId:) applies it only with applyViewFilters: true; otherwise it narrows only by this view's customAttributeConditions and sort. Use customAttributeConditions to filter which social profiles the view returns.
group ViewGroup ↻ circular view ViewGroup →: The primary group of this view: the first entry of groups, which is the oldest group it belongs to. Null when the view is ungrouped.
groups [ViewGroup!]! ↻ circular view ViewGroup →: Every view group this view belongs to, oldest group first. The app lets a view sit in several groups; addViewToGroup and removeViewFromGroup change one membership. Empty when the view is ungrouped.
id ID!: Unique identifier of this saved view. Use the returned id with socialProfiles(presetId:) to fetch the view's social profiles.
name String!: Display name of the view.
position Int: Display slot of this view; lower values come first. Inside a ViewGroup member list, or a list filtered by groupId, it is the slot within that group. Elsewhere it is the slot in the default list of this view kind, set by reorderDefaultViewList. Null when the slot is unset. Hidden views are not exposed through the public API.
showReportingStats Boolean!: Whether reporting stats are surfaced in the UI for this view.
sort JSON!: Sort directives applied when listing social profiles via this view. Each entry is { field, direction }: field is one of media_items_taken_at_max, followers_count, source_tracking, source_content, source_tracking_until, source_last_pulled_at, account_name; direction is ASC or DESC (case-insensitive).
updatedAt DateTimeWithZone!: When the view was last updated.
updatedAt DateTimeWithZone!: When the group was last updated.

mutation AddViewToGroupDefault($groupId: ID!, $viewId: ID!) { addViewToGroup(groupId: $groupId, viewId: $viewId) { viewGroup { id name memberIds } changed userErrors { field message } } }

{ "data": { "addViewToGroup": { "viewGroup": { "id": "8e0f0ff1-8024-5af5-9506-49091f53a920", "name": "Northwind Sidebar", "memberIds": [ "eaa824b8-374f-5db8-bee2-51dfd8c3776c", "8d6ddb76-8b81-5725-a762-2d2e18432dcf" ] }, "changed": true, "userErrors": [] } } }