Agent ExplorerBeta

REST Endpoints

Agent Explorer exposes a REST API for programmatic access to all features.

Request/response logs showing API interactions

Authentication

All API endpoints require a valid Clerk session cookie (browser) or a Clerk session token (server-to-server). Unauthenticated requests return 401.

Projects

MethodPathDescription
GET/api/projectsList projects (query: ?teamId=, ?personal=true)
POST/api/projectsCreate a project
GET/api/projects/:idGet project details
PUT/api/projects/:idUpdate project
DELETE/api/projects/:idDelete project and all data
GET/api/projects/:id/oauth/configGet OAuth config
PUT/api/projects/:id/oauth/configSave OAuth config
POST/api/projects/:id/oauth/revokeRevoke OAuth tokens

Create Project

POST /api/projects
Content-Type: application/json

{
  "name": "My Agent",
  "agentcardUrl": "https://agent.example.com"
}

Conversations

MethodPathDescription
GET/api/conversationsList conversations
POST/api/conversationsCreate conversation
GET/api/conversations/:idGet conversation
PUT/api/conversations/:idUpdate conversation
DELETE/api/conversations/:idDelete conversation
GET/api/conversations/:id/messagesList messages
PUT/api/conversations/:id/messagesAdd message

Mock Agents

MethodPathDescription
GET/api/mock-agentsList mock agents
POST/api/mock-agentsCreate mock agent
GET/api/mock-agents/:idGet mock agent
PUT/api/mock-agents/:idUpdate mock agent
DELETE/api/mock-agents/:idDelete mock agent
POST/api/mock-agents/:id/a2aSend A2A message to mock
GET/api/mock-agents/:id/.well-known/agent-card.jsonGet mock agent's AgentCard
GET/api/mock-agents/:id/webhooks/subscriptionsList active webhook subscriptions
DELETE/api/mock-agents/:id/webhooks/subscriptions?subscriptionId=:sidDelete a webhook subscription
GET/api/mock-agents/:id/webhooks/deliveriesList webhook delivery logs
GET/api/mock-agents/api-keysList API keys
POST/api/mock-agents/api-keysCreate API key
DELETE/api/mock-agents/api-keys/:idDelete API key

AgentCard

GET /api/agentcard?url=https://agent.example.com

Fetches and validates the AgentCard from the given base URL.

Templates

MethodPathDescription
GET/api/templatesList payload templates
POST/api/templatesCreate template

Teams

MethodPathDescription
GET/api/teamsList teams
POST/api/teamsCreate team
GET/api/teams/:idGet team
PUT/api/teams/:idUpdate team
DELETE/api/teams/:idDelete team
GET/api/teams/:id/membersList members
POST/api/teams/:id/membersAdd member
DELETE/api/teams/:id/membersRemove member

Settings

MethodPathDescription
GET/api/settings/llmList LLM configs
POST/api/settings/llmCreate LLM config
PUT/api/settings/llm/:idUpdate LLM config
DELETE/api/settings/llm/:idDelete LLM config

OAuth

MethodPathDescription
POST/api/oauth/authorizeInitiate OAuth flow
POST/api/oauth/callbackOAuth callback handler

Error Responses

All endpoints return errors in a consistent format:

{
  "error": "Project not found"
}

HTTP status codes: 400 Bad Request, 401 Unauthorized, 403 Forbidden, 404 Not Found, 500 Internal Error