---
title: "Execute Tool"
method: POST
path: "/internal/tools/{tool_name}/execute"
tags: ["internal"]
---

# Execute Tool

`POST /internal/tools/{tool_name}/execute`

Execute a tool against the resolved, already-authorized target company.

The company comes from the request (``Nanocorp-Company`` header for a user
principal, or the key's own company for a company principal), not from the
credential — see ``resolve_target_company_id``.

## Path parameters

- `tool_name` string, required

## Headers

- `Nanocorp-Company` string, nullable

## Request body

- ExecuteToolRequest
  - `arguments` object, required

## Response `200`

Successful Response

- ExecuteToolResponse
  - `success` boolean, required
  - `result` object, nullable
  - `error` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/nanocorp/apis/nanocorp-api.md) · [All operations](https://skmtc.dev/nanocorp/apis/nanocorp-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nanocorp/nanocorp-api/revisions/04b208d3215b/schema)