List safe runtime agent metadata

GET

https://cessy.ai/api/rest/tenant-id/app-id/agents

Lists agents from the selected app runtime source using a strict public metadata allowlist. A Workspace catalog can include agents that are not published yet; user-delegated DM creation still resolves agentId against the published app configuration. Prompts, credentials, provider settings, MCP assignments, and container configuration are never returned.

Authentication

AuthorizationBearer

Runtime bearer accepted by the normal app-scoped pipeline: an API key or OAuth/JWT with the ‘runtime’ scope, or an app-scoped agent service token. Individual operations may require a narrower principal type.

Query parameters

workspaceIdstringOptionalformat: "^ws_[A-Za-z0-9_-]+$"

Optional Workspace runtime selector for preview or validation calls. If supplied with X-CES-Workspace-ID, both values must match.

Response

Safe app agent catalog

agentslist of objects

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

1	const url = 'https://cessy.ai/api/rest/tenant-id/app-id/agents';
2	const options = {
3	method: 'GET',
4	headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
5	body: '{}'
6	};
7
8	try {
9	const response = await fetch(url, options);
10	const data = await response.json();
11	console.log(data);
12	} catch (error) {
13	console.error(error);
14	}

1	{
2	"agents": [
3	{
4	"id": "agent_9f8b7c6d5e4a3b2c1d0e",
5	"name": "customer_support_bot",
6	"label": "Customer Support Bot",
7	"kind": "standard"
8	}
9	]
10	}

Authentication

Headers

Query parameters

Response

Errors