Agents

Read the published agent's public information with an API key, without opening a session.

GET /v1/agents/agt_01J8ACME00001
Authorization: Bearer kl_pub_dev_…       (or a secret key)

200:

{ "agent": { "id": "agt_01J8ACME00001", "versionId": "agv_…", "name": "Acme Assistant",
             "greeting": "Hi! I'm Acme's assistant…", "allowedComponents": ["text", "card", "acme.productCard"] } }

The version is the one active in the key’s environment; in development the draft is returned when nothing is published. 404 when the agent does not exist or nothing can be served. Useful for pre-rendering the greeting or checking that a build’s key points at the expected environment.

Configuration (persona, tools, versions) is managed in the dashboard; there is no public write API for it in this release.

Last updated 2026-09-28 · Report an issue with this page