agent-catalog

Create catalog entry

Create a new catalog entry from scratch. SUPER_ADMIN only.

post/v3/agent-catalog

Request

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

Request body

namestring required

Template name

descriptionstring nullable

Template description

agent_typestring

Agent type identifier

modelstring required

LLM model identifier

system_prompt_templatestring required

System prompt template

user_prompt_templatestring nullable

User prompt template

temperaturenumber nullable

LLM temperature

max_tokensinteger nullable

Maximum output tokens

reasoning_effortstring nullable

Reasoning effort level

toolsstring[]

Tool identifiers

type_configobject nullable

Type-specific configuration

is_publishedboolean

Whether the entry is visible to non-admin users

is_system_agentboolean

System agents are installed into workspaces and appear in the Chat agent picker

Response

Successful Response

idstring required
namestring required
descriptionstring nullable required
agent_typestring required
modelstring required
system_prompt_templatestring required
user_prompt_templatestring nullable required
temperaturenumber nullable required
max_tokensinteger nullable required
reasoning_effortstring nullable required
toolsstring[] required
type_configobject nullable required
is_publishedboolean required
is_system_agentboolean

True when the entry is a system agent installed into workspaces for Chat.

created_by_user_idstring required
source_agent_idstring nullable required
source_organization_idstring nullable required
created_atstring date-time required
updated_atstring date-time required
has_draftboolean

True when the entry has unpublished draft changes.

draftobject nullable

Staged draft changes parsed from the draft row's YAML.

Changes

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