---
title: "Get scheduled tool execution details"
method: GET
path: "/v1/scheduled_tools/{id}"
tags: ["Tools"]
---

# Get scheduled tool execution details

`GET /v1/scheduled_tools/{id}`

Returns the details for a specific scheduled tool execution

## Path parameters

- `id` string, required

## Response `200`

OK

- SchemasToolExecutionDetailResponse
  - `attempts` SchemasToolExecutionAttemptResponse[]
    - `finished_at` string
    - `id` string
    - `output` ToolResponseOutput
      - `authorization` AuthAuthorizationResponse
        - `context` AuthAuthorizationContext
          - `token` string
          - `user_info` object
        - `id` string
        - `provider_id` string
        - `scopes` string[]
        - `status` 'not_started' | 'pending' | 'completed' | 'failed'
        - `url` string
        - `user_id` string
      - `error` ToolError
        - `additional_prompt_content` string
        - `can_retry` boolean, required
        - `developer_message` string
        - `extra` object
        - `kind` 'TOOLKIT_LOAD_FAILED' | 'TOOL_DEFINITION_BAD_DEFINITION' | 'TOOL_DEFINITION_BAD_INPUT_SCHEMA' | 'TOOL_DEFINITION_BAD_OUTPUT_SCHEMA' | 'TOOL_REQUIREMENTS_NOT_MET' | 'TOOL_RUNTIME_BAD_INPUT_VALUE' | 'TOOL_RUNTIME_BAD_OUTPUT_VALUE' | 'TOOL_RUNTIME_RETRY' | 'TOOL_RUNTIME_CONTEXT_REQUIRED' | 'TOOL_RUNTIME_FATAL' | 'CONTEXT_CHECK_FAILED' | 'CONTEXT_DENIED' | 'UPSTREAM_RUNTIME_BAD_REQUEST' | 'UPSTREAM_RUNTIME_AUTH_ERROR' | 'UPSTREAM_RUNTIME_NOT_FOUND' | 'UPSTREAM_RUNTIME_VALIDATION_ERROR' | 'UPSTREAM_RUNTIME_RATE_LIMIT' | 'UPSTREAM_RUNTIME_SERVER_ERROR' | 'UPSTREAM_RUNTIME_UNMAPPED' | 'NETWORK_TRANSPORT_RUNTIME_TIMEOUT' | 'NETWORK_TRANSPORT_RUNTIME_UNREACHABLE' | 'NETWORK_TRANSPORT_RUNTIME_UNMAPPED' | 'UNKNOWN', required
        - `message` string, required
        - `retry_after_ms` integer
        - `stacktrace` string
        - `status_code` integer
      - `logs` ToolLog[]
        - `level` string, required
        - `message` string, required
        - `subtype` string
      - `value` unknown
    - `started_at` string
    - `success` boolean
    - `system_error_message` string
  - `created_at` string
  - `execution_status` string
  - `execution_type` string
  - `finished_at` string
  - `id` string
  - `input` ToolRawInputs
  - `run_at` string
  - `started_at` string
  - `tool_name` string
  - `toolkit_name` string
  - `toolkit_version` string
  - `updated_at` string
  - `user_id` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `415` — Unsupported Media Type
- `500` — Internal Server Error

## Changes

- **2026-04-16** `a509111298b2` — 3 warning
  - added the new `NETWORK_TRANSPORT_RUNTIME_TIMEOUT` enum value to the `attempts/items/output/error/kind` response property for the response status `200`
  - added the new `NETWORK_TRANSPORT_RUNTIME_UNMAPPED` enum value to the `attempts/items/output/error/kind` response property for the response status `200`
  - added the new `NETWORK_TRANSPORT_RUNTIME_UNREACHABLE` enum value to the `attempts/items/output/error/kind` response property for the response status `200`
- **2026-01-22** `0df52128804d` — 2 warning
  - added the new `CONTEXT_CHECK_FAILED` enum value to the `attempts/items/output/error/kind` response property for the response status `200`
  - added the new `CONTEXT_DENIED` enum value to the `attempts/items/output/error/kind` response property for the response status `200`
- **2025-10-30** `f59a2fe653b8` — 1 warning, 1 info
  - deleted the `header` request parameter `Authorization`
  - the endpoint scheme security `Bearer` was added to the API

[Change history](https://skmtc.dev/arcadeai/apis/arcade-api/changes/v1/scheduled_tools/:id/get.md)

---

[API](https://skmtc.dev/arcadeai/apis/arcade-api.md) · [All operations](https://skmtc.dev/arcadeai/apis/arcade-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/arcadeai/arcade-api/revisions/a509111298b2/schema)