Recomms AI
  1. Items
Recomms AI
  • Documentation
  • Recomms AI SDK
  • Items
    • Create an item
      POST
    • Update an item
      PATCH
    • Get items
      GET
    • Get item by ID
      GET
    • Delete item
      DELETE
    • Get item side info
      GET
    • Create item side info
      POST
    • Delete item side info
      DELETE
    • Reset items
      POST
  • Users
    • Create a user
      POST
    • Update a user
      PATCH
    • Get users
      GET
    • Get user by ID
      GET
    • Delete user
      DELETE
    • Get user side info
      GET
    • Create user side info
      POST
    • Delete user side info
      DELETE
    • Reset users
      POST
  • Interactions
    • Record an interaction
      POST
    • Get interactions
      GET
    • Delete an interaction
      DELETE
    • Record multiple interactions
      POST
    • Reset interactions
      POST
  • Business Rules
    • Create a new business rule
      POST
    • List business rules
      GET
    • Get business rule by ID
      GET
    • Update business rule
      PATCH
    • Delete business rule
      DELETE
  • Recommendations
    • Get item recommendations for a user
    • Get user recommendations for an item
    • Get similar users
    • Predict scores for user-item pairs
    • Predict scores for a batch of user-item combinations
    • Search for items
    • Search for users
    • Get top items
  1. Items

Create an item

POST
https://api.recomms.ai/{database}/items
Items
Add a new item to the specified database.

Request

Path Params
database
string 
required
The ID of the database to operate on
Body Params application/json
Object for creating a new item. Additional properties can be included based on defined side info.
id
string 
required
Unique identifier for the item
Additional properties
integer  | number  | string  | boolean 
optional
Example
{
    "id": "string"
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.recomms.ai//items' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id": "string"
}'

Responses

🟢200OK
application/json
Successful operation
Body
status
enum<string> 
optional
Allowed value:
success
id
integer 
optional
The ID of the created or affected resource
Example
{
    "status": "success",
    "id": 0
}
🟠400Bad Request
🟠401Unauthorized
Modified at 2025-03-13 16:58:00
Previous
Recomms AI SDK
Next
Update an item
Built with