Getting Started

API Keys

Generate workspace-scoped API keys for programmatic access.

API keys are available on Growth and Pro plans. Early-access workspaces get one read-only key for evaluation. Pro unlocks full scope access including write, export, and import.

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. Early-access 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

Frequently asked questions about Telden Product Service Desk, pricing, and EU compliance.

Help Center

User guides and practical resources for getting started with Telden.

Available Endpoints

26 stable and 15 preview operations from the public OpenAPI contract.

Stable endpoints

GET/api/healthPublic liveness probe. No authentication required.

GET/api/health/emailStaff-only email readiness probe (Brevo SMTP). Requires staff authentication.

GET/api/skusList SKUs for the current workspace.

POST/api/skusCreate a SKU in the current workspace. Supports dry_run and Idempotency-Key.

GET/api/skus/{id}Get a SKU with agent-readable blocker and capability flags.

DELETE/api/skus/{id}Delete a SKU and related records in the current workspace.

GET/api/skus/{id}/documentsList documents linked to a SKU (legacy sku_id column and document_sku join).

GET/api/skus/{id}/dossier.zipDownload one SKU dossier PDF together with all attached documents as a ZIP archive.

GET/api/skus/{id}/exportExport one SKU as JSON or CSV. Bearer auth requires the `export` scope (paid/enterprise plans).

POST/api/skus/{id}/fields/{fieldId}/sync-from-entityCopy the current confirmed linked entity value into a dossier field. Supports dry_run and Idempotency-Key.

POST/api/skus/{id}/review/completeMark a SKU review as complete after all issues and extraction conflicts are resolved.

GET/api/importsList recent import batches for the current workspace.

GET/api/imports/{batchId}Get one import batch summary.

POST/api/importUpload and process a CSV, TSV, XLSX, XLS, or ODS SKU import.

GET/api/workspace/api-keysList active workspace API keys.

POST/api/workspace/api-keysCreate a workspace API key.

DELETE/api/workspace/api-keys/{id}Revoke a workspace API key.

POST/api/workspace/api-keys/{id}Rotate a workspace API key (revoke old key and create a new one).

GET/api/v1/skusList workspace SKUs via Bearer-token auth. Requires API key with skus:read scope.

POST/api/skus/{id}/ai-fillTrigger AI fill for a SKU's missing dossier fields. Creates a background job and returns immediately. AI suggestions require human review and are never auto-approved for compliance output.

GET/api/skus/{id}/ai-fill/jobPoll the latest AI-fill job status for a SKU.

POST/api/skus/{id}/ai-fill/cancelCancel a running AI-fill job (pending or processing).

POST/api/supplier-email/draftGenerate a supplier outreach email draft for missing compliance documents.

POST/api/supplier-email/sendSend a supplier outreach email via workspace SMTP.

GET/api/supplier-email/requestsList sent supplier email requests for a SKU.

PATCH/api/supplier-email/requests/{id}Update supplier email request status.

Preview endpoints

Preview routes are documented in OpenAPI but are not yet a compatibility promise.

GET/api/mcpMCP server info and health check (WebStandardStreamableHTTP transport).

POST/api/mcpCall the read-only Telden MCP server.

POST/api/classifyClassify a file as product CSV, compliance document, or other.

POST/api/classify/containersExpand supported containers (.zip, .eml, RFC 2822 .msg) and classify each extracted part. Nested .zip/.eml recurse up to recursion_limit (3); encrypted archives, opaque .p7m, and Outlook compound .msg return skipped diagnostics.

POST/api/documents/bulkUpload up to 20 compliance documents in one multipart batch.

POST/api/upload/orchestrateRecord upload orchestration audit events for classified files.

GET/api/imports/{batchId}/reviewGet post-import batch review workbench payload for imported SKUs, suggestions, and provenance.

POST/api/imports/{batchId}/entity-resolutionValidate and persist linked-entity resolution decisions for an import batch.

POST/api/import/from-urlPreview a product import from a public shop or catalog URL.

POST/api/v1/skus/{id}/re-extractTrigger re-extraction of a SKU's linked documents via Bearer-token auth. Requires API key with extractions:write scope.

POST/api/v1/documents/{id}/re-extractTrigger re-extraction of a document via Bearer-token auth. Requires API key with extractions:write scope.

POST/api/research/productResearch missing product data from public sources and return cited suggestions only.

GET/api/exportsList past export runs for the current workspace.

POST/api/exportsTrigger a new export run with a chosen template and scope.

GET/api/exports/templatesList available export templates for the current workspace.

Full specification at /docs/api · /api/openapi.json