Query

operations

List operations for the current workspace, ordered newest first.

Paginated · weighted cost MCP: getOperations

Arguments

after String default null: Cursor for fetching the next page of results.
first Int default 20: Number of operations to return (page size).

Returns

A paginated connection of OperationSummary nodes. See Pagination for the connection shape.

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.

edges [OperationSummaryEdge!]!: List of edges with cursors.
cursor String!: Cursor for this node.
node OperationSummary!: The operation summary.
createdAt DateTimeWithZone!: When the operation was created.
id ID!: Unique identifier of the operation.
operationType String!: The type of operation (e.g. refetch_engagement, update_custom_attributes).
status OperationStatus!: Current processing status of the operation.
COMPLETED: All items in the operation have been processed successfully.
FAILED: All items in the operation have failed.
PARTIAL: The operation finished but some items failed while others succeeded.
PROCESSING: The operation is currently being processed.
QUEUED: The operation has been created but processing has not yet started.
total Int!: Total number of items in the operation.
nodes [OperationSummary!]!: List of operation summaries.
createdAt DateTimeWithZone!: When the operation was created.
id ID!: Unique identifier of the operation.
operationType String!: The type of operation (e.g. refetch_engagement, update_custom_attributes).
status OperationStatus!: Current processing status of the operation.
COMPLETED: All items in the operation have been processed successfully.
FAILED: All items in the operation have failed.
PARTIAL: The operation finished but some items failed while others succeeded.
PROCESSING: The operation is currently being processed.
QUEUED: The operation has been created but processing has not yet started.
total Int!: Total number of items in the operation.
pageInfo PageInfo!: Pagination information.
endCursor String: Cursor for the last node in this page.
hasNextPage Boolean!: Whether there are more results after this page.
hasPreviousPage Boolean!: Whether there are results before this page.
startCursor String: Cursor for the first node in this page.
totalCount Int: Total number of items available.

Open in explorer ↗

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

Paginate the workspace's background operations, newest first.

query.graphql

query OperationsDefault($first: Int, $after: String) {
  operations(first: $first, after: $after) {
    totalCount
    edges {
      node {
        id
        status
        operationType
        total
        createdAt
      }
    }
    pageInfo {
      hasNextPage
      endCursor
    }
  }
}

variables.json

{
  "first": 10
}

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": "query OperationsDefault($first: Int, $after: String) {\n  operations(first: $first, after: $after) {\n    totalCount\n    edges {\n      node {\n        id\n        status\n        operationType\n        total\n        createdAt\n      }\n    }\n    pageInfo {\n      hasNextPage\n      endCursor\n    }\n  }\n}",
  "variables": {
    "first": 10
  }
}'

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: `query OperationsDefault($first: Int, $after: String) {
  operations(first: $first, after: $after) {
    totalCount
    edges {
      node {
        id
        status
        operationType
        total
        createdAt
      }
    }
    pageInfo {
      hasNextPage
      endCursor
    }
  }
}`,
    variables: {
      "first": 10
    }
  })
})
console.log(JSON.stringify(await response.json(), null, 2))

Request · Ruby

require "json"
require "net/http"

query = <<~'GRAPHQL'
  query OperationsDefault($first: Int, $after: String) {
    operations(first: $first, after: $after) {
      totalCount
      edges {
        node {
          id
          status
          operationType
          total
          createdAt
        }
      }
      pageInfo {
        hasNextPage
        endCursor
      }
    }
  }
GRAPHQL

response = Net::HTTP.post(
  URI("https://app.archive.com/api/v2"),
  { query: query, variables: { "first" => 10 } }.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 = """
query OperationsDefault($first: Int, $after: String) {
  operations(first: $first, after: $after) {
    totalCount
    edges {
      node {
        id
        status
        operationType
        total
        createdAt
      }
    }
    pageInfo {
      hasNextPage
      endCursor
    }
  }
}
"""

response = requests.post(
    "https://app.archive.com/api/v2",
    json={"query": query, "variables": {"first": 10}},
    headers={
        "Authorization": "Bearer docs_demo_token_0000000000000000000000",
        "WORKSPACE-ID": "6ccefa76-e8ba-5ab0-9c60-e48a9e235a4a",
    },
)
print(json.dumps(response.json(), indent=2))

200 OK 31 lines

{
  "data": {
    "operations": {
      "totalCount": 2,
      "edges": [
        {
          "node": {
            "id": "57d0f9ea-ba8a-59c5-8f7b-2aba9a54e7aa",
            "status": "PROCESSING",
            "operationType": "refetch_engagement",
            "total": 1,
            "createdAt": "2024-12-31T23:00:00Z"
          }
        },
        {
          "node": {
            "id": "aeb032f4-179f-549f-b83c-3db2c5b58a2d",
            "status": "COMPLETED",
            "operationType": "refetch_engagement",
            "total": 1,
            "createdAt": "2024-12-31T22:00:00Z"
          }
        }
      ],
      "pageInfo": {
        "hasNextPage": false,
        "endCursor": "Z2lkOi8vYXJjaGl2ZS9PcGVyYXRpb24vMjAyNC0xMi0zMVQyMjowMDowMC4wMDAwMDBafGFlYjAzMmY0LTE3OWYtNTQ5Zi1iODNjLTNkYjJjNWI1OGEyZA=="
      }
    }
  }
}