MUTATION

reorderViewsInGroup

Reorder the submitted Content View, Social Profile View, and Creator View ids within the named group. Members omitted from viewIds keep their relative order and sort after the listed views.

MCP: reorderViewsInGroup

Arguments

groupId ID! required: UUID of the ViewGroup whose member views should be reordered.
viewIds [ID!]! required: FilterPreset UUIDs in the desired display order. Must list only views that are currently members of this group. The first id becomes position 1.

Returns

userErrors [UserError!]!: List of user-facing errors. Empty on success.
viewGroup ViewGroup: The reordered ViewGroup. contentViews, socialProfileViews, and creatorViews reflect the new ordering in a single round-trip. Null when the group was not found or the reorder failed.

Open in explorer ↗

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

Reorder the member views within a view group.

query.graphql

mutation ReorderViewsInGroupDefault($groupId: ID!, $viewIds: [ID!]!) {
  reorderViewsInGroup(groupId: $groupId, viewIds: $viewIds) {
    viewGroup {
      id
      name
    }
    userErrors {
      field
      message
    }
  }
}

variables.json

{
  "groupId": "8e0f0ff1-8024-5af5-9506-49091f53a920",
  "viewIds": [
    "eaa824b8-374f-5db8-bee2-51dfd8c3776c"
  ]
}

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 ReorderViewsInGroupDefault($groupId: ID!, $viewIds: [ID!]!) {\n  reorderViewsInGroup(groupId: $groupId, viewIds: $viewIds) {\n    viewGroup {\n      id\n      name\n    }\n    userErrors {\n      field\n      message\n    }\n  }\n}",
  "variables": {
    "groupId": "8e0f0ff1-8024-5af5-9506-49091f53a920",
    "viewIds": [
      "eaa824b8-374f-5db8-bee2-51dfd8c3776c"
    ]
  }
}'

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 ReorderViewsInGroupDefault($groupId: ID!, $viewIds: [ID!]!) {
  reorderViewsInGroup(groupId: $groupId, viewIds: $viewIds) {
    viewGroup {
      id
      name
    }
    userErrors {
      field
      message
    }
  }
}`,
    variables: {
      "groupId": "8e0f0ff1-8024-5af5-9506-49091f53a920",
      "viewIds": [
        "eaa824b8-374f-5db8-bee2-51dfd8c3776c"
      ]
    }
  })
})
console.log(JSON.stringify(await response.json(), null, 2))

Request · Ruby

require "json"
require "net/http"

query = <<~'GRAPHQL'
  mutation ReorderViewsInGroupDefault($groupId: ID!, $viewIds: [ID!]!) {
    reorderViewsInGroup(groupId: $groupId, viewIds: $viewIds) {
      viewGroup {
        id
        name
      }
      userErrors {
        field
        message
      }
    }
  }
GRAPHQL

response = Net::HTTP.post(
  URI("https://app.archive.com/api/v2"),
  { query: query, variables: { "groupId" => "8e0f0ff1-8024-5af5-9506-49091f53a920", "viewIds" => ["eaa824b8-374f-5db8-bee2-51dfd8c3776c"] } }.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 ReorderViewsInGroupDefault($groupId: ID!, $viewIds: [ID!]!) {
  reorderViewsInGroup(groupId: $groupId, viewIds: $viewIds) {
    viewGroup {
      id
      name
    }
    userErrors {
      field
      message
    }
  }
}
"""

response = requests.post(
    "https://app.archive.com/api/v2",
    json={"query": query, "variables": {"groupId": "8e0f0ff1-8024-5af5-9506-49091f53a920", "viewIds": ["eaa824b8-374f-5db8-bee2-51dfd8c3776c"]}},
    headers={
        "Authorization": "Bearer docs_demo_token_0000000000000000000000",
        "WORKSPACE-ID": "6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a",
    },
)
print(json.dumps(response.json(), indent=2))

200 OK

{
  "data": {
    "reorderViewsInGroup": {
      "viewGroup": {
        "id": "8e0f0ff1-8024-5af5-9506-49091f53a920",
        "name": "Northwind Sidebar"
      },
      "userErrors": []
    }
  }
}