> ## Documentation Index
> Fetch the complete documentation index at: https://developers.logicgate.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Find by step (GET /api/v1/form/sections)

> **Permissions:** Authenticated User

Retrieve all sections configured on the identified step.



## OpenAPI

````yaml GET /api/v1/form/sections
openapi: 3.1.0
info:
  title: Risk Cloud API
  description: >-
    The Risk Cloud API is a collection of RESTful API endpoints that empower you
    and your team to directly integrate, automate, and build with the Risk
    Cloud. Risk Cloud API endpoint payloads are JSON based, with some endpoints
    supporting exports in CSV and XSLX formats for flexible integration.


    This API documentation showcases our Risk Cloud API v1, containing a variety
    of endpoints with continued support for enabling integrations with the Risk
    Cloud.


    Visit the [LogicGate Risk Cloud Developer
    Portal](https://www.logicgate.com/developer/) to get started with building
    your custom integration with quick start guides, usage guides, release
    notes, and more. Or download the [v1 OpenAPI
    specification](/legacy-openapi.json).


    Explore our [Risk Cloud API v2](https://docs.logicgate.com/v2/index.html)
    endpoints and documentation as well. [Risk Cloud API
    v2](https://docs.logicgate.com/v2/index.html) is our collection of API-First
    endpoints that are tailor made for our developer users, offer concise and
    highly documented details, are supported by a [Postman
    collection](https://www.postman.com/logicgate-postman/workspace/logicgate-risk-cloud-api/collection/29257227-de8d264b-6eeb-4177-bea6-2da0a8cabffc)
    and [v2 OpenAPI specification](https://github.com/LogicGateTech/openapi),
    and contain our latest API endpoint releases.
  contact:
    name: developer-relations@logicgate.com
    email: developer-relations@logicgate.com
  version: v2026.11.0
servers:
  - url: https://{subdomain}.logicgate.com
    description: Your Risk Cloud environment.
    variables:
      subdomain:
        description: Your Risk Cloud environment's subdomain (e.g. `qa`).
        default: your-instance
security:
  - ApiToken: []
  - basic: []
tags:
  - name: Authentication
    description: >-
      Getting Started: How to create an [API Access
      Token](https://www.logicgate.com/developer/risk-cloud-api-authentication/)
      to begin integrating with the Risk Cloud API
  - name: Attachment
    description: Endpoints for uploading, downloading, and retrieving record attachments.
  - name: Field
    description: Endpoints for creating, updating, and querying fields.
  - name: Principal
    description: >-
      Endpoints for the authenticated principal to view and manage their own
      details.
  - name: Record Audit
    description: Endpoints for retrieving record audit history and productivity data.
  - name: Step
    description: Endpoints for retrieving steps and the steps a user can access.
  - name: Table Report
    description: Endpoints for retrieving and managing table reports.
  - name: User Group
    description: Endpoints for managing user groups and their membership.
externalDocs:
  description: Developer Portal
  url: https://www.logicgate.com/developer/
paths:
  /api/v1/form/sections:
    get:
      tags:
        - Section
      summary: >-
        Return lists of Linked Workflows and Relationship Reports based on a
        parameter step ID.
      description: |-
        **Permissions:** Authenticated User

        Retrieve all sections configured on the identified step.
      operationId: findByStep_1
      parameters:
        - name: step
          in: query
          description: The unique ID of the step whose sections should be returned.
          required: false
          schema:
            type: string
        - name: workflow
          in: query
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                oneOf:
                  - type: array
                    items:
                      $ref: '#/components/schemas/SectionResult_FullSectionSummary'
                  - type: array
                    items:
                      $ref: '#/components/schemas/SectionObject_FullSectionSummary'
components:
  schemas:
    SectionResult_FullSectionSummary:
      type: object
      properties:
        name:
          type: string
        color:
          type: string
        icon:
          type: string
        priority:
          type: integer
          format: int32
        colspan:
          type: integer
          format: int32
        collapsed:
          type: boolean
        defaultState:
          type: string
          enum:
            - HIDDEN
            - INACTIVE
        conditionsEnabled:
          type: boolean
        conditionsUseAndOperator:
          type: boolean
        stepId:
          type: string
        stepName:
          type: string
        parentId:
          type: string
        workflowId:
          type: string
        workflowName:
          type: string
        applicationId:
          type: string
        applicationName:
          type: string
        applicationType:
          enum:
            - value: ACCESS_MANAGEMENT
              label: Access Management
              restricted: false
            - value: AML_KYC
              label: AML/KYC
              restricted: false
            - value: ASSET_MANAGEMENT
              label: Asset Management
              restricted: false
            - value: AUDIT_MANAGEMENT
              label: Audit Management
              restricted: false
            - value: BUSINESS_CONTINUITY_PLANNING
              label: Business Continuity Planning
              restricted: false
            - value: CHANGE_MANAGEMENT
              label: Change Management
              restricted: false
            - value: COMPLAINT_MANAGEMENT
              label: Complaint Management
              restricted: false
            - value: COMPLIANCE_MANAGEMENT
              label: Compliance Task Management
              restricted: false
            - value: CONTRACT_MANAGEMENT
              label: Procurement & Contract Management
              restricted: false
            - value: CONTROLS_COMPLIANCE
              label: Controls Compliance
              restricted: false
            - value: CONTROLS_MANAGEMENT
              label: Controls Management
              restricted: false
            - value: CRISIS_MANAGEMENT
              label: Crisis Management
              restricted: false
            - value: CUSTOM
              label: Custom
              restricted: false
            - value: CUSTOM_GRC_USE_CASE
              label: Custom GRC Use Case
              restricted: false
            - value: CYBER_RISK_MANAGEMENT
              label: Cyber Risk Management
              restricted: false
            - value: DATA_PRIVACY_MANAGEMENT
              label: Data Privacy Management
              restricted: false
            - value: EMPLOYEE_COMPLIANCE
              label: Employee Compliance
              restricted: false
            - value: ENTERPRISE_RISK_MANAGEMENT
              label: Enterprise Risk Management
              restricted: false
            - value: ESG
              label: ESG
              restricted: false
            - value: INCIDENT_MANAGEMENT
              label: Incident Management
              restricted: false
            - value: INTERNAL_AUDIT_MANAGEMENT
              label: Internal Audit Management
              restricted: false
            - value: IT_RISK_MANAGEMENT
              label: IT Risk Management
              restricted: false
            - value: OPERATIONAL_RESILIENCY
              label: Operational Resiliency
              restricted: false
            - value: OTHER
              label: Other
              restricted: false
            - value: POLICY_AND_PROCEDURE_MANAGEMENT
              label: Policy and Procedure Management
              restricted: false
            - value: POLICY_MANAGEMENT
              label: Policy Management
              restricted: false
            - value: PRIVACY_MANAGEMENT
              label: Privacy Management (GDPR, CCPA, etc.)
              restricted: false
            - value: QUANTIFY
              label: Quantify
              restricted: true
            - value: REGULATORY_COMPLIANCE
              label: Regulatory Compliance
              restricted: false
            - value: REPOSITORY
              label: Repository
              restricted: false
            - value: RISK_QUANTIFICATION
              label: Risk Quantification
              restricted: true
            - value: SOX_TESTING
              label: SOX Testing
              restricted: false
            - value: STANDARDS_REGULATIONS
              label: Standards and Regulations
              restricted: false
            - value: SURVEY
              label: Survey
              restricted: false
            - value: THIRD_PARTY_RISK_MANAGEMENT
              label: Third-Party Risk Management
              restricted: false
        applicationLive:
          type: boolean
        conditionsValid:
          type: boolean
        conditionsAndParentsValid:
          type: boolean
      required:
        - applicationId
        - applicationLive
        - applicationName
        - applicationType
        - collapsed
        - color
        - colspan
        - conditionsAndParentsValid
        - conditionsEnabled
        - conditionsUseAndOperator
        - conditionsValid
        - defaultState
        - icon
        - name
        - parentId
        - priority
        - stepId
        - stepName
        - workflowId
        - workflowName
    SectionObject_FullSectionSummary:
      type: object
      discriminator:
        propertyName: sectionType
      oneOf:
        - description: Circular reference to FormSection_FullSectionSummary
        - description: >-
            And other types: Dashboard_FullSectionSummary,
            DashboardSection_FullSectionSummary, FieldLink_FullSectionSummary,
            FormSection_FullSectionSummary, FormSection_FullSectionSummary,
            FormSection_FullSectionSummary, GraphReport_FullSectionSummary,
            HtmlSection_FullSectionSummary, VisualReport,
            WorkflowLink_FullSectionSummary, AnalysisReport_FullSectionSummary,
            EmbeddedReport_FullSectionSummary,
            EvidenceSection_FullSectionSummary,
            DataWarehouseLink_FullSectionSummary,
            ScopingSection_FullSectionSummary
      properties:
        id:
          type: string
        active:
          type: boolean
        created:
          type: string
          format: date-time
        updated:
          type: string
          format: date-time
        name:
          type: string
        color:
          type: string
        icon:
          type: string
        guidance:
          type: string
        priority:
          type: integer
          format: int32
        colspan:
          type: integer
          format: int32
        collapsed:
          type: boolean
        defaultState:
          type: string
          enum:
            - HIDDEN
            - INACTIVE
        conditionsEnabled:
          type: boolean
        conditionsUseAndOperator:
          type: boolean
        step:
          $ref: '#/components/schemas/Step_FullSectionSummary'
        stepId:
          type: string
        parentId:
          type: string
        sectionType:
          type: string
          enum:
            - CONTENT_SECTION
            - DASHBOARD
            - DASHBOARD_SECTION
            - FIELD_LINK
            - FORM_SECTION
            - GRAPH_REPORT
            - HTML_SECTION
            - STEP_PAGE
            - SUB_SECTION
            - VISUAL_REPORT
            - WORKFLOW_LINK
            - JIRA_WORKFLOW_LINK
            - ANALYSIS_REPORT
            - EMBEDDED_REPORT
            - EVIDENCE_SECTION
            - DATA_WAREHOUSE_LINK
            - SCOPING_SECTION
      required:
        - active
        - collapsed
        - color
        - colspan
        - conditionsEnabled
        - conditionsUseAndOperator
        - created
        - defaultState
        - guidance
        - icon
        - id
        - name
        - parentId
        - priority
        - step
        - stepId
        - updated
    Step_FullSectionSummary:
      type: object
      description: An entity to store details about a specific step within a workflow
      discriminator:
        propertyName: stepType
      oneOf:
        - $ref: '#/components/schemas/Origin_FullSectionSummary'
        - description: >-
            And other types: Chain_FullSectionSummary, End_FullSectionSummary,
            Origin_FullSectionSummary, Chain_FullSectionSummary,
            End_FullSectionSummary
      properties:
        stepType:
          type: string
          description: >-
            Step type. Advisory on writes. The server resolves the persisted
            step's type from the step id and ignores any client-supplied value.
          enum:
            - ORIGIN
            - CHAIN
            - END
        name:
          type: string
          description: Step name.
        description:
          type: string
          description: Description of the step.
        priority:
          type: integer
          format: int32
          description: >-
            Determines the step's place in the workflow. Priority is in
            descending order with 0 being the first step.
        userGroupOperationType:
          type: string
          description: >-
            Determine how users are able to interact with user groups on the
            step. By default, new steps will allow FULL_ACCESS user group
            editing.
          enum:
            - FULL_ACCESS
            - ADD_ONLY
            - READ_ONLY
        xpos:
          type: integer
          format: int32
          description: Vertical position of the step on the process screen.
        ypos:
          type: integer
          format: int32
          description: Horizontal position of the step on the process screen.
        commentsEnabled:
          type: boolean
          description: Allows comments to be displayed on a step.
        documentsEnabled:
          type: boolean
          description: Allows documents to be generated on a step.
        externalUserMfaRequired:
          type: boolean
          description: >-
            Whether or not to require MFA for external users to access this
            step.
        uxriEnabled:
          type: boolean
          description: Whether or not to enable UXRI on the step.
        autofillEnabled:
          type: boolean
          description: Whether or not to enable autofill on the step.
        sla:
          $ref: '#/components/schemas/ServiceLevelAgreement_FullSectionSummary'
          description: Object containing all SLA information.
        assignableUserType:
          type: string
          description: >-
            Determine what users are able to be assigned to a record. By
            default, new records will allow APP_USERS as assignees.
          enum:
            - APP_AND_EXTERNAL_USERS
            - APP_USERS
            - EXTERNAL_USERS
        id:
          type: string
        active:
          type: boolean
        created:
          type: string
          format: date-time
        updated:
          type: string
          format: date-time
        end:
          type: boolean
        contains:
          description: Circular reference to Step_FullSectionSummary
          writeOnly: true
        origin:
          type: boolean
        chain:
          type: boolean
      required:
        - active
        - assignableUserType
        - autofillEnabled
        - commentsEnabled
        - created
        - description
        - documentsEnabled
        - externalUserMfaRequired
        - id
        - name
        - priority
        - sla
        - stepType
        - updated
        - userGroupOperationType
        - uxriEnabled
        - xpos
        - ypos
    Origin_FullSectionSummary:
      allOf:
        - description: Circular reference to Step_FullSectionSummary
    ServiceLevelAgreement_FullSectionSummary:
      type: object
      properties:
        enabled:
          type: boolean
        duration:
          type: integer
          format: int64
      required:
        - duration
        - enabled
  securitySchemes:
    ApiToken:
      type: http
      scheme: bearer
      bearerFormat: API Token
    basic:
      type: http
      scheme: basic

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.