Tags actions

11 actions. Each action calls the same API route with the same scopes on every surface.

assign_tags

Assign Tags. Body fields: path, tags..

Route	PUT /api/v1/tags/items
Tool name	calternal_api_assign_tags
Surfaces	cli, mcp, webmcp
Scopes	data
Effect	destructive, needs --confirm
Encoding	request json, response json

body

Field	Type	Required	Description
path	string	yes
tags	array of string	yes

calternal action run assign_tags --input '{}' --confirm --json

get_file_assignment

Get file assignment.

Route	GET /api/v1/tags/items/{path}
Tool name	calternal_api_get_file_assignment
Surfaces	cli, mcp, webmcp
Scopes	data
Effect	read only
Encoding	request none, response json

path

Field	Type	Required	Description
path	string	yes

calternal action run get_file_assignment --input '{"path":{"path":"<path>"}}' --json

list_file_assignments

List file assignments Continuation: Pass next_cursor unchanged. Reduce limit after an overflow..

Route	GET /api/v1/tags/items
Tool name	calternal_api_list_file_assignments
Surfaces	cli, mcp, webmcp
Scopes	data
Effect	read only
Encoding	request none, response json

query

Field	Type	Required	Description
cursor	integer (0–)	no
folder	string	no
limit	integer (0–)	no

calternal action run list_file_assignments --input '{}' --json

list_tags

List Tags.

Route	GET /api/v1/tags
Tool name	calternal_api_list_tags
Surfaces	cli, mcp, webmcp
Scopes	data
Effect	read only
Encoding	request none, response json

calternal action run list_tags --input '{}' --json

preview_rename

Preview rename. Body fields: confirmed, new_tag, old_tag..

Route	POST /api/v1/tags/rename/preview
Tool name	calternal_api_preview_rename
Surfaces	cli, mcp, webmcp
Scopes	data
Effect	read only
Encoding	request json, response json

body

Field	Type	Required	Description
confirmed	boolean	no
new_tag	string	yes
old_tag	string	yes

calternal action run preview_rename --input '{}' --json

rename_tag

Rename Tag. Body fields: confirmed, new_tag, old_tag..

Route	POST /api/v1/tags/rename
Tool name	calternal_api_rename_tag
Surfaces	cli, mcp, webmcp
Scopes	data
Effect	destructive, needs --confirm
Encoding	request json, response json

body

Field	Type	Required	Description
confirmed	boolean	no
new_tag	string	yes
old_tag	string	yes

calternal action run rename_tag --input '{}' --confirm --json

rewrite_status

Tag progress.

Route	GET /api/v1/tags/rewrites/{id}
Tool name	calternal_api_rewrite_status
Surfaces	cli, mcp, webmcp
Scopes	data
Effect	read only
Encoding	request none, response json

path

Field	Type	Required	Description
id	string	yes

calternal action run rewrite_status --input '{"path":{"id":"<id>"}}' --json

start_rewrite

Update Tag. Body fields: confirmed, new_tag, old_tag..

Route	POST /api/v1/tags/rewrites
Tool name	calternal_api_start_rewrite
Surfaces	cli, mcp, webmcp
Scopes	data
Effect	destructive, needs --confirm
Encoding	request json, response json

body

Field	Type	Required	Description
confirmed	boolean	no
new_tag	string	yes
old_tag	string	yes

calternal action run start_rewrite --input '{}' --confirm --json

tag_page

Get Tag details Continuation: Pass next_cursor unchanged. Reduce limit after an overflow..

Route	GET /api/v1/tags/{tag}
Tool name	calternal_api_tag_page
Surfaces	cli, mcp, webmcp
Scopes	data
Effect	read only
Encoding	request none, response json

path

Field	Type	Required	Description
tag	string	yes

query

Field	Type	Required	Description
cursor	integer (0–)	no
limit	integer (0–)	no

calternal action run tag_page --input '{"path":{"tag":"<tag>"}}' --json

tags_reconcile

Reconcile Tags.

Route	POST /api/v1/tags/reconcile
Tool name	calternal_api_tags_reconcile
Surfaces	cli, mcp, webmcp
Scopes	data
Effect	destructive, needs --confirm
Encoding	request none, response json

calternal action run tags_reconcile --input '{}' --confirm --json

undo_rewrite

Undo Tag update.

Route	POST /api/v1/tags/rewrites/{id}/undo
Tool name	calternal_api_undo_rewrite
Surfaces	cli, mcp, webmcp
Scopes	data
Effect	destructive, needs --confirm
Encoding	request none, response json

path

Field	Type	Required	Description
id	string	yes

calternal action run undo_rewrite --input '{"path":{"id":"<id>"}}' --confirm --json