Query

labels

List the creator labels of the current workspace, alphabetically by name (case-insensitive). deleting is true while a workspace-wide deletion of the label is in progress; do not assign such a label, and do not recreate it until it disappears from this list. Returns at most 1000 rows; this field is not paginated.

MCP: getLabels

Arguments

This field takes no arguments.

Returns

Returns [Label!]!.

deleting Boolean!: True while a workspace-wide deletion of this label is in progress. The label leaves this list once the deletion finishes; do not assign it, and do not recreate it until it disappears from this list.
name String!: The label as stored for this workspace (the spelling a customer typed). Pass this spelling back as-is; matching ignores case and surrounding whitespace.

Open in explorer ↗

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

Return every creator label in the workspace, by name, with its deleting flag.

query.graphql

query LabelsDefault {
  labels {
    name
    deleting
  }
}

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 LabelsDefault {\n  labels {\n    name\n    deleting\n  }\n}"
}'

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 LabelsDefault {
  labels {
    name
    deleting
  }
}`
  })
})
console.log(JSON.stringify(await response.json(), null, 2))

Request · Ruby

require "json"
require "net/http"

query = <<~'GRAPHQL'
  query LabelsDefault {
    labels {
      name
      deleting
    }
  }
GRAPHQL

response = Net::HTTP.post(
  URI("https://app.archive.com/api/v2"),
  { query: query }.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 LabelsDefault {
  labels {
    name
    deleting
  }
}
"""

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

200 OK 22 lines

{
  "data": {
    "labels": [
      {
        "name": "Gifting",
        "deleting": false
      },
      {
        "name": "Plant Parents",
        "deleting": false
      },
      {
        "name": "Retired 2024",
        "deleting": false
      },
      {
        "name": "VIP",
        "deleting": false
      }
    ]
  }
}