science.alt.dataset.resolveLabel Documentation (EN)

main query

Resolve a named dataset label to its underlying dataset entry. When version is omitted, resolves to the most recently created label with the given name.

Parameters

handle string Required

DID or handle of the dataset owner

name string Required

Label name, e.g. 'mnist'

version string Optional

Specific version to resolve. If omitted, resolves to latest.

Output

Encodingapplication/json

cid string Required

CID of the resolved dataset entry

label refscience.alt.dataset.label Required

The label record that was resolved

uri stringat-uri Required

AT-URI of the resolved dataset entry

Errors

LabelNotFound No label found with the given name

Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Service Endpoint Base URL for XRPC calls (e.g., https://api.bsky.social)

Parameters

handle * DID or handle of the dataset owner

name * Label name, e.g. 'mnist'

version Specific version to resolve. If omitted, resolves to latest.

View raw schema

{
  "type": "query",
  "errors": [
    {
      "name": "LabelNotFound",
      "description": "No label found with the given name"
    }
  ],
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "uri",
        "cid",
        "label"
      ],
      "properties": {
        "cid": {
          "type": "string",
          "description": "CID of the resolved dataset entry"
        },
        "uri": {
          "type": "string",
          "format": "at-uri",
          "description": "AT-URI of the resolved dataset entry"
        },
        "label": {
          "ref": "science.alt.dataset.label",
          "type": "ref",
          "description": "The label record that was resolved"
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "required": [
      "handle",
      "name"
    ],
    "properties": {
      "name": {
        "type": "string",
        "maxLength": 200,
        "description": "Label name, e.g. 'mnist'"
      },
      "handle": {
        "type": "string",
        "description": "DID or handle of the dataset owner"
      },
      "version": {
        "type": "string",
        "maxLength": 50,
        "description": "Specific version to resolve. If omitted, resolves to latest."
      }
    }
  },
  "description": "Resolve a named dataset label to its underlying dataset entry. When version is omitted, resolves to the most recently created label with the given name."
}