agents

Create Agent

Create new agent. Supports both IDs and identifiers for traits, knowledge sources, and tools. Auto-generates identifier from name if not provided.

post/api/v1/agents

Request

  • Base URL: https://api.gnosari.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.gnosari.com/api/v1/agents
  • Auth: one of:
    • HTTP bearer
    • API key in header X-AUTH-TOKEN

Request body

namestring required
descriptionstring nullable
instructionsstring nullable
identifierstring nullable
image_urlstring nullable
configurationobject nullable
modelstring nullable
temperaturenumber
reasoning_effortstring
orchestratorboolean
memorystring nullable
interactive_buttons_enabledboolean
interactive_buttons_behaviorstring nullable

Optional guidance on WHEN the agent should render interactive choice buttons. NULL uses the canonical default behavior.

access_level'PRIVATE' | 'PASSWORD_PROTECTED' | 'PUBLIC'
access_passwordstring nullable
chat_theme_idinteger nullable
uristring nullable

URL-friendly identifier for public access (e.g., 'my-assistant')

domain_idinteger nullable

Domain where the agent will be published

knowledge_idsinteger[] nullable
entity_type_idsinteger[] nullable

Response

Successful Response

Agent required

Changes

No recorded changes to this operation across all 1 revision of this API.