{"openapi":"3.1.0","info":{"title":"Aleph Engineering Website","description":"Aleph Engineering's public marketing website has no authenticated, transactional API — this document describes its public, read-only content pages so agents and crawlers can discover the site's structure. Every listed path also serves a text/markdown representation of the same content when requested with an Accept: text/markdown header. See /developers/ for the human-readable version of this reference, and info.x-api-lifecycle below for the versioning and deprecation policy.","version":"1.0.0","contact":{"name":"Aleph Engineering","email":"contact@aleph.engineering","url":"https://v2.aleph.engineering"},"x-api-lifecycle":{"versioning":"URL path versioning. This document is published at both /openapi.json (always the latest shape) and /v1/openapi.json (a stable alias that keeps serving the v1 shape). A future breaking change to this document ships as /v2/openapi.json; /v1/openapi.json keeps serving the v1 shape unchanged until it is sunset.","deprecation":"A deprecated version is announced at least 90 days before removal via the Deprecation and Sunset HTTP response headers on its endpoints, and is noted in this policy.","current_version":"v1","deprecated_versions":[]}},"servers":[{"url":"https://v2.aleph.engineering","description":"Latest"},{"url":"https://v2.aleph.engineering/v1","description":"Stable v1 alias (currently identical to latest; see info.x-api-lifecycle)"}],"paths":{"/":{"get":{"summary":"Aleph Engineering | AI-native modernization","operationId":"get-home","description":"Returns the Aleph Engineering | AI-native modernization page. Supports content negotiation: send Accept: text/markdown for a markdown representation of the same content.","responses":{"200":{"description":"Page content, negotiated by the Accept header.","content":{"text/html":{"schema":{"type":"string"},"examples":{"default":{"summary":"Rendered page"}}},"text/markdown":{"schema":{"type":"string"},"examples":{"default":{"summary":"Same content as markdown, served when Accept: text/markdown is sent"}}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/services/":{"get":{"summary":"Services","operationId":"get-services","description":"Returns the Services page. Supports content negotiation: send Accept: text/markdown for a markdown representation of the same content.","responses":{"200":{"description":"Page content, negotiated by the Accept header.","content":{"text/html":{"schema":{"type":"string"},"examples":{"default":{"summary":"Rendered page"}}},"text/markdown":{"schema":{"type":"string"},"examples":{"default":{"summary":"Same content as markdown, served when Accept: text/markdown is sent"}}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/about-us/":{"get":{"summary":"About us","operationId":"get-about","description":"Returns the About us page. Supports content negotiation: send Accept: text/markdown for a markdown representation of the same content.","responses":{"200":{"description":"Page content, negotiated by the Accept header.","content":{"text/html":{"schema":{"type":"string"},"examples":{"default":{"summary":"Rendered page"}}},"text/markdown":{"schema":{"type":"string"},"examples":{"default":{"summary":"Same content as markdown, served when Accept: text/markdown is sent"}}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/projects/":{"get":{"summary":"Projects","operationId":"get-projects","description":"Returns the Projects page. Supports content negotiation: send Accept: text/markdown for a markdown representation of the same content.","responses":{"200":{"description":"Page content, negotiated by the Accept header.","content":{"text/html":{"schema":{"type":"string"},"examples":{"default":{"summary":"Rendered page"}}},"text/markdown":{"schema":{"type":"string"},"examples":{"default":{"summary":"Same content as markdown, served when Accept: text/markdown is sent"}}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/faqs/":{"get":{"summary":"FAQ","operationId":"get-faqs","description":"Returns the FAQ page. Supports content negotiation: send Accept: text/markdown for a markdown representation of the same content.","responses":{"200":{"description":"Page content, negotiated by the Accept header.","content":{"text/html":{"schema":{"type":"string"},"examples":{"default":{"summary":"Rendered page"}}},"text/markdown":{"schema":{"type":"string"},"examples":{"default":{"summary":"Same content as markdown, served when Accept: text/markdown is sent"}}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/alldone-gmbh/":{"get":{"summary":"Alldone GmbH","operationId":"get-alldone","description":"Returns the Alldone GmbH page. Supports content negotiation: send Accept: text/markdown for a markdown representation of the same content.","responses":{"200":{"description":"Page content, negotiated by the Accept header.","content":{"text/html":{"schema":{"type":"string"},"examples":{"default":{"summary":"Rendered page"}}},"text/markdown":{"schema":{"type":"string"},"examples":{"default":{"summary":"Same content as markdown, served when Accept: text/markdown is sent"}}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/wassermeloni-gmbh/":{"get":{"summary":"Wassermeloni GmbH","operationId":"get-wassermeloni","description":"Returns the Wassermeloni GmbH page. Supports content negotiation: send Accept: text/markdown for a markdown representation of the same content.","responses":{"200":{"description":"Page content, negotiated by the Accept header.","content":{"text/html":{"schema":{"type":"string"},"examples":{"default":{"summary":"Rendered page"}}},"text/markdown":{"schema":{"type":"string"},"examples":{"default":{"summary":"Same content as markdown, served when Accept: text/markdown is sent"}}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/clever-elements-gmbh/":{"get":{"summary":"Clever Elements GmbH","operationId":"get-clever-elements","description":"Returns the Clever Elements GmbH page. Supports content negotiation: send Accept: text/markdown for a markdown representation of the same content.","responses":{"200":{"description":"Page content, negotiated by the Accept header.","content":{"text/html":{"schema":{"type":"string"},"examples":{"default":{"summary":"Rendered page"}}},"text/markdown":{"schema":{"type":"string"},"examples":{"default":{"summary":"Same content as markdown, served when Accept: text/markdown is sent"}}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/toygardens-media/":{"get":{"summary":"Toygardens Media","operationId":"get-toygardens","description":"Returns the Toygardens Media page. Supports content negotiation: send Accept: text/markdown for a markdown representation of the same content.","responses":{"200":{"description":"Page content, negotiated by the Accept header.","content":{"text/html":{"schema":{"type":"string"},"examples":{"default":{"summary":"Rendered page"}}},"text/markdown":{"schema":{"type":"string"},"examples":{"default":{"summary":"Same content as markdown, served when Accept: text/markdown is sent"}}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/flexsport/":{"get":{"summary":"flexSPORT","operationId":"get-flexsport","description":"Returns the flexSPORT page. Supports content negotiation: send Accept: text/markdown for a markdown representation of the same content.","responses":{"200":{"description":"Page content, negotiated by the Accept header.","content":{"text/html":{"schema":{"type":"string"},"examples":{"default":{"summary":"Rendered page"}}},"text/markdown":{"schema":{"type":"string"},"examples":{"default":{"summary":"Same content as markdown, served when Accept: text/markdown is sent"}}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/cargobee-solutions-gmbh/":{"get":{"summary":"CargoBee Solutions GmbH","operationId":"get-cargobee","description":"Returns the CargoBee Solutions GmbH page. Supports content negotiation: send Accept: text/markdown for a markdown representation of the same content.","responses":{"200":{"description":"Page content, negotiated by the Accept header.","content":{"text/html":{"schema":{"type":"string"},"examples":{"default":{"summary":"Rendered page"}}},"text/markdown":{"schema":{"type":"string"},"examples":{"default":{"summary":"Same content as markdown, served when Accept: text/markdown is sent"}}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/syrocon-ag/":{"get":{"summary":"SyroCon AG","operationId":"get-syrocon","description":"Returns the SyroCon AG page. Supports content negotiation: send Accept: text/markdown for a markdown representation of the same content.","responses":{"200":{"description":"Page content, negotiated by the Accept header.","content":{"text/html":{"schema":{"type":"string"},"examples":{"default":{"summary":"Rendered page"}}},"text/markdown":{"schema":{"type":"string"},"examples":{"default":{"summary":"Same content as markdown, served when Accept: text/markdown is sent"}}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/data-protection-declaration/":{"get":{"summary":"Data Protection Declaration","operationId":"get-privacy","description":"Returns the Data Protection Declaration page. Supports content negotiation: send Accept: text/markdown for a markdown representation of the same content.","responses":{"200":{"description":"Page content, negotiated by the Accept header.","content":{"text/html":{"schema":{"type":"string"},"examples":{"default":{"summary":"Rendered page"}}},"text/markdown":{"schema":{"type":"string"},"examples":{"default":{"summary":"Same content as markdown, served when Accept: text/markdown is sent"}}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/imprint/":{"get":{"summary":"Imprint","operationId":"get-imprint","description":"Returns the Imprint page. Supports content negotiation: send Accept: text/markdown for a markdown representation of the same content.","responses":{"200":{"description":"Page content, negotiated by the Accept header.","content":{"text/html":{"schema":{"type":"string"},"examples":{"default":{"summary":"Rendered page"}}},"text/markdown":{"schema":{"type":"string"},"examples":{"default":{"summary":"Same content as markdown, served when Accept: text/markdown is sent"}}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/contact/":{"get":{"summary":"Contact us","operationId":"get-contact","description":"Returns the Contact us page. Supports content negotiation: send Accept: text/markdown for a markdown representation of the same content.","responses":{"200":{"description":"Page content, negotiated by the Accept header.","content":{"text/html":{"schema":{"type":"string"},"examples":{"default":{"summary":"Rendered page"}}},"text/markdown":{"schema":{"type":"string"},"examples":{"default":{"summary":"Same content as markdown, served when Accept: text/markdown is sent"}}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/developers/":{"get":{"summary":"Developers","operationId":"get-developers","description":"Returns the Developers page. Supports content negotiation: send Accept: text/markdown for a markdown representation of the same content.","responses":{"200":{"description":"Page content, negotiated by the Accept header.","content":{"text/html":{"schema":{"type":"string"},"examples":{"default":{"summary":"Rendered page"}}},"text/markdown":{"schema":{"type":"string"},"examples":{"default":{"summary":"Same content as markdown, served when Accept: text/markdown is sent"}}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/llms.txt":{"get":{"summary":"LLM-friendly site summary","operationId":"get-llms-txt","description":"Plain-text summary of Aleph Engineering for AI agents, including when-to-use guidance.","responses":{"200":{"description":"Plain-text summary","content":{"text/plain":{"schema":{"type":"string"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/sitemap.xml":{"get":{"summary":"XML sitemap","operationId":"get-sitemap","responses":{"200":{"description":"Sitemap listing every public page","content":{"application/xml":{"schema":{"type":"string"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/api/pages.json":{"get":{"summary":"Public pages, as data","operationId":"get-pages-json","description":"The same page list as this document's `paths`, as a plain JSON array — for agents that want page metadata without parsing an OpenAPI document.","responses":{"200":{"description":"Array of public pages","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","required":["path","title","url"],"properties":{"path":{"type":"string"},"title":{"type":"string"},"url":{"type":"string","format":"uri"}}}}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/openapi.json":{"get":{"summary":"OpenAPI document (latest)","operationId":"get-openapi-latest","description":"This document. Always the current shape; see /v1/openapi.json for the stable v1 alias.","responses":{"200":{"description":"This OpenAPI document.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenApiDocument"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}},"/v1/openapi.json":{"get":{"summary":"OpenAPI document (stable v1 alias)","operationId":"get-openapi-v1","description":"Stable, versioned alias of /openapi.json. This URL keeps serving the v1 document shape even after /openapi.json moves to v2; see info.x-api-lifecycle for the deprecation policy.","responses":{"200":{"description":"This OpenAPI document.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenApiDocument"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"}}}}},"components":{"schemas":{"ProblemDetails":{"type":"object","description":"RFC 9457 (application/problem+json) error object returned by every error response on this site.","properties":{"type":{"type":"string","format":"uri","description":"A URI identifying the problem type."},"title":{"type":"string","description":"Short, human-readable summary of the problem."},"status":{"type":"integer","description":"HTTP status code."},"detail":{"type":"string","description":"Human-readable explanation specific to this occurrence."},"resources":{"type":"object","description":"Links an agent can use to recover: home, sitemap, llms.txt, OpenAPI document.","additionalProperties":{"type":"string","format":"uri"}}},"required":["title","status"]},"OpenApiDocument":{"type":"object","description":"An OpenAPI 3.1 document.","required":["openapi","info","paths"],"properties":{"openapi":{"type":"string"},"info":{"type":"object"},"paths":{"type":"object"}}}},"responses":{"NotFound":{"description":"The requested path does not exist on this site.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}},"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}},"TooManyRequests":{"description":"Rate limit exceeded. Retry after the delay in the Retry-After header.","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait before retrying."},"RateLimit-Policy":{"schema":{"type":"string"},"description":"The configured rate-limit policy, e.g. \"50;w=1\" (50 requests per 1-second window)."}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}},"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetails"}}}}}}}