v3
automation-tools

Create a shared automation tool

post/v3/automation-tools

Request

  • Base URL
    https://api.mentium.io (the document declares no server; this is the origin it was published from)
  • Auth
    HTTP bearer

Headers

mentium-workspace-idstring nullable

Request body

namestring required

Human-readable display name

function_namestring nullable

LLM function identifier. Auto-generated from name if omitted.

descriptionstring nullable

Human-readable description of what this tool does

http_method'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' required
http_urlstring required

Target URL (may contain {{template}} vars)

auth_type'NONE' | 'API_KEY' | 'BEARER_TOKEN' | 'BASIC_AUTH'
auth_secretobject nullable

Auth credentials to store in Vault. For API_KEY: {header_name, api_key}. For BEARER_TOKEN: {token}. For BASIC_AUTH: {username, password}.

headersobject nullable

Static HTTP headers

query_paramsobject nullable

Static query parameters

body_templateobject nullable

JSON body template

timeout_secondsinteger

Request timeout in seconds

input_schemaobject nullable

JSON Schema describing parameters the LLM can supply at call-time

Response

Successful Response

idstring required
namestring required
function_namestring
descriptionstring nullable required
tool_typestring
http_methodstring nullable
http_urlstring nullable
auth_type'NONE' | 'API_KEY' | 'BEARER_TOKEN' | 'BASIC_AUTH'
has_secretboolean

Whether vault-backed auth credentials are configured

headersobject nullable
query_paramsobject nullable
body_templateobject nullable
timeout_secondsinteger
input_schemaobject nullable
created_atstring date-time required
updated_atstring date-time required

Changes

No recorded changes to this operation across all 2 revisions of this API.