> ## 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 record that is based on a step > The Record will return with a status of ASSIGNED if a valid assignee email is given. It will otherwise return as NOT_ASSIGNED. The returned object is the newly created Record. ## OpenAPI ````yaml POST /api/v1/records/steps 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/steps: post: tags: - Record summary: Create a Record that is based on a Step. description: >- The Record will return with a status of ASSIGNED if a valid assignee email is given. It will otherwise return as NOT_ASSIGNED. The returned object is the newly created Record. operationId: createRecordByStepId requestBody: content: application/json: schema: $ref: '#/components/schemas/RecordBasicsIn' required: true responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/RecordBasics' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/AppStatusResponse' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/RecordBasics' components: schemas: RecordBasicsIn: type: object description: The Step ID and initial Field values for the new Record. properties: stepId: type: string fields: type: array items: $ref: '#/components/schemas/FieldBasicsIn' recordDueDate: type: string assigneeEmailAddress: type: string required: - assigneeEmailAddress - fields - recordDueDate - stepId RecordBasics: type: object properties: id: type: string active: type: boolean created: type: string format: date-time updated: type: string format: date-time name: type: string recordName: type: string primaryFieldValue: type: string status: type: string enum: - INACTIVE - NOT_ASSIGNED - ASSIGNED - IN_PROGRESS - COMPLETE recordDueDate: type: string format: date-time workflowDueDate: type: string format: date-time fields: type: array items: $ref: '#/components/schemas/FieldBasicsOut' public: type: boolean required: - active - created - fields - id - name - primaryFieldValue - recordDueDate - recordName - status - updated - workflowDueDate AppStatusResponse: type: object additionalProperties: true description: >- An RFC 9457 problem detail. Extension members are written as top-level fields rather than under `properties`, and `status` is a string, to stay compatible with pre-RFC 9457 clients. Empty fields are omitted. properties: type: type: string format: uri title: type: string status: type: string example: '400' detail: type: string instance: type: string format: uri message: type: string description: Legacy alias of `detail`. FieldBasicsIn: type: object properties: fieldId: type: string values: type: array items: type: string aiReason: type: string aiConfidence: type: string aiSources: type: array items: $ref: '#/components/schemas/AiSource' required: - aiConfidence - aiReason - aiSources - fieldId - values 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 AiSource: type: object properties: type: type: string enum: - USER_ATTACHMENT - FIELD - PROMPT - GENERATED name: type: string required: - name - type 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.