---
title: "install tools"
method: POST
path: "/pkgs/tools/installed"
tags: ["tools"]
---

# install tools

`POST /pkgs/tools/installed`

## Request

- Base URL: `http:////localhost:80/v2`
- URL: `http:////localhost:80/v2/pkgs/tools/installed`
- Auth: none declared
- TypeScript: <https://skmtc.dev/arduino/apis/arduino-create-agent/docs/pkgs/tools/installed/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- ToolsInstallRequestBody
  - `checksum` string: A checksum of the archive. Mandatory when url is present. This ensures that the package is downloaded correcly.
  - `name` string, required: The name of the tool
  - `packager` string, required: The packager of the tool
  - `signature` string: The signature used to sign the url. Mandatory when url is present. This ensure the security of the file downloaded
  - `url` string: The url where the package can be found. Optional. If present checksum must also be present.
  - `version` string, required: The version of the tool

## Response `200`

OK response.

- ToolsInstallResponseBody: InstallResponseBody result type (default view)
  - `status` string, required: The status of the operation

## Changes

- **2023-08-28** `b4ab36c40745`: 1 info
  - endpoint added
- **2019-03-29** `6d4133c72aa7`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/arduino/apis/arduino-create-agent/changes/pkgs/tools/installed/post.md)

---

[API](https://skmtc.dev/arduino/apis/arduino-create-agent.md) - [All operations](https://skmtc.dev/arduino/apis/arduino-create-agent/llms.txt) - [OpenAPI document](https://skmtc.dev/arduino/apis/arduino-create-agent/revisions/95e99312309c?raw)