---
title: "Get Arcade Tool Specification"
method: GET
path: "/v1/tools/{name}"
tags: ["Tools"]
---

# Get Arcade Tool Specification

`GET /v1/tools/{name}`

Returns the arcade tool specification for a specific tool

## Path parameters

- `name` string, required

## Query parameters

- `include_format` string[]
- `user_id` string

## Response `200`

OK

- SchemasToolResponse
  - `description` string
  - `formatted_schema` object
  - `fully_qualified_name` string, required
  - `input` SchemasInput, required
    - `parameters` SchemasParameter[]
      - `description` string
      - `inferrable` boolean
      - `name` string, required
      - `required` boolean
      - `value_schema` SchemasValueSchema, required
        - `enum` string[]
        - `inner_val_type` string
        - `val_type` string, required
  - `metadata` ToolToolMetadata
    - `behavior` ToolBehavior
      - `destructive` boolean
      - `idempotent` boolean
      - `open_world` boolean
      - `operations` string[]
      - `read_only` boolean
    - `classification` ToolClassification
      - `service_domains` string[]
    - `extras` object
  - `name` string, required
  - `output` SchemasOutput
    - `available_modes` string[]
    - `description` string
    - `value_schema` SchemasValueSchema
      - `enum` string[]
      - `inner_val_type` string
      - `val_type` string, required
  - `qualified_name` string, required
  - `requirements` SchemasRequirements
    - `authorization` SchemasAuthorizationRequirement
      - `id` string
      - `oauth2` SchemasOAuth2AuthorizationRequirement
        - `scopes` string[]
      - `provider_id` string
      - `provider_type` string
      - `status` 'active' | 'inactive'
      - `status_reason` string
      - `token_status` 'not_started' | 'pending' | 'completed' | 'failed'
    - `met` boolean
    - `secrets` SchemasSecretRequirement[]
      - `key` string, required
      - `met` boolean
      - `status_reason` string
  - `toolkit` SchemasToolkitResponse, required
    - `description` string
    - `name` string, required
    - `version` string

## Other responses

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

## Changes

- **2026-02-20** `80cda61e307a` — 1 info
  - added the optional property `metadata` to the response with the `200` status
- **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/tools/:name/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)