Beautiful Open-Source Form Builder
Optimize API form list endpoint to return lightweight summaries, excluding properties for improved performance. Update documentation to reflect changes and remove deprecated endpoints. Add changelog entry for significant API updates.
Julien Nahum5a1d86c44f94
diff --git a/.cursor/rules/docs.mdc b/.cursor/rules/docs.mdcindex 72c78b7ed..fc2ecefe0 100644--- a/.cursor/rules/docs.mdc+++ b/.cursor/rules/docs.mdc@@ -363,6 +363,34 @@ When adding a new API endpoint to the documentation, you must update multiple fiExample workflow: When adding a new workspace forms endpoint, you would create `docs/api-reference/forms/list-workspace-forms.mdx`, add it to the Forms group in `docs.json`, add the path definition to `openapi.yaml`, and add the route to `sanctum-routes.php` if needed.+### Updating the API changelog++For significant API documentation changes, update `docs/api-reference/changelog.mdx` to inform API consumers:++**Always update the changelog for:**++- New API endpoints+- Breaking changes (removed fields, changed response formats)+- Deprecated endpoints or features+- Changes to authentication or permissions+- Performance optimizations that affect response structure++**Changelog entry format:**++```markdown+## YYYY-MM-DD – Brief description++Summary of what changed and why.++### What changed++- Bullet points of specific changes++### Migration guide (if breaking)++Code examples showing before/after usage+```+### Accessibility requirements- Include descriptive alt text for all images and diagramsdiff --git a/api/app/Http/Controllers/Forms/FormController.php b/api/app/Http/Controllers/Forms/FormController.phpindex e6a501bd0..5520a48cf 100644--- a/api/app/Http/Controllers/Forms/FormController.php+++ b/api/app/Http/Controllers/Forms/FormController.php@@ -6,6 +6,7 @@ use App\Http\Controllers\Controller;use App\Http\Requests\StoreFormRequest;use App\Http\Requests\UpdateFormRequest;use App\Http\Requests\UploadAssetRequest;+use App\Http\Resources\FormListResource;use App\Http\Resources\FormResource;use App\Models\Forms\Form;use App\Models\Forms\FormSubmission;@@ -35,21 +36,28 @@ class FormController extends Controller$this->authorize('ownsWorkspace', $workspace);$this->authorize('viewAny', Form::class);+ // Select only columns needed for FormListResource (excludes heavy 'properties' and 'removed_properties')$forms = $workspace->forms()- ->with(['workspace.users' => fn ($q) => $q->withPivot('role')])- ->withCount(['submissions as submissions_count' => fn ($q) => $q->where('status', FormSubmission::STATUS_COMPLETED)])+ ->select([+ 'id',+ 'slug',+ 'title',+ 'visibility',+ 'tags',+ 'closes_at',+ 'max_submissions_count',+ 'workspace_id',+ 'custom_domain',+ 'created_at',+ 'updated_at',+ ])+ ->with(['workspace'])+ ->withCount(['submissions as submissions_count' => fn($q) => $q->where('status', FormSubmission::STATUS_COMPLETED)])->withTotalViews()->orderByDesc('updated_at')->paginate(10);- $formCollection = FormResource::collection($forms);- $formCollection->each(function ($formResource) {- $formResource->setCleanings(- $this->formCleaner->processForm(request(), $formResource->resource)->simulateCleaning($formResource->resource->workspace)->getPerformedCleanings()- );- });-- return $formCollection;+ return FormListResource::collection($forms);}public function show(Form $form)diff --git a/api/app/Http/Resources/FormListResource.php b/api/app/Http/Resources/FormListResource.phpnew file mode 100644index 000000000..d36bc7e00--- /dev/null+++ b/api/app/Http/Resources/FormListResource.php@@ -0,0 +1,41 @@+<?php++namespace App\Http\Resources;++use Illuminate\Http\Resources\Json\JsonResource;++/**+ * Lightweight resource for form list endpoints.+ * Excludes heavy fields like `properties` and `removed_properties` to reduce response size.+ */+class FormListResource extends JsonResource+{+ /**+ * Transform the resource into an array.+ *+ * @param \Illuminate\Http\Request $request+ * @return array+ */+ public function toArray($request)+ {+ return [+ 'id' => $this->id,+ 'slug' => $this->slug,+ 'title' => $this->title,+ 'visibility' => $this->visibility,+ 'tags' => $this->tags,+ 'views_count' => $this->views_count,+ 'submissions_count' => $this->submissions_count,+ 'created_at' => $this->created_at?->toIso8601String(),+ 'updated_at' => $this->updated_at?->toIso8601String(),+ 'last_edited_human' => $this->updated_at?->diffForHumans(),+ 'closes_at' => $this->closes_at,+ 'is_closed' => $this->is_closed,+ 'max_submissions_count' => $this->max_submissions_count,+ 'max_number_of_submissions_reached' => $this->max_number_of_submissions_reached,+ 'is_pro' => $this->workspace->is_pro ?? false,+ 'workspace_id' => $this->workspace_id,+ 'share_url' => $this->share_url,+ ];+ }+}diff --git a/api/tests/Feature/Forms/FormTest.php b/api/tests/Feature/Forms/FormTest.phpindex f6a1bee77..a8a59d11e 100644--- a/api/tests/Feature/Forms/FormTest.php+++ b/api/tests/Feature/Forms/FormTest.php@@ -34,6 +34,49 @@ it('can fetch forms', function () {->assertJsonPath('data.0.title', $form->title);});+it('returns lightweight form list without properties', function () {+ $user = $this->actingAsUser();+ $workspace = $this->createUserWorkspace($user);+ $form = $this->createForm($user, $workspace);++ $response = $this->getJson(route('open.workspaces.forms.index', $workspace->id))+ ->assertSuccessful();++ // Verify expected FormListResource fields are present+ $response->assertJsonStructure([+ 'data' => [+ '*' => [+ 'id',+ 'slug',+ 'title',+ 'visibility',+ 'tags',+ 'views_count',+ 'submissions_count',+ 'created_at',+ 'updated_at',+ 'last_edited_human',+ 'closes_at',+ 'is_closed',+ 'max_submissions_count',+ 'max_number_of_submissions_reached',+ 'is_pro',+ 'workspace_id',+ 'share_url',+ ],+ ],+ ]);++ // Verify heavy 'properties' field is NOT included (key optimization)+ $response->assertJsonMissingPath('data.0.properties');+ $response->assertJsonMissingPath('data.0.removed_properties');++ // Verify timestamps are ISO 8601 format+ $formData = $response->json('data.0');+ expect($formData['created_at'])->toMatch('/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\+\d{2}:\d{2}$/');+ expect($formData['updated_at'])->toMatch('/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\+\d{2}:\d{2}$/');+});+it('can fetch a form', function () {$user = $this->actingAsProUser();$workspace = $this->createUserWorkspace($user);diff --git a/client/components/users/settings/two-factor-auth/TwoFactorAuth.vue b/client/components/users/settings/two-factor-auth/TwoFactorAuth.vuedeleted file mode 100644index b5c8bc33a..000000000--- a/client/components/users/settings/two-factor-auth/TwoFactorAuth.vue+++ /dev/null@@ -1,213 +0,0 @@-<template>- <div class="space-y-4">- <div>- <h3 class="text-lg font-medium text-neutral-900">Two-Factor Authentication</h3>- <p class="text-sm text-neutral-500 mt-1">- Add an extra layer of security to your account using an authenticator app.- </p>- </div>-- <!-- 2FA Status -->- <div v-if="twoFactorEnabled" class="space-y-4">- <UAlert- color="success"- variant="subtle"- icon="i-heroicons-check-circle"- description="Two-factor authentication is enabled on your account."- />-- <div class="flex gap-2">- <UButton- color="neutral"- variant="outline"- @click="openRecoveryCodesModal"- >- View Recovery Codes- </UButton>- <UButton- color="neutral"- variant="outline"- @click="showDisableModal = true"- >- Disable 2FA- </UButton>- </div>- </div>-- <!-- Enable 2FA Flow -->- <TwoFactorEnableFlow- v-else- :enabling="enabling2FA"- :confirming="confirming2FA"- :secret="twoFactorSecret"- :qr-code="twoFactorQrCode"- @enable="enableTwoFactor"- @confirm="confirmTwoFactor"- />-- <!-- Recovery Codes Modal -->- <RecoveryCodesModal- :show="showRecoveryCodesModal"- :codes="recoveryCodesList"- :loading="loadingRecoveryCodes"- :regenerating="regeneratingCodes"- :just-regenerated="justRegenerated"- @close="closeRecoveryCodesModal"- @load="loadRecoveryCodesWithPassword"- @regenerate="handleRegenerateRecoveryCodes"- @copy="copyRecoveryCodes"- />-- <!-- Disable 2FA Modal -->- <DisableTwoFactorModal- :show="showDisableModal"- :loading="disabling2FA"- @close="closeDisableModal"- @disable="disableTwoFactor"- />- </div>-</template>--<script setup>-import { useTwoFactor } from '~/composables/query/useTwoFactor'-import TwoFactorEnableFlow from './TwoFactorEnableFlow.vue'-import RecoveryCodesModal from './RecoveryCodesModal.vue'-import DisableTwoFactorModal from './DisableTwoFactorModal.vue'--const alert = useAlert()-const auth = useAuth()-const { data: user } = auth.user()--// Two-Factor Authentication-const { enable, confirm, disable, recoveryCodes: getRecoveryCodes, regenerateRecoveryCodes } = useTwoFactor()--const twoFactorEnabled = computed(() => user.value?.two_factor_enabled ?? false)-const twoFactorSecret = ref(null)-const twoFactorQrCode = ref(null)-const recoveryCodesList = ref([])-const showRecoveryCodesModal = ref(false)-const showDisableModal = ref(false)--const enabling2FA = ref(false)-const confirming2FA = ref(false)-const disabling2FA = ref(false)-const loadingRecoveryCodes = ref(false)-const regeneratingCodes = ref(false)-const justRegenerated = ref(false)--const enableMutation = enable()-const confirmMutation = confirm()-const disableMutation = disable()-const recoveryCodesMutation = getRecoveryCodes()-const regenerateMutation = regenerateRecoveryCodes()--const enableTwoFactor = async () => {- enabling2FA.value = true- try {- const response = await enableMutation.mutateAsync()- twoFactorSecret.value = response.secret- twoFactorQrCode.value = response.qr_code- } catch (error) {- alert.error(error.response?._data?.message || 'Failed to enable two-factor authentication')- } finally {- enabling2FA.value = false- }-}--const confirmTwoFactor = async (code) => {- confirming2FA.value = true- try {- const response = await confirmMutation.mutateAsync({ code })-- recoveryCodesList.value = response.recovery_codes || []- twoFactorSecret.value = null- twoFactorQrCode.value = null-- // Refresh user data- await auth.invalidateUser()-- // Show recovery codes modal automatically after enabling- justRegenerated.value = false- showRecoveryCodesModal.value = true-- alert.success('Two-factor authentication has been enabled successfully.')- } catch (error) {- alert.error(error.response?._data?.message || error.response?._data?.errors?.code?.[0] || 'Invalid code. Please try again.')- } finally {- confirming2FA.value = false- }-}--const disableTwoFactor = async (code) => {- disabling2FA.value = true- try {- await disableMutation.mutateAsync({ code })-- showDisableModal.value = false-- // Refresh user data- await auth.invalidateUser()-- alert.success('Two-factor authentication has been disabled.')- } catch (error) {- alert.error(error.response?._data?.message || error.response?._data?.errors?.code?.[0] || 'Invalid code. Please try again.')- } finally {- disabling2FA.value = false- }-}--const openRecoveryCodesModal = () => {- recoveryCodesList.value = []- justRegenerated.value = false- showRecoveryCodesModal.value = true-}--const closeRecoveryCodesModal = () => {- showRecoveryCodesModal.value = false-}--const closeDisableModal = () => {- showDisableModal.value = false-}--const loadRecoveryCodesWithPassword = async (password) => {- loadingRecoveryCodes.value = true- try {- const response = await recoveryCodesMutation.mutateAsync({ password })- recoveryCodesList.value = response.recovery_codes || []- } catch (error) {- alert.error(error.response?._data?.message || error.response?._data?.errors?.password?.[0] || 'Failed to load recovery codes')- } finally {- loadingRecoveryCodes.value = false- }-}--const handleRegenerateRecoveryCodes = async () => {- regeneratingCodes.value = true- try {- const response = await regenerateMutation.mutateAsync()- recoveryCodesList.value = response.recovery_codes || []- justRegenerated.value = true- alert.success('Recovery codes have been regenerated. Please save them in a safe place.')- } catch (error) {- alert.error(error.response?._data?.message || 'Failed to regenerate recovery codes')- } finally {- regeneratingCodes.value = false- }-}--const copyRecoveryCodes = async () => {- try {- // Extract just the codes from objects- const codes = recoveryCodesList.value.map(item =>- typeof item === 'string' ? item : item.code- )- const codesText = codes.join('\n')- await navigator.clipboard.writeText(codesText)- alert.success('Recovery codes copied to clipboard')- } catch {- alert.error('Failed to copy recovery codes')- }-}-</script>-diff --git a/client/composables/query/forms/useFormsList.js b/client/composables/query/forms/useFormsList.jsindex 3130d2f30..51023a71a 100644--- a/client/composables/query/forms/useFormsList.js+++ b/client/composables/query/forms/useFormsList.js@@ -7,22 +7,13 @@ export function useFormsList(workspaceId, options = {}) {// Separate API filters and custom options from TanStack Query optionsconst { fetchAll, ...queryOptions } = options- const queryClient = useQueryClient()-const query = useInfiniteQuery({queryKey: computed(() => ['forms', 'list', workspaceId.value]),queryFn: ({ pageParam = 1 }) => {const apiFilters = { page: pageParam }- return formsApi.list(workspaceId.value, { params: apiFilters }).then(res => {- // Prime cache for each form- res?.data?.forEach(form => {- queryClient.setQueryData(['forms', form.id], form)- if (form.slug) {- queryClient.setQueryData(['forms', 'slug', form.slug], form)- }- })- return res- })+ // Note: List endpoint returns lightweight form data (no properties).+ // Individual form detail queries will fetch the full form when needed.+ return formsApi.list(workspaceId.value, { params: apiFilters })},initialPageParam: 1,getNextPageParam: (lastPage) => {diff --git a/client/package-lock.json b/client/package-lock.jsonindex 967654a62..55811b72a 100644--- a/client/package-lock.json+++ b/client/package-lock.json@@ -63,11 +63,13 @@"webcam-easy": "^1.1.1"},"devDependencies": {+ "@iconify-json/bxl": "^1.2.2","@iconify-json/clarity": "^1.2.1",+ "@iconify-json/devicon": "^1.2.56","@iconify-json/heroicons": "^1.2.2","@iconify-json/ic": "^1.2.1","@iconify-json/ix": "^1.2.10",- "@iconify-json/lucide": "^1.2.74",+ "@iconify-json/lucide": "^1.2.82","@iconify-json/octicon": "^1.2.1","@iconify-json/tabler": "^1.2.1","@nuxt/eslint-config": "^1.3.0",@@ -1794,6 +1796,16 @@"url": "https://github.com/sponsors/nzakas"}},+ "node_modules/@iconify-json/bxl": {+ "version": "1.2.2",+ "resolved": "https://registry.npmjs.org/@iconify-json/bxl/-/bxl-1.2.2.tgz",+ "integrity": "sha512-+cSX1abFQ2Q8jK9IdLHC05luZYq3zgNFqXsiEcKyigUdIEmGQNQp4xjnsCUmOYFvHrV7C1/D0wr/Lm/stAD3tw==",+ "dev": true,+ "license": "CC-BY-4.0",+ "dependencies": {+ "@iconify/types": "*"+ }+ },"node_modules/@iconify-json/clarity": {"version": "1.2.2","resolved": "https://registry.npmjs.org/@iconify-json/clarity/-/clarity-1.2.2.tgz",@@ -1804,6 +1816,16 @@"@iconify/types": "*"}},+ "node_modules/@iconify-json/devicon": {+ "version": "1.2.56",+ "resolved": "https://registry.npmjs.org/@iconify-json/devicon/-/devicon-1.2.56.tgz",+ "integrity": "sha512-4HYxc/MXcIgaAbs9h27asp+JyUlGs/F1uPxkYeVdHCxopxRYi1f+U10zmjCzkzhdCACgHbG7Jg8w4zeGS9OxlA==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "@iconify/types": "*"+ }+ },"node_modules/@iconify-json/heroicons": {"version": "1.2.2","resolved": "https://registry.npmjs.org/@iconify-json/heroicons/-/heroicons-1.2.2.tgz",@@ -1835,9 +1857,9 @@}},"node_modules/@iconify-json/lucide": {- "version": "1.2.74",- "resolved": "https://registry.npmjs.org/@iconify-json/lucide/-/lucide-1.2.74.tgz",- "integrity": "sha512-vDoGHcDZdWgUbt9J3TCJlxFzX/Mw0vUIAoZdkfI2mINOi1/cgVZHivgZ8QtiGlepskTL3PcG8t93Ky/vtQgXGA==",+ "version": "1.2.82",+ "resolved": "https://registry.npmjs.org/@iconify-json/lucide/-/lucide-1.2.82.tgz",+ "integrity": "sha512-fHZWegspOZonl5GNTvOkHsjnTMdSslFh3EzpzUtRyLxO8bOonqk2OTU3hCl0k4VXzViMjqpRK3X1sotnuBXkFA==","dev": true,"license": "ISC","dependencies": {diff --git a/client/package.json b/client/package.jsonindex 9c024abc9..196400d48 100644--- a/client/package.json+++ b/client/package.json@@ -15,11 +15,13 @@"test:ui": "VITEST=true vitest --ui"},"devDependencies": {+ "@iconify-json/bxl": "^1.2.2","@iconify-json/clarity": "^1.2.1",+ "@iconify-json/devicon": "^1.2.56","@iconify-json/heroicons": "^1.2.2","@iconify-json/ic": "^1.2.1","@iconify-json/ix": "^1.2.10",- "@iconify-json/lucide": "^1.2.74",+ "@iconify-json/lucide": "^1.2.82","@iconify-json/octicon": "^1.2.1","@iconify-json/tabler": "^1.2.1","@nuxt/eslint-config": "^1.3.0",diff --git a/docs/api-reference/changelog.mdx b/docs/api-reference/changelog.mdxindex a3256be1c..4563b082e 100644--- a/docs/api-reference/changelog.mdx+++ b/docs/api-reference/changelog.mdx@@ -3,6 +3,52 @@ title: "Changelog"description: "Notable updates to the OpnForm API."---+## 2025-01-02 – Optimized form list endpoint++The form list endpoint now returns **lightweight form summaries** for improved performance:++* `GET /open/workspaces/{workspaceId}/forms`++<Info>+The deprecated `GET /open/forms` endpoint (which lists all forms across workspaces) has been removed from the documentation. It remains available for existing Zapier integrations but is not recommended for new implementations.+</Info>++### What changed++This endpoint no longer includes the `properties` array (form fields and blocks) in the response. This significantly reduces response size and improves load times, especially for workspaces with many forms or complex form structures.++### Response fields++The list endpoint now returns these fields:++| Field | Description |+|-------|-------------|+| `id`, `slug`, `title`, `visibility`, `tags` | Core form identification |+| `views_count`, `submissions_count` | Form statistics |+| `created_at`, `updated_at`, `last_edited_human` | Timestamps (ISO 8601 + human-readable) |+| `closes_at`, `is_closed` | Form closure status |+| `max_submissions_count`, `max_number_of_submissions_reached` | Submission limits |+| `is_pro`, `workspace_id`, `share_url` | Workspace and sharing info |++### Migration guide++If your integration relies on `properties` from list endpoints, update your code to:++1. Fetch the form list to get form IDs/slugs+2. Call `GET /open/forms/{slug}` for each form where you need the full `properties` array++```javascript+// Before: properties were included in list response+const forms = await fetch('/open/workspaces/1/forms');++// After: fetch full form details when needed+const formList = await fetch('/open/workspaces/1/forms');+const fullForm = await fetch(`/open/forms/${formList.data[0].slug}`);+// fullForm.properties is now available+```++---+## 2024-06-18 – API creation 🎉The first public version of the OpnForm REST API is live! You can now:diff --git a/docs/api-reference/forms/list-forms.mdx b/docs/api-reference/forms/list-forms.mdxdeleted file mode 100644index 03ed8d69f..000000000--- a/docs/api-reference/forms/list-forms.mdx+++ /dev/null@@ -1,49 +0,0 @@-----openapi: get /open/forms------# List Forms (Deprecated)--<Warning>-**Deprecated**: This endpoint is deprecated. Use [List Workspace Forms](./list-workspace-forms) instead to retrieve forms for a specific workspace.-</Warning>--Retrieve every form accessible to the authenticated user across **all** of their workspaces.--## Authentication & Scope--This request must be authenticated using a **Personal Access Token** that includes the `forms-read` ability.--```http-Authorization: Bearer <token>-```--## Request--```http-GET /open/forms HTTP/1.1-Host: api.opnform.com-Authorization: Bearer <token>-```--There are no query parameters for this endpoint.--## Response--`200 OK` – Returns a JSON array of Form objects.--```json-[- {- "id": 42,- "slug": "customer-feedback",- "title": "Customer Feedback",- "visibility": "public",- "properties": [- /* form fields & layout blocks */- ]- }-]-```--`403 Forbidden` – The token does not include the required `forms-read` ability.\ No newline at end of filediff --git a/docs/api-reference/forms/list-workspace-forms.mdx b/docs/api-reference/forms/list-workspace-forms.mdxindex edfc936ca..4fe265c1d 100644--- a/docs/api-reference/forms/list-workspace-forms.mdx+++ b/docs/api-reference/forms/list-workspace-forms.mdx@@ -4,6 +4,10 @@ openapi: get /open/workspaces/{workspaceId}/formsRetrieve all forms within a specific workspace.+<Info>+This endpoint returns **lightweight form summaries** optimized for listing. The `properties` array (form fields and blocks) is excluded to reduce response size. Use the [Get Form](./get-form) endpoint to retrieve the complete form with all fields.+</Info>+## Authentication & ScopeThis request must be authenticated using a **Personal Access Token** that includes the `forms-read` ability.@@ -34,7 +38,7 @@ Authorization: Bearer <token>## Response-`200 OK` – Returns a paginated JSON response containing Form objects.+`200 OK` – Returns a paginated JSON response containing lightweight form summaries.```json{@@ -44,18 +48,33 @@ Authorization: Bearer <token>"slug": "customer-feedback","title": "Customer Feedback","visibility": "public",+ "tags": ["feedback", "support"],+ "views_count": 1250,"submissions_count": 15,- "properties": [- /* form fields & layout blocks */- ]+ "created_at": "2024-11-15T10:30:00+00:00",+ "updated_at": "2025-01-02T14:25:00+00:00",+ "last_edited_human": "2 hours ago",+ "closes_at": null,+ "is_closed": false,+ "max_submissions_count": null,+ "max_number_of_submissions_reached": false,+ "is_pro": true,+ "workspace_id": 1,+ "share_url": "https://opnform.com/forms/customer-feedback"}],- "current_page": 1,- "per_page": 10,- "total": 1+ "meta": {+ "current_page": 1,+ "per_page": 10,+ "total": 1+ }}```+<Tip>+To get the full form including fields (`properties`), call the [Get Form](./get-form) endpoint with the form's `slug` or `id`.+</Tip>+`403 Forbidden` – The token does not include the required `forms-read` ability, or you do not have access to the workspace.`404 Not Found` – The workspace does not exist.diff --git a/docs/api-reference/openapi.yaml b/docs/api-reference/openapi.yamlindex 9f417b38a..4146c94b4 100644--- a/docs/api-reference/openapi.yaml+++ b/docs/api-reference/openapi.yaml@@ -367,7 +367,7 @@ paths:tags:- Formssummary: List Workspace Forms- description: "Retrieve all forms within a specific workspace. Requires `forms-read` ability."+ description: "Retrieve all forms within a specific workspace. Returns lightweight form summaries (excludes `properties`). Use the Get Form endpoint to retrieve the full form with all fields. Requires `forms-read` ability."security:- bearerAuth: []parameters:@@ -396,7 +396,7 @@ paths:data:type: arrayitems:- $ref: "#/components/schemas/Form"+ $ref: "#/components/schemas/FormListItem"links:type: objectproperties:@@ -434,7 +434,7 @@ paths:tags:- Formssummary: List Forms- description: "Retrieve all forms accessible to the token holder across all workspaces. **Deprecated**: Use `/open/workspaces/{workspaceId}/forms` instead."+ description: "Retrieve all forms accessible to the token holder across all workspaces. Returns lightweight form summaries (excludes `properties`). **Deprecated**: Use `/open/workspaces/{workspaceId}/forms` instead."deprecated: truesecurity:- bearerAuth: []@@ -446,7 +446,7 @@ paths:schema:type: arrayitems:- $ref: "#/components/schemas/Form"+ $ref: "#/components/schemas/FormListItem""403":description: Forbidden – token lacks forms-read abilitypost:@@ -1362,6 +1362,73 @@ components:description: An array of field and layout blocks that make up the form.items:$ref: "#/components/schemas/FormProperty"+ FormListItem:+ type: object+ description: A lightweight form summary returned by list endpoints. Use the Get Form endpoint to retrieve full form details including properties.+ properties:+ id:+ type: number+ description: The unique identifier for the form.+ readOnly: true+ slug:+ type: string+ description: The URL-friendly slug for the form.+ readOnly: true+ title:+ type: string+ description: The title of the form.+ visibility:+ type: string+ enum: [public, draft, closed]+ description: The current visibility state of the form.+ tags:+ type: array+ items:+ type: string+ nullable: true+ views_count:+ type: number+ description: Total number of form views.+ submissions_count:+ type: number+ description: Total number of completed submissions.+ created_at:+ type: string+ format: date-time+ description: ISO 8601 timestamp of when the form was created.+ updated_at:+ type: string+ format: date-time+ description: ISO 8601 timestamp of when the form was last modified.+ last_edited_human:+ type: string+ description: Human-readable time since last edit (e.g., "2 hours ago").+ closes_at:+ type: string+ format: date-time+ nullable: true+ description: When the form will close for submissions.+ is_closed:+ type: boolean+ description: Whether the form is currently closed.+ max_submissions_count:+ type: integer+ minimum: 1+ nullable: true+ description: Maximum number of submissions allowed.+ max_number_of_submissions_reached:+ type: boolean+ description: Whether the submission limit has been reached.+ is_pro:+ type: boolean+ description: Whether the form's workspace has a Pro subscription.+ workspace_id:+ type: number+ description: ID of the workspace that owns the form.+ share_url:+ type: string+ format: uri+ description: Public URL to share the form.FormProperty:type: objectdescription: A single field or layout block within a form.diff --git a/docs/docs.json b/docs/docs.jsonindex 6b96b85ad..fcf71cc36 100644--- a/docs/docs.json+++ b/docs/docs.json@@ -67,7 +67,6 @@"group": "Forms","pages": ["api-reference/forms/list-workspace-forms",- "api-reference/forms/list-forms","api-reference/forms/create-form","api-reference/forms/get-form","api-reference/forms/update-form",