catalog_get
Resolve one exact authorized project resource ID and return compact metadata. For a semantic_model ref, details.metadata.definition contains the bounded active definition (datasets, dimensions, and metrics); use it to explain metric formulas before exporting dashboards or searching documentation.
Machine-readable: focused JSON · complete manifest
Contract
| Property | Value |
|---|---|
| Authorization | RESOURCE_READ |
| Effect | read |
| Operation | manual |
| Tags | catalog, describe |
| Defaults | {} |
| MCP annotations | read-only, idempotent, non-destructive, closed-world |
Input schema
{
"additionalProperties": false,
"properties": {
"ref": {
"additionalProperties": false,
"properties": {
"id": {
"maxLength": 256,
"minLength": 1,
"pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
"type": "string"
},
"kind": {
"enum": [
"project",
"connection",
"source",
"model",
"semantic_model",
"pipeline",
"dashboard"
],
"type": "string"
}
},
"required": [
"id",
"kind"
],
"type": "object"
}
},
"required": [
"ref"
],
"type": "object"
}
Output schema
{
"additionalProperties": false,
"properties": {
"details": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"project",
"connection",
"source",
"model",
"semantic_model",
"pipeline",
"dashboard"
],
"type": "string"
},
"metadata": {
"additionalProperties": {},
"type": "object"
}
},
"required": [
"kind",
"metadata"
],
"type": "object"
},
"item": {
"additionalProperties": false,
"properties": {
"description": {
"type": "string"
},
"displayName": {
"type": "string"
},
"domain": {
"type": "string"
},
"name": {
"type": "string"
},
"owner": {
"type": "string"
},
"ref": {
"additionalProperties": false,
"properties": {
"id": {
"maxLength": 256,
"minLength": 1,
"pattern": "^[A-Za-z0-9][A-Za-z0-9_.:-]*$",
"type": "string"
},
"kind": {
"enum": [
"project",
"connection",
"source",
"model",
"semantic_model",
"pipeline",
"dashboard"
],
"type": "string"
}
},
"required": [
"id",
"kind"
],
"type": "object"
},
"tags": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"name",
"ref"
],
"type": "object"
}
},
"required": [
"details",
"item"
],
"type": "object"
}