# Create or update records (upsert)

Create or update records (upsert)

            Records are created if they don't exist, or updated if matched by systemRef.

            Partial Success Behavior:
            - Each record is processed independently
            - Successful records are persisted even if others fail
            - Check summary.failed and individual records[].status for failures
            - Failed records include error details in records[].error

            Limits: Maximum 100 records per request.

Business Applications:
- Bulk record import
- Entity synchronization

Real Example:
bash
curl --location 'https://{{host}}/api/v1/records' \
--header 'Authorization: bearer {{token}}' \
--header 'Content-Type: application/json' \
--data '{
  "records": example value
}'

Endpoint: POST /api/v1/records
Version: 1.0.0
Security: BearerAuth

## Request fields (application/json):

  - `records` (array, required)
    Records

  - `records.type` (string)
    Type

  - `records.systemRef` (object,null)
    Systemref

  - `records.attributes` (object)
    Attributes

## Response 200 fields (application/json):

  - `data` (object)

  - `data.summary` (object)
    Summary

  - `data.records` (array)
    Records

  - `error` (object,null)

  - `meta` (object)

  - `meta.success` (boolean)

  - `meta.message` (string)

  - `meta.timestamp` (string)

  - `meta.version` (string)


## Response 400 fields

## Response 401 fields

## Response 403 fields

## Response 500 fields