Formspark Management API preview

Unofficial Octri preview. Built from Formspark’s public Management API OpenAPI 1.0.0 document. It covers four read operations: workspaces, forms, form submissions, and workspace submissions. The Management API differs from the public form-submission endpoint.

Get the generated TypeScript SDK

Download TypeScript SDK v1.0.0. Unzip, run npm install and npm run build in the package directory. This preview is downloadable; it is not published to npm.

Create a Management API token in the Formspark dashboard. Token access follows its owner's workspace membership. Forms and submissions require a paid workspace plan. Do not put the token in browser code.

import { Formspark } from "formspark-octri-preview-sdk";
const client = new Formspark({
  baseUrl: "https://api.formspark.io/public/v1",
  auth: { bearerAuth: process.env.API_TOKEN! },
});
const workspaces = await client.workspaces.list({ limit: 25 });
const forms = await client.forms.list({ workspaceId: "your-workspace-id", limit: 25 });
const submissions = await client.submissions.list({ formId: "your-form-id", limit: 25 });
const next = submissions.nextCursor;
if (next) await client.submissions.list({ formId: "your-form-id", startingAfter: next });

Submission data has arbitrary customer-defined keys, represented as Record<string, unknown>. The SDK does not infer a fixed field schema. Use client.submissions.list2({ workspaceId: "your-workspace-id" }) for workspace-wide submissions.

Scope and validation

Downloaded ZIP compiled with TypeScript. A local synthetic HTTP mock verified bearer auth, custom base URL, paths, workspace ID, cursors, dynamic submission data, and a typed 403. No live Formspark API calls or real customer data were used. This preview has no tested automatic spec synchronization. Use the endpoint reference for request and response shapes.