Skip to main content
OrgX memory includes decisions, artifacts, initiative context, project history, and learned operating patterns. AI clients should use MCP memory tools by default. REST clients can call the governed tool execution endpoint for approved memory operations.

​
Execute a Memory Tool

POST /api/client/tools/execute

curl https://useorgx.com/api/client/tools/execute \
  -X POST \
  -H "Authorization: Bearer $ORGX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tool_id": "orgx_search",
    "args": {
      "query": "deployment decisions",
      "limit": 5
    }
  }'

​
Available Tool IDs

ToolDescription
orgx_searchSearch organizational memory and project context.
orgx_recommendReturn a context-aware next action recommendation.
Tool IDs may also be sent with the chatgpt. prefix. The API normalizes chatgpt.orgx_search to orgx_search.

​
Request Fields

FieldTypeRequiredDescription
tool_idstringYesAllowed tool ID.
argsobjectNoTool-specific arguments.
project_idstringNoOptional project scope.
initiative_idstringNoOptional initiative scope.
run_idstringNoOptional run scope.

​
Response

{
  "ok": true,
  "data": {
    "results": []
  },
  "tool_id": "orgx_search",
  "execution_time_ms": 42
}

​
Errors

StatusMeaning
400Missing tool_id or invalid JSON.
401API key authentication failed.
403Tool is not available through the client REST API.

​
MCP Equivalent

For AI clients, use:
  • orgx_search
  • orgx_search
  • orgx_recommend