> ## 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. # Create a parent record > Add a parent Record relationship to the Record represented by the path variable. The parent may already exist or it may need to be created. ## OpenAPI ````yaml POST /api/v1/records/{recordId}/parent 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/records/{recordId}/parent: post: tags: - Record summary: Create a parent Record. description: >- Add a parent Record relationship to the Record represented by the path variable. The parent may already exist or it may need to be created. operationId: createParent parameters: - name: recordId in: path required: true schema: type: string - name: layout in: query description: Layout ID required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/Record_ExtendedRecordSummary' required: true responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/FilteredRecord_FilteredRecordSummary' components: schemas: Record_ExtendedRecordSummary: type: object description: The record field values to apply before submitting. properties: id: type: string active: type: boolean created: type: string format: date-time updated: type: string format: date-time state: type: string enum: - ARCHIVED - LIVE sequenceId: type: integer format: int64 dueDate: type: string format: date-time stepDueDate: type: string format: date-time userDate: type: string format: date-time recordName: type: string step: $ref: '#/components/schemas/Step_ExtendedRecordSummary' origin: $ref: '#/components/schemas/Step_ExtendedRecordSummary' creator: $ref: '#/components/schemas/User_ExtendedRecordSummary' user: $ref: '#/components/schemas/User_ExtendedRecordSummary' secondaryAssignees: type: array items: $ref: '#/components/schemas/User_ExtendedRecordSummary' userGroups: type: array items: $ref: '#/components/schemas/UserGroup_ExtendedRecordSummary' currentValueMaps: type: array items: $ref: '#/components/schemas/ValueMap_ExtendedRecordSummary' assignee: $ref: '#/components/schemas/User_ExtendedRecordSummary' assigneeType: type: string enum: - EXTERNAL - INTERNAL - NONE - SELF - STEP daysUntilDue: $ref: '#/components/schemas/DaysUntilDue_ExtendedRecordSummary' activeForRecord: description: Circular reference to Record_ExtendedRecordSummary lastUpdated: type: string format: date-time status: type: string enum: - INACTIVE - NOT_ASSIGNED - ASSIGNED - IN_PROGRESS - COMPLETE viewableTitle: type: string initialStateEndStep: type: boolean workflowDueDate: type: string format: date-time recordType: type: string enum: - RECORD - JIRA_RECORD name: type: string isPublic: type: boolean required: - active - activeForRecord - assignee - assigneeType - created - creator - currentValueMaps - daysUntilDue - dueDate - id - lastUpdated - origin - recordName - secondaryAssignees - sequenceId - state - step - stepDueDate - updated - user - userDate - userGroups FilteredRecord_FilteredRecordSummary: type: object properties: properties: type: array items: $ref: '#/components/schemas/RecordProperty_FilteredRecordSummary' record: $ref: '#/components/schemas/RecordDetails_FilteredRecordSummary' required: - properties - record Step_ExtendedRecordSummary: type: object description: An entity to store details about a specific step within a workflow discriminator: propertyName: stepType oneOf: - $ref: '#/components/schemas/Origin_ExtendedRecordSummary' - description: >- And other types: Chain_ExtendedRecordSummary, End_ExtendedRecordSummary, Origin_ExtendedRecordSummary, Chain_ExtendedRecordSummary, End_ExtendedRecordSummary 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_ExtendedRecordSummary' 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_ExtendedRecordSummary 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 - xpos - ypos User_ExtendedRecordSummary: allOf: - $ref: '#/components/schemas/CurrentValue_ExtendedRecordSummary' - type: object properties: email: type: string company: type: string imageUrl: type: string status: type: string tier: type: string enum: - PRIMARY - SECONDARY - LIMITED pricingUserTier: type: string enum: - STANDARD - POWER mfaEnabled: type: boolean mfaSetup: type: boolean autoprovisioned: type: boolean scimStatus: type: string automatedUser: type: boolean automatedUserFieldLabels: type: array items: type: string lastLogin: $ref: '#/components/schemas/AccessAudit_ExtendedRecordSummary' lastDeactivated: type: string format: date-time external: type: boolean disabled: type: boolean serviceAccount: type: boolean superUser: type: boolean name: type: string locked: type: boolean description: Entity for storing all information pertaining to a user. discriminator: propertyName: status oneOf: - description: Circular reference to Active_ExtendedRecordSummary - description: >- And other types: Automated_ExtendedRecordSummary, Disabled_ExtendedRecordSummary, External_ExtendedRecordSummary, Locked_ExtendedRecordSummary, Service_ExtendedRecordSummary properties: status: type: string required: - status UserGroup_ExtendedRecordSummary: type: object properties: id: type: string active: type: boolean created: type: string format: date-time updated: type: string format: date-time recordDefault: type: boolean title: type: string automatedUserGroup: type: boolean automatedUserGroupFieldLabel: type: string required: - active - automatedUserGroup - automatedUserGroupFieldLabel - created - id - recordDefault - title - updated ValueMap_ExtendedRecordSummary: type: object properties: id: type: string active: type: boolean created: type: string format: date-time updated: type: string format: date-time copyable: type: boolean required: - active - created - id - updated DaysUntilDue_ExtendedRecordSummary: type: object description: A summary of the days left until a record is due. properties: value: type: integer format: int64 description: >- Days until the effective due date. This value is absolute and will always be positive. When overdue, this value will be the number of days since the due date. label: type: string description: Label associated with the days until due. enum: - NO_DUE_DATE - COMPLETED - OVERDUE - DUE_WITHIN_A_WEEK - FAR_FROM_DUE required: - label - value RecordProperty_FilteredRecordSummary: type: object properties: header: type: string fieldType: type: string enum: - TEXT - EXTERNAL_USER - EXTERNAL_ID - TEXT_AREA - DATE_PICKER - NUMBER - E_SIGNATURE - CHECKBOX - MULTI_SELECT - RADIO - SELECT - USER - ATTACHMENT - CALCULATION - TEXT_CONCATENATION - FIXED_DATE_CALCULATION - LINKED_RECORDS_COUNT - DUE_DATE - DAYS_UNTIL_DUE - EVIDENCE - AEC_INFO - ANNUAL_LOSS_EXPOSURE 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 recordId: type: string url: type: string rawValue: {} formattedValue: type: string formattedValueList: type: array items: type: string required: - fieldType - formattedValue - formattedValueList - header - rawValue - recordId - systemField - url RecordDetails_FilteredRecordSummary: type: object properties: id: type: string depth: type: integer format: int64 name: type: string recordName: type: string dueDate: type: string format: date-time user: type: boolean canEdit: type: boolean canRead: type: boolean step: type: string description: step workflow: type: string description: workflow application: type: string description: application jiraKey: type: string stepId: type: string stepEnd: type: boolean required: - application - canEdit - canRead - depth - dueDate - id - jiraKey - name - recordName - step - user - workflow Origin_ExtendedRecordSummary: allOf: - description: Circular reference to Step_ExtendedRecordSummary ServiceLevelAgreement_ExtendedRecordSummary: type: object properties: enabled: type: boolean duration: type: integer format: int64 required: - duration - enabled CurrentValue_ExtendedRecordSummary: type: object description: Entity used to manage record's field data. discriminator: propertyName: discriminator oneOf: - $ref: '#/components/schemas/CurrentCommonValue_ExtendedRecordSummary' - description: >- And other types: CurrentDateValue_ExtendedRecordSummary, CurrentDateRangeValue_ExtendedRecordSummary, CurrentJobValue_ExtendedRecordSummary, CurrentCommonValue_ExtendedRecordSummary, CurrentDateValue_ExtendedRecordSummary, CurrentDateRangeValue_ExtendedRecordSummary, LabelValue_ExtendedRecordSummary, CleanAttachment_ExtendedRecordSummary, DirtyAttachment_ExtendedRecordSummary, PendingAttachment_ExtendedRecordSummary, CurrentGoogleAttachmentValue_ExtendedRecordSummary, CurrentSharepointAttachmentValue_ExtendedRecordSummary, Active_ExtendedRecordSummary, Automated_ExtendedRecordSummary, Disabled_ExtendedRecordSummary, External_ExtendedRecordSummary, Locked_ExtendedRecordSummary, Service_ExtendedRecordSummary, CurrentNumericRangeValue_ExtendedRecordSummary, CurrentJobValue_ExtendedRecordSummary properties: id: type: string active: type: boolean created: type: string format: date-time updated: type: string format: date-time discriminator: type: string idOrTransientId: type: string transientIdOrId: type: string textOrNumericValue: type: string empty: type: boolean required: - active - created - discriminator - id - updated AccessAudit_ExtendedRecordSummary: type: object description: Entity used to track authentication attempts. discriminator: propertyName: accessType oneOf: - $ref: '#/components/schemas/LogIn_ExtendedRecordSummary' - description: >- And other types: LogOut_ExtendedRecordSummary, LogInFail_ExtendedRecordSummary, CredentialsRolled_ExtendedRecordSummary, TokenRolled_ExtendedRecordSummary, LogIn_ExtendedRecordSummary, LogOut_ExtendedRecordSummary, LogInFail_ExtendedRecordSummary, CredentialsRolled_ExtendedRecordSummary, TokenRolled_ExtendedRecordSummary properties: id: type: string active: type: boolean created: type: string format: date-time updated: type: string format: date-time accessType: type: string required: - accessType - active - created - id - updated CurrentCommonValue_ExtendedRecordSummary: allOf: - description: Circular reference to CurrentValue_ExtendedRecordSummary required: - description LogIn_ExtendedRecordSummary: allOf: - description: Circular reference to AccessAudit_ExtendedRecordSummary required: - accessType 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.