Mutation

moveCreatorViewToGroup

Move a saved Creator View into a view group, or out (when groupId is null).

MCP: moveCreatorViewToGroup

Arguments

groupId ID: Target ViewGroup UUID. Pass null to remove the view from any group it currently belongs to.
viewId ID! required: FilterPreset UUID of the Creator View to move.

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.

creatorView CreatorView: The moved Creator View, with the populated group field. Null when the view was not found or the move failed.
createdAt DateTimeWithZone!: When the view was created.
customAttributeConditions JSON!: Custom-attribute conditions narrowing the filter set.
filters JSON!: Opaque filter blob, stored and echoed back but not applied when reading the view: creators(presetId:) narrows only by this view's customAttributeConditions and sort. Use customAttributeConditions to filter which creators the view returns.
group ViewGroup: Group this view belongs to, or null when the view is ungrouped. Populated by moveCreatorViewToGroup.
collections [Collection!]!: Collections that belong to this group, ordered by their position within the group.
createdAt DateTimeWithZone!: When the Collection was created.
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.
filters JSON!: Opaque filter blob defining which items belong to the view.
group ViewGroup ↻ circular view ViewGroup →: Group this view belongs to, or null when the view is ungrouped. Populated by moveContentViewToGroup.
id ID!: Unique identifier (FilterPreset UUID). Use this with items(presetId:).
name String!: Display name of the view.
showReportingStats Boolean!: Whether reporting stats are surfaced in the UI for this view.
sort JSON!: Sort directives applied when listing items via this view.
updatedAt DateTimeWithZone!: When the view was last updated.
createdAt DateTimeWithZone!: When the group was created.
creatorViews [CreatorView!]! ↻ circular view CreatorView →: Creator Views that belong to this group, ordered by their position within the group.
id ID!: Unique identifier.
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.
filters JSON!: Opaque filter blob, stored and echoed back but not applied when reading the view: socialProfiles(presetId:) narrows only by this view's customAttributeConditions and sort. Use customAttributeConditions to filter which social profiles the view returns.
group ViewGroup ↻ circular view ViewGroup →: Group this view belongs to, or null when the view is ungrouped. Populated by moveSocialProfileViewToGroup.
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.
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.
updatedAt DateTimeWithZone!: When the view was last updated.
updatedAt DateTimeWithZone!: When the group was last updated.
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.
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.
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.

Open in explorer ↗

Values are sampled from a demo workspace — substitute your own token and workspace id.

Move a saved Creator View into a view group (or out with a null groupId).

query.graphql

mutation MoveCreatorViewToGroupDefault($viewId: ID!, $groupId: ID) {
  moveCreatorViewToGroup(viewId: $viewId, groupId: $groupId) {
    creatorView {
      id
      name
      group {
        id
        name
      }
    }
    userErrors {
      field
      message
    }
  }
}

variables.json

{
  "viewId": "8d6ddb76-8b81-5725-a762-2d2e18432dcf",
  "groupId": "8e0f0ff1-8024-5af5-9506-49091f53a920"
}

Headers

Authorization: Bearer docs_demo_token_0000000000000000000000
WORKSPACE-ID: 6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a

Request · cURL

curl https://app.archive.com/api/v2 \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer docs_demo_token_0000000000000000000000' \
  -H 'WORKSPACE-ID: 6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a' \
  -d '{
  "query": "mutation MoveCreatorViewToGroupDefault($viewId: ID!, $groupId: ID) {\n  moveCreatorViewToGroup(viewId: $viewId, groupId: $groupId) {\n    creatorView {\n      id\n      name\n      group {\n        id\n        name\n      }\n    }\n    userErrors {\n      field\n      message\n    }\n  }\n}",
  "variables": {
    "viewId": "8d6ddb76-8b81-5725-a762-2d2e18432dcf",
    "groupId": "8e0f0ff1-8024-5af5-9506-49091f53a920"
  }
}'

Request · Node.js

const response = await fetch("https://app.archive.com/api/v2", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer docs_demo_token_0000000000000000000000",
    "WORKSPACE-ID": "6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a"
  },
  body: JSON.stringify({
    query: `mutation MoveCreatorViewToGroupDefault($viewId: ID!, $groupId: ID) {
  moveCreatorViewToGroup(viewId: $viewId, groupId: $groupId) {
    creatorView {
      id
      name
      group {
        id
        name
      }
    }
    userErrors {
      field
      message
    }
  }
}`,
    variables: {
      "viewId": "8d6ddb76-8b81-5725-a762-2d2e18432dcf",
      "groupId": "8e0f0ff1-8024-5af5-9506-49091f53a920"
    }
  })
})
console.log(JSON.stringify(await response.json(), null, 2))

Request · Ruby

require "json"
require "net/http"

query = <<~'GRAPHQL'
  mutation MoveCreatorViewToGroupDefault($viewId: ID!, $groupId: ID) {
    moveCreatorViewToGroup(viewId: $viewId, groupId: $groupId) {
      creatorView {
        id
        name
        group {
          id
          name
        }
      }
      userErrors {
        field
        message
      }
    }
  }
GRAPHQL

response = Net::HTTP.post(
  URI("https://app.archive.com/api/v2"),
  { query: query, variables: { "viewId" => "8d6ddb76-8b81-5725-a762-2d2e18432dcf", "groupId" => "8e0f0ff1-8024-5af5-9506-49091f53a920" } }.to_json,
  "Content-Type" => "application/json",
  "Authorization" => "Bearer docs_demo_token_0000000000000000000000",
  "WORKSPACE-ID" => "6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a"
)
puts response.body

Request · Python

import json
import requests

query = """
mutation MoveCreatorViewToGroupDefault($viewId: ID!, $groupId: ID) {
  moveCreatorViewToGroup(viewId: $viewId, groupId: $groupId) {
    creatorView {
      id
      name
      group {
        id
        name
      }
    }
    userErrors {
      field
      message
    }
  }
}
"""

response = requests.post(
    "https://app.archive.com/api/v2",
    json={"query": query, "variables": {"viewId": "8d6ddb76-8b81-5725-a762-2d2e18432dcf", "groupId": "8e0f0ff1-8024-5af5-9506-49091f53a920"}},
    headers={
        "Authorization": "Bearer docs_demo_token_0000000000000000000000",
        "WORKSPACE-ID": "6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a",
    },
)
print(json.dumps(response.json(), indent=2))

200 OK 15 lines

{
  "data": {
    "moveCreatorViewToGroup": {
      "creatorView": {
        "id": "8d6ddb76-8b81-5725-a762-2d2e18432dcf",
        "name": "Northwind VIP Creators",
        "group": {
          "id": "8e0f0ff1-8024-5af5-9506-49091f53a920",
          "name": "Northwind Sidebar"
        }
      },
      "userErrors": []
    }
  }
}