set_catalog
Set or clear a catalog grouping label on an existing pipeline or tap only when a user explicitly asks to organize work under a named catalog.
Instructions
Set or clear the catalog grouping label on an existing pipeline or tap. ONLY call this when the user has explicitly asked to organize work under a named catalog. Do NOT call it proactively — catalogs are a user-chosen organizational convention; assigning one for them puts the pipeline/tap into a taxonomy they didn't ask for. Pass exactly one of pipeline or tap to identify the target. Pass catalog to set the label, or omit it (or pass an empty string) to clear it. Survives subsequent re-ingests — datris ingest no longer rewrites an existing pipeline's config. If this Datris instance's agent policy requires a person to approve this action, the call does NOT perform it: it returns status pending_approval with an approvalId. Tell the user it is waiting for approval in Datris, then poll get_approval with that id (pause with wait_seconds between polls) — do not re-issue the action.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "set_catalog"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tap | No | Tap name to update. Mutually exclusive with `pipeline`. | |
| reason | No | Optional one-line reason for this change, recorded in the platform's audit log and shown to anyone asked to approve it. | |
| catalog | No | Catalog label. Omit or pass an empty string to clear the label. | |
| pipeline | No | Pipeline name to update. Mutually exclusive with `tap`. |