---
title: "Generate tool inputs from natural language"
method: POST
path: "/api/v3.1/tools/execute/{tool_slug}/input"
tags: ["Tools", "AI", "Natural Language Processing"]
---

# Generate tool inputs from natural language

`POST /api/v3.1/tools/execute/{tool_slug}/input`

Uses AI to translate a natural language description into structured arguments for a specific tool. This endpoint is useful when you want to let users describe what they want to do in plain language instead of providing structured parameters.

## Path parameters

- `tool_slug` string, required

## Request body

- object
  - `text` string, required — Natural language description of what you want to accomplish with this tool
  - `custom_description` string — Custom description of the tool to help guide the LLM in generating more accurate inputs
  - `system_prompt` string — System prompt to control and guide the behavior of the LLM when generating inputs
  - `version` string — Tool version to use when generating inputs (defaults to "latest" if not specified)

## Response `200`

Successfully generated structured inputs for the action based on natural language description

- object
  - `arguments` object — Key-value pairs of arguments required by the tool to accomplish the described task
  - `error` string — Error message if the arguments could not be generated (null if successful)

## Other responses

- `400` — Bad request - Invalid input parameters or insufficient description to generate tool arguments
- `401` — Unauthorized - Authentication credentials are missing or invalid
- `404` — Not found - The specified tool does not exist
- `422` — Unprocessable entity - Invalid state of the connected account
- `429` — Too many requests - Rate limit exceeded for natural language processing
- `500` — Internal server error - AI processing failed or other server error occurred

---

[API](https://skmtc.net/composiohq/apis/composio-platform-api-v3-1.md) · [All operations](https://skmtc.net/composiohq/apis/composio-platform-api-v3-1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/composiohq/composio-platform-api-v3-1/revisions/4239836857f8/schema)