Skip to content

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

fix(docs): Fix API reference OpenAPI pages not loading

sohamganatra9765275df445
diff --git a/docs/app/(home)/reference/[[...slug]]/page.tsx b/docs/app/(home)/reference/[[...slug]]/page.tsx
index 0dcc6ade5..6d70444a8 100644
--- a/docs/app/(home)/reference/[[...slug]]/page.tsx
+++ b/docs/app/(home)/reference/[[...slug]]/page.tsx
@@ -1,5 +1,5 @@
import type { ComponentType } from 'react';
-import { referenceSource, getOgImageUrl } from '@/lib/source';
+import { getReferenceSource, getOgImageUrl } from '@/lib/source';
import { APIPage } from '@/components/api-page';
import {
DocsBody,
@@ -25,6 +25,7 @@ export default async function Page({
params: Promise<{ slug?: string[] }>;
}) {
const { slug } = await params;
+ const referenceSource = await getReferenceSource();
const page = referenceSource.getPage(slug);
if (!page) notFound();
@@ -54,7 +55,8 @@ export default async function Page({
<DocsBody>
<MDX
components={getMDXComponents({
- a: createRelativeLink(referenceSource, page),
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
+ a: createRelativeLink(referenceSource as any, page),
})}
/>
</DocsBody>
@@ -62,7 +64,8 @@ export default async function Page({
);
}
-export function generateStaticParams() {
+export async function generateStaticParams() {
+ const referenceSource = await getReferenceSource();
return referenceSource.generateParams();
}
@@ -85,6 +88,7 @@ export async function generateMetadata({
};
}
+ const referenceSource = await getReferenceSource();
const page = referenceSource.getPage(slug);
if (!page) notFound();
diff --git a/docs/app/llms.mdx/[[...slug]]/route.ts b/docs/app/llms.mdx/[[...slug]]/route.ts
index 15d1d60ef..898d1c3ca 100644
--- a/docs/app/llms.mdx/[[...slug]]/route.ts
+++ b/docs/app/llms.mdx/[[...slug]]/route.ts
@@ -1,6 +1,6 @@
import {
source,
- referenceSource,
+ getReferenceSource,
examplesSource,
toolkitsSource,
getLLMText,
@@ -374,9 +374,9 @@ async function openapiPageToMarkdown(
}
// Map URL prefixes to their sources
+// Note: 'reference' is handled specially below with async getReferenceSource()
const sources = [
{ prefix: 'docs', source },
- { prefix: 'reference', source: referenceSource },
{ prefix: 'examples', source: examplesSource },
{ prefix: 'toolkits', source: toolkitsSource },
];
@@ -430,14 +430,21 @@ export async function GET(
const { slug = [] } = await params;
const [prefix, ...rest] = slug;
- // Find the matching source
- const match = sources.find((s) => s.prefix === prefix);
- if (!match) notFound();
+ // Handle 'reference' specially - uses async getReferenceSource() for OpenAPI pages
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
+ let pageSource: any;
+ if (prefix === 'reference') {
+ pageSource = await getReferenceSource();
+ } else {
+ const match = sources.find((s) => s.prefix === prefix);
+ if (!match) notFound();
+ pageSource = match.source;
+ }
// Get the page from that source (MDX pages)
let page;
try {
- page = match.source.getPage(rest.length > 0 ? rest : undefined);
+ page = pageSource.getPage(rest.length > 0 ? rest : undefined);
} catch (e) {
console.error('Error in getPage:', e);
page = null;
@@ -512,12 +519,10 @@ export async function GET(
throw e;
}
console.error('Unexpected error in llms.mdx route:', e);
- const errorMessage = e instanceof Error ? e.message : String(e);
- const errorStack = e instanceof Error ? e.stack : '';
return new Response(
- `# Error\n\nAn error occurred while generating the markdown content.\n\n**Error:** ${errorMessage}\n\n**Stack:**\n\`\`\`\n${errorStack}\n\`\`\``,
+ `# Error\n\nAn error occurred while generating the markdown content.`,
{
- status: 200, // Return 200 so we can see the error
+ status: 500,
headers: {
'Content-Type': 'text/markdown; charset=utf-8',
},