> ## Documentation Index
> Fetch the complete documentation index at: https://docs.the40thieves.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# get_task_status

> Status of a long-running tool call that returned a task handle instead of a result (index_vault on a large vault does).

Status of a long-running tool call that returned a task handle instead of a result (index\_vault on a large vault does). Pass the task\_id from the handle; while status is working it reports progress, and once completed it carries the tool's result. Read-only; only the caller that started the task can read it. Domain: admin.

| | |
| - | - |
| **Domain** | admin |
| **Scopes** | none |
| **Access** | read |
| **Tags** | `read-only`, `domain:admin` |
| **Profile** | core, full |

## Annotations

| Annotation | Value |
| - | - |
| Read-only | yes |
| Destructive | no |
| Idempotent | no |
| Accepts an idempotency key | no |

`Idempotent` is the advisory MCP `idempotentHint`. `Destructive` is also `yes` for a tool that
asks for confirmation only on some calls.

## Confirmation (human in the loop)

No human confirmation is required to call this tool.

## Input

| Parameter | Type | Required | Default | Description |
| - | - | - | - | - |
| `task_id` | `string` | yes | — | length 1–200 |

## Output

| Field | Type | Always present | Description |
| - | - | - | - |
| `task_id` | `string` | yes | — |
| `status` | `enum` | yes | One of: `"working"`, `"input_required"`, `"completed"`, `"failed"`, `"cancelled"` |
| `created_at` | `string` | yes | — |
| `last_updated_at` | `string` | yes | — |
| `progress` | `object` | | — |
| `progress.done` | `number` | with parent | — |
| `progress.total` | `number` | | — |
| `progress.message` | `string` | | — |
| `retry_after_seconds` | `number` | | — |
| `result` | `Record<string, any>` | | — |
| `error` | `object` | | — |
| `error.code` | `number` | with parent | — |
| `error.message` | `string` | with parent | — |
| `error.data` | `Record<string, any>` | | — |
| `status_message` | `string` | | — |

## Related tools

Other tools in the `admin` domain: [`cancel_task`](https://docs.the40thieves.dev/reliquary-tc/tools/reference/cancel_task/), [`get_index_status`](https://docs.the40thieves.dev/reliquary-tc/tools/reference/get_index_status/), [`get_metrics`](https://docs.the40thieves.dev/reliquary-tc/tools/reference/get_metrics/), [`get_server_config`](https://docs.the40thieves.dev/reliquary-tc/tools/reference/get_server_config/), [`inspect_acl`](https://docs.the40thieves.dev/reliquary-tc/tools/reference/inspect_acl/), [`inspect_visibility`](https://docs.the40thieves.dev/reliquary-tc/tools/reference/inspect_visibility/), [`server_health`](https://docs.the40thieves.dev/reliquary-tc/tools/reference/server_health/), [`session_rerun`](https://docs.the40thieves.dev/reliquary-tc/tools/reference/session_rerun/).

Back to the [tool catalog](https://docs.the40thieves.dev/reliquary-tc/tools/tool-catalog.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.