Reference — developers

REST API

Namespace: mindfulagent/v1
Base: /wp-json/mindfulagent/v1/

Chat & conversations

Method	Route	Purpose
GET	/conversations	List conversations
POST	/conversations	Create
GET	/conversations/{id}	Detail + messages
POST	/conversations/{id}/messages	Add messages (where exposed)
POST	/chat	Non-stream chat
POST	/chat/stream	SSE streaming
GET	/models	Model list

Agents & knowledge

Method	Route	Purpose
GET/POST	/agents	List / create
GET	/agents/{id}	Detail
POST	/agents/{id}/knowledge/text	Add text
POST	/agents/{id}/knowledge/url	Add URL
POST	/agents/{id}/knowledge/file	Upload file
Additional	/knowledge/...	Manage chunks, reprocess

Teams

Method	Route	Purpose
GET	/teams/my	Current user’s teams
POST	/teams	Create team
POST	/teams/{id}/members	Add member

Settings

Method	Route	Purpose
GET/POST	/settings/api-keys	Key management
GET	/settings/brand-voice	Brand voices

Additional routes exist for exports, scanning, OAuth, sessions—inspect includes/api/*.php in the repo for the full surface.

Hooks & filters

Hook	When
mindfulagent_before_chat	Before chat request
mindfulagent_after_chat	After response
mindfulagent_agent_created	New agent
Filter mindfulagent_system_prompt	Adjust system prompt
Filter mindfulagent_available_models	Restrict models
Filter mindfulagent_max_tokens	Token limits

SSE / reverse proxies

Long streams may require nginx proxy_read_timeout, Apache ProxyTimeout, or CDN settings—see README “Long chat streams” section.

Database

Tables use prefix ma_ (see Activator).