uploadFormRecordAttachment

POST

/api/v1/data-sources/{id}/records/{recordId}/attachments

Uploads a base64-encoded image as a dedicated form attachment bound to an image field, returning the updated record detail with its incremented version. Uses optimistic concurrency — the request body must carry the record’s current version, and a mismatch returns 409. Because image fields are single-valued, uploading to a field that already has an attachment replaces it. Authorization matches record editing. Form attachments are never exposed through the general Media library.

Request Body^required

Media typeapplication/json

object

fieldKey

required

string

fileName

string

contentType

string

data

required

Base64-encoded image bytes

string

version

required

The record’s current version

integer

Example^generated

{
  "fieldKey": "example",
  "fileName": "example",
  "contentType": "example",
  "data": "example",
  "version": 1
}

Responses

201

Updated record detail after the attachment change

403

Not permitted to edit this record

409

Record version conflict

422

Not an image, unsupported type, or too large