Get request forms

Retrieves a filtered and paginated list of request forms configured within the specified space. Request forms are structured templates that define how users submit requests for content, programs, tasks, or other initiatives, enabling standardized intake processes and self-service workflows. This endpoint supports filtering by form name, activation status, and cursor-based pagination for efficiently navigating large form libraries.

Key Features:

• Query forms using flexible filtering: search by name substring (case-insensitive), filter by activation status (activated=true/false)
• Control payload size and response detail with includeCustomProperties flag to include or exclude custom field definitions
• Navigate large form collections efficiently with cursor-based pagination using limit and cursor parameters
• Results automatically filtered based on user's space access permissions ensuring proper security boundaries
• Returns comprehensive form metadata including formId, name, activation status, creation/update timestamps, and optional custom properties

Common Use Cases:

• Display available request forms in user-facing form selection interfaces for content requests, program proposals, or task submissions
• Administrative form management: retrieve all forms (activated and deactivated) for configuration, auditing, or lifecycle management
• Search for specific forms: use name parameter to find forms like 'Content Request' or 'Marketing Campaign Proposal' by partial name matching
• Discover active forms only: filter with activated=true to show forms currently available for end-user request submission
• Form library management: retrieve all forms with includeCustomProperties=true to analyze field structures, validation rules, and metadata schemas across the organization

Practical Examples:

• Retrieve active forms for dropdown: GET /v2/spaces/w5PmrE9p0kicqqRSVJ3VBQ/forms?activated=true&limit=50 returns first 50 active forms users can submit requests with
• Search for content-related forms: GET /v2/spaces/w5PmrE9p0kicqqRSVJ3VBQ/forms?name=Content&limit=20 finds all forms with 'Content' in the name (e.g., 'Content Request Form', 'Content Approval Form')
• Admin view of all forms: GET /v2/spaces/w5PmrE9p0kicqqRSVJ3VBQ/forms?includeCustomProperties=true&limit=100 retrieves comprehensive form data including custom property definitions for management dashboards
• Paginate through large form libraries: First request returns cursor='abc123xyz', next request uses ?cursor=abc123xyz&limit=50 to fetch subsequent pages

Response Interpretation:

• RequestFormQueryResponse contains 'count' (forms in current page), 'cursor' (pagination token for next page, null when no more results), 'items' (array of RequestForm objects), and optional metadata
• Check cursor in response: if null, you've retrieved all matching forms; if non-null, pass it to next request to continue pagination
• Each form in 'items' includes formId (unique identifier), name (display name), activated (availability status), createdAt/updatedAt timestamps, and optionally custom property definitions if includeCustomProperties=true was specified

Authorization Logic:

1. User must have valid JWT token with seismic.programs.view or seismic.programs.manage scope
2. Results automatically filtered to forms user has permission to view based on space roles and form visibility settings
3. Forms marked as private or restricted may be filtered from results based on user's permission level