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

# Bulk update record values

> Update individual field values across many existing records in one request. Update-only: unknown records are reported in `failed`, never created.



## OpenAPI

````yaml https://api.useinvent.com/openapi.json post /orgs/{org_id}/tables/{table_id}/records/values/bulk
openapi: 3.1.0
info:
  version: 1.0.0
  title: Invent API
servers:
  - url: https://api.useinvent.com
security:
  - bearerAuth: []
paths:
  /orgs/{org_id}/tables/{table_id}/records/values/bulk:
    post:
      tags:
        - Orgs Tables
      summary: Bulk update record values
      description: >-
        Update individual field values across many existing records in one
        request. Update-only: unknown records are reported in `failed`, never
        created.
      parameters:
        - schema:
            type: string
          required: true
          description: Org ID
          name: org_id
          in: path
        - schema:
            type: string
          required: true
          description: Table ID
          name: table_id
          in: path
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BulkUpdateTableRecordValuesSchema'
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/BulkUpdateTableRecordValuesSchema'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  updated:
                    type: array
                    items:
                      type: string
                  failed:
                    type: array
                    items:
                      type: object
                      properties:
                        record_id:
                          type: string
                        error:
                          type: string
                      required:
                        - record_id
                        - error
                required:
                  - updated
                  - failed
components:
  schemas:
    BulkUpdateTableRecordValuesSchema:
      type: object
      properties:
        updates:
          type: array
          items:
            type: object
            properties:
              record_id:
                type: string
                maxLength: 128
              key:
                type: string
                minLength: 1
                maxLength: 64
                pattern: ^[a-z][a-z0-9_]{0,63}$
              value:
                description: >-
                  The value to set. Repeat a record_id + key pair to build a
                  multi-value array; null clears the field.
            required:
              - record_id
              - key
          minItems: 1
          maxItems: 500
      required:
        - updates
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: Bearer token authentication using your API key

````