get_task_status
Retrieve the status and progress of an asynchronous operation using its token. Returns completion state, errors, or redirect URI.
Instructions
Look up the status of an async operation by its token.
The async tools (delete_entry, copy_entry, sometimes
import_document) return an operation_token instead of the
final result — call this to check whether the operation finished.
For "wait until done" semantics, use wait_for_task instead so
you don't have to write a polling loop.
Args: operation_token: The string token returned by the originating async tool.
Returns: Server's task payload — operationToken,
operationType, percentComplete, status (one of
NotStarted, InProgress, Completed, Failed,
Canceled), redirectUri (set when the op produced a new
entry, e.g. after a copy), entryId (the resulting entry's ID
when applicable), errors (list — empty on success), and
timestamps.
On failure: returns {"mode": "error", "error": <slug>, "operation_token": <str>, ...}. Common slugs: not_found
(token unknown — usually expired or from a different server
instance), auth_failed.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| operation_token | Yes | Operation token returned by an async tool (delete_entry, copy_entry, occasionally import_document). Server-scoped; tokens from a different server instance won't resolve. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||