curl --request POST \
  --url https://api.kallabot.com/v1/tools \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "schema": {
    "url": "<string>",
    "url_template": "<string>",
    "method": "POST",
    "headers": {},
    "query": {},
    "body": "<unknown>",
    "static": {},
    "auth": {
      "type": "none",
      "credential_id": "<string>",
      "token": "<string>",
      "header": "<string>",
      "query": "<string>",
      "value": "<string>",
      "sealed": "<string>",
      "hint": "<string>"
    },
    "parameters": {},
    "response": {
      "pick": "<string>",
      "max_chars": 10050,
      "error_message": "<string>"
    },
    "speech": {
      "filler": "<string>",
      "filler_after_ms": 5000,
      "fillers_by_lang": {}
    },
    "timeout_ms": 8000,
    "blocking": true,
    "filler": "<string>",
    "async": true,
    "side_effect": true,
    "lookup": true
  }
}
'

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: '<string>',
    description: '<string>',
    schema: {
      url: '<string>',
      url_template: '<string>',
      method: 'POST',
      headers: {},
      query: {},
      body: JSON.stringify('<unknown>'),
      static: {},
      auth: {
        type: 'none',
        credential_id: '<string>',
        token: '<string>',
        header: '<string>',
        query: '<string>',
        value: '<string>',
        sealed: '<string>',
        hint: '<string>'
      },
      parameters: {},
      response: {pick: '<string>', max_chars: 10050, error_message: '<string>'},
      speech: {filler: '<string>', filler_after_ms: 5000, fillers_by_lang: {}},
      timeout_ms: 8000,
      blocking: true,
      filler: '<string>',
      async: true,
      side_effect: true,
      lookup: true
    }
  })
};

fetch('https://api.kallabot.com/v1/tools', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.kallabot.com/v1/tools"

payload = {
    "name": "<string>",
    "description": "<string>",
    "schema": {
        "url": "<string>",
        "url_template": "<string>",
        "method": "POST",
        "headers": {},
        "query": {},
        "body": "<unknown>",
        "static": {},
        "auth": {
            "type": "none",
            "credential_id": "<string>",
            "token": "<string>",
            "header": "<string>",
            "query": "<string>",
            "value": "<string>",
            "sealed": "<string>",
            "hint": "<string>"
        },
        "parameters": {},
        "response": {
            "pick": "<string>",
            "max_chars": 10050,
            "error_message": "<string>"
        },
        "speech": {
            "filler": "<string>",
            "filler_after_ms": 5000,
            "fillers_by_lang": {}
        },
        "timeout_ms": 8000,
        "blocking": True,
        "filler": "<string>",
        "async": True,
        "side_effect": True,
        "lookup": True
    }
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "id": "<string>",
  "kind": "api",
  "name": "<string>",
  "description": "<string>",
  "category": "<string>",
  "tool_schema": {},
  "tags": [
    "<string>"
  ],
  "is_active": true,
  "version": 123,
  "last_tested": "<string>",
  "test_status": "<string>",
  "created_at": "<string>",
  "updated_at": "<string>",
  "credential_id": "<string>",
  "connection_status": "unknown",
  "last_error": "<string>",
  "discovery": {}
}

{
  "type": "https://docs.kallabot.com/errors/unsupported_api_version",
  "title": "Kallabot-Version names a version this API doesn't have",
  "status": 400,
  "code": "unsupported_api_version",
  "retryable": false
}

{
  "type": "https://docs.kallabot.com/errors/unauthenticated",
  "title": "Missing or invalid API key",
  "status": 401,
  "code": "unauthenticated",
  "retryable": false
}

{
  "type": "https://docs.kallabot.com/errors/insufficient_scope",
  "title": "The key lacks a required scope",
  "status": 403,
  "code": "insufficient_scope",
  "retryable": false
}

{
  "type": "https://docs.kallabot.com/errors/revision_conflict",
  "title": "Conflicts with the resource's current state",
  "status": 409,
  "code": "revision_conflict",
  "retryable": false
}

{
  "type": "https://docs.kallabot.com/errors/invalid_request",
  "title": "One or more fields are not valid",
  "status": 422,
  "code": "invalid_request",
  "retryable": false
}

{
  "type": "https://docs.kallabot.com/errors/sdk_version_unsupported",
  "title": "This SDK release is switched off: upgrade the SDK",
  "status": 426,
  "code": "sdk_version_unsupported",
  "retryable": false
}

{
  "type": "https://docs.kallabot.com/errors/precondition_required",
  "title": "A required header is missing (Idempotency-Key or If-Match)",
  "status": 428,
  "code": "precondition_required",
  "retryable": false
}

{
  "type": "https://docs.kallabot.com/errors/rate_limited",
  "title": "Too many requests",
  "status": 429,
  "code": "rate_limited",
  "retryable": true
}

{
  "type": "https://docs.kallabot.com/errors/internal_error",
  "title": "Something went wrong on our side",
  "status": 500,
  "code": "internal_error",
  "retryable": true
}