cite
Create a permanent citation URL for any catalog entity, including a snapshot timestamp to ensure reproducibility.
Instructions
Generate a citation URL for a catalog entity.
Creates a permanent, citable URL for any catalog entity (dataset, execution, asset, etc.). By default, includes a snapshot timestamp for reproducibility. Use current=True for a link to the live data.
Args: rid: RID of the entity to cite (e.g., "1-ABC"). current: If True, return URL to current state without snapshot. If False (default), return permanent URL with snapshot timestamp.
Returns: JSON with: - url: The citation URL - rid: The entity RID - is_snapshot: Whether URL includes snapshot timestamp
Examples: cite("1-ABC") -> {"url": "https://host/id/catalog/1-ABC@2024-01-15", "is_snapshot": true}
cite("1-ABC", current=True)
-> {"url": "https://host/id/catalog/1-ABC", "is_snapshot": false}
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"rid": "<rid>"
},
"name": "cite"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| rid | Yes | ||
| current | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |