# List an agent's published endpoints

Source: https://docs.vlayers.ai/reference/hosting/list-agent-endpoints

`GET /v1/agents/{id}/endpoints` · scope `workspace:read`

Shows the endpoints a hosted agent publishes at `run.vlayers.ai`: the URL callers use for each kind (`api`, `hook`, `mcp`), who may call it (anyone, an endpoint key, a signature, or OAuth), the version answering now and the one waiting for a ready room, the limits in force, the endpoint keys (never their secrets), the monthly spend cap and what the endpoint has spent this month. A public endpoint can be called by anyone, and its traffic is billed to your workspace.

Requires an API key with the `workspace:read` scope.

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `id` | path | string | yes | The agent id. Example: `"0192f5c2-6f7a-7b9c-8d1e-2f3a4b5c6d78"` |

## Request

cURL:

```bash
curl "https://api.vlayers.ai/v1/agents/$AGENT_ID/endpoints" \
  -H "Authorization: Bearer $VOICELAYER_API_KEY"
```

TypeScript:

```ts
import { VoiceLayer } from '@voicelayer/api';

const voicelayer = new VoiceLayer();

const { endpoints } = await voicelayer.hosting.listAgentEndpoints('<agent-id>');
console.log(endpoints);
```

Python:

```python
from voicelayer import VoiceLayer

vl = VoiceLayer()

result = vl.hosting.list_agent_endpoints("<agent-id>")
print(result.endpoints)
```

## Response `200`

```json
{
  "endpoints": [
    {
      "id": "x7k2p4q9m3vd",
      "agentId": "0192f5c2-6f7a-7b9c-8d1e-2f3a4b5c6d78",
      "environment": "prd",
      "enabled": true,
      "disabled": null,
      "monthlySpendCapUsd": null,
      "spentThisMonthUsd": 0.42,
      "routes": [
        {
          "kind": "api",
          "url": "https://run.vlayers.ai/x7k2p4q9m3vd/api",
          "auth": "key",
          "servingVersion": 3,
          "pendingVersion": null,
          "settings": {},
          "limits": {
            "maxRequestBytes": 10485760,
            "maxResponseBytes": 67108864,
            "timeoutMs": 30000,
            "requestsPerSecond": 50,
            "concurrentStreams": 50,
            "streamIdleMs": 300000
          }
        }
      ],
      "keys": [
        {
          "id": "0192f5c1-5e6f-7a8b-9c0d-1e2f3a4b5c67",
          "kind": "api",
          "name": "Partner integration",
          "preview": "vle_AbCd…wXyZ",
          "createdAt": "2026-10-20T15:04:05.000Z",
          "expiresAt": null,
          "lastUsedAt": null,
          "revokedAt": null
        }
      ]
    }
  ]
}
```
