Record multiple interactions

POST

https://api.recomms.ai/{database}/interactions/bulk

Record multiple interactions between users and items in a single request.

Request

Path Params

Body Params application/json

Example

[
    {
        "user_id": "string",
        "item_id": "string",
        "action": "detailviews",
        "timestamp": 0,
        "cascadeCreate": true,
        "duration": 0,
        "price": 0,
        "amount": 0,
        "rating": -1,
        "portion": 0
    }
]

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.recomms.ai//interactions/bulk' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "user_id": "string",
        "item_id": "string",
        "action": "detailviews",
        "timestamp": 0,
        "cascadeCreate": true,
        "duration": 0,
        "price": 0,
        "amount": 0,
        "rating": -1,
        "portion": 0
    }
]'

Responses

🟢200OK

application/json

Successful operation

Body

Example

{
    "status": "completed",
    "total": 0,
    "successful": 0,
    "failed": 0,
    "results": {
        "success": [
            {
                "status": "success",
                "timestamp": 0
            }
        ],
        "errors": [
            {
                "error": "string",
                "interaction": {
                    "user_id": "string",
                    "item_id": "string",
                    "action": "detailviews",
                    "timestamp": 0,
                    "cascadeCreate": true,
                    "duration": 0,
                    "price": 0,
                    "amount": 0,
                    "rating": -1,
                    "portion": 0
                }
            }
        ]
    }
}

🟠400Bad Request

🟠401Unauthorized

Modified at 2025-03-13 16:59:48

Delete an interaction

Reset interactions