> ## 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 all by parent workflow ## OpenAPI ````yaml GET /api/v1/scoping-trees 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/scoping-trees: get: tags: - ScopingTree operationId: findAllByParentWorkflow parameters: - name: parent-workflow in: query required: true schema: type: string - name: pageable in: query required: true schema: $ref: '#/components/schemas/Pageable' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/PageScopingTreeOut' components: schemas: Pageable: type: object properties: paged: type: boolean pageNumber: type: integer format: int32 pageSize: type: integer format: int32 sort: $ref: '#/components/schemas/SortObject' unpaged: type: boolean offset: type: integer format: int64 PageScopingTreeOut: type: object properties: totalElements: type: integer format: int64 totalPages: type: integer format: int32 first: type: boolean last: type: boolean numberOfElements: type: integer format: int32 pageable: $ref: '#/components/schemas/Pageable' sort: $ref: '#/components/schemas/SortObject' size: type: integer format: int32 content: type: array items: $ref: '#/components/schemas/ScopingTreeOut' number: type: integer format: int32 empty: type: boolean SortObject: type: object properties: sorted: type: boolean unsorted: type: boolean empty: type: boolean ScopingTreeOut: type: object properties: allowDuplicateAssessments: type: boolean id: type: string multipleFocusRecords: type: boolean name: type: string modified: type: boolean valid: type: boolean parentWorkflow: $ref: '#/components/schemas/WorkflowSummaryOut' root: $ref: '#/components/schemas/ScopingTreeItemOut' errors: type: array items: $ref: '#/components/schemas/ScopingTreeValidationError' parentWorkflowId: type: string required: - allowDuplicateAssessments - errors - id - modified - multipleFocusRecords - name - parentWorkflow - root - valid WorkflowSummaryOut: type: object properties: id: type: string description: ID of the workflow. active: type: boolean description: True if the workflow is active. created: type: string format: date-time description: Created Date of the workflow. updated: type: string format: date-time description: Last Updated Date of the workflow. name: type: string description: Name of the workflow. recordPrefix: type: string description: Prefix to be used for every record created from the workflow. allowGroups: type: boolean description: Nodes created in the workflow are allowed user groups. requireGroups: type: boolean description: Nodes created in the workflow require user groups. xpos: type: integer format: int32 description: X axis position of the workflow on the application screen ypos: type: integer format: int32 description: Y axis position of the workflow on the application screen sla: $ref: '#/components/schemas/ServiceLevelAgreement' description: Object containing all SLA information. allowAec: type: boolean description: Enabled automated evidence collection. applicationId: type: string description: The parent application ID of this workflow. workflowType: type: string description: The type of this workflow (LG or Jira). enum: - WORKFLOW - JIRA_WORKFLOW - CONTROL_WORKFLOW - ANALYSIS_WORKFLOW application: $ref: '#/components/schemas/ApplicationSummaryOut' description: The parent application of this workflow. required: - active - allowAec - allowGroups - application - applicationId - created - id - name - recordPrefix - requireGroups - sla - updated - workflowType - xpos - ypos ScopingTreeItemOut: type: object properties: id: type: string scopingWorkflow: $ref: '#/components/schemas/WorkflowSummaryOut' assessmentWorkflow: $ref: '#/components/schemas/WorkflowSummaryOut' layout: $ref: '#/components/schemas/LayoutBasicOut' bcws: $ref: '#/components/schemas/BulkCreateWorkflowSourceOut' child: description: Circular reference to ScopingTreeItemOut errors: $ref: '#/components/schemas/ScopingTreeItemErrors' required: - assessmentWorkflow - bcws - child - errors - id - layout - scopingWorkflow ScopingTreeValidationError: type: object properties: type: type: string enum: - BCWS - MAP_TO_ASSESSMENT - MAP_TO_SCOPING - STRUCTURE message: type: string required: - message - type ServiceLevelAgreement: type: object properties: enabled: type: boolean duration: type: integer format: int64 required: - duration - enabled ApplicationSummaryOut: type: object properties: id: type: string active: type: boolean created: type: string format: date-time updated: type: string format: date-time name: type: string type: type: string color: type: string icon: type: string live: type: boolean permissionsEnabled: type: boolean required: - active - color - created - icon - id - live - name - permissionsEnabled - type - updated LayoutBasicOut: type: object properties: id: type: string description: The unique ID of this Risk Cloud resource active: type: boolean description: If the Risk Cloud resource is active created: type: string format: date-time description: >- The moment this Risk Cloud resource was created measured in milliseconds since the Unix epoch. updated: type: string format: date-time description: >- The moment this Risk Cloud resource was last updated measured in milliseconds since the Unix epoch. title: type: string description: The name of the layout defaultLayout: type: boolean description: If the layout is a default layout layoutType: type: string description: The type of the layout required: - active - created - defaultLayout - id - layoutType - title - updated BulkCreateWorkflowSourceOut: type: object properties: sourceWorkflow: $ref: '#/components/schemas/WorkflowApiOut' layout: $ref: '#/components/schemas/LayoutBasicOut' sourceSearchStep: $ref: '#/components/schemas/StepApiOut' destinationCreateStep: $ref: '#/components/schemas/StepApiOut' defaultAssignee: $ref: '#/components/schemas/CrossflowSummaryOut' defaultDueDate: $ref: '#/components/schemas/CrossflowSummaryOut' tableReport: $ref: '#/components/schemas/TableReportBasicOut' required: - defaultAssignee - defaultDueDate - destinationCreateStep - layout - sourceSearchStep - sourceWorkflow - tableReport ScopingTreeItemErrors: type: object properties: bcwsErrors: type: array items: $ref: '#/components/schemas/ScopingTreeValidationError' mapToAssessmentErrors: type: array items: $ref: '#/components/schemas/ScopingTreeValidationError' mapToScopingErrors: type: array items: $ref: '#/components/schemas/ScopingTreeValidationError' structureErrors: type: array items: $ref: '#/components/schemas/ScopingTreeValidationError' required: - bcwsErrors - mapToAssessmentErrors - mapToScopingErrors - structureErrors WorkflowApiOut: type: object properties: id: type: string description: The unique ID of this Risk Cloud resource example: a1b2c3d4 name: type: string description: The name of the workflow example: Risk Assessments description: type: string description: The description of the workflow example: Risk Assessment Description Text recordPrefix: type: string description: >- The prefix to be used in the name of every record created from this workflow example: Assessment applicationId: type: string description: The unique ID of the parent application of the workflow example: a1b2c3d4 applicationName: type: string description: The name of the parent application of the workflow example: Cyber Risk Management Application xpos: type: integer format: int32 description: The x-coordinate of the workflow in the application builder example: 20 ypos: type: integer format: int32 description: The y-coordinate of the workflow in the application builder example: 20 type: type: string description: The type of workflow enum: - WORKFLOW - JIRA_WORKFLOW - CONTROL_WORKFLOW - ANALYSIS_WORKFLOW example: WORKFLOW object: type: string description: Identifies the type of object this data represents example: workflow required: - applicationId - applicationName - description - id - name - object - recordPrefix - type - xpos - ypos title: Workflow (Response) StepApiOut: type: object properties: id: type: string description: The unique ID of this Risk Cloud resource example: a1b2c3d4 name: type: string description: The name of the step example: Identify Risk description: type: string description: The description of the step example: This is a description of the step xpos: type: integer format: int32 description: The x-coordinate of the step in the application builder example: 20 ypos: type: integer format: int32 description: The y-coordinate of the step in the application builder example: 20 type: type: string description: The type of the step enum: - ORIGIN - CHAIN - END example: ORIGIN enableComments: type: boolean description: Whether comments are displayed on a step example: false assignableUserType: type: string description: >- Indicates which users are allowed to be assigned this step on a record enum: - APP_AND_EXTERNAL_USERS - APP_USERS - EXTERNAL_USERS example: APP_USERS externalUserMfaRequired: type: boolean description: Whether MFA is required for external users to access this step. example: false autofillEnabled: type: boolean description: Whether or not to enable autofill on the step. example: false workflow: $ref: '#/components/schemas/WorkflowPropertyApiOut' description: The parent workflow of the step object: type: string description: Identifies the type of object this data represents example: step required: - assignableUserType - autofillEnabled - description - enableComments - externalUserMfaRequired - id - name - object - type - workflow - xpos - ypos title: Step (Response) CrossflowSummaryOut: type: object properties: id: type: string description: The unique ID of this Risk Cloud resource crossflowReducer: type: string enum: - NEWEST - OLDEST - MOST_RECENTLY_LINKED - LEAST_RECENTLY_LINKED - SUM - AVERAGE - HIGHEST - LOWEST calcSpecificToStep: type: boolean calcStep: $ref: '#/components/schemas/Step' systemField: type: string enum: - NAME - STATUS - CREATED - ENTERED_STEP_DATE - USER_DATE - EFFECTIVE_DUE_DATE - STEP_DUE_DATE - CURRENT_DATE - DUE_DATE - DAYS_UNTIL_DUE - SIMILARITY - RATIONALE - MATCH_CONFIDENCE - COMPLETED_DATE - LAST_COMPLETED_DATE - ID - SEQUENCE - ASSESSMENT_COUNT - USER_NAME - USER_ID - CREATOR_NAME - USER_GROUP - STEP_NAME - STEP_ID - ORIGIN_NAME - ORIGIN_ID - WORKFLOW_NAME - WORKFLOW_RECORD_PREFIX - WORKFLOW_ID - PRIMARY_FIELD - STATE fieldWorkflow: $ref: '#/components/schemas/WorkflowSummaryOut' fieldWorkflowId: type: string customField: $ref: '#/components/schemas/FieldBasicsOut' customFieldId: type: string priority: type: integer format: int32 required: - calcSpecificToStep - calcStep - crossflowReducer - customField - customFieldId - fieldWorkflow - fieldWorkflowId - id - priority - systemField TableReportBasicOut: type: object properties: priority: type: integer format: int32 description: type: string documentsEnabled: type: boolean inlineEditEnabled: type: boolean autoExpand: type: boolean version: type: integer format: int32 workflow: $ref: '#/components/schemas/WorkflowSummaryOut' id: type: string description: The unique ID of this Risk Cloud resource active: type: boolean description: If the Risk Cloud resource is active created: type: string format: date-time description: >- The moment this Risk Cloud resource was created measured in milliseconds since the Unix epoch. updated: type: string format: date-time description: >- The moment this Risk Cloud resource was last updated measured in milliseconds since the Unix epoch. title: type: string description: The name of the layout defaultLayout: type: boolean description: If the layout is a default layout layoutType: type: string description: The type of the layout required: - active - autoExpand - created - defaultLayout - description - documentsEnabled - id - inlineEditEnabled - layoutType - priority - title - updated - version - workflow WorkflowPropertyApiOut: type: object properties: id: type: string description: The unique ID of this Risk Cloud resource example: a1b2c3d4 name: type: string description: The name of the workflow example: Risk Assessments recordPrefix: type: string description: >- The prefix to be used in the name of every record created from this workflow example: Assessment object: type: string description: Identifies the type of object this data represents example: workflow required: - id - name - object - recordPrefix title: Workflow (Property) Step: type: object description: An entity to store details about a specific step within a workflow discriminator: propertyName: stepType oneOf: - $ref: '#/components/schemas/Origin' - description: 'And other types: Chain, End, Origin, Chain, End' 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. isPublic: type: boolean description: >- Allows a step to become a public step. Public steps allow for a shareable public record link to be generated in the step edit screen. Public steps do not require any login credentials. 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' description: Object containing all SLA information. workflow: description: Circular reference to Workflow workflowId: type: string 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 writeOnly: true origin: type: boolean chain: type: boolean required: - active - assignableUserType - autofillEnabled - commentsEnabled - created - description - documentsEnabled - externalUserMfaRequired - id - isPublic - name - priority - sla - stepType - updated - userGroupOperationType - uxriEnabled - workflow - workflowId - xpos - ypos FieldBasicsOut: type: object properties: id: type: string name: type: string label: type: string fieldType: type: string required: type: boolean readOnly: type: boolean currentValues: type: array items: $ref: '#/components/schemas/CurrentValueBasicsOut' operators: type: array items: type: string enum: - EQUALS - NOT_EQUALS - IS - IS_NOT - GREATER_THAN - GREATER_THAN_EQUALS - LESS_THAN - LESS_THAN_EQUALS - CONTAINS - DOES_NOT_CONTAIN - 'NULL' - NOT_NULL - DATE_RANGE - NUMERIC_RANGE required: - currentValues - fieldType - id - label - name - operators - readOnly - required Origin: allOf: - description: Circular reference to Step CurrentValueBasicsOut: type: object properties: id: type: string active: type: boolean archived: type: boolean created: type: string format: date-time discriminator: type: string updated: type: string format: date-time textValue: type: string numericValue: type: number format: double temporalValue: type: string format: date-time valueType: type: string required: - active - archived - created - discriminator - id - numericValue - temporalValue - textValue - updated - valueType 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.