> ## Documentation Index
> Fetch the complete documentation index at: https://docs.glider.fi/llms.txt
> Use this file to discover all available pages before exploring further.

# tRPC v2 Agents API

> Feature-gated parent-agent read and draft APIs for the staged multi-leg agent rollout

The `v2.agents.*` namespace is the canonical staged surface for parent-agent
summary, detail, lifecycle, and draft bootstrap flows.

* Base endpoint: `POST /v1/trpc`
* Namespace: `v2.agents.*`
* Auth: wallet session or API key
* Rollout: gated behind the `multi_leg_agents_v1` feature flag

## Enabled Procedure Groups

* `v2.agents.list`
* `v2.agents.get`
* `v2.agents.pause`
* `v2.agents.resume`
* `v2.agents.archive`
* `v2.agents.drafts.commit`
* `v2.agents.drafts.startFromAgent`

## Rollout Notes

* The entire route is exposed only when `multi_leg_agents_v1=true` for the
  caller.
* `authored_agent_sdk` does not expose the route by itself. It only enables
  authored draft behavior within the already-enabled parent-agent surface.
* With both flags off by default, this API lands dark.

## Current Scope

The surface is intentionally focused on parent-agent handling:

1. list parent agents
2. inspect parent-agent detail
3. pause, resume, or archive an existing parent agent
4. start an edit draft from an existing agent
5. commit a ready draft back through the agent-aware service layer

There is still no standalone public `create` entrypoint in this namespace.
Initial authoring continues to flow through the staged `v2.workflows.*` draft
surface until later rollout slices unify the product entrypoints.