Skip to main content
POST
/
search
Search
curl --request POST \
  --url https://api.trymaitai.ai/api/v1/search \
  --header 'Content-Type: application/json' \
  --header 'X-Maitai-Api-Key: <api-key>' \
  --data '
{
  "query": "how do I import an OpenAI agent",
  "limit": 3
}
'
{
  "data": {
    "results": [
      {
        "use_case": "Import a code-defined OpenAI Agents SDK agent into Maitai.",
        "difficulty": "easy",
        "execution_guidance": "Authenticate the CLI, then run the framework-aware import against the user's Python module.",
        "recommended_plan_steps": [
          {
            "index": 1,
            "kind": "Required",
            "phase": "Prerequisite",
            "command": "maitai login --api-key $MAITAI_API_KEY",
            "description": "Authenticate the CLI against the Maitai Platform."
          },
          {
            "index": 2,
            "kind": "Required",
            "phase": "Step",
            "command": "maitai agents import ./agents.py --framework openai-agents --application-name <name>",
            "description": "Run the framework-aware import against the user's Python module."
          },
          {
            "index": 3,
            "kind": "Optional",
            "phase": "Next Step",
            "command": "maitai agents export <agent_id>",
            "description": "Export the imported agent to round-trip the manifest."
          }
        ],
        "guardrails": [
          "[importAgents] Pass `on_conflict='update'` when re-running against the same application so existing agents are merged in place.",
          "[importAgents] Set `execution_mode: 'reasoning'` for OpenAI Agents SDK imports so the runtime uses reasoning-style orchestration."
        ],
        "primary_tool_slugs": [
          "importAgents"
        ],
        "related_tool_slugs": [
          "listAgents",
          "createAgent",
          "createAgentAction"
        ]
      }
    ],
    "catalog_size": 339
  }
}

Authorizations

X-Maitai-Api-Key
string
header
required

Your Maitai API key from the Portal.

Body

application/json
query
string
required

Free-form natural-language query (e.g. 'how do I import an OpenAI agent').

limit
integer

Maximum number of result interpretations to return (1-10, default 5).

Response

200 - application/json

Search.

data
any