{
    "openapi": "3.1.0",
    "info": {
        "title": "ASPEKT Public API",
        "version": "1.0.0",
        "summary": "Read-only JSON API for ASPEKT, a digital agency in Zadar, Croatia.",
        "description": "Use this API to read ASPEKT's company profile, services, industry-specific products, blog posts, portfolio projects and client reviews without authentication. All endpoints are read-only, free to use, and require no API key, which makes them suitable for agent evaluation and sandboxing.\n\nEvery response is JSON. Errors use a stable shape with `status`, `code`, `message`, `hint`, `docs`, `openapi` and `path` fields. Blog posts and reviews are paginated with `page` and `per_page`.\n\nContent is published in Croatian (locale `hr`). Company facts, service descriptions and agent guidance are also available in English through https://aspekt.co/llm-info.json.\n\nRate limits: 120 requests per 60 seconds per client IP. Every response includes the IETF `RateLimit-Policy` and `RateLimit` structured fields; a 429 response also includes `Retry-After`. Versioning: the major version lives in the URL path. Breaking changes ship under a new major path, and deprecated operations announce themselves with RFC 9745 `Deprecation` and `Sunset` headers. See https://aspekt.co/docs#versioning-and-deprecation.",
        "termsOfService": "https://aspekt.co/pravila-privatnosti",
        "contact": {
            "name": "ASPEKT",
            "url": "https://aspekt.co/kontakt",
            "email": "info@aspekt.co"
        },
        "license": {
            "name": "Proprietary. Reading and indexing this API by AI agents is allowed.",
            "identifier": "LicenseRef-ASPEKT-Proprietary"
        }
    },
    "servers": [
        {
            "url": "https://aspekt.co/api",
            "description": "Production"
        }
    ],
    "tags": [
        {
            "name": "Discovery",
            "description": "Entry points that describe the API surface."
        },
        {
            "name": "Company",
            "description": "Agency profile, contact details and positioning."
        },
        {
            "name": "Services",
            "description": "Core services the agency offers."
        },
        {
            "name": "Products",
            "description": "Industry-specific CMS products."
        },
        {
            "name": "Blog",
            "description": "Published articles about web design, development and SEO."
        },
        {
            "name": "Portfolio",
            "description": "Case studies and live projects."
        },
        {
            "name": "Reviews",
            "description": "Published client reviews."
        }
    ],
    "paths": {
        "/v1": {
            "get": {
                "operationId": "getApiIndex",
                "tags": [
                    "Discovery"
                ],
                "summary": "Describe the public API",
                "description": "Returns the API name, version, documentation URL, OpenAPI URL, MCP server URL and a list of every available resource with its URL.",
                "responses": {
                    "200": {
                        "description": "API index.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ApiIndex"
                                }
                            }
                        },
                        "headers": {
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            }
                        }
                    },
                    "404": {
                        "description": "Structured JSON error. Every error uses the same envelope: `error.status`, `error.code`, `error.message`, `error.hint`, plus `error.docs` and `error.openapi`.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorEnvelope"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "The client exceeded the public rate limit. The body uses the same error envelope and `Retry-After` states how long to wait.",
                        "headers": {
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "Retry-After": {
                                "$ref": "#/components/headers/RetryAfter"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorEnvelope"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "Structured JSON error. Every error uses the same envelope: `error.status`, `error.code`, `error.message`, `error.hint`, plus `error.docs` and `error.openapi`.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorEnvelope"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/v1/agency": {
            "get": {
                "operationId": "getAgencyProfile",
                "tags": [
                    "Company"
                ],
                "summary": "Get the ASPEKT company profile",
                "description": "Returns a structured agency profile: legal name, description, contact details, location, Google rating, services, products, tech stack, case studies, ideal client fit, agent guidance and discovery endpoints. This is the same data as https://aspekt.co/llm-info.json.",
                "responses": {
                    "200": {
                        "description": "Company profile.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/GetAgencyProfileResponse"
                                }
                            }
                        },
                        "headers": {
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            }
                        }
                    },
                    "404": {
                        "description": "Structured JSON error. Every error uses the same envelope: `error.status`, `error.code`, `error.message`, `error.hint`, plus `error.docs` and `error.openapi`.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorEnvelope"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "The client exceeded the public rate limit. The body uses the same error envelope and `Retry-After` states how long to wait.",
                        "headers": {
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "Retry-After": {
                                "$ref": "#/components/headers/RetryAfter"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorEnvelope"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "Structured JSON error. Every error uses the same envelope: `error.status`, `error.code`, `error.message`, `error.hint`, plus `error.docs` and `error.openapi`.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorEnvelope"
                                }
                            }
                        }
                    },
                    "503": {
                        "description": "Structured JSON error. Every error uses the same envelope: `error.status`, `error.code`, `error.message`, `error.hint`, plus `error.docs` and `error.openapi`.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorEnvelope"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/v1/services": {
            "get": {
                "operationId": "listServices",
                "tags": [
                    "Services"
                ],
                "summary": "List core services",
                "description": "Returns every core service ASPEKT offers, with a stable identifier, display name, summary and the public landing page URL.",
                "responses": {
                    "200": {
                        "description": "Service catalog.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ListServicesResponse"
                                }
                            }
                        },
                        "headers": {
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            }
                        }
                    },
                    "404": {
                        "description": "Structured JSON error. Every error uses the same envelope: `error.status`, `error.code`, `error.message`, `error.hint`, plus `error.docs` and `error.openapi`.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorEnvelope"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "The client exceeded the public rate limit. The body uses the same error envelope and `Retry-After` states how long to wait.",
                        "headers": {
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "Retry-After": {
                                "$ref": "#/components/headers/RetryAfter"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorEnvelope"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "Structured JSON error. Every error uses the same envelope: `error.status`, `error.code`, `error.message`, `error.hint`, plus `error.docs` and `error.openapi`.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorEnvelope"
                                }
                            }
                        }
                    },
                    "503": {
                        "description": "Structured JSON error. Every error uses the same envelope: `error.status`, `error.code`, `error.message`, `error.hint`, plus `error.docs` and `error.openapi`.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorEnvelope"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/v1/products": {
            "get": {
                "operationId": "listProducts",
                "tags": [
                    "Products"
                ],
                "summary": "List industry-specific products",
                "description": "Returns the productized CMS solutions ASPEKT builds for specific industries: tourism agencies, transfer companies, real estate agencies, apartments and villas, yacht charter, associations and clinics.",
                "responses": {
                    "200": {
                        "description": "Product catalog.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ListProductsResponse"
                                }
                            }
                        },
                        "headers": {
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            }
                        }
                    },
                    "404": {
                        "description": "Structured JSON error. Every error uses the same envelope: `error.status`, `error.code`, `error.message`, `error.hint`, plus `error.docs` and `error.openapi`.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorEnvelope"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "The client exceeded the public rate limit. The body uses the same error envelope and `Retry-After` states how long to wait.",
                        "headers": {
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "Retry-After": {
                                "$ref": "#/components/headers/RetryAfter"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorEnvelope"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "Structured JSON error. Every error uses the same envelope: `error.status`, `error.code`, `error.message`, `error.hint`, plus `error.docs` and `error.openapi`.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorEnvelope"
                                }
                            }
                        }
                    },
                    "503": {
                        "description": "Structured JSON error. Every error uses the same envelope: `error.status`, `error.code`, `error.message`, `error.hint`, plus `error.docs` and `error.openapi`.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorEnvelope"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/v1/posts": {
            "get": {
                "operationId": "listPosts",
                "tags": [
                    "Blog"
                ],
                "summary": "List published blog posts",
                "description": "Returns published blog posts, newest first, as a paginated collection. Use the slug from this response with getPost to read a single article.",
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "required": false,
                        "description": "Page number to return, starting at 1.",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "default": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "required": false,
                        "description": "Number of posts per page. Maximum 50.",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 50,
                            "default": 15
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Paginated list of posts.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ListPostsResponse"
                                }
                            }
                        },
                        "headers": {
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            }
                        }
                    },
                    "404": {
                        "description": "Structured JSON error. Every error uses the same envelope: `error.status`, `error.code`, `error.message`, `error.hint`, plus `error.docs` and `error.openapi`.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorEnvelope"
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "The query parameters failed validation.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "The client exceeded the public rate limit. The body uses the same error envelope and `Retry-After` states how long to wait.",
                        "headers": {
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "Retry-After": {
                                "$ref": "#/components/headers/RetryAfter"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorEnvelope"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "Structured JSON error. Every error uses the same envelope: `error.status`, `error.code`, `error.message`, `error.hint`, plus `error.docs` and `error.openapi`.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorEnvelope"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/v1/posts/{slug}": {
            "get": {
                "operationId": "getPost",
                "tags": [
                    "Blog"
                ],
                "summary": "Get a single blog post",
                "description": "Returns one published blog post identified by its slug, including its canonical URL on aspekt.co.",
                "parameters": [
                    {
                        "name": "slug",
                        "in": "path",
                        "required": true,
                        "description": "Slug of the post, for example `sto-je-on-page-seo`.",
                        "schema": {
                            "type": "string",
                            "minLength": 1
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Single post.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/GetPostResponse"
                                }
                            }
                        },
                        "headers": {
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            }
                        }
                    },
                    "404": {
                        "description": "Structured JSON error. Every error uses the same envelope: `error.status`, `error.code`, `error.message`, `error.hint`, plus `error.docs` and `error.openapi`.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorEnvelope"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "The client exceeded the public rate limit. The body uses the same error envelope and `Retry-After` states how long to wait.",
                        "headers": {
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "Retry-After": {
                                "$ref": "#/components/headers/RetryAfter"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorEnvelope"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "Structured JSON error. Every error uses the same envelope: `error.status`, `error.code`, `error.message`, `error.hint`, plus `error.docs` and `error.openapi`.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorEnvelope"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/v1/portfolio": {
            "get": {
                "operationId": "listPortfolio",
                "tags": [
                    "Portfolio"
                ],
                "summary": "List portfolio projects",
                "description": "Returns published portfolio projects, newest first, with the URL of the live website and a thumbnail image. Paginated.",
                "responses": {
                    "200": {
                        "description": "Paginated portfolio projects.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ListPortfolioResponse"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Structured JSON error. Every error uses the same envelope: `error.status`, `error.code`, `error.message`, `error.hint`, plus `error.docs` and `error.openapi`.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorEnvelope"
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "The query parameters failed validation.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "The client exceeded the public rate limit. The body uses the same error envelope and `Retry-After` states how long to wait.",
                        "headers": {
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "Retry-After": {
                                "$ref": "#/components/headers/RetryAfter"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorEnvelope"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "Structured JSON error. Every error uses the same envelope: `error.status`, `error.code`, `error.message`, `error.hint`, plus `error.docs` and `error.openapi`.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorEnvelope"
                                }
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "required": false,
                        "description": "Page number to return, starting at 1.",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "default": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "required": false,
                        "description": "Number of projects per page. Maximum 50.",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 50,
                            "default": 15
                        }
                    }
                ]
            }
        },
        "/v1/reviews": {
            "get": {
                "operationId": "listReviews",
                "tags": [
                    "Reviews"
                ],
                "summary": "List client reviews",
                "description": "Returns published client reviews with the author name, company subtitle, star rating, plain-text comment and publication date, as a paginated collection.",
                "parameters": [
                    {
                        "name": "page",
                        "in": "query",
                        "required": false,
                        "description": "Page number to return, starting at 1.",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "default": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "required": false,
                        "description": "Number of reviews per page. Maximum 50.",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 50,
                            "default": 20
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Paginated list of reviews.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ListReviewsResponse"
                                }
                            }
                        },
                        "headers": {
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            }
                        }
                    },
                    "404": {
                        "description": "Structured JSON error. Every error uses the same envelope: `error.status`, `error.code`, `error.message`, `error.hint`, plus `error.docs` and `error.openapi`.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorEnvelope"
                                }
                            }
                        }
                    },
                    "422": {
                        "description": "The query parameters failed validation.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ValidationError"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "The client exceeded the public rate limit. The body uses the same error envelope and `Retry-After` states how long to wait.",
                        "headers": {
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "Retry-After": {
                                "$ref": "#/components/headers/RetryAfter"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorEnvelope"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "Structured JSON error. Every error uses the same envelope: `error.status`, `error.code`, `error.message`, `error.hint`, plus `error.docs` and `error.openapi`.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorEnvelope"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/v1/deprecations": {
            "get": {
                "operationId": "getDeprecationPolicy",
                "tags": [
                    "Discovery"
                ],
                "summary": "Get the versioning and deprecation policy",
                "description": "Returns the machine-readable versioning policy, the headers used to announce a deprecation, and the current deprecation register. The register is empty while no operation is scheduled for removal.",
                "responses": {
                    "200": {
                        "description": "Versioning policy and deprecation register.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/DeprecationRegister"
                                }
                            }
                        }
                    },
                    "404": {
                        "description": "Structured JSON error.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorEnvelope"
                                }
                            }
                        }
                    },
                    "429": {
                        "description": "The client exceeded the public rate limit.",
                        "headers": {
                            "RateLimit-Policy": {
                                "$ref": "#/components/headers/RateLimitPolicy"
                            },
                            "RateLimit": {
                                "$ref": "#/components/headers/RateLimit"
                            },
                            "Retry-After": {
                                "$ref": "#/components/headers/RetryAfter"
                            }
                        },
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorEnvelope"
                                }
                            }
                        }
                    },
                    "500": {
                        "description": "Structured JSON error.",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/ErrorEnvelope"
                                }
                            }
                        }
                    }
                }
            }
        }
    },
    "components": {
        "responses": {
            "Error": {
                "description": "Structured JSON error. Every error uses the same envelope: `error.status`, `error.code`, `error.message`, `error.hint`, plus `error.docs` and `error.openapi`.",
                "content": {
                    "application/json": {
                        "schema": {
                            "$ref": "#/components/schemas/ErrorEnvelope"
                        }
                    }
                }
            },
            "ValidationError": {
                "description": "The query parameters failed validation. Uses the same error envelope as every other error, with a `validation_failed` code and the field messages in `error.details`.",
                "content": {
                    "application/json": {
                        "schema": {
                            "$ref": "#/components/schemas/ValidationError"
                        }
                    }
                }
            },
            "RateLimited": {
                "description": "The client exceeded the public rate limit. The body uses the same error envelope and `Retry-After` states how long to wait.",
                "headers": {
                    "RateLimit-Policy": {
                        "$ref": "#/components/headers/RateLimitPolicy"
                    },
                    "RateLimit": {
                        "$ref": "#/components/headers/RateLimit"
                    },
                    "Retry-After": {
                        "$ref": "#/components/headers/RetryAfter"
                    }
                },
                "content": {
                    "application/json": {
                        "schema": {
                            "$ref": "#/components/schemas/ErrorEnvelope"
                        }
                    }
                }
            }
        },
        "schemas": {
            "ApiIndex": {
                "type": "object",
                "required": [
                    "name",
                    "version",
                    "documentation",
                    "openapi",
                    "resources"
                ],
                "properties": {
                    "name": {
                        "type": "string",
                        "examples": [
                            "ASPEKT Public API"
                        ]
                    },
                    "version": {
                        "type": "string",
                        "examples": [
                            "1.0.0"
                        ]
                    },
                    "description": {
                        "type": "string"
                    },
                    "documentation": {
                        "type": "string",
                        "format": "uri"
                    },
                    "openapi": {
                        "type": "string",
                        "format": "uri"
                    },
                    "authentication": {
                        "type": "string",
                        "examples": [
                            "none"
                        ]
                    },
                    "rate_limit": {
                        "type": "string",
                        "description": "Human readable quota applied to the public API.",
                        "examples": [
                            "120 requests per 60 seconds per IP"
                        ]
                    },
                    "mcp_server": {
                        "type": "string",
                        "format": "uri"
                    },
                    "contact": {
                        "type": "string",
                        "format": "email"
                    },
                    "resources": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "required": [
                                "name",
                                "method",
                                "url",
                                "description"
                            ],
                            "properties": {
                                "name": {
                                    "type": "string"
                                },
                                "method": {
                                    "type": "string",
                                    "enum": [
                                        "GET"
                                    ]
                                },
                                "url": {
                                    "type": "string"
                                },
                                "description": {
                                    "type": "string"
                                }
                            }
                        }
                    },
                    "rate_limit_headers": {
                        "type": "array",
                        "description": "Response headers that announce the quota and the remaining budget.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "versioning": {
                        "type": "string",
                        "description": "Versioning and deprecation policy."
                    },
                    "deprecation_policy": {
                        "type": "string",
                        "format": "uri",
                        "description": "URL of the versioning and deprecation policy."
                    }
                }
            },
            "AgencyProfile": {
                "type": "object",
                "required": [
                    "name",
                    "url",
                    "description",
                    "contact"
                ],
                "properties": {
                    "name": {
                        "type": "string",
                        "examples": [
                            "ASPEKT"
                        ]
                    },
                    "legalName": {
                        "type": "string",
                        "examples": [
                            "ASPEKT vl. Kristina Alić"
                        ]
                    },
                    "type": {
                        "type": "string",
                        "examples": [
                            "digital-agency"
                        ]
                    },
                    "url": {
                        "type": "string",
                        "format": "uri"
                    },
                    "email": {
                        "type": "string",
                        "format": "email"
                    },
                    "languages": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        }
                    },
                    "description": {
                        "type": "string"
                    },
                    "foundingYear": {
                        "type": "integer"
                    },
                    "numberOfProjects": {
                        "type": "string"
                    },
                    "averageGoogleRating": {
                        "type": "number"
                    },
                    "location": {
                        "$ref": "#/components/schemas/AgencyLocation"
                    },
                    "contact": {
                        "$ref": "#/components/schemas/AgencyContact"
                    },
                    "rating": {
                        "type": "object",
                        "properties": {
                            "platform": {
                                "type": "string"
                            },
                            "value": {
                                "type": "number"
                            },
                            "reviewCount": {
                                "type": "integer"
                            }
                        }
                    },
                    "sameAs": {
                        "type": "array",
                        "items": {
                            "type": "string",
                            "format": "uri"
                        }
                    },
                    "services": {
                        "type": "object",
                        "properties": {
                            "core": {
                                "type": "array",
                                "items": {
                                    "$ref": "#/components/schemas/Service"
                                }
                            }
                        }
                    },
                    "industrySpecificSolutions": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/Product"
                        }
                    },
                    "techStack": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "array",
                            "items": {
                                "type": "string"
                            }
                        }
                    },
                    "caseStudies": {
                        "type": "array",
                        "items": {
                            "type": "object",
                            "properties": {
                                "slug": {
                                    "type": "string"
                                },
                                "name": {
                                    "type": "string"
                                },
                                "url": {
                                    "type": "string",
                                    "format": "uri"
                                },
                                "summary": {
                                    "type": "string"
                                }
                            }
                        }
                    },
                    "idealFit": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        }
                    },
                    "nonFit": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        }
                    },
                    "whenToUse": {
                        "type": "array",
                        "description": "Plain-language guidance for agents about the jobs ASPEKT is and is not a good fit for.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "instructionsForAI": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        }
                    },
                    "developerResources": {
                        "type": "object",
                        "properties": {
                            "documentation": {
                                "type": "string",
                                "format": "uri"
                            },
                            "openapi": {
                                "type": "string",
                                "format": "uri"
                            },
                            "apiBaseUrl": {
                                "type": "string",
                                "format": "uri"
                            },
                            "apiAuthentication": {
                                "type": "string"
                            },
                            "apiRateLimit": {
                                "type": "string"
                            },
                            "mcpServer": {
                                "type": "string",
                                "format": "uri"
                            }
                        }
                    },
                    "links": {
                        "type": "object",
                        "additionalProperties": {
                            "type": "string",
                            "format": "uri"
                        }
                    },
                    "lastUpdated": {
                        "type": "string",
                        "format": "date"
                    }
                }
            },
            "AgencyLocation": {
                "type": "object",
                "properties": {
                    "streetAddress": {
                        "type": "string"
                    },
                    "addressLocality": {
                        "type": "string"
                    },
                    "addressRegion": {
                        "type": "string"
                    },
                    "postalCode": {
                        "type": "string"
                    },
                    "addressCountry": {
                        "type": "string"
                    },
                    "serviceArea": {
                        "type": "array",
                        "items": {
                            "type": "string"
                        }
                    }
                }
            },
            "AgencyContact": {
                "type": "object",
                "required": [
                    "email",
                    "contactForm"
                ],
                "properties": {
                    "email": {
                        "type": "string",
                        "format": "email"
                    },
                    "phone": {
                        "type": "string"
                    },
                    "contactForm": {
                        "type": "string",
                        "format": "uri"
                    }
                }
            },
            "Service": {
                "type": "object",
                "required": [
                    "id",
                    "name",
                    "url",
                    "summary"
                ],
                "properties": {
                    "id": {
                        "type": "string",
                        "description": "Stable identifier of the service.",
                        "examples": [
                            "website-design"
                        ]
                    },
                    "name": {
                        "type": "string",
                        "examples": [
                            "Website Design"
                        ]
                    },
                    "url": {
                        "type": "string",
                        "format": "uri",
                        "description": "Public landing page for the service."
                    },
                    "summary": {
                        "type": "string",
                        "description": "One-sentence description of the outcome the service delivers."
                    }
                }
            },
            "Product": {
                "type": "object",
                "required": [
                    "id",
                    "name",
                    "url",
                    "summary"
                ],
                "properties": {
                    "id": {
                        "type": "string",
                        "description": "Stable identifier of the product.",
                        "examples": [
                            "tourism-agencies"
                        ]
                    },
                    "name": {
                        "type": "string",
                        "examples": [
                            "Tourism Agency Websites"
                        ]
                    },
                    "url": {
                        "type": "string",
                        "format": "uri",
                        "description": "Public landing page for the product."
                    },
                    "summary": {
                        "type": "string",
                        "description": "What the product includes and who it is for."
                    }
                }
            },
            "Post": {
                "type": "object",
                "required": [
                    "id",
                    "slug",
                    "title",
                    "summary",
                    "published_at",
                    "url"
                ],
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "slug": {
                        "type": "string"
                    },
                    "title": {
                        "type": "string"
                    },
                    "summary": {
                        "type": "string"
                    },
                    "published_at": {
                        "type": "string",
                        "format": "date"
                    },
                    "url": {
                        "type": "string",
                        "format": "uri",
                        "description": "Canonical URL of the article on aspekt.co."
                    },
                    "image": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "uri",
                        "description": "Thumbnail image URL, or null when the post has no image."
                    }
                }
            },
            "PortfolioProject": {
                "type": "object",
                "required": [
                    "id",
                    "slug",
                    "title",
                    "project_url",
                    "published_at"
                ],
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "slug": {
                        "type": "string"
                    },
                    "title": {
                        "type": "string"
                    },
                    "project_url": {
                        "type": "string",
                        "format": "uri",
                        "description": "URL of the live project."
                    },
                    "published_at": {
                        "type": "string",
                        "format": "date"
                    },
                    "image": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "uri"
                    }
                }
            },
            "Review": {
                "type": "object",
                "required": [
                    "id",
                    "author",
                    "rating",
                    "comment",
                    "published_at"
                ],
                "properties": {
                    "id": {
                        "type": "integer"
                    },
                    "author": {
                        "type": "string"
                    },
                    "subtitle": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "description": "Company or project the reviewer represents."
                    },
                    "rating": {
                        "type": "integer",
                        "minimum": 1,
                        "maximum": 5
                    },
                    "comment": {
                        "type": "string",
                        "description": "Plain-text review comment."
                    },
                    "published_at": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "date"
                    },
                    "avatar": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "uri"
                    }
                }
            },
            "PaginationLinks": {
                "type": "object",
                "properties": {
                    "first": {
                        "type": "string",
                        "format": "uri"
                    },
                    "last": {
                        "type": "string",
                        "format": "uri"
                    },
                    "prev": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "uri"
                    },
                    "next": {
                        "type": [
                            "string",
                            "null"
                        ],
                        "format": "uri"
                    }
                }
            },
            "PaginationMeta": {
                "type": "object",
                "properties": {
                    "current_page": {
                        "type": "integer"
                    },
                    "from": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "last_page": {
                        "type": "integer"
                    },
                    "path": {
                        "type": "string",
                        "format": "uri"
                    },
                    "per_page": {
                        "type": "integer"
                    },
                    "to": {
                        "type": [
                            "integer",
                            "null"
                        ]
                    },
                    "total": {
                        "type": "integer"
                    }
                }
            },
            "ResponseMeta": {
                "type": "object",
                "properties": {
                    "count": {
                        "type": "integer"
                    },
                    "documentation": {
                        "type": "string",
                        "format": "uri"
                    },
                    "source": {
                        "type": "string",
                        "format": "uri"
                    },
                    "locale": {
                        "type": "string"
                    }
                }
            },
            "ErrorEnvelope": {
                "type": "object",
                "required": [
                    "error"
                ],
                "properties": {
                    "error": {
                        "type": "object",
                        "required": [
                            "status",
                            "code",
                            "message",
                            "hint"
                        ],
                        "properties": {
                            "status": {
                                "type": "integer",
                                "description": "HTTP status code."
                            },
                            "code": {
                                "type": "string",
                                "description": "Stable machine-readable error code.",
                                "examples": [
                                    "not_found"
                                ]
                            },
                            "message": {
                                "type": "string",
                                "description": "Human readable explanation."
                            },
                            "hint": {
                                "type": "string",
                                "description": "What to do next."
                            },
                            "path": {
                                "type": "string",
                                "description": "Requested path."
                            },
                            "docs": {
                                "type": "string",
                                "format": "uri"
                            },
                            "openapi": {
                                "type": "string",
                                "format": "uri"
                            }
                        }
                    }
                }
            },
            "ValidationError": {
                "type": "object",
                "required": [
                    "error"
                ],
                "properties": {
                    "error": {
                        "type": "object",
                        "required": [
                            "status",
                            "code",
                            "message",
                            "hint",
                            "details"
                        ],
                        "properties": {
                            "status": {
                                "type": "integer",
                                "description": "HTTP status code. Always 422.",
                                "const": 422
                            },
                            "code": {
                                "type": "string",
                                "description": "Stable machine-readable error code.",
                                "const": "validation_failed"
                            },
                            "message": {
                                "type": "string",
                                "description": "Human readable summary of the validation failure."
                            },
                            "hint": {
                                "type": "string",
                                "description": "What to do next."
                            },
                            "path": {
                                "type": "string",
                                "description": "Requested path."
                            },
                            "docs": {
                                "type": "string",
                                "format": "uri"
                            },
                            "openapi": {
                                "type": "string",
                                "format": "uri"
                            },
                            "details": {
                                "type": "object",
                                "description": "Validation messages keyed by parameter name.",
                                "additionalProperties": {
                                    "type": "array",
                                    "items": {
                                        "type": "string"
                                    }
                                }
                            }
                        }
                    }
                }
            },
            "DeprecationRegister": {
                "type": "object",
                "required": [
                    "policy",
                    "deprecated",
                    "meta"
                ],
                "properties": {
                    "policy": {
                        "type": "object",
                        "required": [
                            "versioning",
                            "currentVersion",
                            "minimumNoticeDays",
                            "documentation"
                        ],
                        "properties": {
                            "version": {
                                "type": "string"
                            },
                            "versioning": {
                                "type": "string",
                                "enum": [
                                    "url-path",
                                    "header",
                                    "media-type"
                                ]
                            },
                            "currentVersion": {
                                "type": "string",
                                "examples": [
                                    "v1"
                                ]
                            },
                            "stableVersions": {
                                "type": "array",
                                "items": {
                                    "type": "string"
                                }
                            },
                            "minimumNoticeDays": {
                                "type": "integer",
                                "minimum": 0,
                                "examples": [
                                    90
                                ]
                            },
                            "headers": {
                                "type": "object",
                                "description": "Response headers used to announce a deprecation.",
                                "additionalProperties": {
                                    "type": "string"
                                }
                            },
                            "breakingChanges": {
                                "type": "string"
                            },
                            "documentation": {
                                "type": "string",
                                "format": "uri"
                            },
                            "notifications": {
                                "type": "string",
                                "format": "uri"
                            }
                        }
                    },
                    "deprecated": {
                        "type": "array",
                        "description": "Operations scheduled for removal. Empty when nothing is deprecated.",
                        "items": {
                            "type": "object",
                            "required": [
                                "operationId",
                                "deprecatedAt",
                                "sunsetAt"
                            ],
                            "properties": {
                                "operationId": {
                                    "type": "string"
                                },
                                "deprecatedAt": {
                                    "type": "string",
                                    "format": "date-time"
                                },
                                "sunsetAt": {
                                    "type": "string",
                                    "format": "date-time"
                                },
                                "replacement": {
                                    "type": [
                                        "string",
                                        "null"
                                    ]
                                }
                            }
                        }
                    },
                    "meta": {
                        "type": "object",
                        "properties": {
                            "count": {
                                "type": "integer",
                                "minimum": 0
                            },
                            "documentation": {
                                "type": "string",
                                "format": "uri"
                            },
                            "openapi": {
                                "type": "string",
                                "format": "uri"
                            }
                        }
                    }
                }
            },
            "GetAgencyProfileResponse": {
                "type": "object",
                "required": [
                    "data",
                    "meta"
                ],
                "properties": {
                    "data": {
                        "$ref": "#/components/schemas/AgencyProfile"
                    },
                    "meta": {
                        "$ref": "#/components/schemas/ResponseMeta"
                    }
                }
            },
            "ListServicesResponse": {
                "type": "object",
                "required": [
                    "data",
                    "meta"
                ],
                "properties": {
                    "data": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/Service"
                        }
                    },
                    "meta": {
                        "$ref": "#/components/schemas/ResponseMeta"
                    }
                }
            },
            "ListProductsResponse": {
                "type": "object",
                "required": [
                    "data",
                    "meta"
                ],
                "properties": {
                    "data": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/Product"
                        }
                    },
                    "meta": {
                        "$ref": "#/components/schemas/ResponseMeta"
                    }
                }
            },
            "ListPostsResponse": {
                "type": "object",
                "required": [
                    "data",
                    "links",
                    "meta"
                ],
                "properties": {
                    "data": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/Post"
                        }
                    },
                    "links": {
                        "$ref": "#/components/schemas/PaginationLinks"
                    },
                    "meta": {
                        "$ref": "#/components/schemas/PaginationMeta"
                    }
                }
            },
            "GetPostResponse": {
                "type": "object",
                "required": [
                    "data"
                ],
                "properties": {
                    "data": {
                        "$ref": "#/components/schemas/Post"
                    }
                }
            },
            "ListPortfolioResponse": {
                "type": "object",
                "required": [
                    "data",
                    "links",
                    "meta"
                ],
                "properties": {
                    "data": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/PortfolioProject"
                        }
                    },
                    "links": {
                        "$ref": "#/components/schemas/PaginationLinks"
                    },
                    "meta": {
                        "$ref": "#/components/schemas/PaginationMeta"
                    }
                }
            },
            "ListReviewsResponse": {
                "type": "object",
                "required": [
                    "data",
                    "links",
                    "meta"
                ],
                "properties": {
                    "data": {
                        "type": "array",
                        "items": {
                            "$ref": "#/components/schemas/Review"
                        }
                    },
                    "links": {
                        "$ref": "#/components/schemas/PaginationLinks"
                    },
                    "meta": {
                        "$ref": "#/components/schemas/PaginationMeta"
                    }
                }
            }
        },
        "headers": {
            "RateLimitPolicy": {
                "description": "IETF RateLimit-Policy structured field describing the quota, for example `\"aspekt-api\";q=120;w=60`.",
                "schema": {
                    "type": "string",
                    "examples": [
                        "\"aspekt-api\";q=120;w=60"
                    ]
                }
            },
            "RateLimit": {
                "description": "IETF RateLimit structured field with the remaining quota (`r`) and seconds until reset (`t`).",
                "schema": {
                    "type": "string",
                    "examples": [
                        "\"aspekt-api\";r=118;t=42"
                    ]
                }
            },
            "RetryAfter": {
                "description": "Seconds to wait before retrying, sent with 429 responses.",
                "schema": {
                    "type": "integer",
                    "minimum": 1
                }
            },
            "Deprecation": {
                "description": "RFC 9745 structured field date timestamp, sent only on deprecated operations. Example: `@1735689600`.",
                "schema": {
                    "type": "string",
                    "examples": [
                        "@1735689600"
                    ]
                }
            },
            "Sunset": {
                "description": "RFC 8594 HTTP date after which the operation stops working, sent only on deprecated operations. Example: `Wed, 01 Jul 2026 00:00:00 GMT`.",
                "schema": {
                    "type": "string",
                    "examples": [
                        "Wed, 01 Jul 2026 00:00:00 GMT"
                    ]
                }
            }
        }
    },
    "x-deprecation-policy": {
        "versioning": "url-path",
        "currentVersion": "v1",
        "minimumNoticeDays": 90,
        "breakingChanges": "Reserved for a new major path. Within /v1 only additive changes are allowed.",
        "headers": {
            "Deprecation": "RFC 9745 structured field date timestamp.",
            "Sunset": "RFC 8594 HTTP date of removal.",
            "Link": "`rel=\"deprecation\"` pointing at the replacement operation, when one exists."
        },
        "register": "https://aspekt.co/api/v1/deprecations",
        "documentation": "https://aspekt.co/docs#versioning-and-deprecation"
    }
}
