Skip to content
telemioDeveloper Docs
Open console
DOCUMENTATIONReference · v1 · Read-onlyBrowse integrations ↗
Docs/Developer Connect/Developer Connect API
Reference · v1 · Read-only

API v1

Read authorized workspace summaries and runtime activity through a stable, scoped interface.

AI-READY REFERENCE

Pass this guide to your agent

Short, page-specific instructions for an AI coding assistant.

Markdown ↗
Preview agent instructions 
# Telemio agent instructions — Developer Connect API v1

Build a read-only integration against https://api.telemio.sh/api/integrations/v1. Use a scoped bearer credential from a trusted server secret store. Start with GET /workspaces, then GET /workspaces/{workspaceId}/summary or /runtimes?limit=50. Preserve workspace authorization boundaries and process 401, 403, and 404 explicitly. Use the OpenAPI contract at /docs/integrations/openapi.json. Do not use an ingest credential for API reads or assume any write endpoint exists.

Reference: https://telemio.sh/docs/integrations/api.html

Base URL

Shell
https://api.telemio.sh/api/integrations/v1

Use a read-scoped MCP workspace credential created inside Telemio’s console, stored in your automation platform’s secret store. Send it as a Bearer token. The endpoint also accepts authorized Telemio user OAuth tokens. Never use an ingest credential for data reads.

Endpoints

MethodPathResult
GET/workspacesAuthorized workspaces only
GET/workspaces/{workspaceId}/summaryOne-hour telemetry summary
GET/workspaces/{workspaceId}/runtimes?limit=50Recent runtime sessions, newest first

Example: list workspaces

Shell
curl -fsS \
  -H "Authorization: Bearer $TELEMIO_READ_TOKEN" \
  https://api.telemio.sh/api/integrations/v1/workspaces

Example: summarize one workspace

Shell
curl -fsS \
  -H "Authorization: Bearer $TELEMIO_READ_TOKEN" \
  https://api.telemio.sh/api/integrations/v1/workspaces/WORKSPACE_ID/summary

The JSON envelope uses a data field, consistent with Telemio’s existing APIs. Authentication failures return HTTP 401 or 403. A workspace outside the credential’s scope returns 404. Runtime polling accepts limits from 1 to 100 and optional status filtering.

OpenAPI contract

Download the OpenAPI 3.1 specification to generate typed clients or inspect request and response schemas.

Next

Use the or to connect this API to a workflow.