---
title: "Start Tool Run"
method: POST
path: "/v1beta2/tool/start-run"
tags: ["Tools"]
---

# Start Tool Run

`POST /v1beta2/tool/start-run`

## Request

- Base URL: `https://api.hunch.tools`
- URL: `https://api.hunch.tools/v1beta2/tool/start-run`
- Auth: HTTP bearer

This endpoint creates a new run of the specified tool with the supplied
inputs. It returns the tool run UID, which can be used to check the status
and retrieve the outputs of the run.

Inputs are specified as a list of dictionaries each containing the title of
the input block and the input.

## Headers

- `authorization` string, nullable

## Request body

- StartToolRunRequest: The request body used to start a tool run.
  - `tool_uid` string, required: The unique identifier of the tool to run
  - `inputs` ToolRunInput[], required: The inputs to the tool
    - `title` string, required: The title of the input block in the tool
    - `text` string, nullable, required: The value for the input

## Response `200`

Successful Response

- StartToolRunResponse: The response body returned after starting a tool run.
  - `tool_run_uid` string, required: The unique identifier of the tool run

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `422`: Validation Error
- `456`: Additional Response

---

[API](https://skmtc.dev/hunch/apis/hunch-api.md) - [All operations](https://skmtc.dev/hunch/apis/hunch-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hunch/apis/hunch-api/revisions/f434015fdbee?raw)