---
title: "Add"
method: POST
path: "/api/v1/tools"
tags: ["Tools Resource"]
---

# Add

`POST /api/v1/tools`

## Request body

- ToolReference
  - `labels` object
  - `id` string
  - `name` string
  - `description` string
  - `uri` string
  - `type` string
  - `inputSchema` InputSchema
    - `type` string
    - `properties` object
    - `required` string[]
  - `namespace` string
  - `configurationURI` string
  - `secretsURI` string

## Response `200`

OK

- WanakuResponseToolReference
  - `error` WanakuError
    - `message` string
  - `data` ToolReference
    - `labels` object
    - `id` string
    - `name` string
    - `description` string
    - `uri` string
    - `type` string
    - `inputSchema` InputSchema
      - `type` string
      - `properties` object
      - `required` string[]
    - `namespace` string
    - `configurationURI` string
    - `secretsURI` string

## Other responses

- `400` — Bad Request

## Changes

- **2026-05-14** `e544cfb4deed` — 1 info
  - removed the non-success response with the status `500`
- **2026-05-11** `cc2b66f5cdc5` — 1 info
  - added the non-success response with the status `500`
- **2026-05-11** `90c90efc66a2` — 1 info
  - removed the non-success response with the status `500`
- **2026-03-25** `50f9b34925ab` — 1 info
  - added the non-success response with the status `500`

[Change history](https://skmtc.dev/wanaku-ai/apis/wanaku-router-backend-api/changes/api/v1/tools/post.md)

---

[API](https://skmtc.dev/wanaku-ai/apis/wanaku-router-backend-api.md) · [All operations](https://skmtc.dev/wanaku-ai/apis/wanaku-router-backend-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/wanaku-ai/wanaku-router-backend-api/revisions/801af2512b23/schema)