---
title: "Upload new tool or existing one"
method: POST
path: "/tools/{name}/zip"
tags: ["Management"]
---

# Upload new tool or existing one

`POST /tools/{name}/zip`

## Request

- Base URL: `/bk/api` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/bk/api/tools/{name}/zip`
- Auth: HTTP bearer

Upload code of a tool and create new one or overwrite existing version

## Path parameters

- `name` string, required

## Request body `multipart/form-data`

- object
  - `meta` Tool
    - `id` integer
    - `name` string
  - `file` string, binary

## Response `201`

Successfully created group

## Changes

- **2022-05-28** `1e69a1a6d062`: 1 breaking, 2 info
  - removed the media type `application/zip` from the request body
  - api operation id `upload_tool` removed and replaced with `upload_new_or_overwrite_tool`
  - added the media type `multipart/form-data` to the request body
- **2022-05-22** `c93e6eb539ed`: 1 info
  - endpoint added
- **2021-01-31** `6dffc3a4de00`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/kraken-ci/apis/kraken-ci/changes/tools/:name/zip/post.md)

---

[API](https://skmtc.dev/kraken-ci/apis/kraken-ci.md) - [All operations](https://skmtc.dev/kraken-ci/apis/kraken-ci/llms.txt) - [OpenAPI document](https://skmtc.dev/kraken-ci/apis/kraken-ci/revisions/1f2ae877f985?raw)