Create record

Create a new digital twin record with image upload. The image is automatically watermarked with a unique ID. Supports both multipart form upload and JSON with base64 image.

POST /api/records

Create record

cURL

curl --request POST \
  --url https://yys-sqr-render-bsbe.onrender.com/api/records \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form image='@example-file'

201

{
  "success": true,
  "watermark_id": "SQR-A1B2C",
  "card": {
    "watermark_id": "SQR-A1B2C",
    "template_id": "pharma",
    "claim_status": "unclaimed",
    "description": "<string>",
    "record_metadata": {
      "product_name": "Aspirin",
      "dosage": "100mg"
    },
    "image_url": "<string>",
    "watermarked_image_url": "<string>",
    "scan_count": 0,
    "nft_token_id": 123,
    "mint_transaction_hash": "<string>",
    "owner_address": "<string>",
    "claimed_by": "<string>",
    "claim_transaction_hash": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "minted_at": "2023-11-07T05:31:56Z",
    "claimed_at": "2023-11-07T05:31:56Z"
  },
  "watermarked_image": "<string>"
}

Authorizations

Authorization · string · header · required

Pass a Supabase JWT or a 48-character hex API key as a Bearer token.

Body

multipart/form-dataapplication/json

image · file · required

Image file

template_id · string · default: custom

metadata · string

JSON string of metadata key-value pairs

Response

201

application/json

Record created

success · boolean

Example:

true

watermark_id · string

Example:

"SQR-A1B2C"

card · object

Show child attributes

watermarked_image · string

Base64-encoded watermarked image