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.