API Documentation

CegTec Website Agent API — chat, qualify leads, check availability, and book meetings.

Base URL

https://api.cegtec.net

Authentication

All API endpoints require an x-api-key header.

x-api-key: your_api_key_here

Contact info@cegtec.net to request an API key.

Machine-Readable Specs

OpenAPI 3.1 Specification — full schema definitions, request/response examples
A2A Agent Card — agent-to-agent discovery
MCP Server Discovery — Model Context Protocol configuration
llms.txt — LLM-readable site summary

Endpoints

Chat

`POST /api/v1/chat`	Send a message to the AI agent
`GET /api/v1/chat/init`	Get page-specific greeting

Knowledge

`GET /api/v1/services`	Services and offerings
`GET /api/v1/company`	Company information
`GET /api/v1/pricing`	Pricing packages
`GET /api/v1/case-studies?industry=SaaS`	Case studies (filterable)

Calendar

`GET /api/v1/availability?from=&to=`	Available meeting slots
`POST /api/v1/book`	Book a discovery meeting

Lead Qualification

POST /api/v1/qualify ICP fit scoring (0-100)

Webhooks

`POST /api/v1/webhooks`	Register webhook (events: lead.qualified, meeting.booked, conversation.ended)
`GET /api/v1/webhooks`	List webhooks
`DELETE /api/v1/webhooks/:id`	Delete webhook

Event Streaming (SSE)

GET /api/v1/events?events=lead.qualified,meeting.booked Real-time Server-Sent Events stream

Subscriptions

`POST /api/v1/subscriptions`	Register agent subscription
`GET /api/v1/subscriptions`	List subscriptions
`DELETE /api/v1/subscriptions/:id`	Cancel subscription

Workflows

`POST /api/v1/workflows`	Start multi-step workflow (template: lead-to-meeting)
`GET /api/v1/workflows/:id`	Workflow status
`PATCH /api/v1/workflows/:id/steps/:stepId`	Advance workflow step

Cross-Service Handoff

POST /api/v1/handoff Transfer context to another agent

Rate Limits

100 requests per minute per API key. Response headers:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 99
X-RateLimit-Reset: 1711234567
Retry-After: 60  (only on 429)

Error Responses

All errors return a consistent JSON structure:

{
  "error": {
    "code": "INVALID_PARAMETER",
    "message": "from and to query parameters required",
    "status": 400,
    "retryable": false
  }
}

Error codes: UNAUTHORIZED, INVALID_PARAMETER, NOT_FOUND, RATE_LIMITED, INTERNAL_ERROR

Idempotency

All POST endpoints support an Idempotency-Key header. Duplicate requests with the same key return the cached response (24h TTL).

Idempotency-Key: unique-request-id-123

MCP Protocol

For MCP-capable agents, connect via Streamable HTTP:

POST https://api.cegtec.net/mcp
x-api-key: your_api_key
Content-Type: application/json

Agent Negotiation

Query agent capabilities before connecting:

OPTIONS https://api.cegtec.net/mcp

→ { "capabilities": ["chat","qualify","calendar","knowledge","webhooks","sse","workflows"] }