ta_library
Refresh reindex status, trigger reindexing, or update watched state for videos, channels, and playlists; writes require confirm=true and allow-writes, otherwise calls preview as dry runs.
Instructions
Reindex progress and watched-state changes for a video, channel, or playlist. Writes run only when confirm is true and TUBEARCHIVIST_ALLOW_WRITES=true. Otherwise the call is a dry-run and no HTTP write is sent. Actions: refresh_status (GET /api/refresh/), refresh (POST /api/refresh/), watched (POST /api/watched/).
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": {
"action": "<action>"
},
"name": "ta_library"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | id | |
| type | No | type | |
| action | Yes | Tube Archivist operation to call. | |
| confirm | No | Boolean true runs the write when TUBEARCHIVIST_ALLOW_WRITES is true. Omit it or pass false for a dry-run preview that sends nothing. The string true is rejected. | |
| document | No | document | |
| extract_videos | No | extract_videos |