Open
Description
Describe the bug
Hello,
We've recently upgraded our documentation to the latest 4.3.7 version and found out that documentation generation is broken since version 4.2.0. Schema for each endpoint is undefined.
This is one endpoint from 4.1.0
id: activities-get
title: "Get list of activities"
description: "Get list of activities"
sidebar_label: "Get list of activities"
hide_title: true
hide_table_of_contents: true
api: eJzFVltv2zYU/isEn2VbMbI9+M1N08DYugaNhwIzjIGWjm02EsmRlGFD0H/fOZRky5emTlOgT4LIj+fynWvJvVg5PprxceLlRnoJjs8jrg1Y4aVWk5SPOnf/PoDnETfCihw8WHpacoU/CLvTyktVhHdT/QwKkVLhxX8F2B3+pOASKw3d42mAMOmYAkghjVihMnCOiSxjFhJtU8fWYgNsAYiz4AurIGVSMWNhI3Xh8BBFO99n7zVT2rOltivwzGtmRJDkdBCn/RosO1jdR2NcsoZc8FHJ/c6Q+c5bqVZ4o4osE4sMz7wtoIr4tme0k7XZNxXSY8EZrRxyhc+HcUyfY+eeiiRBZ1BagqyA8gQRxmQyCfwMvjrClR0z0NBPy8BnY5BefIWE6BZpGrSL7NFSZEKURkt0DzAWnaPyQgy+7yB66KWnX/65ceydcMCr6E2mTDzkrqNeWCt2Z9oxRVrcgYBvU7HtiQX6IfCnef6iRa1fTzuHWj5IyFL3M318KGR6iWFMxFygiXxFACT4M2ask7obDol5sQLbRePR77cEf8Qk1erOgvBwhYILOdtIWAu1+kEJU5ljbYncXGNGioiexxcXAgxbFBLCMIyHv/XiYW94O72JRze3ozj+hx+pusLet6iqqHpfSorXJwT1IGnJ5hn/ixrh/DRJwuk1feZOp9cBpwFAPWcpioxI+aLtMyK1guPC2cs4bk+hkkAVOdkW+n8jYLxwoBKi9h1G/ZmcIdjLiJbQZk7sgnnVHA193xq4N2ihdQZCtVG/Vx5Hw5Ern0zN9Zvc6QiZai+yaZ0vH6zOp7rr1XeBl5w7WB68nChBl3DZzY96A3kzAc5vJ4m+pkdH/H6LkwsN/QN21/T06tx0TMc2zak3UzW8jAqIiN9eGnD31mr7mvH2w0VVazqrqvr4tYJPp+WVBfcRZ7lYXYPtDNNgYT1lTk+PGK5O0xmXLJZJ55leMnHYyyKO28ta00a2atYwv8afgTBysBkOxl2oA7tp97PCZghbe2/caDAox0miC+WpVqp+plGW7ic6x0cbYSX5EsjpwI4LdNa5mTc91UFSWKyOoG8cdp+QqLN59/aJsmEvvcUcNgQj6SBqF8oDplkk1yBSnJjEmFRLHZ42tP4Z/GCmWGAOsvHjhNxBAmpGh/24H1O54SLncxFSs1HyTbKPYrK30cPWD0wmZKjewGzZBGJGDpDaIbXJo316jWoJUJYLzIe/bVZVdFwvxkRZKh0Rn+4T9UT7vsx+9dp8kYZnCuPF/X8jsoLwnNKgTa+QFlEbTXK/FkDxNr7z6qyjkJR9ETzcTzEV/gc84Gi8
sidebar_class_name: "get api-method"
info_path: api/logeto-public-api
custom_edit_url: null
import ApiTabs from "@theme/ApiTabs";
import DiscriminatorTabs from "@theme/DiscriminatorTabs";
import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import SecuritySchemes from "@theme/ApiExplorer/SecuritySchemes";
import MimeTabs from "@theme/MimeTabs";
import ParamsItem from "@theme/ParamsItem";
import ResponseSamples from "@theme/ResponseSamples";
import SchemaItem from "@theme/SchemaItem";
import SchemaTabs from "@theme/SchemaTabs";
import Heading from "@theme/Heading";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
<Heading
as={"h1"}
className={"openapi__heading"}
children={"Get list of activities"}
>
</Heading>
<MethodEndpoint
method={"get"}
path={"/api/v2/Activities"}
context={"endpoint"}
>
</MethodEndpoint>
Get list of activities
<Heading
id={"request"}
as={"h2"}
className={"openapi-tabs__heading"}
children={"Request"}
>
</Heading>
<details
style={{"marginBottom":"1rem"}}
className={"openapi-markdown__details"}
data-collapsed={false}
open={true}
>
<summary
style={{}}
>
<h3
className={"openapi-markdown__details-summary-header-params"}
>
Query Parameters
</h3>
</summary><div>
<ul>
<ParamsItem
className={"paramsItem"}
param={{"name":"ContinuationToken","in":"query","description":"Token is needed, unless all records have been returned in previous request. Do not forget to pass also all other parameters.","schema":{"type":"string","nullable":true},"x-position":1,"enumDescriptions":[]}}
>
</ParamsItem>
</ul>
</div>
</details><div>
<div>
<ApiTabs
label={undefined}
id={undefined}
>
<TabItem
label={"200"}
value={"200"}
>
<div>
Success
</div><div>
<MimeTabs
className={"openapi-tabs__mime"}
schemaType={"response"}
>
<TabItem
label={"application/json"}
value={"application/json"}
>
<SchemaTabs
className={"openapi-tabs__schema"}
>
<TabItem
label={"Schema"}
value={"Schema"}
>
<details
style={{}}
className={"openapi-markdown__details response"}
data-collapsed={false}
open={true}
>
<summary
style={{}}
className={"openapi-markdown__details-summary-response"}
>
<strong>
Schema
</strong>
</summary><div
style={{"textAlign":"left","marginLeft":"1rem"}}
>
</div><ul
style={{"marginLeft":"1rem"}}
>
<SchemaItem
collapsible={false}
name={"ContinuationToken"}
required={false}
schemaName={"string"}
qualifierMessage={undefined}
schema={{"type":"string","nullable":true}}
>
</SchemaItem><SchemaItem
collapsible={true}
className={"schemaItem"}
>
<details
style={{}}
className={"openapi-markdown__details"}
>
<summary
style={{}}
>
<span
className={"openapi-schema__container"}
>
<strong
className={"openapi-schema__property"}
>
Items
</strong><span
className={"openapi-schema__name"}
>
object[]
</span><span
className={"openapi-schema__divider"}
>
</span><span
className={"openapi-schema__nullable"}
>
nullable
</span>
</span>
</summary><div
style={{"marginLeft":"1rem"}}
>
<li>
<div
style={{"fontSize":"var(--ifm-code-font-size)","opacity":"0.6","marginLeft":"-.5rem","paddingBottom":".5rem"}}
>
Array [
</div>
</li><SchemaItem
collapsible={false}
name={"Guid"}
required={false}
schemaName={"guid"}
qualifierMessage={undefined}
schema={{"type":"string","format":"guid"}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"Revision"}
required={false}
schemaName={"int64"}
qualifierMessage={undefined}
schema={{"type":"integer","format":"int64"}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"PersonCreated"}
required={false}
schemaName={"guid"}
qualifierMessage={undefined}
schema={{"type":"string","format":"guid","nullable":true}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"PersonChanged"}
required={false}
schemaName={"guid"}
qualifierMessage={undefined}
schema={{"type":"string","format":"guid","nullable":true}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"TimestampCreated"}
required={false}
schemaName={"date-time"}
qualifierMessage={undefined}
schema={{"type":"string","format":"date-time","nullable":true,"example":"2025-02-24T10:14:00Z"}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"TimestampChanged"}
required={false}
schemaName={"date-time"}
qualifierMessage={undefined}
schema={{"type":"string","format":"date-time","nullable":true,"example":"2025-02-24T10:14:00Z"}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"Name"}
required={true}
schemaName={"string"}
qualifierMessage={undefined}
schema={{"type":"string","nullable":true}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"Code"}
required={false}
schemaName={"string"}
qualifierMessage={undefined}
schema={{"type":"string","nullable":true}}
>
</SchemaItem><SchemaItem
collapsible={true}
className={"schemaItem"}
>
<details
style={{}}
className={"openapi-markdown__details"}
>
<summary
style={{}}
>
<span
className={"openapi-schema__container"}
>
<strong
className={"openapi-schema__property"}
>
Type
</strong><span
className={"openapi-schema__name"}
>
object
</span>
</span>
</summary><div
style={{"marginLeft":"1rem"}}
>
<div>
<span
className={"badge badge--info"}
style={{"marginBottom":"1rem"}}
>
oneOf
</span><SchemaTabs>
<TabItem
label={"ActivityType"}
value={"0-item-properties"}
>
<div
style={{"marginTop":".5rem","marginBottom":".5rem"}}
>
string
<div
style={{"paddingTop":"1rem"}}
>
**Possible values:** [`Work`, `Absence`, `Break`]
</div>
</div>
</TabItem>
</SchemaTabs>
</div>
</div>
</details>
</SchemaItem><SchemaItem
collapsible={false}
name={"Default"}
required={false}
schemaName={"boolean"}
qualifierMessage={undefined}
schema={{"type":"boolean"}}
>
</SchemaItem><SchemaItem
collapsible={true}
className={"schemaItem"}
>
<details
style={{}}
className={"openapi-markdown__details"}
>
<summary
style={{}}
>
<span
className={"openapi-schema__container"}
>
<strong
className={"openapi-schema__property"}
>
TimeEntry
</strong><span
className={"openapi-schema__name"}
>
object
</span>
</span>
</summary><div
style={{"marginLeft":"1rem"}}
>
<div>
<span
className={"badge badge--info"}
style={{"marginBottom":"1rem"}}
>
oneOf
</span><SchemaTabs>
<TabItem
label={"ActivityTypeTimeEntry"}
value={"0-item-properties"}
>
<div
style={{"marginTop":".5rem","marginBottom":".5rem"}}
>
string
<div
style={{"paddingTop":"1rem"}}
>
**Possible values:** [`Optional`, `TotalTime`, `FromTo`]
</div>
</div>
</TabItem>
</SchemaTabs>
</div>
</div>
</details>
</SchemaItem><SchemaItem
collapsible={false}
name={"Inactive"}
required={false}
schemaName={"boolean"}
qualifierMessage={undefined}
schema={{"type":"boolean"}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"Movement"}
required={false}
schemaName={"boolean"}
qualifierMessage={undefined}
schema={{"type":"boolean"}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"Icon"}
required={false}
schemaName={"string"}
qualifierMessage={undefined}
schema={{"type":"string","nullable":true}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"ExternalKey"}
required={false}
schemaName={"string"}
qualifierMessage={undefined}
schema={{"type":"string","nullable":true}}
>
</SchemaItem><li>
<div
style={{"fontSize":"var(--ifm-code-font-size)","opacity":"0.6","marginLeft":"-.5rem"}}
>
]
</div>
</li>
</div>
</details>
</SchemaItem>
</ul>
</details>
</TabItem><TabItem
label={"Example (from schema)"}
value={"Example (from schema)"}
>
<ResponseSamples
responseExample={"{\n \"ContinuationToken\": \"string\",\n \"Items\": [\n {\n \"Guid\": \"string\",\n \"Revision\": 0,\n \"PersonCreated\": \"string\",\n \"PersonChanged\": \"string\",\n \"TimestampCreated\": \"2025-02-24T10:14:00Z\",\n \"TimestampChanged\": \"2025-02-24T10:14:00Z\",\n \"Name\": \"string\",\n \"Code\": \"string\",\n \"Type\": \"Work\",\n \"Default\": true,\n \"TimeEntry\": \"Optional\",\n \"Inactive\": true,\n \"Movement\": true,\n \"Icon\": \"string\",\n \"ExternalKey\": \"string\"\n }\n ]\n}"}
language={"json"}
>
</ResponseSamples>
</TabItem>
</SchemaTabs>
</TabItem>
</MimeTabs>
</div>
</TabItem><TabItem
label={"400"}
value={"400"}
>
<div>
Error
</div><div>
<MimeTabs
className={"openapi-tabs__mime"}
schemaType={"response"}
>
<TabItem
label={"application/json"}
value={"application/json"}
>
<SchemaTabs
className={"openapi-tabs__schema"}
>
<TabItem
label={"Schema"}
value={"Schema"}
>
<details
style={{}}
className={"openapi-markdown__details response"}
data-collapsed={false}
open={true}
>
<summary
style={{}}
className={"openapi-markdown__details-summary-response"}
>
<strong>
Schema
</strong>
</summary><div
style={{"textAlign":"left","marginLeft":"1rem"}}
>
</div><ul
style={{"marginLeft":"1rem"}}
>
<SchemaItem
collapsible={true}
className={"schemaItem"}
>
<details
style={{}}
className={"openapi-markdown__details"}
>
<summary
style={{}}
>
<span
className={"openapi-schema__container"}
>
<strong
className={"openapi-schema__property"}
>
Error
</strong><span
className={"openapi-schema__name"}
>
object
</span><span
className={"openapi-schema__divider"}
>
</span><span
className={"openapi-schema__required"}
>
required
</span>
</span>
</summary><div
style={{"marginLeft":"1rem"}}
>
<SchemaItem
collapsible={false}
name={"Code"}
required={false}
schemaName={"string"}
qualifierMessage={undefined}
schema={{"type":"string","nullable":true}}
>
</SchemaItem><SchemaItem
collapsible={false}
name={"Message"}
required={false}
schemaName={"string"}
qualifierMessage={undefined}
schema={{"type":"string","nullable":true}}
>
</SchemaItem>
</div>
</details>
</SchemaItem>
</ul>
</details>
</TabItem><TabItem
label={"Example (from schema)"}
value={"Example (from schema)"}
>
<ResponseSamples
responseExample={"{\n \"Error\": {\n \"Code\": \"string\",\n \"Message\": \"string\"\n }\n}"}
language={"json"}
>
</ResponseSamples>
</TabItem>
</SchemaTabs>
</TabItem>
</MimeTabs>
</div>
</TabItem>
</ApiTabs>
</div>
</div>
This is when I try to generate document with 4.2.0 and above
id: activities-get
title: "Get list of activities"
description: "Get list of activities"
sidebar_label: "Get list of activities"
hide_title: true
hide_table_of_contents: true
api: eJzFVttuGzcQ/RVinqmLBbcP+6Y4jmGkaYxYRYEaQkHtjiTGXJIhZwULwv57MdSutLIUR44L5EnQ8nDmzJkLZwOkFhGyBxjnpFeaNEaYSnAegyLt7G0BWefs3xskkOBVUCUSBr66AatKhAyunCVtq3Rv4h7RggRtIYNvFYY1SCgw5kF7PocMEkToKCxigYUUlTUYo1DGiIC5C0UUS7VCMUO0IiBVwWIhtBU+4Eq7KoqA3yqM1BfvnbCOxNyFBZIgJ7xKlqJL5hwtMYg96z5IiPkSSwXZBmjtmX6koO0CJNjKGDUzCBmFCmsJTz3vot7SvqinEgJG72zEyNdHwyH/HAZ3X+U5xggScmcJLTFEeW90nvQZfI2M23RoKGM+z5OeDSE3+4o5y62KInlX5i5wZlKWsrkyESX4zqfNiRz8OMBaAmniv/ClCeydigi1fBOVW8IydtyrENT6yLsE3eL2AnxfiqeemkUKKqf2+ouM2rju15Gw/KDRFPH/jPGm0sUpheculIoggwUDaglfcKWjdt10aEu4wNBFa0u/XzL8DkN09iqgIjzDwYmabSwslV38pIWJLjGSKv05NApF2CNd4okE45MqfUrDaDj6rTcc9UaXk4thdnGZDYf/wIGrM/i+xVXN3ftSUby+IHgG6cCcH+BPHoTT50WSvp4zZ65ccR5wkgA8c+aqMizK3y48ggRn8bBxdjYOx1PqJLRVydzS/G8MjGcRbc7SvguoHjkYhr2MaAVt3ol1oldPawnvW4I7QjPnDCrbZv3aUlgfhvLZb7V+UzgdIxNHyky29fIhuHLiulH9EHgquD3zFOWtVXyIp8P85FZYNi/A8elt7s6Z0RKunwiDVeYjrs+Z6fUxdY27MufZzN3wMiohJFyeeuCuQ3DhNc/bTzfV1tNRV20/v9bw89fyzIb7hDGqxTnYzmOaGG5fmedfDxSun5fzDZIwOpJwc6H2e5mEEmnpeCNbNGsYLSGDgfJ6sBoNxl1oxLBq97MqGMhgSeRjNhhsxnnuKkvcK3XfuAWS6+euBAkrFTTHksTpwA4b9KFzMm1masS8CprWyd847T6pUB+m3dN7road9Raz3xC85g+yXSj3mGaRXKIqMCQ5tZ27dLWR9Y8Uh/DVzOhcjO9uORwM2zcXRv1hf8jt5l2kUqXSbJx8V+yDnOw4Ej7RwBulU/cmZTdNIh44AHY74jF5sE8vXSQGbDYzFfGvYOqaP28XY5as0JGFL3aF+sz7rs1+9dp8UoZHTuPJ/X+lTMV44DJoyyuVhWyzyeFvDXC+PXVuHU0UtrJrgpvrCdT1fzzgaLw=
sidebar_class_name: "get api-method"
info_path: api/logeto-public-api
custom_edit_url: null
import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import ParamsDetails from "@theme/ParamsDetails";
import RequestSchema from "@theme/RequestSchema";
import StatusCodes from "@theme/StatusCodes";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
import Heading from "@theme/Heading";
<Heading
as={"h1"}
className={"openapi__heading"}
children={"Get list of activities"}
>
</Heading>
<MethodEndpoint
method={"get"}
path={"/api/v2/Activities"}
context={"endpoint"}
>
</MethodEndpoint>
Get list of activities
<Heading
id={"request"}
as={"h2"}
className={"openapi-tabs__heading"}
children={"Request"}
>
</Heading>
<ParamsDetails
parameters={[{"name":"ContinuationToken","in":"query","description":"Token is needed, unless all records have been returned in previous request. Do not forget to pass also all other parameters.","schema":{"type":"string","nullable":true},"x-position":1}]}
>
</ParamsDetails>
<RequestSchema
title={"Body"}
body={undefined}
>
</RequestSchema>
<StatusCodes
id={undefined}
label={undefined}
responses={{"200":{"description":"Success","content":{"application/json":{"schema":{"allOf":[{"type":"object","additionalProperties":false,"properties":{"ContinuationToken":{"type":"string","nullable":true}},"title":"ResponseBase"},{"type":"object","additionalProperties":false,"properties":{"Items":{"type":"array","nullable":true,"items":{"allOf":[{"allOf":[{"type":"object","x-abstract":true,"additionalProperties":false,"title":"SystemFieldsResponseBase"},{"type":"object","additionalProperties":false,"properties":{"Guid":{"type":"string","format":"guid"},"Revision":{"type":"integer","format":"int64"},"PersonCreated":{"type":"string","format":"guid","nullable":true},"PersonChanged":{"type":"string","format":"guid","nullable":true},"TimestampCreated":{"type":"string","format":"date-time","nullable":true,"example":"2025-02-24T10:14:00Z"},"TimestampChanged":{"type":"string","format":"date-time","nullable":true,"example":"2025-02-24T10:14:00Z"}}}],"title":"SystemFieldsResponse"},{"type":"object","additionalProperties":false,"required":["Name"],"properties":{"Name":{"type":"string","nullable":true},"Code":{"type":"string","nullable":true},"Type":{"default":"Work","oneOf":[{"type":"string","description":"","x-enumNames":["Work","Absence","Break"],"enum":["Work","Absence","Break"],"title":"ActivityType"}]},"Default":{"type":"boolean"},"TimeEntry":{"default":"Optional","oneOf":[{"type":"string","description":"","x-enumNames":["Optional","TotalTime","FromTo"],"enum":["Optional","TotalTime","FromTo"],"title":"ActivityTypeTimeEntry"}]},"Inactive":{"type":"boolean"},"Movement":{"type":"boolean"},"Icon":{"type":"string","nullable":true},"ExternalKey":{"type":"string","nullable":true}}}],"title":"ActivitiesResponseItem"}}}}],"title":"ActivitiesResponse"}}}},"400":{"description":"Error","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["Error"],"properties":{"Error":{"type":"object","additionalProperties":false,"properties":{"Code":{"type":"string","nullable":true},"Message":{"type":"string","nullable":true}},"title":"ErrorBase"}},"title":"ErrorResponse"}}}}}}
>
</StatusCodes>
This is our OpenAPI yaml https://filebin.net/8bpy8ggdysccr5u8
Are we doing something wrong or is this a bug?
Thanks a lot