List agents

GET/agent/list

Retrieves a list of PhenoAgents belonging to the authenticated user

RequiresBearerauthentication

Query parameters

tagsstringoptional

Filter by tags

Returns

Agents retrieved successfully

Response fields

successbooleanoptional

messagestringoptional

agentsobject[]optional

idstringoptional

Agent ID

namestringoptional

Agent name

descriptionstringoptional

Agent description

promptsstring[]optional

Array of prompt IDs used by this agent

toolsstring[]optional

Array of MCP server tool IDs used by this agent

workflowsstring[]optional

Array of workflow IDs exposed as tools by this agent

tagsstring[]optional

Tags for categorizing the agent

provideroneOfoptional

FHIR provider ID(s) - must be valid UUIDs from existing FHIR providers

GETRequest

# Get authentication token
PHENOML_TOKEN=$(curl -X POST "https://experiment.app.pheno.ml/v2/auth/token" \
  -u "$PHENOML_CLIENT_ID:$PHENOML_CLIENT_SECRET" \
  | jq -r '.access_token')

curl -X GET "https://experiment.app.pheno.ml/agent/list" \
  -H "Authorization: Bearer $PHENOML_TOKEN"

200 OKExample Response

{
  "success": true,
  "message": "Agents retrieved successfully",
  "agents": [
    {
      "id": "agent_123",
      "name": "Medical Assistant",
      "description": "An AI assistant for medical information processing",
      "prompts": [
        "prompt_123"
      ],
      "tags": [
        "medical",
        "fhir"
      ],
      "provider": [
        "7002b0b4-8d09-445a-bf65-0fafdaf26c35"
      ]
    },
    {
      "id": "agent_456",
      "name": "Clinical Coding Assistant",
      "description": "Helps with ICD-10 and SNOMED coding",
      "prompts": [
        "prompt_456"
      ],
      "tags": [
        "coding"
      ],
      "provider": [
        "7002b0b4-8d09-445a-bf65-0fafdaf26c35"
      ]
    }
  ]
}