from metadata.sdk import configure
from metadata.sdk.entities import Tags

configure(
    host="https://your-company.open-metadata.org/api",
    jwt_token="your-jwt-token"
)

# Get by ID
tag = Tags.retrieve("68ec158c-5f5e-4277-8a19-5e9e0cd5294f")
print(f"{tag.fullyQualifiedName.root}: {getattr(tag.description, 'root', tag.description)}")

# Get by ID with fields
tag = Tags.retrieve(
    "68ec158c-5f5e-4277-8a19-5e9e0cd5294f",
    fields=["owners", "children"]
)

# Get by fully qualified name
tag = Tags.retrieve_by_name("Certification.Bronze")

# Get by name with fields
tag = Tags.retrieve_by_name(
    "Certification.Bronze",
    fields=["owners", "children"]
)

// client is an initialized OpenMetadataClient.
var tag = client.tags().get("68ec158c-5f5e-4277-8a19-5e9e0cd5294f");

// Get by ID with fields
var tagWithFields = client.tags().get(
    "68ec158c-5f5e-4277-8a19-5e9e0cd5294f",
    "owners,children");

// Get by fully qualified name
var tagByName = client.tags().getByName("Certification.Bronze");

// Get by name with fields
var tagByNameWithFields = client.tags().getByName(
    "Certification.Bronze",
    "owners,children");

# Get by ID
curl "{base_url}/api/v1/tags/68ec158c-5f5e-4277-8a19-5e9e0cd5294f" \
  -H "Authorization: Bearer {access_token}"

# Get by ID with fields
curl "{base_url}/api/v1/tags/68ec158c-5f5e-4277-8a19-5e9e0cd5294f?fields=owners,children" \
  -H "Authorization: Bearer {access_token}"

# Get by fully qualified name
curl "{base_url}/api/v1/tags/name/Certification.Bronze" \
  -H "Authorization: Bearer {access_token}"

# Get by name with fields
curl "{base_url}/api/v1/tags/name/Certification.Bronze?fields=owners,children" \
  -H "Authorization: Bearer {access_token}"

{
  "id": "68ec158c-5f5e-4277-8a19-5e9e0cd5294f",
  "name": "Bronze",
  "fullyQualifiedName": "Certification.Bronze",
  "description": "Bronze certified Data Asset.",
  "style": {
    "color": "#C08320"
  },
  "version": 0.1,
  "updatedAt": 1769982619666,
  "updatedBy": "admin",
  "classification": {
    "id": "06d90883-6be9-4f7e-9475-753f10a95e94",
    "type": "classification",
    "name": "Certification",
    "fullyQualifiedName": "Certification",
    "deleted": false
  },
  "deleted": false,
  "owners": [],
  "provider": "system",
  "mutuallyExclusive": false
}