Updates an existing request form's configuration including name, description, activation state, custom property
override options, and associated template settings. Request forms define the structure and fields for
work requests that users submit to initiate programs or tasks. This endpoint allows administrators to
modify form metadata and behavior without recreating the form or affecting existing requests created
with this form.
Key Features:
- Updates form display name and description for clarity in form selection interfaces
- Modifies form activation state to control availability for new request submissions
- Configures custom property overrides to tailor form fields for specific workflows
- Adjusts form template associations for request-to-program conversion patterns
- Preserves existing requests created with this form while updating the form definition
- Maintains form ID and relationships while updating configurable attributes
Authorization Logic:
- User must have a valid JWT (JSON Web Token - a secure, stateless authentication token) with management scopes
- User must have permission to manage request forms in the space
Usage Example:
Update a form's display name and activate it: Call PUT /v2/spaces/w5PmrE9p0kicqqRSVJ3VBQ/forms/yS86zRG7smz7NVwdUEyJSj
with request body {"name": "Q1 Product Launch Request", "activated": true} to rename the form and make it available for users to submit requests. Deactivate a seasonal form by setting activated to false when the campaign period ends.