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

# Create Record

> Create a new workboard record of the given custom record type.



## OpenAPI

````yaml /api/openapi_legacy.json post /records/{typeId}
openapi: 3.1.0
info:
  title: FlowEQ - Legacy API
  description: FlowEQ Legacy REST API
  version: '1.0'
  contact:
    name: FlowEQ
    url: https://www.floweq.com
    email: support@floweq.com
servers:
  - url: https://next.floweq.com/api/v1
security:
  - bearerAuth: []
paths:
  /records/{typeId}:
    post:
      tags:
        - Records
      summary: Create Record
      description: Create a new workboard record of the given custom record type.
      parameters:
        - schema:
            type: string
            description: Custom record type ID.
          required: true
          description: Custom record type ID.
          name: typeId
          in: path
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateRecordBody'
      responses:
        '201':
          description: Record created successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Record'
        '400':
          description: >-
            Bad request — field IDs invalid, required fields missing, or value
            type mismatch.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateRecordValidationError'
        '401':
          description: Unauthorized.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Record type not found for the given typeId.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    CreateRecordBody:
      type: object
      additionalProperties:
        anyOf:
          - type: boolean
          - type: number
          - type: string
      description: >-
        Map of custom field UIDs to their values. Date fields must be formatted
        as YYYY-MM-DD strings.
      example:
        293ce860-4667-4ab8-a1a8-99c63f2a601d: This is a text field
        970bf74e-9350-42ff-b722-64da9c0134a3: true
        a7e644fc-bcad-4344-b9da-819fbda53554: '2026-01-30'
        a90de5ec-3773-46ab-b41b-02791cf9e552: 42
        04d1460d-8cee-497a-b7ee-71116bb035c2: This is a required field
    Record:
      type: object
      properties:
        id:
          type: string
          description: Unique record identifier.
        record_type:
          type: string
          description: >-
            Record type identifier (e.g., 'uccfiling', 'custom',
            'infoleaseasset').
        uid:
          description: Record type definition UID.
        status:
          type: string
          description: Current status of the record.
        parent_record:
          description: Parent record object, or null if none.
        child_records:
          type: array
          items: {}
          description: List of child record objects.
        instance:
          description: >-
            The underlying instance object (InfoleaseAsset, UCCFiling, or
            PurchasedLabel), if applicable.
        fields:
          type: object
          additionalProperties: {}
          description: Custom field values keyed by field name.
        linked:
          type: object
          additionalProperties:
            type: object
            additionalProperties: {}
          description: Linked external objects, keyed by source then object name.
        created_at:
          type: string
          description: ISO 8601 creation timestamp.
        updated_at:
          type: string
          description: ISO 8601 last updated timestamp.
        views:
          type: array
          items:
            type: string
          description: List of view IDs this record belongs to.
      required:
        - record_type
        - status
        - child_records
        - created_at
        - updated_at
        - views
    CreateRecordValidationError:
      type: object
      properties:
        message:
          type: string
          description: Human-readable error description.
        invalid_fields:
          type: array
          items:
            type: string
          description: Field IDs not recognised for this record type.
        required_fields:
          type: array
          items:
            type: object
            properties:
              uid:
                type: string
              field_name:
                type: string
            required:
              - uid
              - field_name
          description: Required fields that were not provided.
        type_errors:
          type: array
          items:
            type: object
            properties:
              uid:
                type: string
              field_name:
                type: string
              expected:
                type: string
                description: >-
                  Expected type, e.g. 'boolean', 'number', 'date (YYYY-MM-DD)',
                  'string'.
            required:
              - uid
              - field_name
              - expected
          description: Fields whose submitted value did not match the expected type.
      required:
        - message
    ErrorResponse:
      type: object
      properties:
        message:
          type: string
          description: Human-readable error description.
      required:
        - message

````