Getting Started

API Keys

Generate workspace-scoped API keys.

API keys are available on Pro. Trial workspaces can create one read-only key for evaluation.

API Reference

Full OpenAPI spec with curl, JavaScript, and Python samples.

Quickstart

Get your first API response in under a minute.

Authentication guide

Quickstart Guide

1. Get your API key

Go to Settings > Integrations in your workspace. Pro workspaces can create API keys with full scopes. Trial workspaces can create one read-only key for evaluation.

2. Make your first request

Try the health endpoint (no auth needed) or list your SKUs with your API key:

Check service health (no auth):

curl https://telden.eu/api/health

List your workspace SKUs with your API key:

curl https://telden.eu/api/skus \
  -H "Authorization: Bearer YOUR_API_KEY"

3. Configure an AI agent

Connect Telden as an MCP server for Claude Desktop, Cursor, or any MCP-compatible agent:

MCP server config (claude_desktop_config.json / .cursor/mcp.json)

{
  "mcpServers": {
    "telden": {
      "url": "https://telden.eu/api/mcp",
      "headers": {
        "Authorization": "Bearer ${TELDEN_ACCESS_TOKEN}"
      }
    }
  }
}

Your API key is workspace-scoped. Use the Bearer token in the Authorization header for all authenticated endpoints. Your workspace ID is shown at the top of the Settings page under Workspace.

Product Resources

Extraction Benchmark

Real-document AI extraction performance: dataset, methodology, results, and honest limitations.

MCP Server

Model Context Protocol reference: endpoint, authentication, scopes, tools, and client configuration.

FAQ

Preguntas frecuentes sobre Telden Product Service Desk, precios y cumplimiento UE.

Centro de ayuda

Guías de usuario y recursos prácticos para comenzar con Telden.

Available Endpoints

GET/api/healthHealth check

GET/api/skusList all SKUs

POST/api/skusCreate a SKU

GET/api/skus/{id}Get a SKU

DELETE/api/skus/{id}Delete a SKU

GET/api/skus/{id}/documentsList documents linked to a SKU

GET/api/skus/{id}/exportExport enriched SKU data (CSV or JSON)

POST/api/importUpload CSV/TSV/spreadsheet import

GET/api/importsList import batches

GET/api/imports/{batchId}Get one import batch status

POST/api/mcpMCP-style agent read model

Full spec at /docs/api