v46

latestOpenAPI 3.0.0MITraw.githubusercontent.com2026-08-0311978417.1 KB
Agents

Search agents by name

Search for agent configurations by name in the workspace identified by {wId}.

get/api/v1/w/{wId}/assistant/agent_configurations/search

Path parameters

wIdstring required

ID of the workspace

Query parameters

qstring required

Search query for agent configuration names

Response

Successfully retrieved agent configurations

Example response

{
  "agentConfigurations": [
    {
      "id": 12345,
      "sId": "7f3a9c2b1e",
      "version": 2,
      "versionCreatedAt": "2023-06-15T14:30:00Z",
      "versionAuthorId": "0ec9852c2f",
      "name": "Customer Support Agent",
      "description": "An AI agent designed to handle customer support inquiries",
      "instructions": "Always greet the customer politely and try to resolve their issue efficiently.",
      "pictureUrl": "https://example.com/agent-images/support-agent.png",
      "status": "active",
      "scope": "workspace",
      "userFavorite": true,
      "model": {
        "providerId": "openai",
        "modelId": "gpt-4",
        "temperature": 0.7
      },
      "actions": [],
      "maxStepsPerRun": 10,
      "templateId": "b4e2f1a9c7"
    }
  ]
}