Create agent custom tool

Create a new user-defined agent tool. Pass draft=true to generate a tool definition from a natural-language description without persisting it.

post/api/v0/agent/tools

Request

Base URL
https://api.outerport.com (the document declares no server; this is the origin it was published from)
Auth
HTTP bearer
TypeScript
https://skmtc.dev/outerport/apis/outerport-api/docs/api/v0/agent/tools/post.ts
A function with typed inputs. Its response is checked against the schema.

draftboolean

When true, generate a tool definition without saving.

tool_type'python' | 'prompt' | 'api'

Tool type: python, prompt, api.

namestring nullable

The tool name (snake_case). Required when draft=false.

descriptionstring

The tool description.

parametersobject[] nullable

Parameter definitions [{name, type, description, required}].

codestring

Code/prompt/config body.

Successful Response

Sep 25, 2026fcd15f6d35b4 Revision changes
- info
  added to the response body anyOf list for the response status
- info
  removed from the response body anyOf list for the response status