Skip to main content
POST
Create OpenAPI Tool

Endpoint

POST /v3/tools/

Description

Creates a new tool using an OpenAPI schema with custom configurations.

Authentication

API Key (x-api-key) in the header.

Request Parameters

Request Example

Curl Request

Response

Returns tool IDs for the created tools.

Authorizations

x-api-key
string
header
required

Body

application/json
tool_set_name
string

Name for the tool set (prefixed with openapi-).

openapi_schema
object

OpenAPI schema for tool definition.

default_headers
object

Optional default headers for requests.

default_query_params
object

Optional default query parameters.

default_body_params
object

Optional default body parameters.

endpoint_defaults
object

Optional endpoint-specific default parameters.

enhance_descriptions
boolean

Whether to enhance descriptions using OpenAI.

openai_api_key
string | null

OpenAI API key (if enhancement is enabled).

Response

Tools created successfully

tool_ids
string[]