{
  "slug": "circleci-orb-version-looks-up-one-orb-version-f972250f5e9d",
  "title": "circleci orb version looks up one orb version",
  "tools": [
    "circleci"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-10-28T15:57:37.000Z",
  "announced_at": "2026-10-28T15:57:37.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When inspecting a CircleCI orb version, look it up by orb reference or version UUID. Use JSON and jq to extract fields such as the version ID.",
    "examples": [
      "circleci orb version <namespace>/<orb>@<version>",
      "circleci orb version <namespace>/<orb>",
      "circleci orb version <namespace>/<orb>@<version> --json --jq .id"
    ],
    "gotchas": [
      "Version: v1.12.0",
      "--json: Output as JSON.",
      "--jq <string>: Filter response values using jq syntax.",
      "Without `@<version>`, the lookup shows the latest published version, matching the default used by `orb source`."
    ]
  },
  "why_it_matters": "When inspecting a CircleCI orb version for a repository's pipeline configuration, look it up by orb reference or version ID.",
  "sources": [
    "https://github.com/CircleCI-Public/circleci-cli/releases/tag/v1.12.0",
    "https://github.com/CircleCI-Public/circleci-cli/pull/1946",
    "https://github.com/CircleCI-Public/circleci-cli/blob/v1.12.0/internal/cmd/root/testdata/help/circleci/orb/version.txt"
  ],
  "rank": 0.98032,
  "review_state": "approved",
  "provenance": {
    "run_id": "daily-20261028-20",
    "verdict_id": "daily-20261028-20:daily-20261028-20-d525e4fbc2f5fb83-7:gate",
    "evidence_hash": "57d7d86c4f3c734efa1a63f8222e2aafb4ea567c16163b41a7cc00e0a8d69178"
  }
}