Agents API

The Agents API lets you discover Glean agents, inspect their input and output schemas, and execute agent runs. Use it to embed Glean's agentic capabilities directly into your own applications and workflows.

Use Cases

Agent Discovery

Search for agents available to the authenticated user and retrieve their configuration to decide which agent to invoke.

Schema Inspection

Fetch an agent’s input and output schemas so you can build type-safe integrations and validate payloads before invoking a run.

Agent Execution

Create agent runs to execute Glean agents programmatically and incorporate their results into downstream automation.

API Endpoints

Method	Endpoint	Purpose
POST	/api/agents/search	Search agents
GET	/api/agents/{agent_id}	Get agent
GET	/api/agents/{agent_id}/schemas	Get agent schemas
POST	/api/agents/{agent_id}/runs	Create agent run

For error responses, see Platform API Errors for the shared ProblemDetail code reference and remediation guidance.