SDK

Type-safe TypeScript client generated from the OpenAPI spec.

SDK

@vortex-api/pile exports an openapi-fetch client typed against the same openapi.json that generates MCP tools and CLI commands — paths, params, request bodies, and responses are all typechecked.

import { createPileClient } from "@vortex-api/pile";

const client = createPileClient({
  baseUrl: process.env.PILE_BASE_URL!, // https://<host>
  apiKey: process.env.PILE_API_KEY!, // workspace-scoped key
});

const { data, error } = await client.GET(
  "/workspaces/{organizationId}/issues",
  { params: { path: { organizationId: "org_..." } } }
);

const created = await client.POST("/workspaces/{organizationId}/documents", {
  params: { path: { organizationId: "org_..." } },
  body: { title: "Release notes", content: "…", contentFormat: "markdown" },
});

When to use which surface

All four authenticate identically and see the same entities, links, and comments — a doc created via MCP shows up in the SDK and the app.