Skip to main content
Creates a tool and declares its first version. A tool only recorded from calls under the same name is adopted; one already declared returns 409. Give it a runtime for a hosted agent to call your endpoint. Header values are returned on read, so keep secrets out of them.
Calls POST /v1/tool

​
Options

​
string
required
​
string
required
When the agent should use the tool.
​
string
​
array
​
string
​
string
​
object
Omit or null for a tool that is only graded.
​
object
required
​
switch
​
array
Repeatable.
​
object

​
Example

Every command also takes the global options and sets one of the exit codes.